How vivek248-cloud/coe works
Holy Cross College’s OBE examination system manages question banks and turns approved course material into structured examination papers. The principal workflow runs from faculty upload and duplicate resolution, through HOD/COE review and blueprint-based selection, to paper generation and export. The README documents capabilities beyond the sampled excerpts; those branches are represented at their supported paths, while unverified implementation links are omitted. The system uses a shared relational database and role-based access; unsampled subsystems are not described in implementation detail.
Main entry points: upload.php Bank upload and editing · auth.php Session and role guards · commit_upload.php Bank commit and duplicate resolution · shuffle.php Paper set generation
Components 24
Access and administration
- Role-based login
modules/auth/login.php - Institutional administration
modules/admin/index.php
Question bank workflow
- Faculty workspace
modules/teaching/dashboard.php - Bank upload and editing
modules/teaching/upload.php - Upload parsing
api/parse_upload.php - Question import and extraction
includes/question_importer.php - Bank commit and duplicate resolution
api/commit_upload.php - Bank review workspace
modules/coe/review_bank.php - Bank verification
api/verify_bank.php - Bank browsing and export
modules/teaching/view_banks.php
Blueprint and generation
- Blueprint matrix
modules/coe/blueprint.php - COE workspace
modules/coe/dashboard.php - Paper set generation
modules/coe/shuffle.php - Question candidates
api/get_candidates.php - Generated paper viewing
modules/coe/view_paper.php - Shuffle generation API
api/shuffle_generate.php - DOCX paper export
api/export_docx.php - Paper document renderer
docx_generator.py
Shared services
- Session and role guards
includes/auth.php - Exam and schema helpers
includes/system.php - Database connection
config/db.php - Institutional exam database
Other components
- Teaching staff
- COE staff
Connections 29
- Teaching staff → Role-based login: signs in
- COE staff → Role-based login: signs in
- Role-based login → Session and role guards: checks roles
modules/auth/login.php - Teaching staff → Bank upload and editing: uploads bank
- Bank upload and editing → Upload parsing: submits file
- Upload parsing → Question import and extraction: uses extraction
api/parse_upload.php - Bank upload and editing → Bank commit and duplicate resolution: commits choices
modules/teaching/upload.php - Bank commit and duplicate resolution → Institutional exam database: stores bank
api/commit_upload.php - COE staff → Bank review workspace: reviews banks
- Bank review workspace → Institutional exam database: reads bank data
modules/coe/review_bank.php - Bank verification → Institutional exam database: verifies bank
api/verify_bank.php - Faculty workspace → Bank upload and editing: opens upload
- Faculty workspace → Bank browsing and export: browses banks
- COE staff → Blueprint matrix: defines matrix
- Blueprint matrix → Institutional exam database: stores blueprint
modules/coe/blueprint.php - COE staff → Paper set generation: generates sets
- Paper set generation → Question candidates: requests candidates
- Paper set generation → Shuffle generation API: starts generation
- Shuffle generation API → Institutional exam database: records papers and usage
api/shuffle_generate.php - COE workspace → Generated paper viewing: opens paper
- Generated paper viewing → DOCX paper export: exports document
- DOCX paper export → Paper document renderer: renders DOCX
- Paper document renderer → Institutional exam database: reads paper data
- Bank upload and editing → Session and role guards: checks access
modules/teaching/upload.php - Bank commit and duplicate resolution → Session and role guards: checks access
api/commit_upload.php - Database connection → Institutional exam database: connects to
config/db.php - Session and role guards → Database connection: loads connection
includes/auth.php - Session and role guards → Exam and schema helpers: loads helpers
includes/auth.php - Bank commit and duplicate resolution → Exam and schema helpers: uses system helpers
api/commit_upload.php