# aaditya514/auto-meds architecture

> Architecture diagram of the GitHub repository aaditya514/auto-meds, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aaditya514/auto-meds
- Repository: https://github.com/aaditya514/auto-meds

## Overview

Auto-Meds is a smart e-pharmacy backend and Angular portal for patients, caregivers, and pharmacists. The main workflow runs from medicine discovery and prescription-backed refill requests through pharmacist review, ordering, and recurring refills; caregiver delegation and live notifications support that cycle. The graph also preserves clinical safety, inventory, audit, and administration capabilities described in the README. Only selected source files were sampled, so documented cross-system links are included, while uncertain implementation-level calls are omitted.

Main entry points: [`auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Subscription.java`](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Subscription.java) (Refill subscriptions), [`auto-meds-frontend/auto-meds-frontend/src/app/patient/medicines/medicines.component.ts`](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/patient/medicines/medicines.component.ts) (Patient portal), [`auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts`](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts) (Admin API client), [`auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java`](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Patient and caregiver"]
  node_portal["Patient portal"]
  node_cart["Cart and checkout"]
  node_caregiver["Caregiver delegation"]
end

subgraph group_clinical["Clinical and fulfillment"]
  node_clinical["Prescription and safety"]
  node_ocr["Prescription OCR"]
  node_medicine["Medicine catalog<br/>[Medicine.java]"]
  node_orders["Orders and dispensing<br/>[Order.java]"]
  node_ordercontract["Order response<br/>[OrderDTO.java]"]
end

subgraph group_refill["Subscriptions and inventory"]
  node_subscription["Refill subscriptions<br/>[Subscription.java]"]
  node_subscriptioncontract["Subscription response"]
  node_scheduler["Auto-refill scheduler"]
  node_stock["Inventory allocation"]
end

subgraph group_operations["Pharmacy operations"]
  node_admin["Pharmacist console"]
  node_adminservice["Admin API client<br/>[admin.service.ts]"]
  node_audit["Audit trail"]
  node_realtime["Live notifications"]
end

subgraph group_platform["Identity and platform"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_user["User account<br/>[User.java]"]
  node_userrepo[("User repository")]
  node_principal["Security principal<br/>[UserPrincipal.java]"]
  node_badrequest["Request validation error"]
  node_frontendauth["Portal authentication<br/>[auth.service.ts]"]
end

node_patient(("Patient / caregiver"))
node_external(("SMS gateway"))

node_patient -->|"uses"| node_portal
node_portal -.->|"searches catalog"| node_medicine
node_portal -.->|"uploads prescription"| node_clinical
node_portal -.->|"adds items"| node_cart
node_cart -.->|"places orders"| node_orders
node_patient -->|"delegates access"| node_caregiver
node_clinical -.->|"requests OCR"| node_ocr
node_ocr -->|"matches candidates"| node_medicine
node_admin -.->|"uses API client"| node_adminservice
node_adminservice -->|"reviews requests"| node_subscription
node_adminservice -->|"updates soft locks"| node_stock
node_adminservice -->|"updates status"| node_orders
node_scheduler -->|"dispatches refills"| node_subscription
node_subscription -->|"allocates inventory"| node_stock
node_subscription -->|"returns response"| node_subscriptioncontract
node_orders -.->|"exposes order data"| node_ordercontract
node_frontendauth -->|"calls auth API"| node_auth
node_auth -->|"looks up users"| node_userrepo
node_auth -->|"creates accounts"| node_user
node_userrepo -->|"persists"| node_user
node_user -->|"forms principal"| node_principal
node_auth -->|"rejects invalid input"| node_badrequest
node_admin -->|"receives live updates"| node_realtime
node_orders -.->|"publishes status"| node_realtime
node_external -->|"confirms refills"| node_subscription
node_clinical -->|"records decisions"| node_audit

click node_portal "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/patient/medicines/medicines.component.ts"
click node_cart "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/patient/checkout/checkout.component.ts"
click node_caregiver "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/CaregiverService.java"
click node_clinical "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionService.java"
click node_ocr "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionOcrService.java"
click node_medicine "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Medicine.java"
click node_orders "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Order.java"
click node_ordercontract "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/OrderDTO.java"
click node_subscription "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Subscription.java"
click node_subscriptioncontract "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/SubscriptionResponseDTO.java"
click node_scheduler "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/scheduler/AutoRefillScheduler.java"
click node_stock "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/MedicineRepository.java"
click node_admin "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/admin/dashboard/admin-dashboard.component.ts"
click node_adminservice "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts"
click node_audit "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/controller/AuditLogController.java"
click node_realtime "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/SseNotificationService.java"
click node_auth "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java"
click node_user "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/User.java"
click node_userrepo "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/UserRepository.java"
click node_principal "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/security/UserPrincipal.java"
click node_badrequest "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/exception/BadRequestException.java"
click node_frontendauth "https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/core/services/auth.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_portal,node_cart,node_caregiver toneBlue
class node_clinical,node_ocr,node_medicine,node_orders,node_ordercontract toneAmber
class node_subscription,node_subscriptioncontract,node_scheduler,node_stock toneMint
class node_admin,node_adminservice,node_audit,node_realtime toneRose
class node_auth,node_user,node_userrepo,node_principal,node_badrequest,node_frontendauth,node_patient,node_external toneIndigo
```

## Components

### Patient and caregiver

- [Patient portal](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/patient/medicines/medicines.component.ts): `auto-meds-frontend/auto-meds-frontend/src/app/patient/medicines/medicines.component.ts`
- [Cart and checkout](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/patient/checkout/checkout.component.ts): `auto-meds-frontend/auto-meds-frontend/src/app/patient/checkout/checkout.component.ts`
- [Caregiver delegation](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/CaregiverService.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/CaregiverService.java`

### Clinical and fulfillment

- [Prescription and safety](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionService.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionService.java`
- [Prescription OCR](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionOcrService.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionOcrService.java`
- [Medicine catalog](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Medicine.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Medicine.java`
- [Orders and dispensing](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Order.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Order.java`
- [Order response](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/OrderDTO.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/OrderDTO.java`

### Subscriptions and inventory

- [Refill subscriptions](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Subscription.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/Subscription.java`
- [Subscription response](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/SubscriptionResponseDTO.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/dto/SubscriptionResponseDTO.java`
- [Auto-refill scheduler](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/scheduler/AutoRefillScheduler.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/scheduler/AutoRefillScheduler.java`
- [Inventory allocation](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/MedicineRepository.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/MedicineRepository.java`

### Pharmacy operations

- [Pharmacist console](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/admin/dashboard/admin-dashboard.component.ts): `auto-meds-frontend/auto-meds-frontend/src/app/admin/dashboard/admin-dashboard.component.ts`
- [Admin API client](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts): `auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts`
- [Audit trail](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/controller/AuditLogController.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/controller/AuditLogController.java`
- [Live notifications](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/SseNotificationService.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/SseNotificationService.java`

### Identity and platform

- [Authentication](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java`
- [User account](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/User.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/entity/User.java`
- [User repository](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/UserRepository.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/UserRepository.java`
- [Security principal](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/security/UserPrincipal.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/security/UserPrincipal.java`
- [Request validation error](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/exception/BadRequestException.java): `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/exception/BadRequestException.java`
- [Portal authentication](https://github.com/aaditya514/auto-meds/blob/main/auto-meds-frontend/auto-meds-frontend/src/app/core/services/auth.service.ts): `auto-meds-frontend/auto-meds-frontend/src/app/core/services/auth.service.ts`

### Other components

- **Patient / caregiver**
- **SMS gateway**

## Connections

- Patient / caregiver → Patient portal: uses
- Patient portal → Medicine catalog: searches catalog
- Patient portal → Prescription and safety: uploads prescription
- Patient portal → Cart and checkout: adds items
- Cart and checkout → Orders and dispensing: places orders
- Patient / caregiver → Caregiver delegation: delegates access
- Prescription and safety → Prescription OCR: requests OCR
- Prescription OCR → Medicine catalog: matches candidates (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/PrescriptionOcrService.java`)
- Pharmacist console → Admin API client: uses API client
- Admin API client → Refill subscriptions: reviews requests (evidence: `auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts`)
- Admin API client → Inventory allocation: updates soft locks (evidence: `auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts`)
- Admin API client → Orders and dispensing: updates status (evidence: `auto-meds-frontend/auto-meds-frontend/src/app/core/services/admin.service.ts`)
- Auto-refill scheduler → Refill subscriptions: dispatches refills
- Refill subscriptions → Inventory allocation: allocates inventory
- Refill subscriptions → Subscription response: returns response (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/SubscriptionService.java`)
- Orders and dispensing → Order response: exposes order data
- Portal authentication → Authentication: calls auth API (evidence: `auto-meds-frontend/auto-meds-frontend/src/app/core/services/auth.service.ts`)
- Authentication → User repository: looks up users (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java`)
- Authentication → User account: creates accounts (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java`)
- User repository → User account: persists (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/repository/UserRepository.java`)
- User account → Security principal: forms principal (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/security/UserPrincipal.java`)
- Authentication → Request validation error: rejects invalid input (evidence: `auto-meds-backend/auto-meds-backend/src/main/java/com/automeds/service/AuthService.java`)
- Pharmacist console → Live notifications: receives live updates
- Orders and dispensing → Live notifications: publishes status
- SMS gateway → Refill subscriptions: confirms refills
- Prescription and safety → Audit trail: records decisions
