How institutofloravida/pharma-api works
Pharma API is a NestJS service for institutional medicine inventory and dispensing. The principal visible workflow is an authenticated HTTP request to preview dispensing, which invokes application logic that checks medicine stock and selects eligible batches. Other substantial domain branches cover stock movements, inventory and reports, and management of operators and reference records. The excerpts establish the preview and report-controller links; other capabilities are represented from the source tree, but their runtime wiring was not sampled.
Main entry points: repositories Repository Contracts · controllers HTTP Controllers · dispensation-preview.ts Dispense Preview · operator Operator Management
Components 21
HTTP API
- HTTP Controllers
src/infra/http/controllers - JWT and Roles
src/infra/auth
Inventory Operations
- Medicine Stock
src/domain/pharma/application/repositories/medicines-stock-repository.ts - Batch Stock
src/domain/pharma/application/repositories/batch-stocks-repository.ts - Stock Movements
src/domain/pharma/application/use-cases/movimentation - Inventory Queries
src/domain/pharma/application/use-cases/inventory - Reports
src/domain/pharma/application/use-cases/reports - Metrics and Alerts
src/domain/pharma/application/use-cases/metrics - Medicine Utilization
src/domain/pharma/application/use-cases/use-medicine
Dispensing
- Dispense Preview
src/domain/pharma/application/use-cases/dispensation/dispensation-preview.ts - Dispensation Records
src/domain/pharma/application/use-cases/dispensation
Administration
- Operator Management
src/domain/pharma/application/use-cases/operator - Institution Records
src/domain/pharma/application/use-cases/institution - Medicine Reference Data
src/domain/pharma/application/use-cases/auxiliary-records - Patient Records
src/domain/pharma/application/use-cases/patient
Domain and Persistence
- Repository Contracts
src/domain/pharma/application/repositories - Pharma Entities
src/domain/pharma/enterprise/entities - Core Primitives
src/core - Prisma Database
src/infra/database - Cryptography Adapters
src/infra/cryptography
Other components
- API Client
Connections 20
- API Client → HTTP Controllers: sends requests
- HTTP Controllers → Dispense Preview: invokes preview
src/infra/http/controllers/dispensation/dispensation-preview.controller.ts - Dispense Preview → Medicine Stock: reads stock
src/domain/pharma/application/use-cases/dispensation/dispensation-preview.ts - Dispense Preview → Batch Stock: lists batches
src/domain/pharma/application/use-cases/dispensation/dispensation-preview.ts - HTTP Controllers → Reports: dispatches reports
src/infra/http/controllers/reports/get-inventory-report.controller.ts - HTTP Controllers → JWT and Roles: guards requests
src/infra/http/controllers/dispensation/dispensation-preview.controller.ts - Stock Movements → Repository Contracts: uses contracts
- Inventory Queries → Repository Contracts: uses contracts
- Reports → Repository Contracts: uses contracts
- Metrics and Alerts → Repository Contracts: uses contracts
- Dispensation Records → Repository Contracts: uses contracts
src/domain/pharma/application/use-cases/dispensation/dispensation-preview.ts - Operator Management → Repository Contracts: uses contracts
src/domain/pharma/application/use-cases/operator/authenticate-operator.ts - Institution Records → Repository Contracts: uses contracts
- Medicine Reference Data → Repository Contracts: uses contracts
- Patient Records → Repository Contracts: uses contracts
src/domain/pharma/application/use-cases/patient/update-patient.ts - Medicine Utilization → Repository Contracts: uses contracts
- Repository Contracts → Prisma Database: implemented by
- Repository Contracts → Pharma Entities: models data
src/domain/pharma/application/repositories/medicines-stock-repository.ts - Dispense Preview → Core Primitives: returns Either
src/domain/pharma/application/use-cases/dispensation/dispensation-preview.ts - Operator Management → Cryptography Adapters: uses cryptography