# mdsreq-fga-unb/req-2026.2-t01-sigcecp architecture

> Architecture diagram of the GitHub repository mdsreq-fga-unb/req-2026.2-t01-sigcecp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp
- Repository: https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp

## Overview

SigCECP is a FastAPI portal for publishing public content and events while giving coordinators authenticated tools to manage publications, events, and student classes. Public visitors browse content and event listings/details; coordinators sign in, then use protected management routes. The backend separates route handling from domain services, with SQLAlchemy persistence and uploaded media. README and sampled sources establish the main route/service/storage relationships; some class-association behavior and template interactions are only partially sampled.

Main entry points: [`backend/main.py`](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/main.py) (FastAPI app), [`backend/publicacoes/services.py`](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/services.py) (Publication service), [`backend/eventos/services.py`](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/services.py) (Event service), [`backend/auth/router.py`](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/router.py) (Login routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application"]
  node_app["FastAPI app<br/>[main.py]"]
end

subgraph group_identity["Admin identity"]
  node_auth_routes["Login routes<br/>[router.py]"]
  node_auth_guard["Admin guard<br/>[dependencies.py]"]
  node_auth_middleware["Session middleware<br/>[middleware.py]"]
  node_auth_service["Session service<br/>[services.py]"]
  node_auth_security["Token security<br/>[security.py]"]
end

subgraph group_domains["Portal domains"]
  node_publication_routes["Publication routes<br/>[router.py]"]
  node_publication_service["Publication service<br/>[services.py]"]
  node_publication_media["Publication media<br/>[media.py]"]
  node_event_routes["Event routes<br/>[router.py]"]
  node_event_service["Event service<br/>[services.py]"]
  node_event_media["Event media<br/>[media.py]"]
  node_class_routes["Class routes<br/>[router.py]"]
  node_class_service["Class service<br/>[services.py]"]
end

subgraph group_resources["Data and presentation"]
  node_db[("SQLAlchemy database<br/>[database.py]")]
  node_models["Domain models"]
  node_templates["HTML templates"]
  node_config["Template config<br/>[config.py]"]
end

node_visitor(("Public visitor"))
node_coordinator(("Coordinator"))

node_visitor -->|"browses"| node_app
node_coordinator -->|"signs in"| node_auth_routes
node_coordinator -->|"manages"| node_publication_routes
node_coordinator -->|"manages"| node_event_routes
node_coordinator -->|"manages"| node_class_routes
node_app -->|"registers routes"| node_auth_routes
node_app -->|"registers routes"| node_publication_routes
node_app -->|"registers routes"| node_event_routes
node_app -->|"registers routes"| node_class_routes
node_app -->|"installs"| node_auth_middleware
node_app -->|"queries"| node_publication_service
node_app -->|"queries"| node_event_service
node_auth_routes -->|"authenticates sessions"| node_auth_service
node_auth_service -->|"uses token functions"| node_auth_security
node_auth_guard -->|"decodes token"| node_auth_security
node_auth_guard -->|"validates session"| node_auth_service
node_auth_routes -->|"renders pages"| node_templates
node_publication_routes -->|"delegates operations"| node_publication_service
node_event_routes -->|"delegates operations"| node_event_service
node_class_routes -->|"delegates operations"| node_class_service
node_publication_service -->|"saves media"| node_publication_media
node_event_service -->|"saves media"| node_event_media
node_publication_service -->|"reads and writes"| node_db
node_event_service -->|"reads and writes"| node_db
node_class_service -->|"reads and writes"| node_db
node_app -->|"renders public pages"| node_templates
node_app -->|"uses template configuration"| node_config
node_config -->|"configures templates"| node_templates
node_publication_service -->|"uses publication models"| node_models
node_event_service -->|"uses event models"| node_models
node_class_service -->|"uses class models"| node_models

click node_app "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/main.py"
click node_auth_routes "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/router.py"
click node_auth_guard "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/dependencies.py"
click node_auth_middleware "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/middleware.py"
click node_auth_service "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/services.py"
click node_auth_security "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/security.py"
click node_publication_routes "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/router.py"
click node_publication_service "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/services.py"
click node_publication_media "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/media.py"
click node_event_routes "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/router.py"
click node_event_service "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/services.py"
click node_event_media "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/media.py"
click node_class_routes "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/turmas/router.py"
click node_class_service "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/turmas/services.py"
click node_db "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/database.py"
click node_models "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/tree/main/backend"
click node_templates "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/tree/main/frontend"
click node_config "https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/config.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_app toneBlue
class node_auth_routes,node_auth_guard,node_auth_middleware,node_auth_service,node_auth_security toneAmber
class node_publication_routes,node_publication_service,node_publication_media,node_event_routes,node_event_service,node_event_media,node_class_routes,node_class_service toneMint
class node_db,node_models,node_templates,node_config toneRose
class node_visitor,node_coordinator toneIndigo
```

## Components

### Application

- [FastAPI app](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/main.py): `backend/main.py`

### Admin identity

- [Login routes](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/router.py): `backend/auth/router.py`
- [Admin guard](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/dependencies.py): `backend/auth/dependencies.py`
- [Session middleware](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/middleware.py): `backend/auth/middleware.py`
- [Session service](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/services.py): `backend/auth/services.py`
- [Token security](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/auth/security.py): `backend/auth/security.py`

### Portal domains

- [Publication routes](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/router.py): `backend/publicacoes/router.py`
- [Publication service](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/services.py): `backend/publicacoes/services.py`
- [Publication media](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/publicacoes/media.py): `backend/publicacoes/media.py`
- [Event routes](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/router.py): `backend/eventos/router.py`
- [Event service](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/services.py): `backend/eventos/services.py`
- [Event media](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/eventos/media.py): `backend/eventos/media.py`
- [Class routes](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/turmas/router.py): `backend/turmas/router.py`
- [Class service](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/turmas/services.py): `backend/turmas/services.py`

### Data and presentation

- [SQLAlchemy database](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/database.py): `backend/database.py`
- [Domain models](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/tree/main/backend): `backend`
- [HTML templates](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/tree/main/frontend): `frontend`
- [Template config](https://github.com/mdsreq-fga-unb/req-2026.2-t01-sigcecp/blob/main/backend/config.py): `backend/config.py`

### Other components

- **Public visitor**
- **Coordinator**

## Connections

- Public visitor → FastAPI app: browses (evidence: `backend/main.py`)
- Coordinator → Login routes: signs in (evidence: `backend/auth/router.py`)
- Coordinator → Publication routes: manages (evidence: `backend/publicacoes/router.py`)
- Coordinator → Event routes: manages (evidence: `backend/eventos/router.py`)
- Coordinator → Class routes: manages (evidence: `backend/turmas/router.py`)
- FastAPI app → Login routes: registers routes (evidence: `backend/main.py`)
- FastAPI app → Publication routes: registers routes (evidence: `backend/main.py`)
- FastAPI app → Event routes: registers routes (evidence: `backend/main.py`)
- FastAPI app → Class routes: registers routes (evidence: `backend/main.py`)
- FastAPI app → Session middleware: installs (evidence: `backend/main.py`)
- FastAPI app → Publication service: queries (evidence: `backend/main.py`)
- FastAPI app → Event service: queries (evidence: `backend/main.py`)
- Login routes → Session service: authenticates sessions (evidence: `backend/auth/router.py`)
- Session service → Token security: uses token functions (evidence: `backend/auth/services.py`)
- Admin guard → Token security: decodes token (evidence: `backend/auth/dependencies.py`)
- Admin guard → Session service: validates session (evidence: `backend/auth/dependencies.py`)
- Login routes → HTML templates: renders pages (evidence: `backend/auth/router.py`)
- Publication routes → Publication service: delegates operations (evidence: `backend/publicacoes/router.py`)
- Event routes → Event service: delegates operations (evidence: `backend/eventos/router.py`)
- Class routes → Class service: delegates operations (evidence: `backend/turmas/router.py`)
- Publication service → Publication media: saves media (evidence: `backend/publicacoes/services.py`)
- Event service → Event media: saves media (evidence: `backend/eventos/services.py`)
- Publication service → SQLAlchemy database: reads and writes (evidence: `backend/publicacoes/services.py`)
- Event service → SQLAlchemy database: reads and writes (evidence: `backend/eventos/services.py`)
- Class service → SQLAlchemy database: reads and writes (evidence: `backend/turmas/services.py`)
- FastAPI app → HTML templates: renders public pages (evidence: `backend/main.py`)
- FastAPI app → Template config: uses template configuration (evidence: `backend/main.py`)
- Template config → HTML templates: configures templates (evidence: `backend/config.py`)
- Publication service → Domain models: uses publication models (evidence: `backend/publicacoes/services.py`)
- Event service → Domain models: uses event models (evidence: `backend/eventos/services.py`)
- Class service → Domain models: uses class models (evidence: `backend/turmas/services.py`)
