# kiin11/managerstudentcaltholic architecture

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

- Interactive diagram: https://gitdiagram.com/kiin11/managerstudentcaltholic
- Repository: https://github.com/kiin11/managerstudentcaltholic

## Overview

ManagerStudentCatholic is a Catholic parish student-management web application. Staff manage students, classes, enrollments, attendance, grades, promotions, and sacrament approvals; parents and other users have role-based accounts. Its central workflow is managing academic-year class rosters and recording attendance, with additional campaign, registration, messaging, reporting, and facilities capabilities visible in the controller tree. Sampled controllers and services show EF Core persistence and Redis-backed QR attendance; other branches are represented from filenames and documented capabilities, so their internal links are omitted where not evidenced.

Main entry points: [`ManagerStudentCaltholic/Data/ParishDbContext.cs`](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Data/ParishDbContext.cs) (Parish database), [`ManagerStudentCaltholic/Program.cs`](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Program.cs) (Web application), [`ManagerStudentCaltholic/Controllers/AttendanceController.cs`](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AttendanceController.cs) (Attendance records), [`ManagerStudentCaltholic/Services/RedisAttendanceService.cs`](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/RedisAttendanceService.cs) (QR attendance cache)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and registration"]
  node_accounts["Accounts and roles"]
  node_users["User administration<br/>[UsersController.cs]"]
  node_registration["Public registration"]
  node_students["Student records"]
  node_parentmessages["Parent messaging"]
  node_announcements["Announcements"]
end

subgraph group_academics["Academic management"]
  node_years["Academic years"]
  node_classes["Classes and rooms"]
  node_enrollments["Class enrollment"]
  node_grades["Grade management"]
  node_lessonplans["Lesson planning"]
end

subgraph group_attendance["Attendance and campaigns"]
  node_attendance["Attendance records"]
  node_redisattendance["QR attendance cache"]
  node_masscampaign["Mass campaigns"]
  node_absence["Absence requests"]
end

subgraph group_sacraments["Sacraments and advancement"]
  node_promotion["Student promotion"]
  node_sacrament["Sacrament evaluation"]
  node_sacramentregistry["Sacrament registry"]
end

subgraph group_platform["Shared application services"]
  node_app["Web application<br/>[Program.cs]"]
  node_reports["Reports and printing"]
  node_dashboard["Dashboards"]
  node_background["Background jobs"]
  node_db[("Parish database<br/>[ParishDbContext.cs]")]
  node_redis[("Redis cache")]
end

node_staff(("Staff and parents"))

node_staff -->|"uses"| node_app
node_app -.->|"routes"| node_accounts
node_app -.->|"routes"| node_students
node_app -.->|"routes"| node_registration
node_app -.->|"routes"| node_attendance
node_app -.->|"routes"| node_classes
node_app -.->|"routes"| node_grades
node_app -.->|"routes"| node_sacrament
node_app -.->|"configures"| node_db
node_accounts -.->|"reads/writes"| node_db
node_users -->|"reads/writes"| node_db
node_registration -.->|"reads/writes"| node_db
node_students -.->|"reads/writes"| node_db
node_years -.->|"reads/writes"| node_db
node_classes -->|"reads/writes"| node_db
node_enrollments -->|"reads/writes"| node_db
node_grades -.->|"reads/writes"| node_db
node_lessonplans -.->|"reads/writes"| node_db
node_attendance -->|"reads/writes"| node_db
node_attendance -->|"delegates QR"| node_redisattendance
node_redisattendance -->|"reads/writes"| node_db
node_redisattendance -->|"caches lookups"| node_redis
node_masscampaign -->|"reads/writes"| node_db
node_absence -.->|"reads/writes"| node_db
node_promotion -.->|"reads/writes"| node_db
node_sacrament -->|"reads/writes"| node_db
node_sacramentregistry -.->|"reads/writes"| node_db
node_parentmessages -.->|"reads/writes"| node_db
node_announcements -.->|"reads/writes"| node_db
node_reports -.->|"reads"| node_db
node_dashboard -.->|"reads"| node_db
node_background -.->|"reads/writes"| node_db

