# 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)
