2026-08-10 20:43:44 +07:00
|
|
|
# aplp.backend.spring
|
2026-08-11 23:11:17 +07:00
|
|
|
|
|
|
|
|
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 |
|