click node_app "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Program.cs"
click node_accounts "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AccountController.cs"
click node_users "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/UsersController.cs"
click node_registration "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PublicRegistrationController.cs"
click node_students "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/StudentsController.cs"
click node_years "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AcademicYearsController.cs"
click node_classes "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/ClassesController.cs"
click node_enrollments "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/EnrollmentsController.cs"
click node_grades "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/GradesController.cs"
click node_lessonplans "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/LessonPlansController.cs"
click node_attendance "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AttendanceController.cs"
click node_redisattendance "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/RedisAttendanceService.cs"
click node_masscampaign "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/MassCampaignService.cs"
click node_absence "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AbsenceController.cs"
click node_promotion "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PromotionController.cs"
click node_sacrament "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/SacramentEvaluationService.cs"
click node_sacramentregistry "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/SacramentsController.cs"
click node_parentmessages "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/ParentMessagesController.cs"
click node_announcements "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AnnouncementsController.cs"
click node_reports "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PrintReportsController.cs"
click node_dashboard "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/DashboardController.cs"
click node_background "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/BackgroundJobsController.cs"
click node_db "https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Data/ParishDbContext.cs"

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_accounts,node_users,node_registration,node_students,node_parentmessages,node_announcements toneBlue
class node_years,node_classes,node_enrollments,node_grades,node_lessonplans toneAmber
class node_attendance,node_redisattendance,node_masscampaign,node_absence toneMint
class node_promotion,node_sacrament,node_sacramentregistry toneRose
class node_app,node_reports,node_dashboard,node_background,node_db,node_redis,node_staff toneIndigo
```

## Components

### Identity and registration

- [Accounts and roles](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AccountController.cs): `ManagerStudentCaltholic/Controllers/AccountController.cs`
- [User administration](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/UsersController.cs): `ManagerStudentCaltholic/Controllers/UsersController.cs`
- [Public registration](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PublicRegistrationController.cs): `ManagerStudentCaltholic/Controllers/PublicRegistrationController.cs`
- [Student records](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/StudentsController.cs): `ManagerStudentCaltholic/Controllers/StudentsController.cs`
- [Parent messaging](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/ParentMessagesController.cs): `ManagerStudentCaltholic/Controllers/ParentMessagesController.cs`
- [Announcements](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AnnouncementsController.cs): `ManagerStudentCaltholic/Controllers/AnnouncementsController.cs`

### Academic management

- [Academic years](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AcademicYearsController.cs): `ManagerStudentCaltholic/Controllers/AcademicYearsController.cs`
- [Classes and rooms](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/ClassesController.cs): `ManagerStudentCaltholic/Controllers/ClassesController.cs`
- [Class enrollment](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/EnrollmentsController.cs): `ManagerStudentCaltholic/Controllers/EnrollmentsController.cs`
- [Grade management](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/GradesController.cs): `ManagerStudentCaltholic/Controllers/GradesController.cs`
- [Lesson planning](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/LessonPlansController.cs): `ManagerStudentCaltholic/Controllers/LessonPlansController.cs`

### Attendance and campaigns

- [Attendance records](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AttendanceController.cs): `ManagerStudentCaltholic/Controllers/AttendanceController.cs`
- [QR attendance cache](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/RedisAttendanceService.cs): `ManagerStudentCaltholic/Services/RedisAttendanceService.cs`
- [Mass campaigns](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/MassCampaignService.cs): `ManagerStudentCaltholic/Services/MassCampaignService.cs`
- [Absence requests](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/AbsenceController.cs): `ManagerStudentCaltholic/Controllers/AbsenceController.cs`

### Sacraments and advancement

- [Student promotion](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PromotionController.cs): `ManagerStudentCaltholic/Controllers/PromotionController.cs`
- [Sacrament evaluation](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Services/SacramentEvaluationService.cs): `ManagerStudentCaltholic/Services/SacramentEvaluationService.cs`
- [Sacrament registry](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/SacramentsController.cs): `ManagerStudentCaltholic/Controllers/SacramentsController.cs`

### Shared application services

- [Web application](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Program.cs): `ManagerStudentCaltholic/Program.cs`
- [Reports and printing](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/PrintReportsController.cs): `ManagerStudentCaltholic/Controllers/PrintReportsController.cs`
- [Dashboards](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/DashboardController.cs): `ManagerStudentCaltholic/Controllers/DashboardController.cs`
- [Background jobs](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Controllers/BackgroundJobsController.cs): `ManagerStudentCaltholic/Controllers/BackgroundJobsController.cs`
- [Parish database](https://github.com/kiin11/managerstudentcaltholic/blob/main/ManagerStudentCaltholic/Data/ParishDbContext.cs): `ManagerStudentCaltholic/Data/ParishDbContext.cs`
- **Redis cache**

### Other components

- **Staff and parents**

## Connections

- Staff and parents → Web application: uses
- Web application → Accounts and roles: routes
- Web application → Student records: routes
- Web application → Public registration: routes
- Web application → Attendance records: routes
- Web application → Classes and rooms: routes
- Web application → Grade management: routes
- Web application → Sacrament evaluation: routes
- Web application → Parish database: configures
- Accounts and roles → Parish database: reads/writes
- User administration → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/UsersController.cs`)
- Public registration → Parish database: reads/writes
- Student records → Parish database: reads/writes
- Academic years → Parish database: reads/writes
- Classes and rooms → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/ClassesController.cs`)
- Class enrollment → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/EnrollmentsController.cs`)
- Grade management → Parish database: reads/writes
- Lesson planning → Parish database: reads/writes
- Attendance records → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/AttendanceController.cs`)
- Attendance records → QR attendance cache: delegates QR (evidence: `ManagerStudentCaltholic/Controllers/AttendanceController.cs`)
- QR attendance cache → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Services/RedisAttendanceService.cs`)
- QR attendance cache → Redis cache: caches lookups (evidence: `ManagerStudentCaltholic/Services/RedisAttendanceService.cs`)
- Mass campaigns → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Services/MassCampaignService.cs`)
- Absence requests → Parish database: reads/writes
- Student promotion → Parish database: reads/writes
- Sacrament evaluation → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Services/SacramentEvaluationService.cs`)
- Sacrament registry → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/SacramentsController.cs`)
- Parent messaging → Parish database: reads/writes (evidence: `ManagerStudentCaltholic/Controllers/ParentMessagesController.cs`)
- Announcements → Parish database: reads/writes
- Reports and printing → Parish database: reads
- Dashboards → Parish database: reads
- Background jobs → Parish database: reads/writes
