# aplp.backend.spring

Backend cho **APLP — Adaptive Personal Learning Platform** (learner application `aplp-web`).

Java 21 · Spring Boot 3.5 · Modular Monolith · Clean Architecture 4 Layers · DDD-oriented · Vertical Slice.

## Status

**Phase 0 — Foundation: implemented.**

- Backend skeleton (modular monolith: `common`, `identity`, `learner`)
- JWT authentication (register / login / logout / refresh)
- Basic user + learner profile
- Database foundation: PostgreSQL (docker-compose) + Flyway migrations
- Env-based configuration, unified error handling, `X-Request-Id`, health/readiness
- Integration tests (11, green)

## Quickstart

```bash
docker compose up -d db
./mvnw spring-boot:run
curl http://localhost:8080/actuator/health
```

Xem `docs/SETUP.md` để biết chi tiết.

## Documents

| Tài liệu | Mô tả |
| --- | --- |
| [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Kiến trúc backend: modular monolith, 4 layers |
| [docs/MODULES.md](./docs/MODULES.md) | Danh sách business module theo phase |
| [docs/CONVENTIONS.md](./docs/CONVENTIONS.md) | Coding & layer conventions |
| [docs/SETUP.md](./docs/SETUP.md) | Hướng dẫn setup / chạy local |