How rmsofficialsyt/hms works
This repository is an AI-assisted software-development guideline package, not a single hospital-management application. Its primary workflow is to define product requirements, approve versioned feature specifications, then guide changes through test-first implementation and review. It also provides agent policies and operational playbooks, plus a local project dashboard. A healthcare frontend/backend scaffold is present in the tree; the excerpts show patient registration/search and OPD scheduling/vitals, but do not establish that every listed API capability is implemented. Some subsystem links are therefore omitted.
Main entry points: patient.controller.ts Patient workflow · features Feature specifications · opd.controller.ts OPD workflow · patient.entity.ts Patient domain
Components 29
Guidance and governance
- Product definition
docs/product.md - Feature specifications
docs/features - Agent governance
.agents - Operation playbooks
playbooks
Change workflow
- Change control
docs/changes - Approvals
docs/approvals - Test-first gates
docs/code-testing.md
Project dashboard
- Dashboard UI
Project-Manager-Dashboard/index.html - Local dashboard server
Project-Manager-Dashboard/server.js - Governance parser
Project-Manager-Dashboard/parser.js
Healthcare scaffold
- Hospital dashboard
frontend/src/App.tsx - Patient registration UI
frontend/src/components/patients/RegisterPatientModal.tsx - Vitals UI
frontend/src/components/opd/RecordVitalsModal.tsx - Frontend API service
frontend/src/services/api.ts - HTTP application
backend/src/app.ts - Patient routes
backend/src/interfaces/http/routes/patient.routes.ts - Patient workflow
backend/src/interfaces/http/controllers/patient.controller.ts - Patient domain
backend/src/domain/patients/patient.entity.ts - UHID generation
backend/src/domain/patients/uhid-generator.ts - PHI protection
backend/src/domain/patients/encryption.ts - Registration validation
backend/src/domain/patients/patient.schema.ts - Patient repository
backend/src/infrastructure/repositories/patient.repository.ts - OPD workflow
backend/src/interfaces/http/controllers/opd.controller.ts - Roster generation
backend/src/domain/opd/roster-generator.ts - Appointment tokens
backend/src/domain/opd/token-generator.ts - Vitals validation
backend/src/domain/opd/triage-vitals.schema.ts - Authentication workflow
backend/src/interfaces/http/controllers/auth.controller.ts - JWT service
backend/src/domain/auth/jwt.service.ts
Other components
- Engineer
Connections 23
- Engineer → Product definition: defines product
README.md - Engineer → Feature specifications: specifies features
README.md - Feature specifications → Approvals: requires approval
README.md - Engineer → Change control: submits change
README.md - Change control → Feature specifications: updates specification
README.md - Feature specifications → Test-first gates: guides test-first work
README.md - Agent governance → Operation playbooks: supports agent work
- Local dashboard server → Governance parser: queries state
Project-Manager-Dashboard/server.js - Local dashboard server → Dashboard UI: serves assets
- Hospital dashboard → Patient registration UI: renders
frontend/src/App.tsx - Hospital dashboard → Vitals UI: renders
frontend/src/App.tsx - HTTP application → Patient routes: mounts routes
backend/src/app.ts - Patient routes → Patient workflow: dispatches requests
backend/src/interfaces/http/routes/patient.routes.ts - Patient workflow → Patient domain: creates patients
backend/src/interfaces/http/controllers/patient.controller.ts - Patient workflow → Registration validation: validates input
backend/src/interfaces/http/controllers/patient.controller.ts - Patient workflow → PHI protection: hashes and decrypts
backend/src/interfaces/http/controllers/patient.controller.ts - Patient workflow → Patient repository: reads and saves
backend/src/interfaces/http/controllers/patient.controller.ts - Patient domain → UHID generation: generates UHID
backend/src/domain/patients/patient.entity.ts - Patient domain → PHI protection: encrypts contact
backend/src/domain/patients/patient.entity.ts - OPD workflow → Roster generation: generates slots
backend/src/interfaces/http/controllers/opd.controller.ts - OPD workflow → Appointment tokens: allocates tokens
backend/src/interfaces/http/controllers/opd.controller.ts - OPD workflow → Vitals validation: validates vitals
backend/src/interfaces/http/controllers/opd.controller.ts - Authentication workflow → JWT service: uses token service
backend/src/interfaces/http/controllers/auth.controller.ts