# markjustine28/capstone architecture

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

- Interactive diagram: https://gitdiagram.com/markjustine28/capstone
- Repository: https://github.com/markjustine28/capstone

## Overview

This repository combines a Django school-guidance backend with Flutter platform shells; the tree and excerpts do not expose the Flutter application code. The backend’s visible workflow is API/report handling over student, incident, counseling, and school-year records. API views and Django admin are shown using the central API models; report views reference their own models and serializers. The report subsystem’s exact behavior and URL dispatch are not established by the available excerpts, so those links are omitted. Maintenance commands are represented only where their model dependency is indexed.

Main entry points: [`myproject/api/models.py`](https://github.com/markjustine28/capstone/blob/main/myproject/api/models.py) (Guidance records), [`myproject/reports/views.py`](https://github.com/markjustine28/capstone/blob/main/myproject/reports/views.py) (Report views), [`myproject/api/views.py`](https://github.com/markjustine28/capstone/blob/main/myproject/api/views.py) (API views), [`myproject/api/admin.py`](https://github.com/markjustine28/capstone/blob/main/myproject/api/admin.py) (Django admin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and administration"]
  node_api_views["API views<br/>[views.py]"]
  node_api_admin["Django admin<br/>[admin.py]"]
  node_api_serializers["API serializers<br/>[serializers.py]"]
  node_api_urls["API routes<br/>[urls.py]"]
end

subgraph group_reports["Report handling"]
  node_reports_views["Report views<br/>[views.py]"]
  node_reports_serializers["Report serializers<br/>[serializers.py]"]
  node_reports_models[("Report records<br/>[models.py]")]
end

subgraph group_records["Domain records"]
  node_api_models[("Guidance records<br/>[models.py]")]
  node_school_year_rollover["School-year rollover"]
  node_school_year_repair["School-year repair"]
end

node_api_views -->|"uses records"| node_api_models
node_api_admin -->|"administers"| node_api_models
node_reports_views -->|"uses records"| node_reports_models
node_reports_views -->|"uses serializers"| node_reports_serializers
node_school_year_rollover -->|"uses records"| node_api_models
node_school_year_repair -->|"uses records"| node_api_models

click node_api_views "https://github.com/markjustine28/capstone/blob/main/myproject/api/views.py"
click node_api_admin "https://github.com/markjustine28/capstone/blob/main/myproject/api/admin.py"
click node_api_serializers "https://github.com/markjustine28/capstone/blob/main/myproject/api/serializers.py"
click node_api_urls "https://github.com/markjustine28/capstone/blob/main/myproject/api/urls.py"
click node_reports_views "https://github.com/markjustine28/capstone/blob/main/myproject/reports/views.py"
click node_reports_serializers "https://github.com/markjustine28/capstone/blob/main/myproject/reports/serializers.py"
click node_reports_models "https://github.com/markjustine28/capstone/blob/main/myproject/reports/models.py"
click node_api_models "https://github.com/markjustine28/capstone/blob/main/myproject/api/models.py"
click node_school_year_rollover "https://github.com/markjustine28/capstone/blob/main/myproject/api/management/commands/rollover_school_year.py"
click node_school_year_repair "https://github.com/markjustine28/capstone/blob/main/myproject/api/management/commands/fix_school_years.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_api_views,node_api_admin,node_api_serializers,node_api_urls toneBlue
class node_reports_views,node_reports_serializers,node_reports_models toneAmber
class node_api_models,node_school_year_rollover,node_school_year_repair toneMint
```

## Components

### API and administration

- [API views](https://github.com/markjustine28/capstone/blob/main/myproject/api/views.py): `myproject/api/views.py`
- [Django admin](https://github.com/markjustine28/capstone/blob/main/myproject/api/admin.py): `myproject/api/admin.py`
- [API serializers](https://github.com/markjustine28/capstone/blob/main/myproject/api/serializers.py): `myproject/api/serializers.py`
- [API routes](https://github.com/markjustine28/capstone/blob/main/myproject/api/urls.py): `myproject/api/urls.py`

### Report handling

- [Report views](https://github.com/markjustine28/capstone/blob/main/myproject/reports/views.py): `myproject/reports/views.py`
- [Report serializers](https://github.com/markjustine28/capstone/blob/main/myproject/reports/serializers.py): `myproject/reports/serializers.py`
- [Report records](https://github.com/markjustine28/capstone/blob/main/myproject/reports/models.py): `myproject/reports/models.py`

### Domain records

- [Guidance records](https://github.com/markjustine28/capstone/blob/main/myproject/api/models.py): `myproject/api/models.py`
- [School-year rollover](https://github.com/markjustine28/capstone/blob/main/myproject/api/management/commands/rollover_school_year.py): `myproject/api/management/commands/rollover_school_year.py`
- [School-year repair](https://github.com/markjustine28/capstone/blob/main/myproject/api/management/commands/fix_school_years.py): `myproject/api/management/commands/fix_school_years.py`

## Connections

- API views → Guidance records: uses records (evidence: `myproject/api/views.py`)
- Django admin → Guidance records: administers (evidence: `myproject/api/admin.py`)
- Report views → Report records: uses records (evidence: `myproject/reports/views.py`)
- Report views → Report serializers: uses serializers (evidence: `myproject/reports/views.py`)
- School-year rollover → Guidance records: uses records (evidence: `myproject/api/management/commands/rollover_school_year.py`)
- School-year repair → Guidance records: uses records (evidence: `myproject/api/management/commands/fix_school_years.py`)
