Prescriptoo project documentation
Prescriptoo is a Go API for doctor and organization workflows: identity, patient profiles, prescriptions, medicine catalogs, memberships, subscriptions, and notifications. Business services are separate Go modules composed into one API process.
Start here
- Run the project, configure dependencies, and apply migrations.
- Understand the architecture and service boundaries.
- Browse service guides, shared packages, and the generated Go reference.
- Read the architecture decision records, including superseded decisions.
- Use Scalar or Swagger for HTTP schemas and request examples. Download OpenAPI YAML.
Implementation status
| Area | Current behavior |
|---|---|
| Identity | PostgreSQL-backed registration, authentication, profiles, sessions, verification, and recovery |
| Admin | Implemented user administration and organization/member provisioning; medicine and billing contracts remain 501 |
| Organization | Implemented curated admin capabilities and selected legacy routes; newer organization portal contracts return 501 |
| Doctor, Patient, Prescription, Medicine | Validated HTTP contracts; valid requests return 501 |
| Subscription | New shared-plan and manual-billing contracts return 501; older domain/adapters remain in source |
| Notification | Template and delivery use cases with in-memory storage, console email, and stub SMS |
| Health | Workspace module has no Go source; the API composition root supplies /healthz |
Success schemas and declared permissions on documentation-first routes describe intended behavior. They do not establish persisted data, working authorization, or successful operations. Every service guide distinguishes those states.