# jovitt0/projetinhodadis architecture

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

- Interactive diagram: https://gitdiagram.com/jovitt0/projetinhodadis
- Repository: https://github.com/jovitt0/projetinhodadis

## Overview

This repository is a Django school-management portal, organized around school-scoped administration: users select a school, then manage academic setup, students and enrollments, finance, and governance/privacy records. The documented screens describe HTMX list-and-form interactions and shared response helpers. Sampled views are stubs that raise NotImplementedError, so the graph shows documented intended routing and presentation, not working persistence or service calls; model and service implementations are not present in the supplied tree.

Main entry points: [`setup/urls.py`](https://github.com/jovitt0/projetinhodadis/blob/dev/setup/urls.py) (Django URL router), [`templates`](https://github.com/jovitt0/projetinhodadis/tree/dev/templates) (Server-rendered screens), [`apps/core/htmx.py`](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/core/htmx.py) (HTMX response helpers), [`static/js/app.js`](https://github.com/jovitt0/projetinhodadis/blob/dev/static/js/app.js) (HTMX browser UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry and UI"]
  node_router["Django URL router<br/>[urls.py]"]
  node_accounts["Accounts<br/>[views.py]"]
  node_htmx["HTMX response helpers<br/>[htmx.py]"]
  node_browser["HTMX browser UI<br/>[app.js]"]
  node_templates["Server-rendered screens"]
end

subgraph group_school_access["School and access"]
  node_schools["Schools and years<br/>[views.py]"]
  node_access["Users and permissions<br/>[views.py]"]
  node_preview["Preview roles<br/>[context.py]"]
end

subgraph group_learning["Academic operations"]
  node_academics["Courses and teaching<br/>[views.py]"]
  node_students["Student records<br/>[views.py]"]
end

subgraph group_finance["Enrollment and finance"]
  node_enrollments["Enrollment workflow<br/>[views.py]"]
  node_finance_views["Plans and payments<br/>[views.py]"]
end

subgraph group_governance["Governance and privacy"]
  node_audit["Audit logs<br/>[views.py]"]
  node_privacy["Privacy management<br/>[views.py]"]
end

node_user(("Portal user"))

node_user -->|"uses"| node_browser
node_browser -->|"requests pages"| node_router
node_router -->|"routes"| node_accounts
node_router -->|"routes"| node_schools
node_router -->|"routes"| node_access
node_router -->|"routes"| node_academics
node_router -->|"routes"| node_students
node_router -->|"routes"| node_enrollments
node_router -->|"routes"| node_finance_views
node_router -->|"routes"| node_audit
node_router -->|"routes"| node_privacy
node_schools -->|"renders screens"| node_templates
node_access -->|"renders screens"| node_templates
node_academics -->|"renders screens"| node_templates
node_students -->|"renders screens"| node_templates
node_enrollments -->|"renders screens"| node_templates
node_finance_views -->|"renders screens"| node_templates
node_privacy -->|"renders screens"| node_templates
node_academics -->|"imports helpers"| node_htmx
node_students -->|"imports helpers"| node_htmx
node_enrollments -->|"imports helpers"| node_htmx
node_finance_views -->|"imports helpers"| node_htmx
node_privacy -->|"imports helpers"| node_htmx
node_htmx -->|"triggers UI events"| node_browser
node_browser -->|"handles events"| node_htmx
node_preview -.->|"provides UI context"| node_templates

click node_router "https://github.com/jovitt0/projetinhodadis/blob/dev/setup/urls.py"
click node_accounts "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/accounts/views.py"
click node_htmx "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/core/htmx.py"
click node_browser "https://github.com/jovitt0/projetinhodadis/blob/dev/static/js/app.js"
click node_schools "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/schools/views.py"
click node_access "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/access/views.py"
click node_preview "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/preview/context.py"
click node_academics "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/academics/views.py"
click node_students "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/students/views.py"
click node_enrollments "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/enrollments/views.py"
click node_finance_views "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/finance/views.py"
click node_audit "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/audit/views.py"
click node_privacy "https://github.com/jovitt0/projetinhodadis/blob/dev/apps/privacy/views.py"
click node_templates "https://github.com/jovitt0/projetinhodadis/tree/dev/templates"

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_router,node_accounts,node_htmx,node_browser,node_templates,node_user toneBlue
class node_schools,node_access,node_preview toneAmber
class node_academics,node_students toneMint
class node_enrollments,node_finance_views toneRose
class node_audit,node_privacy toneIndigo
```

## Components

### Web entry and UI

- [Django URL router](https://github.com/jovitt0/projetinhodadis/blob/dev/setup/urls.py): `setup/urls.py`
- [Accounts](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/accounts/views.py): `apps/accounts/views.py`
- [HTMX response helpers](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/core/htmx.py): `apps/core/htmx.py`
- [HTMX browser UI](https://github.com/jovitt0/projetinhodadis/blob/dev/static/js/app.js): `static/js/app.js`
- [Server-rendered screens](https://github.com/jovitt0/projetinhodadis/tree/dev/templates): `templates`

### School and access

- [Schools and years](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/schools/views.py): `apps/schools/views.py`
- [Users and permissions](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/access/views.py): `apps/access/views.py`
- [Preview roles](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/preview/context.py): `apps/preview/context.py`

### Academic operations

- [Courses and teaching](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/academics/views.py): `apps/academics/views.py`
- [Student records](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/students/views.py): `apps/students/views.py`

### Enrollment and finance

- [Enrollment workflow](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/enrollments/views.py): `apps/enrollments/views.py`
- [Plans and payments](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/finance/views.py): `apps/finance/views.py`

### Governance and privacy

- [Audit logs](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/audit/views.py): `apps/audit/views.py`
- [Privacy management](https://github.com/jovitt0/projetinhodadis/blob/dev/apps/privacy/views.py): `apps/privacy/views.py`

### Other components

- **Portal user**

## Connections

- Portal user → HTMX browser UI: uses
- HTMX browser UI → Django URL router: requests pages
- Django URL router → Accounts: routes
- Django URL router → Schools and years: routes
- Django URL router → Users and permissions: routes
- Django URL router → Courses and teaching: routes
- Django URL router → Student records: routes
- Django URL router → Enrollment workflow: routes
- Django URL router → Plans and payments: routes
- Django URL router → Audit logs: routes
- Django URL router → Privacy management: routes
- Schools and years → Server-rendered screens: renders screens
- Users and permissions → Server-rendered screens: renders screens
- Courses and teaching → Server-rendered screens: renders screens
- Student records → Server-rendered screens: renders screens
- Enrollment workflow → Server-rendered screens: renders screens
- Plans and payments → Server-rendered screens: renders screens
- Privacy management → Server-rendered screens: renders screens
- Courses and teaching → HTMX response helpers: imports helpers
- Student records → HTMX response helpers: imports helpers
- Enrollment workflow → HTMX response helpers: imports helpers
- Plans and payments → HTMX response helpers: imports helpers
- Privacy management → HTMX response helpers: imports helpers
- HTMX response helpers → HTMX browser UI: triggers UI events
- HTMX browser UI → HTMX response helpers: handles events
- Preview roles → Server-rendered screens: provides UI context