# tomastomecek/trello-reporter architecture

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

- Interactive diagram: https://gitdiagram.com/tomastomecek/trello-reporter
- Repository: https://github.com/tomastomecek/trello-reporter

## Overview

trello-reporter is a Django application for reporting and charting Trello board activity. Users provide an API key; Trello authorization supplies a token kept in a cookie rather than persisted. The application fetches board data and actions, stores them for charting, and exposes board, sprint, card, and chart views. The README documents synchronization and chart capabilities; sampled code confirms several chart-data paths, but not every route or synchronization call, so unsupported connections are omitted.

Main entry points: [`trello_reporter/charting/views.py`](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/views.py) (Report views), [`trello_reporter/charting/models.py`](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/models.py) (Boards and cards), [`trello_reporter/harvesting/harvestor.py`](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/harvesting/harvestor.py) (Trello fetcher), [`trello_reporter/urls.py`](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/urls.py) (URL routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity and access"]
  node_route_root["URL routing<br/>[urls.py]"]
  node_auth_routes["Auth routes<br/>[urls.py]"]
  node_auth_views["Auth views<br/>[views.py]"]
  node_auth_forms["Profile form<br/>[forms.py]"]
  node_auth_models[("Trello users<br/>[models.py]")]
  node_auth_backend["Auth backend<br/>[backend.py]"]
end

subgraph group_sync["Trello data sync"]
  node_events[("Trello action events<br/>[models.py]")]
  node_harvestor["Trello fetcher<br/>[harvestor.py]"]
end

subgraph group_domain["Board and sprint data"]
  node_boards[("Boards and cards<br/>[models.py]")]
  node_settings["Application settings<br/>[settings.py]"]
end

subgraph group_reporting["Reports and charts"]
  node_chart_routes["Chart routes<br/>[urls.py]"]
  node_chart_views["Report views<br/>[views.py]"]
  node_chart_forms["Chart forms<br/>[forms.py]"]
  node_processing["Chart calculations<br/>[processing.py]"]
  node_templates["Card presentation<br/>[card.py]"]
  node_chart_client["Chart interface<br/>[main.js]"]
  node_constants["Chart definitions<br/>[constants.py]"]
end

node_user(("Browser user"))
node_trello["Trello API"]

node_user -->|"opens reports"| node_route_root
node_route_root -->|"registers routes"| node_auth_routes
node_route_root -->|"registers routes"| node_chart_routes
node_auth_routes -->|"routes requests"| node_auth_views
node_auth_views -->|"validates profile"| node_auth_forms
node_auth_views -.->|"updates profile"| node_auth_models
node_auth_backend -->|"loads user"| node_auth_models
node_auth_backend -->|"checks Trello token"| node_harvestor
node_chart_routes -->|"routes requests"| node_chart_views
node_chart_views -->|"validates inputs"| node_chart_forms
node_chart_views -->|"calculates chart data"| node_processing
node_chart_views -->|"reads board data"| node_boards
node_chart_views -->|"reads card events"| node_events
node_chart_views -->|"reads user settings"| node_auth_models
node_chart_views -->|"renders card links"| node_templates
node_processing -->|"queries chart data"| node_boards
node_chart_forms -->|"uses board models"| node_boards
node_boards -->|"fetches Trello data"| node_harvestor
node_boards -->|"stores action events"| node_events
node_harvestor -->|"requests board data"| node_trello
node_harvestor -->|"loads API key"| node_settings
node_chart_views -.->|"serves chart data"| node_chart_client
node_chart_views -->|"uses chart definitions"| node_constants

click node_route_root "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/urls.py"
click node_auth_routes "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/urls.py"
click node_auth_views "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/views.py"
click node_auth_forms "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/forms.py"
click node_auth_models "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/models.py"
click node_auth_backend "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/backend.py"
click node_chart_routes "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/urls.py"
click node_chart_views "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/views.py"
click node_chart_forms "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/forms.py"
click node_processing "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/processing.py"
click node_templates "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/templatetags/card.py"
click node_chart_client "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/static/main.js"
click node_boards "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/models.py"
click node_events "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/harvesting/models.py"
click node_harvestor "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/harvesting/harvestor.py"
click node_settings "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/settings.py"
click node_constants "https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/constants.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_route_root,node_auth_routes,node_auth_views,node_auth_forms,node_auth_models,node_auth_backend,node_user toneBlue
class node_events,node_harvestor toneAmber
class node_boards,node_settings,node_trello toneMint
class node_chart_routes,node_chart_views,node_chart_forms,node_processing,node_templates,node_chart_client,node_constants toneRose
```

## Components

### Identity and access

- [URL routing](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/urls.py): `trello_reporter/urls.py`
- [Auth routes](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/urls.py): `trello_reporter/authentication/urls.py`
- [Auth views](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/views.py): `trello_reporter/authentication/views.py`
- [Profile form](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/forms.py): `trello_reporter/authentication/forms.py`
- [Trello users](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/models.py): `trello_reporter/authentication/models.py`
- [Auth backend](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/authentication/backend.py): `trello_reporter/authentication/backend.py`

### Trello data sync

- [Trello action events](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/harvesting/models.py): `trello_reporter/harvesting/models.py`
- [Trello fetcher](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/harvesting/harvestor.py): `trello_reporter/harvesting/harvestor.py`

### Board and sprint data

- [Boards and cards](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/models.py): `trello_reporter/charting/models.py`
- [Application settings](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/settings.py): `trello_reporter/settings.py`

### Reports and charts

- [Chart routes](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/urls.py): `trello_reporter/charting/urls.py`
- [Report views](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/views.py): `trello_reporter/charting/views.py`
- [Chart forms](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/forms.py): `trello_reporter/charting/forms.py`
- [Chart calculations](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/processing.py): `trello_reporter/charting/processing.py`
- [Card presentation](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/templatetags/card.py): `trello_reporter/charting/templatetags/card.py`
- [Chart interface](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/static/main.js): `trello_reporter/charting/static/main.js`
- [Chart definitions](https://github.com/tomastomecek/trello-reporter/blob/master/trello_reporter/charting/constants.py): `trello_reporter/charting/constants.py`

### Other components

- **Browser user**
- **Trello API**

## Connections

- Browser user → URL routing: opens reports (evidence: `trello_reporter/urls.py`)
- URL routing → Auth routes: registers routes (evidence: `trello_reporter/urls.py`)
- URL routing → Chart routes: registers routes (evidence: `trello_reporter/urls.py`)
- Auth routes → Auth views: routes requests (evidence: `trello_reporter/authentication/urls.py`)
- Auth views → Profile form: validates profile (evidence: `trello_reporter/authentication/views.py`)
- Auth views → Trello users: updates profile
- Auth backend → Trello users: loads user (evidence: `trello_reporter/authentication/backend.py`)
- Auth backend → Trello fetcher: checks Trello token (evidence: `trello_reporter/authentication/backend.py`)
- Chart routes → Report views: routes requests (evidence: `trello_reporter/charting/urls.py`)
- Report views → Chart forms: validates inputs (evidence: `trello_reporter/charting/views.py`)
- Report views → Chart calculations: calculates chart data (evidence: `trello_reporter/charting/views.py`)
- Report views → Boards and cards: reads board data (evidence: `trello_reporter/charting/views.py`)
- Report views → Trello action events: reads card events (evidence: `trello_reporter/charting/views.py`)
- Report views → Trello users: reads user settings (evidence: `trello_reporter/charting/views.py`)
- Report views → Card presentation: renders card links (evidence: `trello_reporter/charting/views.py`)
- Chart calculations → Boards and cards: queries chart data (evidence: `trello_reporter/charting/processing.py`)
- Chart forms → Boards and cards: uses board models (evidence: `trello_reporter/charting/forms.py`)
- Boards and cards → Trello fetcher: fetches Trello data (evidence: `trello_reporter/charting/models.py`)
- Boards and cards → Trello action events: stores action events (evidence: `trello_reporter/charting/models.py`)
- Trello fetcher → Trello API: requests board data (evidence: `trello_reporter/harvesting/harvestor.py`)
- Trello fetcher → Application settings: loads API key (evidence: `trello_reporter/harvesting/harvestor.py`)
- Report views → Chart interface: serves chart data
- Report views → Chart definitions: uses chart definitions (evidence: `trello_reporter/charting/views.py`)
