initial

README.md

@@ -1 +1,35 @@
 # 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 |