# shreyash414/sage architecture

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

- Interactive diagram: https://gitdiagram.com/shreyash414/sage
- Repository: https://github.com/shreyash414/sage

## Overview

SAGE is an AICTE approval-governance platform: institutional users prepare applications and evidence, receive OCR/AI-assisted document review and compliance checks, then authorized officers scrutinize and advance applications through statutory decisions; EVC inspections can be scheduled as a distinct stage. The README documents the browser-to-backend REST boundary and major capabilities. Source excerpts confirm selected authorization, scrutiny, workflow, alert, audit and EVC-service relationships; other subsystem links are omitted or marked unverified where implementation was not sampled.

Main entry points: [`backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java`](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java) (State transitions), [`backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java`](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java) (Tenant authorization), [`backend/src/main/java/org/aicte/sage/modules/documents/model/Document.java`](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/documents/model/Document.java) (Document evidence), [`evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java`](https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java) (Scheduling service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Browser experience"]
  node_browser["SAGE web app<br/>[App.tsx]"]
  node_api["REST client<br/>[client.ts]"]
  node_authui["Session and login<br/>[AuthContext.tsx]"]
end

subgraph group_authority["Core authority"]
  node_backend["Core REST backend"]
  node_identity["Identity and roles<br/>[AuthService.java]"]
  node_tenancy["Tenant authorization"]
  node_institutions[("Institution records<br/>[Institution.java]")]
  node_applications[("Application lifecycle<br/>[Application.java]")]
  node_workflow["State transitions"]
end

subgraph group_evidence["Document intelligence"]
  node_documents[("Document evidence<br/>[Document.java]")]
  node_storage["Document storage"]
  node_ocr["OCR service<br/>[ocr_service.py]"]
end

subgraph group_oversight["Compliance and oversight"]
  node_scrutiny["Statutory scrutiny"]
  node_compliance["Compliance monitoring"]
  node_deadlines["Expiry deadlines"]
  node_alerts["Alerts and delivery<br/>[AlertService.java]"]
  node_audit[("Audit ledger<br/>[AuditService.java]")]
end

subgraph group_inspection["EVC scheduling"]
  node_evc["EVC scheduling API"]
  node_schedule["Scheduling service"]
  node_solver["CP-SAT optimizer"]
  node_experts[("Expert and availability data<br/>[Expert.java]")]
end

node_applicant(("Institution users"))

node_applicant -->|"uses"| node_browser
node_browser -.->|"requests"| node_api
node_api -->|"REST calls"| node_backend
node_authui -.->|"authenticates"| node_api
node_backend -.->|"serves"| node_identity
node_workflow -->|"checks access"| node_tenancy
node_tenancy -->|"checks affiliation"| node_institutions
node_workflow -->|"loads and updates"| node_applications
node_workflow -->|"creates alerts"| node_alerts
node_scrutiny -->|"evaluates"| node_applications
node_scrutiny -->|"checks evidence"| node_documents
node_documents -.->|"stores files"| node_storage
node_documents -.->|"submits for OCR"| node_ocr
node_compliance -->|"checks readiness"| node_applications
node_compliance -.->|"tracks expiry"| node_deadlines
node_deadlines -.->|"notifies expiry"| node_alerts
node_alerts -.->|"records actions"| node_audit
node_tenancy -->|"records denials"| node_audit
node_evc -.->|"dispatches"| node_schedule
node_schedule -->|"optimizes"| node_solver
node_schedule -->|"loads availability"| node_experts

click node_browser "https://github.com/shreyash414/sage/blob/main/frontend/src/App.tsx"
click node_api "https://github.com/shreyash414/sage/blob/main/frontend/src/api/client.ts"
click node_authui "https://github.com/shreyash414/sage/blob/main/frontend/src/context/AuthContext.tsx"
click node_backend "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/SageApplication.java"
click node_identity "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/auth/service/AuthService.java"
click node_tenancy "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java"
click node_institutions "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/institutions/entity/Institution.java"
click node_applications "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/applications/model/Application.java"
click node_workflow "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java"
click node_documents "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/documents/model/Document.java"
click node_storage "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/documents/service/DocumentStorageService.java"
click node_ocr "https://github.com/shreyash414/sage/blob/main/automation/app/services/ocr_service.py"
click node_scrutiny "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/scrutiny/service/ScrutinyEngineService.java"
click node_compliance "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/compliance/service/ComplianceEngineService.java"
click node_deadlines "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/deadlines/service/DeadlineService.java"
click node_alerts "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/notifications/service/AlertService.java"
click node_audit "https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/common/audit/AuditService.java"
click node_evc "https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/api/EvcScheduleApiController.java"
click node_schedule "https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java"
click node_solver "https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/scheduler/EvcCpSatScheduler.java"
click node_experts "https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/entity/Expert.java"

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_browser,node_api,node_authui,node_applicant toneBlue
class node_backend,node_identity,node_tenancy,node_institutions,node_applications,node_workflow toneAmber
class node_documents,node_storage,node_ocr toneMint
class node_scrutiny,node_compliance,node_deadlines,node_alerts,node_audit toneRose
class node_evc,node_schedule,node_solver,node_experts toneIndigo
```

## Components

### Browser experience

- [SAGE web app](https://github.com/shreyash414/sage/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [REST client](https://github.com/shreyash414/sage/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Session and login](https://github.com/shreyash414/sage/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`

### Core authority

- [Core REST backend](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/SageApplication.java): `backend/src/main/java/org/aicte/sage/SageApplication.java`
- [Identity and roles](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/auth/service/AuthService.java): `backend/src/main/java/org/aicte/sage/modules/auth/service/AuthService.java`
- [Tenant authorization](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java): `backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java`
- [Institution records](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/institutions/entity/Institution.java): `backend/src/main/java/org/aicte/sage/modules/institutions/entity/Institution.java`
- [Application lifecycle](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/applications/model/Application.java): `backend/src/main/java/org/aicte/sage/modules/applications/model/Application.java`
- [State transitions](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java): `backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java`

### Document intelligence

- [Document evidence](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/documents/model/Document.java): `backend/src/main/java/org/aicte/sage/modules/documents/model/Document.java`
- [Document storage](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/documents/service/DocumentStorageService.java): `backend/src/main/java/org/aicte/sage/modules/documents/service/DocumentStorageService.java`
- [OCR service](https://github.com/shreyash414/sage/blob/main/automation/app/services/ocr_service.py): `automation/app/services/ocr_service.py`

### Compliance and oversight

- [Statutory scrutiny](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/scrutiny/service/ScrutinyEngineService.java): `backend/src/main/java/org/aicte/sage/modules/scrutiny/service/ScrutinyEngineService.java`
- [Compliance monitoring](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/compliance/service/ComplianceEngineService.java): `backend/src/main/java/org/aicte/sage/modules/compliance/service/ComplianceEngineService.java`
- [Expiry deadlines](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/deadlines/service/DeadlineService.java): `backend/src/main/java/org/aicte/sage/modules/deadlines/service/DeadlineService.java`
- [Alerts and delivery](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/modules/notifications/service/AlertService.java): `backend/src/main/java/org/aicte/sage/modules/notifications/service/AlertService.java`
- [Audit ledger](https://github.com/shreyash414/sage/blob/main/backend/src/main/java/org/aicte/sage/common/audit/AuditService.java): `backend/src/main/java/org/aicte/sage/common/audit/AuditService.java`

### EVC scheduling

- [EVC scheduling API](https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/api/EvcScheduleApiController.java): `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/api/EvcScheduleApiController.java`
- [Scheduling service](https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java): `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java`
- [CP-SAT optimizer](https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/scheduler/EvcCpSatScheduler.java): `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/scheduler/EvcCpSatScheduler.java`
- [Expert and availability data](https://github.com/shreyash414/sage/blob/main/evc-scheduling-engine/src/main/java/in/gov/aicte/evc/entity/Expert.java): `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/entity/Expert.java`

### Other components

- **Institution users**

## Connections

- Institution users → SAGE web app: uses (evidence: `README.md`)
- SAGE web app → REST client: requests
- REST client → Core REST backend: REST calls (evidence: `README.md`)
- Session and login → REST client: authenticates
- Core REST backend → Identity and roles: serves
- State transitions → Tenant authorization: checks access (evidence: `backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java`)
- Tenant authorization → Institution records: checks affiliation (evidence: `backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java`)
- State transitions → Application lifecycle: loads and updates (evidence: `backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java`)
- State transitions → Alerts and delivery: creates alerts (evidence: `backend/src/main/java/org/aicte/sage/modules/workflow/service/WorkflowEngineService.java`)
- Statutory scrutiny → Application lifecycle: evaluates (evidence: `backend/src/main/java/org/aicte/sage/modules/scrutiny/service/ScrutinyEngineService.java`)
- Statutory scrutiny → Document evidence: checks evidence (evidence: `backend/src/main/java/org/aicte/sage/modules/scrutiny/service/ScrutinyEngineService.java`)
- Document evidence → Document storage: stores files
- Document evidence → OCR service: submits for OCR (evidence: `README.md`)
- Compliance monitoring → Application lifecycle: checks readiness (evidence: `backend/src/main/java/org/aicte/sage/modules/compliance/service/ComplianceEngineService.java`)
- Compliance monitoring → Expiry deadlines: tracks expiry (evidence: `README.md`)
- Expiry deadlines → Alerts and delivery: notifies expiry (evidence: `README.md`)
- Alerts and delivery → Audit ledger: records actions (evidence: `backend/src/main/java/org/aicte/sage/modules/notifications/service/AlertService.java`)
- Tenant authorization → Audit ledger: records denials (evidence: `backend/src/main/java/org/aicte/sage/common/security/AuthoritativeAuthorizationService.java`)
- EVC scheduling API → Scheduling service: dispatches
- Scheduling service → CP-SAT optimizer: optimizes (evidence: `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java`)
- Scheduling service → Expert and availability data: loads availability (evidence: `evc-scheduling-engine/src/main/java/in/gov/aicte/evc/service/DefaultEvcSchedulingService.java`)
