5c6a2e78cf
Register all active platform services and base features in core DB so admin can manage them, add delivery/hospitality/sports-center backend phases, update apps catalog and production deploy tooling. Co-authored-by: Cursor <cursoragent@cursor.com>
92 lines
3.2 KiB
Markdown
92 lines
3.2 KiB
Markdown
# Phase: Clinic Management
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Identifier | `healthcare-13-3` |
|
|
| Status | Planned |
|
|
| Owner | Platform |
|
|
| Module(s) | `healthcare.clinic_services`, `healthcare.staff_assignments`, `healthcare.clinic_policies` |
|
|
| Service(s) | `healthcare` |
|
|
| Depends On | `healthcare-13-0` |
|
|
| ADR(s) | TBD |
|
|
| Manifest | [phase-manifest.yaml](../../ai-framework/phase-manifest.yaml) |
|
|
| Framework | [ADR-013](../../architecture/adr/ADR-013.md) · [ADR-018](../../architecture/adr/ADR-018.md) · [ADR-019](../../architecture/adr/ADR-019.md) |
|
|
|
|
## Objective
|
|
|
|
Enable clinic administrator operations: services catalog, staff-to-department assignments, operating hours policies, and clinic-level configuration — without platform tenant admin (Core), Accounting postings, or patient/doctor clinical workflows owned elsewhere.
|
|
|
|
## Enterprise Phase Discovery
|
|
|
|
> **Required before Implementation.**
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Discovery date | TBD at implementation |
|
|
| Inputs reviewed | Phase 13.0 foundation · clinic admin actor analysis |
|
|
|
|
### Target Responsibility (this phase when Complete)
|
|
|
|
- ClinicService catalog (consultation types, durations, pricing refs — not Accounting invoices)
|
|
- StaffAssignment linking doctors/staff to departments and clinics
|
|
- ClinicPolicy aggregates (cancellation rules, booking lead time, privacy flags)
|
|
- Department hierarchy extensions
|
|
- Permissions `healthcare.clinic_admin.*`, `healthcare.clinic_services.*`
|
|
- Events `healthcare.clinic_service.*`, `healthcare.staff_assignment.*`
|
|
|
|
### Explicitly Excluded
|
|
|
|
- Core tenant/membership admin
|
|
- CRM sales pipelines
|
|
- Appointment slot engine internals (13.1 — consume only)
|
|
- Patient portal (13.4)
|
|
- Medical records (13.5)
|
|
|
|
## Business Analysis
|
|
|
|
| Item | Detail |
|
|
| --- | --- |
|
|
| Actors | Clinic administrator, platform admin (read-only cross-clinic) |
|
|
| Business capabilities | Manage services, staff roster, policies, hours |
|
|
| Success metrics | Admin APIs tenant-scoped; policies enforced by validators in later phases |
|
|
| Non-goals | Payroll, inventory procurement, marketing campaigns |
|
|
|
|
## Scope
|
|
|
|
### In Scope
|
|
|
|
- Aggregates: ClinicService, StaffAssignment, ClinicPolicy, OperatingHoursPolicy
|
|
- CRUD + list with page/filter/sort/search
|
|
- Validators for policy consistency (e.g. cancellation window ≤ booking lead time)
|
|
- Alembic `0004_phase_133_clinic_management`; version `0.13.3.0`
|
|
|
|
### Modules
|
|
|
|
| Module | Change type | Notes |
|
|
| --- | --- | --- |
|
|
| `healthcare.clinic_services` | new | Service catalog |
|
|
| `healthcare.staff_assignments` | new | Staff ↔ department |
|
|
| `healthcare.clinic_policies` | new | Booking/cancellation policies |
|
|
| `healthcare.operating_hours` | extend | Clinic-level hours |
|
|
|
|
## Out of Scope
|
|
|
|
- Doctor panel queue (13.2)
|
|
- Patient portal (13.4)
|
|
- EHR (13.5)
|
|
- Pharmacy (13.6)
|
|
- Delivery (13.7)
|
|
- Accounting journal entries
|
|
|
|
## Completion Criteria
|
|
|
|
- [ ] Clinic admin APIs + permission tests
|
|
- [ ] Policy validators documented
|
|
- [ ] Handover + registry at `0.13.3.0`
|
|
|
|
## Related Documents
|
|
|
|
- [Phase 13.0](phase-13-0-healthcare-foundation.md)
|
|
- [Healthcare Roadmap](../../healthcare-roadmap.md)
|
|
- [Module Registry](../../module-registry.md#healthcare)
|