TorbatYar/docs/phases/Healthcare/phase-13-3-clinic-management.md
Mortezakoohjani 5c6a2e78cf feat(platform): seed service registry, deploy all modules, and fix homepage catalog.
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>
2026-07-27 12:39:51 +03:30

3.2 KiB

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
Framework ADR-013 · ADR-018 · ADR-019

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