# leomach/plataforma-sinodal architecture

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

- Interactive diagram: https://gitdiagram.com/leomach/plataforma-sinodal
- Repository: https://github.com/leomach/plataforma-sinodal

## Overview

A Django platform for organizing events and synodal sessions. Users register and are managed for events; event payments can be confirmed through InfinitePay, while approved delegates participate in session attendance, quorum, and voting. The event hub exposes event documents and delegate session information. Relationships are limited to calls, model references, and integration behavior shown in excerpts or the source index; many routes and views were not sampled.

Main entry points: [`apps/hub/views.py`](https://github.com/leomach/plataforma-sinodal/blob/main/apps/hub/views.py) (Event hub views), [`apps/sessoes/views/painel.py`](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/views/painel.py) (Session management), [`apps/usuarios/views.py`](https://github.com/leomach/plataforma-sinodal/blob/main/apps/usuarios/views.py) (Account workflows), [`apps/eventos/views.py`](https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/views.py) (Event workflows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Users and badges"]
  node_users[("Accounts and profiles<br/>[models.py]")]
  node_user_views["Account workflows<br/>[views.py]"]
  node_badges[("Badge records<br/>[models.py]")]
  node_badge_services["Badge services<br/>[services.py]"]
end

subgraph group_events["Events and payments"]
  node_events_data[("Events and registrations<br/>[models.py]")]
  node_event_views["Event workflows<br/>[views.py]"]
  node_event_forms["Registration forms<br/>[forms.py]"]
  node_payment_views["Payment endpoints<br/>[views.py]"]
  node_payment_dispatch["Payment handler registry<br/>[handlers.py]"]
  node_event_payment["Registration confirmation<br/>[handlers.py]"]
  node_infinitepay["InfinitePay integration<br/>[infinitepay.py]"]
end

subgraph group_sessions["Sessions and deliberation"]
  node_session_data[("Session and voting records<br/>[models.py]")]
  node_session_panel["Session management<br/>[painel.py]"]
  node_session_forms["Session forms<br/>[forms.py]"]
  node_quorum["Quorum calculations<br/>[quorum.py]"]
  node_session_log["Session event log<br/>[eventlog.py]"]
  node_qr_service["QR credentials<br/>[qrcode.py]"]
  node_session_signals["Credential signals<br/>[signals.py]"]
end

subgraph group_hub["Event hub"]
  node_hub_views["Event hub views<br/>[views.py]"]
  node_hub_data[("Event documents<br/>[models.py]")]
end

node_visitor(("Participant"))
node_leaders(("Event leaders"))
node_payment_provider(("InfinitePay"))

node_visitor -->|"registers or signs in"| node_user_views
node_leaders -->|"manages accounts"| node_user_views
node_user_views -->|"updates accounts"| node_users
node_user_views -->|"uses event records"| node_event_views
node_user_views -->|"uses badge records"| node_badges
node_badge_services -->|"uses badge records"| node_badges
node_visitor -->|"browses and registers"| node_event_views
node_event_views -.->|"uses registration forms"| node_event_forms
node_event_views -.->|"uses event records"| node_events_data
node_payment_views -->|"dispatches confirmations"| node_payment_dispatch
node_payment_views -->|"checks payments"| node_infinitepay
node_infinitepay -->|"calls API"| node_payment_provider
node_payment_dispatch -->|"dispatches by prefix"| node_event_payment
node_event_payment -->|"loads registration"| node_events_data
node_event_payment -->|"converts amounts"| node_infinitepay
node_event_payment -->|"registers handler"| node_payment_dispatch
node_event_views -.->|"creates payment links"| node_infinitepay
node_leaders -->|"manages sessions"| node_session_panel
node_session_panel -->|"reads and updates"| node_session_data
node_session_panel -->|"uses forms"| node_session_forms
node_session_panel -->|"records session actions"| node_session_log
node_session_panel -->|"calculates quorum"| node_quorum
node_session_log -->|"checks quorum"| node_quorum
node_session_log -->|"creates log records"| node_session_data
node_session_signals -->|"uses session records"| node_session_data
node_session_signals -->|"generates credentials"| node_qr_service
node_visitor -->|"views event hub"| node_hub_views
node_hub_views -->|"loads event information"| node_events_data
node_hub_views -->|"loads documents"| node_hub_data
node_hub_views -->|"reads session and vote state"| node_session_data
node_hub_views -->|"renders QR credential"| node_qr_service
node_hub_views -->|"requests quorum"| node_quorum
node_hub_views -->|"uses session panel logic"| node_session_panel

click node_users "https://github.com/leomach/plataforma-sinodal/blob/main/apps/usuarios/models.py"
click node_user_views "https://github.com/leomach/plataforma-sinodal/blob/main/apps/usuarios/views.py"
click node_badges "https://github.com/leomach/plataforma-sinodal/blob/main/apps/emblemas/models.py"
click node_badge_services "https://github.com/leomach/plataforma-sinodal/blob/main/apps/emblemas/services.py"
click node_events_data "https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/models.py"
click node_event_views "https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/views.py"
click node_event_forms "https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/forms.py"
click node_payment_views "https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/views.py"
click node_payment_dispatch "https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/handlers.py"
click node_event_payment "https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/handlers.py"
click node_infinitepay "https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/services/infinitepay.py"
click node_session_data "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/models.py"
click node_session_panel "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/views/painel.py"
click node_session_forms "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/forms.py"
click node_quorum "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/quorum.py"
click node_session_log "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/eventlog.py"
click node_qr_service "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/qrcode.py"
click node_session_signals "https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/signals.py"
click node_hub_views "https://github.com/leomach/plataforma-sinodal/blob/main/apps/hub/views.py"
click node_hub_data "https://github.com/leomach/plataforma-sinodal/blob/main/apps/hub/models.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_users,node_user_views,node_badges,node_badge_services toneBlue
class node_events_data,node_event_views,node_event_forms,node_payment_views,node_payment_dispatch,node_event_payment,node_infinitepay toneAmber
class node_session_data,node_session_panel,node_session_forms,node_quorum,node_session_log,node_qr_service,node_session_signals toneMint
class node_hub_views,node_hub_data toneRose
class node_visitor,node_leaders,node_payment_provider toneIndigo
```

## Components

### Users and badges

- [Accounts and profiles](https://github.com/leomach/plataforma-sinodal/blob/main/apps/usuarios/models.py): `apps/usuarios/models.py`
- [Account workflows](https://github.com/leomach/plataforma-sinodal/blob/main/apps/usuarios/views.py): `apps/usuarios/views.py`
- [Badge records](https://github.com/leomach/plataforma-sinodal/blob/main/apps/emblemas/models.py): `apps/emblemas/models.py`
- [Badge services](https://github.com/leomach/plataforma-sinodal/blob/main/apps/emblemas/services.py): `apps/emblemas/services.py`

### Events and payments

- [Events and registrations](https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/models.py): `apps/eventos/models.py`
- [Event workflows](https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/views.py): `apps/eventos/views.py`
- [Registration forms](https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/forms.py): `apps/eventos/forms.py`
- [Payment endpoints](https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/views.py): `apps/pagamentos/views.py`
- [Payment handler registry](https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/handlers.py): `apps/pagamentos/handlers.py`
- [Registration confirmation](https://github.com/leomach/plataforma-sinodal/blob/main/apps/eventos/handlers.py): `apps/eventos/handlers.py`
- [InfinitePay integration](https://github.com/leomach/plataforma-sinodal/blob/main/apps/pagamentos/services/infinitepay.py): `apps/pagamentos/services/infinitepay.py`

### Sessions and deliberation

- [Session and voting records](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/models.py): `apps/sessoes/models.py`
- [Session management](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/views/painel.py): `apps/sessoes/views/painel.py`
- [Session forms](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/forms.py): `apps/sessoes/forms.py`
- [Quorum calculations](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/quorum.py): `apps/sessoes/services/quorum.py`
- [Session event log](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/eventlog.py): `apps/sessoes/services/eventlog.py`
- [QR credentials](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/services/qrcode.py): `apps/sessoes/services/qrcode.py`
- [Credential signals](https://github.com/leomach/plataforma-sinodal/blob/main/apps/sessoes/signals.py): `apps/sessoes/signals.py`

### Event hub

- [Event hub views](https://github.com/leomach/plataforma-sinodal/blob/main/apps/hub/views.py): `apps/hub/views.py`
- [Event documents](https://github.com/leomach/plataforma-sinodal/blob/main/apps/hub/models.py): `apps/hub/models.py`

### Other components

- **Participant**
- **Event leaders**
- **InfinitePay**

## Connections

- Participant → Account workflows: registers or signs in (evidence: `apps/usuarios/views.py`)
- Event leaders → Account workflows: manages accounts (evidence: `apps/usuarios/views.py`)
- Account workflows → Accounts and profiles: updates accounts (evidence: `apps/usuarios/views.py`)
- Account workflows → Event workflows: uses event records (evidence: `apps/usuarios/views.py`)
- Account workflows → Badge records: uses badge records (evidence: `apps/usuarios/views.py`)
- Badge services → Badge records: uses badge records (evidence: `apps/emblemas/services.py`)
- Participant → Event workflows: browses and registers
- Event workflows → Registration forms: uses registration forms
- Event workflows → Events and registrations: uses event records
- Payment endpoints → Payment handler registry: dispatches confirmations (evidence: `apps/pagamentos/views.py`)
- Payment endpoints → InfinitePay integration: checks payments (evidence: `apps/pagamentos/views.py`)
- InfinitePay integration → InfinitePay: calls API (evidence: `apps/pagamentos/services/infinitepay.py`)
- Payment handler registry → Registration confirmation: dispatches by prefix (evidence: `apps/eventos/handlers.py`)
- Registration confirmation → Events and registrations: loads registration (evidence: `apps/eventos/handlers.py`)
- Registration confirmation → InfinitePay integration: converts amounts (evidence: `apps/eventos/handlers.py`)
- Registration confirmation → Payment handler registry: registers handler (evidence: `apps/eventos/handlers.py`)
- Event workflows → InfinitePay integration: creates payment links
- Event leaders → Session management: manages sessions (evidence: `apps/sessoes/views/painel.py`)
- Session management → Session and voting records: reads and updates (evidence: `apps/sessoes/views/painel.py`)
- Session management → Session forms: uses forms (evidence: `apps/sessoes/views/painel.py`)
- Session management → Session event log: records session actions (evidence: `apps/sessoes/views/painel.py`)
- Session management → Quorum calculations: calculates quorum (evidence: `apps/sessoes/views/painel.py`)
- Session event log → Quorum calculations: checks quorum (evidence: `apps/sessoes/services/eventlog.py`)
- Session event log → Session and voting records: creates log records (evidence: `apps/sessoes/services/eventlog.py`)
- Credential signals → Session and voting records: uses session records (evidence: `apps/sessoes/signals.py`)
- Credential signals → QR credentials: generates credentials (evidence: `apps/sessoes/signals.py`)
- Participant → Event hub views: views event hub (evidence: `apps/hub/views.py`)
- Event hub views → Events and registrations: loads event information (evidence: `apps/hub/views.py`)
- Event hub views → Event documents: loads documents (evidence: `apps/hub/views.py`)
- Event hub views → Session and voting records: reads session and vote state (evidence: `apps/hub/views.py`)
- Event hub views → QR credentials: renders QR credential (evidence: `apps/hub/views.py`)
- Event hub views → Quorum calculations: requests quorum (evidence: `apps/hub/views.py`)
- Event hub views → Session management: uses session panel logic (evidence: `apps/hub/views.py`)
