Skip to content

Backend Tasks Observations Inventory

Ankit Upadhyay edited this page Jul 24, 2026 · 2 revisions

Backend: Tasks, Observations, Inventory

Task workflows, observation tools, inventory/dispensary, prescriptions with controlled-substance handling, and adverse-event reporting. Part of Backend Overview.

What it owns

The operational and pharmacy side of a practice: recurring/scheduled tasks (with reminders), configurable observation tools (and their submissions), the inventory/dispensary with catalog/vendors/alerts/consumption, prescriptions (including controlled-substance dispense), and adverse-event reporting.

Routers

task.router.ts (TaskController, TaskLibraryController, TaskTemplateController), task.fhir.router.ts, task-schedule.fhir.router.ts, observationTool.routes.ts (ObservationToolDefinitionController, ObservationToolSubmissionController), inventory.router.ts (InventoryController, InventoryAlertController, InventoryMetaFieldController, InventoryVendorController), catalog.router.ts, prescription.router.ts, adverse-event.router.ts.

Controllers

web/task.controller.ts, web/task.fhir.controller.ts, web/task-schedule.fhir.controller.ts, web/observationTool.controller.ts, web/inventory.controller.ts, web/catalog.controller.ts, web/prescription.controller.ts, web/adverse-event.controller.ts.

Services

  • Tasks: task.service.ts, taskLibrary.service.ts, taskTemplate.service.ts, task-workflow.service.ts, task-workflow-blueprints.ts, task-workflow-materializer.ts, task.recurrence.engine.ts, task.reminder.engine.ts, task.schedule.engine.ts, mappers fhir-task.mapper.ts, task-schedule.fhir.mapper.ts.
  • Observations: observationToolDefinition.service.ts, observationToolSubmission.service.ts.
  • Inventory: inventory.service.ts, inventory.catalog.ts, inventory-consumption.service.ts, catalog.service.ts.
  • Adverse events: adverse-event.service.ts.

Models

observationToolDefinition.ts and inventory.ts (now Prisma type re-exports — its InventoryItemModel export is an empty stub). Task, reminder, adverse-event, and regulatory-authority entities live solely in the Prisma schema since PR #1819 removed their Mongoose models.

Background jobs

Task recurrence, reminders, and schedules run on BullMQ: queues/task.queues.ts, task.schedulers.ts, task-schedule.queue.ts, task-schedule.scheduler.ts; workers taskRecurrence.worker.ts, taskReminder.worker.ts, taskSchedule.worker.ts. See Backend: Realtime, Chat, Jobs.

Notable

  • Three task engines (recurrence / reminder / schedule) plus workflow blueprints/materializer generate concrete task instances from templates — this is what powers recurring medication and observation schedules.
  • Prescriptions deduct inventory on dispense and log controlled substances (DEA-style) — the regulatory export side is also modeled in the desktop app's compliance module (Desktop PIMS Shell).
  • Observation tools are configurable recording forms (e.g. per-shift vitals) surfaced in both PMS and mobile.

Related

Product & Domain
Architecture
Applications
Design & Accessibility
Engineering Handbook
Decisions (ADRs)
Design Docs & Plans
Roadmap
Operations
Meta

Canonical code & docs: main repo · Auto-generated companion: DeepWiki

Clone this wiki locally