How omm-jitesh-mohanty/bput-campus-platform works
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: tickets/services.py Ticket lifecycle · documents/services.py Certificates · dashboard/services.py Operational analytics · ticket_pipeline.py Ticket enrichment
Components 25
Campus operations
- Ticket lifecycle
apps/tickets/services.py - Ticket records
apps/tickets/models.py - Attendance
apps/attendance/services.py - Notices
apps/notices/services.py - Feedback
apps/feedback/models.py - Certificates
apps/documents/services.py - Issued documents
apps/documents/models.py - Document renderer
apps/documents/renderer.py - Accounts
apps/accounts/models.py
AI and workflows
- Ticket enrichment
ai_engine/pipelines/ticket_pipeline.py - Notice summarizer
ai_engine/pipelines/notice_pipeline.py - Feedback insights
ai_engine/pipelines/feedback_pipeline.py - LLM client
ai_engine/llm/base.py - RAG retrieval
ai_engine/rag/retriever.py - Workflow engine
apps/workflows/engine.py - Workflow definitions
apps/workflows/models.py
Notifications
- Notification service
apps/notifications/services.py - Live broadcasters
apps/notifications/broadcasters.py - Notification records
apps/notifications/models.py
Shared services
- Runtime configuration
apps/core/services.py - Audit logging
apps/core/audit.py
Analytics
- Operational analytics
apps/dashboard/services.py - Forecasts and anomalies
apps/dashboard/analytics
Other components
- Student
- Staff
Connections 29
- Student → Ticket lifecycle: submits requests
- Staff → Ticket lifecycle: manages requests
- Ticket lifecycle → Ticket records: creates and updates
apps/tickets/services.py - Ticket lifecycle → Ticket enrichment: enriches with
apps/tickets/services.py - Ticket lifecycle → Workflow engine: attaches workflow
apps/tickets/services.py - Ticket lifecycle → Notification service: notifies events
apps/tickets/services.py - Ticket lifecycle → Audit logging: logs actions
apps/tickets/services.py - Ticket enrichment → LLM client: generates text
ai_engine/pipelines/ticket_pipeline.py - Ticket enrichment → RAG retrieval: extracts metadata
ai_engine/pipelines/ticket_pipeline.py - Notice summarizer → LLM client: summarizes notices
ai_engine/pipelines/notice_pipeline.py - Feedback insights → Feedback: reads feedback
ai_engine/pipelines/feedback_pipeline.py - Feedback insights → LLM client: generates insights
ai_engine/pipelines/feedback_pipeline.py - Workflow engine → Workflow definitions: uses definitions
apps/workflows/engine.py - Workflow engine → Certificates: issues certificates
apps/workflows/engine.py - Certificates → Issued documents: creates records
apps/documents/services.py - Certificates → Document renderer: renders files
apps/documents/services.py - Certificates → Attendance: checks eligibility
apps/documents/services.py - Notification service → Notification records: creates notifications
apps/notifications/services.py - Notification service → Live broadcasters: broadcasts events
- Operational analytics → Ticket records: aggregates tickets
apps/dashboard/services.py - Operational analytics → Accounts: aggregates users
apps/dashboard/services.py - Operational analytics → Feedback: aggregates feedback
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
apps/tickets/services.py