# samuelmeyersanger/sipintar-disdik architecture

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

- Interactive diagram: https://gitdiagram.com/samuelmeyersanger/sipintar-disdik
- Repository: https://github.com/samuelmeyersanger/sipintar-disdik

## Overview

SIPINTAR SD supports school oversight and curriculum-shifting supervision: school operators and supervisors submit supervision data, supervisors verify and produce reports, while administrators maintain schools, assignments, users, and academic periods. Monitoring instruments and dashboards provide complementary evidence and aggregated status; notifications, audit trails, and backup/restore support operations. Source excerpts show key supervision, monitoring, school/user, and public-dashboard relationships; other README-backed capabilities are included with only documented or index-supported links.

Main entry points: [`app/Http/Controllers/Supervisi/ShiftingSupervisionController.php`](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Supervisi/ShiftingSupervisionController.php) (Shifting supervision), [`app/Services/MonitoringInstrumentService.php`](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/MonitoringInstrumentService.php) (Monitoring instruments), [`app/Services/DashboardService.php`](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/DashboardService.php) (Dashboard aggregates), [`app/Services/BackupService.php`](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/BackupService.php) (Backup and restore)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_oversight["Supervision &amp; Monitoring"]
  node_supervision["Shifting supervision"]
  node_supervision_service["Supervision calculations"]
  node_supervision_data[("Supervision records")]
  node_monitoring["School monitoring"]
  node_monitoring_service["Monitoring instruments"]
  node_monitoring_data[("Monitoring records")]
end

subgraph group_administration["Administrative Masters"]
  node_schools["School directory"]
  node_school_service["School management<br/>[SchoolService.php]"]
  node_school_data[("Schools<br/>[School.php]")]
  node_assignments["School assignments"]
  node_academic_years["Academic periods"]
  node_academic_data[("Academic-year records<br/>[AcademicYear.php]")]
  node_user_admin["User administration<br/>[UserController.php]"]
  node_user_service["User management<br/>[UserService.php]"]
  node_user_data[("Users and roles<br/>[User.php]")]
end

subgraph group_insights["Reporting &amp; Insights"]
  node_dashboard["Dashboard aggregates"]
  node_public_home["Public statistics"]
  node_report["Supervision reports"]
end

subgraph group_operations["Operations &amp; Access"]
  node_notifications["Notifications"]
  node_audit["Audit trail"]
  node_activity_data[("Activity logs<br/>[ActivityLog.php]")]
  node_backup["Backup and restore<br/>[BackupService.php]"]
  node_backup_data[("Backup records<br/>[Backup.php]")]
  node_auth["Authentication<br/>[AuthController.php]"]
end

node_operator(("School operator"))
node_supervisor(("Education supervisor"))
node_admin(("District administrator"))
node_public(("Public visitor"))

node_operator -->|"submits evaluations"| node_supervision
node_supervisor -->|"verifies submissions"| node_supervision
node_supervision -.->|"delegates calculations"| node_supervision_service
node_supervision -->|"loads and saves"| node_supervision_data
node_supervision -->|"sends report"| node_report
node_supervisor -->|"assesses schools"| node_monitoring
node_monitoring -->|"delegates instrument work"| node_monitoring_service
node_monitoring_service -->|"creates or updates"| node_monitoring_data
node_monitoring_service -->|"reads school"| node_school_data
node_monitoring_service -->|"records audit event"| node_activity_data
node_admin -->|"maintains directory"| node_schools
node_schools -->|"delegates changes"| node_school_service
node_school_service -.->|"manages records"| node_school_data
node_admin -->|"maps supervisors"| node_assignments
node_admin -.->|"manages periods"| node_academic_years
node_academic_years -.->|"manages records"| node_academic_data
node_admin -->|"manages accounts"| node_user_admin
node_user_admin -->|"delegates user changes"| node_user_service
node_user_service -.->|"manages users"| node_user_data
node_public -->|"views statistics"| node_public_home
node_public_home -->|"requests aggregates"| node_dashboard
node_dashboard -->|"queries schools"| node_school_data
node_dashboard -->|"queries supervision"| node_supervision_data
node_supervisor -->|"sends announcements"| node_notifications
node_admin -->|"broadcasts notices"| node_notifications
node_admin -.->|"reviews activity"| node_audit
node_audit -->|"reads logs"| node_activity_data
node_admin -->|"backs up or restores"| node_backup
node_backup -->|"manages backup records"| node_backup_data
node_backup -->|"logs operations"| node_activity_data
node_operator -.->|"signs in"| node_auth
node_supervisor -.->|"signs in"| node_auth
node_admin -.->|"signs in"| node_auth

