# aalidemirci/disiplin-defteri-codex architecture

> Architecture diagram of the GitHub repository aalidemirci/disiplin-defteri-codex, 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/aalidemirci/disiplin-defteri-codex
- Repository: https://github.com/aalidemirci/disiplin-defteri-codex

## Overview

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: [`frontend/src/modules/disiplin/DisiplinDetayPage.tsx`](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/disiplin/DisiplinDetayPage.tsx) (Discipline screens), [`desktop/main.py`](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/main.py) (Desktop shell), [`frontend/src/modules/kurulum/KurulumPage.tsx`](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/kurulum/KurulumPage.tsx) (School setup screens), [`backend/apps/disiplin/services/decisions.py`](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/decisions.py) (Decisions and appeals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop runtime"]
  node_desktop_app["Desktop shell<br/>[main.py]"]
  node_local_server["Local server<br/>[server.py]"]
  node_session_guard["Session guard<br/>[session_guard.py]"]
  node_encrypted_backup["Encrypted backup<br/>[backup.py]"]
  node_crypto["Field encryption<br/>[crypto.py]"]
end

subgraph group_school["School records"]
  node_school_services["School services"]
  node_school_data[("School and people<br/>[models.py]")]
  node_imports["People import<br/>[imports.py]"]
  node_year_rollover["Year rollover<br/>[year_rollover.py]"]
  node_api_backend["Django API<br/>[views.py]"]
end

subgraph group_discipline["Discipline workflow"]
  node_case_flow["Discipline cases<br/>[cases.py]"]
  node_decision_flow["Decisions and appeals<br/>[decisions.py]"]
  node_deadlines["Legal deadlines"]
  node_discipline_data[("Discipline records<br/>[decisions.py]")]
  node_documents["Official documents<br/>[documents.py]"]
end

subgraph group_honors["Honors and records"]
  node_honors["Honor and awards<br/>[honors.py]"]
  node_purge["Record disposal<br/>[purge.py]"]
end

subgraph group_frontend["User interface"]
  node_frontend_app["Application routes<br/>[App.tsx]"]
  node_discipline_ui["Discipline screens"]
  node_frontend_api["API client<br/>[api.ts]"]
  node_school_ui["School setup screens<br/>[KurulumPage.tsx]"]
end

node_user(("School staff"))

node_user -->|"opens"| node_desktop_app
node_desktop_app -->|"starts"| node_local_server
node_desktop_app -->|"sets token"| node_session_guard
node_desktop_app -->|"rotates backups"| node_encrypted_backup
node_local_server -.->|"serves locally"| node_api_backend
node_user -->|"uses"| node_frontend_app
node_frontend_app -->|"routes to"| node_discipline_ui
node_frontend_app -->|"routes to"| node_school_ui
node_discipline_ui -->|"requests data"| node_frontend_api
node_school_ui -.->|"requests data"| node_frontend_api
node_frontend_api -.->|"calls"| node_api_backend
node_api_backend -.->|"delegates to"| node_school_services
node_school_services -.->|"reads and writes"| node_school_data
node_school_ui -->|"starts import"| node_imports
node_school_ui -->|"starts rollover"| node_year_rollover
node_discipline_ui -->|"manages cases"| node_case_flow
node_discipline_ui -->|"records decisions"| node_decision_flow
node_decision_flow -->|"uses periods"| node_deadlines
node_decision_flow -->|"saves decisions"| node_discipline_data
node_case_flow -->|"produces documents"| node_documents
node_discipline_ui -->|"manages awards"| node_honors
node_discipline_ui -->|"starts disposal"| node_purge
node_encrypted_backup -->|"encrypts backup"| node_crypto
node_school_data -->|"encrypts fields"| node_crypto

click node_desktop_app "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/main.py"
click node_local_server "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/server.py"
click node_session_guard "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/session_guard.py"
click node_encrypted_backup "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/backup.py"
click node_frontend_app "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/App.tsx"
click node_discipline_ui "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/disiplin/DisiplinDetayPage.tsx"
click node_frontend_api "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/lib/api.ts"
click node_school_ui "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/kurulum/KurulumPage.tsx"
click node_school_services "https://github.com/aalidemirci/disiplin-defteri-codex/tree/main/backend/apps/okul/services"
click node_school_data "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/models.py"
click node_imports "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/services/imports.py"
click node_year_rollover "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/services/year_rollover.py"
click node_case_flow "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/cases.py"
click node_decision_flow "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/decisions.py"
click node_deadlines "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/discipline_periods.py"
click node_discipline_data "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/models/decisions.py"
click node_documents "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/documents.py"
click node_honors "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/honors.py"
click node_purge "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/purge.py"
click node_crypto "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/shared/crypto.py"
click node_api_backend "https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/views.py"

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_desktop_app,node_local_server,node_session_guard,node_encrypted_backup,node_crypto toneBlue
class node_school_services,node_school_data,node_imports,node_year_rollover,node_api_backend toneAmber
class node_case_flow,node_decision_flow,node_deadlines,node_discipline_data,node_documents toneMint
class node_honors,node_purge toneRose
class node_frontend_app,node_discipline_ui,node_frontend_api,node_school_ui,node_user toneIndigo
```

## Components

### Desktop runtime

- [Desktop shell](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/main.py): `desktop/main.py`
- [Local server](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/server.py): `desktop/server.py`
- [Session guard](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/session_guard.py): `desktop/session_guard.py`
- [Encrypted backup](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/desktop/backup.py): `desktop/backup.py`
- [Field encryption](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/shared/crypto.py): `backend/shared/crypto.py`

### School records

- [School services](https://github.com/aalidemirci/disiplin-defteri-codex/tree/main/backend/apps/okul/services): `backend/apps/okul/services`
- [School and people](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/models.py): `backend/apps/okul/models.py`
- [People import](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/services/imports.py): `backend/apps/okul/services/imports.py`
- [Year rollover](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/services/year_rollover.py): `backend/apps/okul/services/year_rollover.py`
- [Django API](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/okul/views.py): `backend/apps/okul/views.py`

### Discipline workflow

- [Discipline cases](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/cases.py): `backend/apps/disiplin/services/cases.py`
- [Decisions and appeals](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/decisions.py): `backend/apps/disiplin/services/decisions.py`
- [Legal deadlines](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/discipline_periods.py): `backend/apps/disiplin/discipline_periods.py`
- [Discipline records](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/models/decisions.py): `backend/apps/disiplin/models/decisions.py`
- [Official documents](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/documents.py): `backend/apps/disiplin/services/documents.py`

### Honors and records

- [Honor and awards](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/honors.py): `backend/apps/disiplin/services/honors.py`
- [Record disposal](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/backend/apps/disiplin/services/purge.py): `backend/apps/disiplin/services/purge.py`

### User interface

- [Application routes](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Discipline screens](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/disiplin/DisiplinDetayPage.tsx): `frontend/src/modules/disiplin/DisiplinDetayPage.tsx`
- [API client](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [School setup screens](https://github.com/aalidemirci/disiplin-defteri-codex/blob/main/frontend/src/modules/kurulum/KurulumPage.tsx): `frontend/src/modules/kurulum/KurulumPage.tsx`

### Other components

- **School staff**

## Connections

- School staff → Desktop shell: opens (evidence: `README.md`)
- Desktop shell → Local server: starts (evidence: `desktop/main.py`)
- Desktop shell → Session guard: sets token (evidence: `desktop/main.py`)
- Desktop shell → Encrypted backup: rotates backups (evidence: `desktop/main.py`)
- Local server → Django API: serves locally
- School staff → Application routes: uses (evidence: `README.md`)
- Application routes → Discipline screens: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → School setup screens: routes to (evidence: `frontend/src/App.tsx`)
- Discipline screens → API client: requests data (evidence: `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 (evidence: `backend/apps/okul/services/calendar.py`)
- School setup screens → People import: starts import (evidence: `README.md`)
- School setup screens → Year rollover: starts rollover (evidence: `README.md`)
- Discipline screens → Discipline cases: manages cases (evidence: `README.md`)
- Discipline screens → Decisions and appeals: records decisions (evidence: `README.md`)
- Decisions and appeals → Legal deadlines: uses periods (evidence: `backend/apps/disiplin/services/decisions.py`)
- Decisions and appeals → Discipline records: saves decisions (evidence: `backend/apps/disiplin/services/decisions.py`)
- Discipline cases → Official documents: produces documents (evidence: `README.md`)
- Discipline screens → Honor and awards: manages awards (evidence: `README.md`)
- Discipline screens → Record disposal: starts disposal (evidence: `README.md`)
- Encrypted backup → Field encryption: encrypts backup (evidence: `README.md`)
- School and people → Field encryption: encrypts fields (evidence: `backend/apps/okul/models.py`)
