How aalidemirci/disiplin-defteri-codex works
Disiplin Defteri is a single-user desktop application for managing a secondary school’s discipline and honor-board processes. The principal workflow runs from a complaint or report through guidance, principal decision, possible committee review and appeal, then closure, with statutory deadlines and official documents tracked along the way. School setup, student/personnel import, year rollover, secure backups, and honor/award processing are meaningful supporting capabilities. The graph combines documented product behavior with sampled routing and startup links; unsampled backend and frontend details are represented only where the README supports them.
Main entry points: DisiplinDetayPage.tsx Discipline screens · main.py Desktop shell · KurulumPage.tsx School setup screens · decisions.py Decisions and appeals
Components 22
Desktop runtime
- Desktop shell
desktop/main.py - Local server
desktop/server.py - Session guard
desktop/session_guard.py - Encrypted backup
desktop/backup.py - Field encryption
backend/shared/crypto.py
School records
- School services
backend/apps/okul/services - School and people
backend/apps/okul/models.py - People import
backend/apps/okul/services/imports.py - Year rollover
backend/apps/okul/services/year_rollover.py - Django API
backend/apps/okul/views.py
Discipline workflow
- Discipline cases
backend/apps/disiplin/services/cases.py - Decisions and appeals
backend/apps/disiplin/services/decisions.py - Legal deadlines
backend/apps/disiplin/discipline_periods.py - Discipline records
backend/apps/disiplin/models/decisions.py - Official documents
backend/apps/disiplin/services/documents.py
Honors and records
- Honor and awards
backend/apps/disiplin/services/honors.py - Record disposal
backend/apps/disiplin/services/purge.py
User interface
- Application routes
frontend/src/App.tsx - Discipline screens
frontend/src/modules/disiplin/DisiplinDetayPage.tsx - API client
frontend/src/lib/api.ts - School setup screens
frontend/src/modules/kurulum/KurulumPage.tsx
Other components
- School staff
Connections 24
- School staff → Desktop shell: opens
README.md - Desktop shell → Local server: starts
desktop/main.py - Desktop shell → Session guard: sets token
desktop/main.py - Desktop shell → Encrypted backup: rotates backups
desktop/main.py - Local server → Django API: serves locally
- School staff → Application routes: uses
README.md - Application routes → Discipline screens: routes to
frontend/src/App.tsx - Application routes → School setup screens: routes to
frontend/src/App.tsx - Discipline screens → API client: requests data
frontend/src/modules/disiplin/DisiplinDetayPage.tsx - School setup screens → API client: requests data
- API client → Django API: calls
- Django API → School services: delegates to
- School services → School and people: reads and writes
backend/apps/okul/services/calendar.py - School setup screens → People import: starts import
README.md - School setup screens → Year rollover: starts rollover
README.md - Discipline screens → Discipline cases: manages cases
README.md - Discipline screens → Decisions and appeals: records decisions
README.md - Decisions and appeals → Legal deadlines: uses periods
backend/apps/disiplin/services/decisions.py - Decisions and appeals → Discipline records: saves decisions
backend/apps/disiplin/services/decisions.py - Discipline cases → Official documents: produces documents
README.md - Discipline screens → Honor and awards: manages awards
README.md - Discipline screens → Record disposal: starts disposal
README.md - Encrypted backup → Field encryption: encrypts backup
README.md - School and people → Field encryption: encrypts fields
backend/apps/okul/models.py