click node_supervision "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Supervisi/ShiftingSupervisionController.php"
click node_supervision_service "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/ShiftingSupervisionService.php"
click node_supervision_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/ShiftingSupervision.php"
click node_monitoring "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Monitoring/MonitoringInstrumentController.php"
click node_monitoring_service "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/MonitoringInstrumentService.php"
click node_monitoring_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/MonitoringInstrument.php"
click node_schools "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Master/SchoolController.php"
click node_school_service "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/SchoolService.php"
click node_school_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/School.php"
click node_assignments "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/SekolahBinaanService.php"
click node_academic_years "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/AcademicYearService.php"
click node_academic_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/AcademicYear.php"
click node_user_admin "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/User/UserController.php"
click node_user_service "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/UserService.php"
click node_user_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/User.php"
click node_dashboard "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/DashboardService.php"
click node_public_home "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/WelcomeController.php"
click node_report "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Mail/LaporanSupervisiMail.php"
click node_notifications "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/NotificationService.php"
click node_audit "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Audit/AuditTrailController.php"
click node_activity_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/ActivityLog.php"
click node_backup "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/BackupService.php"
click node_backup_data "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/Backup.php"
click node_auth "https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Auth/AuthController.php"

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_supervision,node_supervision_service,node_supervision_data,node_monitoring,node_monitoring_service,node_monitoring_data toneBlue
class node_schools,node_school_service,node_school_data,node_assignments,node_academic_years,node_academic_data,node_user_admin,node_user_service,node_user_data toneAmber
class node_dashboard,node_public_home,node_report toneMint
class node_notifications,node_audit,node_activity_data,node_backup,node_backup_data,node_auth toneRose
class node_operator,node_supervisor,node_admin,node_public toneIndigo
```

## Components

### Supervision & Monitoring

- [Shifting supervision](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Supervisi/ShiftingSupervisionController.php): `app/Http/Controllers/Supervisi/ShiftingSupervisionController.php`
- [Supervision calculations](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/ShiftingSupervisionService.php): `app/Services/ShiftingSupervisionService.php`
- [Supervision records](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/ShiftingSupervision.php): `app/Models/ShiftingSupervision.php`
- [School monitoring](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Monitoring/MonitoringInstrumentController.php): `app/Http/Controllers/Monitoring/MonitoringInstrumentController.php`
- [Monitoring instruments](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/MonitoringInstrumentService.php): `app/Services/MonitoringInstrumentService.php`
- [Monitoring records](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/MonitoringInstrument.php): `app/Models/MonitoringInstrument.php`

### Administrative Masters

- [School directory](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Master/SchoolController.php): `app/Http/Controllers/Master/SchoolController.php`
- [School management](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/SchoolService.php): `app/Services/SchoolService.php`
- [Schools](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/School.php): `app/Models/School.php`
- [School assignments](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/SekolahBinaanService.php): `app/Services/SekolahBinaanService.php`
- [Academic periods](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/AcademicYearService.php): `app/Services/AcademicYearService.php`
- [Academic-year records](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/AcademicYear.php): `app/Models/AcademicYear.php`
- [User administration](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/User/UserController.php): `app/Http/Controllers/User/UserController.php`
- [User management](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/UserService.php): `app/Services/UserService.php`
- [Users and roles](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/User.php): `app/Models/User.php`

### Reporting & Insights

- [Dashboard aggregates](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/DashboardService.php): `app/Services/DashboardService.php`
- [Public statistics](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/WelcomeController.php): `app/Http/Controllers/WelcomeController.php`
- [Supervision reports](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Mail/LaporanSupervisiMail.php): `app/Mail/LaporanSupervisiMail.php`

### Operations & Access

- [Notifications](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/NotificationService.php): `app/Services/NotificationService.php`
- [Audit trail](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Audit/AuditTrailController.php): `app/Http/Controllers/Audit/AuditTrailController.php`
- [Activity logs](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/ActivityLog.php): `app/Models/ActivityLog.php`
- [Backup and restore](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Services/BackupService.php): `app/Services/BackupService.php`
- [Backup records](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Models/Backup.php): `app/Models/Backup.php`
- [Authentication](https://github.com/samuelmeyersanger/sipintar-disdik/blob/main/app/Http/Controllers/Auth/AuthController.php): `app/Http/Controllers/Auth/AuthController.php`

### Other components

- **School operator**
- **Education supervisor**
- **District administrator**
- **Public visitor**

## Connections

- School operator → Shifting supervision: submits evaluations (evidence: `README.md`)
- Education supervisor → Shifting supervision: verifies submissions (evidence: `README.md`)
- Shifting supervision → Supervision calculations: delegates calculations (evidence: `app/Http/Controllers/Supervisi/ShiftingSupervisionController.php`)
- Shifting supervision → Supervision records: loads and saves (evidence: `app/Http/Controllers/Supervisi/ShiftingSupervisionController.php`)
- Shifting supervision → Supervision reports: sends report (evidence: `app/Http/Controllers/Supervisi/ShiftingSupervisionController.php`)
- Education supervisor → School monitoring: assesses schools (evidence: `README.md`)
- School monitoring → Monitoring instruments: delegates instrument work (evidence: `app/Http/Controllers/Monitoring/MonitoringInstrumentController.php`)
- Monitoring instruments → Monitoring records: creates or updates (evidence: `app/Services/MonitoringInstrumentService.php`)
- Monitoring instruments → Schools: reads school (evidence: `app/Services/MonitoringInstrumentService.php`)
- Monitoring instruments → Activity logs: records audit event (evidence: `app/Services/MonitoringInstrumentService.php`)
- District administrator → School directory: maintains directory (evidence: `README.md`)
- School directory → School management: delegates changes (evidence: `app/Http/Controllers/Master/SchoolController.php`)
- School management → Schools: manages records
- District administrator → School assignments: maps supervisors (evidence: `README.md`)
- District administrator → Academic periods: manages periods
- Academic periods → Academic-year records: manages records
- District administrator → User administration: manages accounts (evidence: `README.md`)
- User administration → User management: delegates user changes (evidence: `app/Http/Controllers/User/UserController.php`)
- User management → Users and roles: manages users
- Public visitor → Public statistics: views statistics (evidence: `app/Http/Controllers/WelcomeController.php`)
- Public statistics → Dashboard aggregates: requests aggregates (evidence: `app/Http/Controllers/WelcomeController.php`)
- Dashboard aggregates → Schools: queries schools (evidence: `app/Services/DashboardService.php`)
- Dashboard aggregates → Supervision records: queries supervision (evidence: `app/Services/DashboardService.php`)
- Education supervisor → Notifications: sends announcements (evidence: `README.md`)
- District administrator → Notifications: broadcasts notices (evidence: `README.md`)
- District administrator → Audit trail: reviews activity
- Audit trail → Activity logs: reads logs (evidence: `app/Http/Controllers/Audit/AuditTrailController.php`)
- District administrator → Backup and restore: backs up or restores (evidence: `README.md`)
- Backup and restore → Backup records: manages backup records (evidence: `app/Services/BackupService.php`)
- Backup and restore → Activity logs: logs operations (evidence: `app/Services/BackupService.php`)
- School operator → Authentication: signs in
- Education supervisor → Authentication: signs in
- District administrator → Authentication: signs in
