mosenioring/back001/README.md

Mosenioring Backend

Production-ready Kotlin/Spring Boot 3 modular monolith skeleton for patient-caregiver-doctor coordination.

Requirements

• Java 21
• Docker + Docker Compose

Local Dev

1. Start dependencies:

docker compose up -d

2. Run the API (JWT resource server):

./gradlew :app:bootRun -Dspring.profiles.active=local

3. Run the worker:

./gradlew :workers:notification-worker:bootRun

Auth

• The backend is a JWT resource server and does not handle user passwords.
• Local auth shortcut is available only when SPRING_PROFILES_ACTIVE=local and ALLOW_LOCAL_AUTH=true.

Local headers (dev only):

• X-Local-Email: user id/email
• X-Local-Roles: comma-separated roles (ADMIN, DOCTOR, CAREGIVER)
• X-Tenant-Id: tenant id

OpenAPI

• http://localhost:8080/swagger-ui/index.html

Health

• http://localhost:8080/health

Key services

• Postgres: localhost:5432 (mosenioring/mosenioring)
• Keycloak: http://localhost:8081 (admin/admin)
• RabbitMQ: http://localhost:15672 (guest/guest)
• MinIO: http://localhost:9001 (minio/minio123)

Notes

• Tenant ID is enforced via TenantFilter using JWT claim tenant_id, or X-Tenant-Id header (local).
• Medication plan creation publishes a MedicationPlanCreated outbox event.
• Worker consumes and emits NotificationRequested events with idempotency via Redis.