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:

```bash
docker compose up -d
```

2) Run the API (JWT resource server):

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

3) Run the worker:

```bash
./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.