# ashhh02/accreditation_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/ashhh02/accreditation_management_system
- Repository: https://github.com/ashhh02/accreditation_management_system

## Overview

JMCFI AMS is a role-based accreditation evidence management system. Program Heads create submission versions and attach supporting files; Dean, Area Chair, and QA/Accreditation Head reviewers assess them, request revisions, or complete review. The application also provides account administration, dashboards and reporting, AI-assisted insights, and messaging. The graph emphasizes these product stages and the shared access, persistence, notification, and audit layers. Some route and view implementations were not sampled, so their connections are omitted rather than inferred.

Main entry points: [`accounts/views.py`](https://github.com/ashhh02/accreditation_management_system/blob/main/accounts/views.py) (Account management), [`dashboard/views.py`](https://github.com/ashhh02/accreditation_management_system/blob/main/dashboard/views.py) (Operational dashboard), [`accreditation/workflow.py`](https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/workflow.py) (Review transitions), [`intelligence/services.py`](https://github.com/ashhh02/accreditation_management_system/blob/main/intelligence/services.py) (AVA insights & reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts &amp; Access"]
  node_account_views["Account management<br/>[views.py]"]
  node_account_forms["Account forms<br/>[forms.py]"]
end

subgraph group_accreditation["Evidence Workflow"]
  node_accreditation_ui["Evidence workspace &amp; review<br/>[db_views.py]"]
  node_workflow["Review transitions<br/>[workflow.py]"]
  node_evidence_data["Cycle-to-requirement structure<br/>[evidence_data.py]"]
  node_evidence_store[("Evidence submissions &amp; versions<br/>[models.py]")]
end

subgraph group_insights["Dashboards &amp; Insights"]
  node_dashboard["Operational dashboard<br/>[views.py]"]
  node_charting["Dashboard charting<br/>[charting.py]"]
  node_ai_insights["AVA insights &amp; reports<br/>[services.py]"]
end

subgraph group_collaboration["Messaging &amp; Alerts"]
  node_message_api["Messaging service<br/>[services.py]"]
  node_message_ws["Messaging WebSocket<br/>[consumers.py]"]
  node_message_store[("Conversations &amp; messages<br/>[models.py]")]
end

subgraph group_platform["Shared Services"]
  node_access["Role access rules<br/>[access.py]"]
  node_audit["Audit records<br/>[audit.py]"]
  node_core_data[("Users &amp; notifications<br/>[models.py]")]
  node_notifications["Notification service<br/>[notifications.py]"]
  node_rate_limit["Rate limiting<br/>[ratelimit.py]"]
end

node_user(("Staff user"))
node_ai_provider["AI provider"]

node_user -->|"signs in / requests access"| node_account_views
node_account_views -->|"validates"| node_account_forms
node_account_views -->|"checks permissions"| node_access
node_account_views -->|"records events"| node_audit
node_account_views -->|"notifies users"| node_notifications
node_user -->|"submits evidence / reviews"| node_accreditation_ui
node_accreditation_ui -->|"reads and writes"| node_evidence_store
node_accreditation_ui -->|"invokes transitions"| node_workflow
node_workflow -->|"updates review state"| node_evidence_store
node_workflow -->|"checks reviewer eligibility"| node_access
node_workflow -->|"sends workflow alerts"| node_notifications
node_user -->|"views status"| node_dashboard
node_dashboard -->|"aggregates submissions"| node_evidence_store
node_dashboard -->|"reads activity data"| node_core_data
node_dashboard -->|"scopes submissions"| node_access
node_dashboard -->|"uses charts"| node_charting
node_user -->|"requests insights"| node_ai_insights
node_ai_insights -->|"retrieves live facts"| node_evidence_store
node_ai_insights -->|"scopes retrieved data"| node_access
node_ai_insights -.->|"optionally calls"| node_ai_provider
node_user -.->|"uses live messaging"| node_message_ws
node_message_ws -->|"delegates messages"| node_message_api
node_message_api -->|"persists messages"| node_message_store
node_message_api -->|"checks send rate"| node_rate_limit
node_message_api -->|"alerts conversation members"| node_notifications
node_notifications -->|"persists notifications"| node_core_data
node_user -->|"works within cycle structure"| node_evidence_data

click node_account_views "https://github.com/ashhh02/accreditation_management_system/blob/main/accounts/views.py"
click node_account_forms "https://github.com/ashhh02/accreditation_management_system/blob/main/accounts/forms.py"
click node_access "https://github.com/ashhh02/accreditation_management_system/blob/main/core/access.py"
click node_audit "https://github.com/ashhh02/accreditation_management_system/blob/main/core/audit.py"
click node_core_data "https://github.com/ashhh02/accreditation_management_system/blob/main/core/models.py"
click node_accreditation_ui "https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/db_views.py"
click node_workflow "https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/workflow.py"
click node_evidence_data "https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/evidence_data.py"
click node_evidence_store "https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/models.py"
click node_dashboard "https://github.com/ashhh02/accreditation_management_system/blob/main/dashboard/views.py"
click node_charting "https://github.com/ashhh02/accreditation_management_system/blob/main/dashboard/charting.py"
click node_ai_insights "https://github.com/ashhh02/accreditation_management_system/blob/main/intelligence/services.py"
click node_message_api "https://github.com/ashhh02/accreditation_management_system/blob/main/resources/services.py"
click node_message_ws "https://github.com/ashhh02/accreditation_management_system/blob/main/resources/consumers.py"
click node_message_store "https://github.com/ashhh02/accreditation_management_system/blob/main/resources/models.py"
click node_notifications "https://github.com/ashhh02/accreditation_management_system/blob/main/core/notifications.py"
click node_rate_limit "https://github.com/ashhh02/accreditation_management_system/blob/main/core/ratelimit.py"

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_account_views,node_account_forms,node_user toneBlue
class node_accreditation_ui,node_workflow,node_evidence_data,node_evidence_store toneAmber
class node_dashboard,node_charting,node_ai_insights toneMint
class node_message_api,node_message_ws,node_message_store toneRose
class node_access,node_audit,node_core_data,node_notifications,node_rate_limit,node_ai_provider toneIndigo
```

## Components

### Accounts & Access

- [Account management](https://github.com/ashhh02/accreditation_management_system/blob/main/accounts/views.py): `accounts/views.py`
- [Account forms](https://github.com/ashhh02/accreditation_management_system/blob/main/accounts/forms.py): `accounts/forms.py`

### Evidence Workflow

- [Evidence workspace & review](https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/db_views.py): `accreditation/db_views.py`
- [Review transitions](https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/workflow.py): `accreditation/workflow.py`
- [Cycle-to-requirement structure](https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/evidence_data.py): `accreditation/evidence_data.py`
- [Evidence submissions & versions](https://github.com/ashhh02/accreditation_management_system/blob/main/accreditation/models.py): `accreditation/models.py`

### Dashboards & Insights

- [Operational dashboard](https://github.com/ashhh02/accreditation_management_system/blob/main/dashboard/views.py): `dashboard/views.py`
- [Dashboard charting](https://github.com/ashhh02/accreditation_management_system/blob/main/dashboard/charting.py): `dashboard/charting.py`
- [AVA insights & reports](https://github.com/ashhh02/accreditation_management_system/blob/main/intelligence/services.py): `intelligence/services.py`

### Messaging & Alerts

- [Messaging service](https://github.com/ashhh02/accreditation_management_system/blob/main/resources/services.py): `resources/services.py`
- [Messaging WebSocket](https://github.com/ashhh02/accreditation_management_system/blob/main/resources/consumers.py): `resources/consumers.py`
- [Conversations & messages](https://github.com/ashhh02/accreditation_management_system/blob/main/resources/models.py): `resources/models.py`

### Shared Services

- [Role access rules](https://github.com/ashhh02/accreditation_management_system/blob/main/core/access.py): `core/access.py`
- [Audit records](https://github.com/ashhh02/accreditation_management_system/blob/main/core/audit.py): `core/audit.py`
- [Users & notifications](https://github.com/ashhh02/accreditation_management_system/blob/main/core/models.py): `core/models.py`
- [Notification service](https://github.com/ashhh02/accreditation_management_system/blob/main/core/notifications.py): `core/notifications.py`
- [Rate limiting](https://github.com/ashhh02/accreditation_management_system/blob/main/core/ratelimit.py): `core/ratelimit.py`

### Other components

- **Staff user**
- **AI provider**

## Connections

- Staff user → Account management: signs in / requests access (evidence: `README.md`)
- Account management → Account forms: validates (evidence: `accounts/views.py`)
- Account management → Role access rules: checks permissions (evidence: `accounts/views.py`)
- Account management → Audit records: records events (evidence: `accounts/views.py`)
- Account management → Notification service: notifies users (evidence: `accounts/views.py`)
- Staff user → Evidence workspace & review: submits evidence / reviews (evidence: `README.md`)
- Evidence workspace & review → Evidence submissions & versions: reads and writes (evidence: `accreditation/db_views.py`)
- Evidence workspace & review → Review transitions: invokes transitions (evidence: `accreditation/db_views.py`)
- Review transitions → Evidence submissions & versions: updates review state (evidence: `accreditation/workflow.py`)
- Review transitions → Role access rules: checks reviewer eligibility (evidence: `accreditation/workflow.py`)
- Review transitions → Notification service: sends workflow alerts (evidence: `accreditation/workflow.py`)
- Staff user → Operational dashboard: views status (evidence: `README.md`)
- Operational dashboard → Evidence submissions & versions: aggregates submissions (evidence: `dashboard/views.py`)
- Operational dashboard → Users & notifications: reads activity data (evidence: `dashboard/views.py`)
- Operational dashboard → Role access rules: scopes submissions (evidence: `dashboard/views.py`)
- Operational dashboard → Dashboard charting: uses charts (evidence: `dashboard/views.py`)
- Staff user → AVA insights & reports: requests insights (evidence: `README.md`)
- AVA insights & reports → Evidence submissions & versions: retrieves live facts (evidence: `intelligence/services.py`)
- AVA insights & reports → Role access rules: scopes retrieved data (evidence: `intelligence/services.py`)
- AVA insights & reports → AI provider: optionally calls (evidence: `intelligence/services.py`)
- Staff user → Messaging WebSocket: uses live messaging (evidence: `README.md`)
- Messaging WebSocket → Messaging service: delegates messages (evidence: `resources/consumers.py`)
- Messaging service → Conversations & messages: persists messages (evidence: `resources/services.py`)
- Messaging service → Rate limiting: checks send rate (evidence: `resources/services.py`)
- Messaging service → Notification service: alerts conversation members (evidence: `resources/services.py`)
- Notification service → Users & notifications: persists notifications (evidence: `core/notifications.py`)
- Staff user → Cycle-to-requirement structure: works within cycle structure (evidence: `README.md`)
