# omm-jitesh-mohanty/bput-campus-platform architecture

> Architecture diagram of the GitHub repository omm-jitesh-mohanty/bput-campus-platform, 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/omm-jitesh-mohanty/bput-campus-platform
- Repository: https://github.com/omm-jitesh-mohanty/bput-campus-platform

## Overview

This is a Django campus operations platform with student and administrator portals for tickets, attendance, notices, feedback, workflows, and certificates. A central ticket workflow creates and enriches requests, attaches approval flows, and notifies users; staff-facing analytics and other campus services provide adjacent capabilities. The graph includes documented and indexed runtime relationships. Several portal routes and subsystems are represented from the tree or README, but their internal wiring was not sampled, so uncertain links are omitted.

Main entry points: [`apps/tickets/services.py`](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/tickets/services.py) (Ticket lifecycle), [`apps/documents/services.py`](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/services.py) (Certificates), [`apps/dashboard/services.py`](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/dashboard/services.py) (Operational analytics), [`ai_engine/pipelines/ticket_pipeline.py`](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/ticket_pipeline.py) (Ticket enrichment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Campus operations"]
  node_tickets["Ticket lifecycle<br/>[services.py]"]
  node_ticketdata[("Ticket records<br/>[models.py]")]
  node_attendance["Attendance<br/>[services.py]"]
  node_notices["Notices<br/>[services.py]"]
  node_feedback[("Feedback<br/>[models.py]")]
  node_documents["Certificates<br/>[services.py]"]
  node_documentdata[("Issued documents<br/>[models.py]")]
  node_renderer["Document renderer<br/>[renderer.py]"]
  node_accountdata[("Accounts<br/>[models.py]")]
end

subgraph group_automation["AI and workflows"]
  node_ticketai["Ticket enrichment<br/>[ticket_pipeline.py]"]
  node_noticeai["Notice summarizer<br/>[notice_pipeline.py]"]
  node_feedbackai["Feedback insights"]
  node_llm["LLM client<br/>[base.py]"]
  node_rag["RAG retrieval<br/>[retriever.py]"]
  node_workflow["Workflow engine<br/>[engine.py]"]
  node_workflowdata[("Workflow definitions<br/>[models.py]")]
end

subgraph group_communications["Notifications"]
  node_notifications["Notification service<br/>[services.py]"]
  node_broadcasters["Live broadcasters<br/>[broadcasters.py]"]
  node_notificationdata[("Notification records<br/>[models.py]")]
end

subgraph group_shared["Shared services"]
  node_config["Runtime configuration<br/>[services.py]"]
  node_audit["Audit logging<br/>[audit.py]"]
end

subgraph group_insights["Analytics"]
  node_dashboard["Operational analytics<br/>[services.py]"]
  node_analytics["Forecasts and anomalies"]
end

node_student(("Student"))
node_staff(("Staff"))

node_student -.->|"submits requests"| node_tickets
node_staff -.->|"manages requests"| node_tickets
node_tickets -->|"creates and updates"| node_ticketdata
node_tickets -->|"enriches with"| node_ticketai
node_tickets -->|"attaches workflow"| node_workflow
node_tickets -->|"notifies events"| node_notifications
node_tickets -->|"logs actions"| node_audit
node_ticketai -->|"generates text"| node_llm
node_ticketai -->|"extracts metadata"| node_rag
node_noticeai -->|"summarizes notices"| node_llm
node_feedbackai -->|"reads feedback"| node_feedback
node_feedbackai -->|"generates insights"| node_llm
node_workflow -->|"uses definitions"| node_workflowdata
node_workflow -->|"issues certificates"| node_documents
node_documents -->|"creates records"| node_documentdata
node_documents -->|"renders files"| node_renderer
node_documents -->|"checks eligibility"| node_attendance
node_notifications -->|"creates notifications"| node_notificationdata
node_notifications -.->|"broadcasts events"| node_broadcasters
node_dashboard -->|"aggregates tickets"| node_ticketdata
node_dashboard -->|"aggregates users"| node_accountdata
node_dashboard -->|"aggregates feedback"| node_feedback
node_student -.->|"uses campus services"| node_attendance
node_student -.->|"reads notices"| node_notices
node_student -.->|"provides feedback"| node_feedback
node_student -.->|"requests certificates"| node_documents
node_staff -.->|"views analytics"| node_dashboard
node_analytics -.->|"supports analysis"| node_dashboard
node_tickets -->|"loads defaults"| node_config

click node_tickets "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/tickets/services.py"
click node_ticketdata "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/tickets/models.py"
click node_attendance "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/attendance/services.py"
click node_notices "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notices/services.py"
click node_feedback "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/feedback/models.py"
click node_documents "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/services.py"
click node_documentdata "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/models.py"
click node_renderer "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/renderer.py"
click node_accountdata "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/accounts/models.py"
click node_ticketai "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/ticket_pipeline.py"
click node_noticeai "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/notice_pipeline.py"
click node_feedbackai "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/feedback_pipeline.py"
click node_llm "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/llm/base.py"
click node_rag "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/rag/retriever.py"
click node_workflow "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/workflows/engine.py"
click node_workflowdata "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/workflows/models.py"
click node_notifications "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/services.py"
click node_broadcasters "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/broadcasters.py"
click node_notificationdata "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/models.py"
click node_config "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/core/services.py"
click node_audit "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/core/audit.py"
click node_dashboard "https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/dashboard/services.py"
click node_analytics "https://github.com/omm-jitesh-mohanty/bput-campus-platform/tree/main/apps/dashboard/analytics"

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_tickets,node_ticketdata,node_attendance,node_notices,node_feedback,node_documents,node_documentdata,node_renderer,node_accountdata toneBlue
class node_ticketai,node_noticeai,node_feedbackai,node_llm,node_rag,node_workflow,node_workflowdata toneAmber
class node_notifications,node_broadcasters,node_notificationdata toneMint
class node_config,node_audit toneRose
class node_dashboard,node_analytics,node_student,node_staff toneIndigo
```

## Components

### Campus operations

- [Ticket lifecycle](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/tickets/services.py): `apps/tickets/services.py`
- [Ticket records](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/tickets/models.py): `apps/tickets/models.py`
- [Attendance](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/attendance/services.py): `apps/attendance/services.py`
- [Notices](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notices/services.py): `apps/notices/services.py`
- [Feedback](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/feedback/models.py): `apps/feedback/models.py`
- [Certificates](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/services.py): `apps/documents/services.py`
- [Issued documents](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/models.py): `apps/documents/models.py`
- [Document renderer](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/documents/renderer.py): `apps/documents/renderer.py`
- [Accounts](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/accounts/models.py): `apps/accounts/models.py`

### AI and workflows

- [Ticket enrichment](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/ticket_pipeline.py): `ai_engine/pipelines/ticket_pipeline.py`
- [Notice summarizer](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/notice_pipeline.py): `ai_engine/pipelines/notice_pipeline.py`
- [Feedback insights](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/pipelines/feedback_pipeline.py): `ai_engine/pipelines/feedback_pipeline.py`
- [LLM client](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/llm/base.py): `ai_engine/llm/base.py`
- [RAG retrieval](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/ai_engine/rag/retriever.py): `ai_engine/rag/retriever.py`
- [Workflow engine](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/workflows/engine.py): `apps/workflows/engine.py`
- [Workflow definitions](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/workflows/models.py): `apps/workflows/models.py`

### Notifications

- [Notification service](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/services.py): `apps/notifications/services.py`
- [Live broadcasters](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/broadcasters.py): `apps/notifications/broadcasters.py`
- [Notification records](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/notifications/models.py): `apps/notifications/models.py`

### Shared services

- [Runtime configuration](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/core/services.py): `apps/core/services.py`
- [Audit logging](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/core/audit.py): `apps/core/audit.py`

### Analytics

- [Operational analytics](https://github.com/omm-jitesh-mohanty/bput-campus-platform/blob/main/apps/dashboard/services.py): `apps/dashboard/services.py`
- [Forecasts and anomalies](https://github.com/omm-jitesh-mohanty/bput-campus-platform/tree/main/apps/dashboard/analytics): `apps/dashboard/analytics`

### Other components

- **Student**
- **Staff**

## Connections

- Student → Ticket lifecycle: submits requests
- Staff → Ticket lifecycle: manages requests
- Ticket lifecycle → Ticket records: creates and updates (evidence: `apps/tickets/services.py`)
- Ticket lifecycle → Ticket enrichment: enriches with (evidence: `apps/tickets/services.py`)
- Ticket lifecycle → Workflow engine: attaches workflow (evidence: `apps/tickets/services.py`)
- Ticket lifecycle → Notification service: notifies events (evidence: `apps/tickets/services.py`)
- Ticket lifecycle → Audit logging: logs actions (evidence: `apps/tickets/services.py`)
- Ticket enrichment → LLM client: generates text (evidence: `ai_engine/pipelines/ticket_pipeline.py`)
- Ticket enrichment → RAG retrieval: extracts metadata (evidence: `ai_engine/pipelines/ticket_pipeline.py`)
- Notice summarizer → LLM client: summarizes notices (evidence: `ai_engine/pipelines/notice_pipeline.py`)
- Feedback insights → Feedback: reads feedback (evidence: `ai_engine/pipelines/feedback_pipeline.py`)
- Feedback insights → LLM client: generates insights (evidence: `ai_engine/pipelines/feedback_pipeline.py`)
- Workflow engine → Workflow definitions: uses definitions (evidence: `apps/workflows/engine.py`)
- Workflow engine → Certificates: issues certificates (evidence: `apps/workflows/engine.py`)
- Certificates → Issued documents: creates records (evidence: `apps/documents/services.py`)
- Certificates → Document renderer: renders files (evidence: `apps/documents/services.py`)
- Certificates → Attendance: checks eligibility (evidence: `apps/documents/services.py`)
- Notification service → Notification records: creates notifications (evidence: `apps/notifications/services.py`)
- Notification service → Live broadcasters: broadcasts events
- Operational analytics → Ticket records: aggregates tickets (evidence: `apps/dashboard/services.py`)
- Operational analytics → Accounts: aggregates users (evidence: `apps/dashboard/services.py`)
- Operational analytics → Feedback: aggregates feedback (evidence: `apps/dashboard/services.py`)
- Student → Attendance: uses campus services
- Student → Notices: reads notices
- Student → Feedback: provides feedback
- Student → Certificates: requests certificates
- Staff → Operational analytics: views analytics
- Forecasts and anomalies → Operational analytics: supports analysis
- Ticket lifecycle → Runtime configuration: loads defaults (evidence: `apps/tickets/services.py`)
