# watchdogpolska/poradnia architecture

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

- Interactive diagram: https://gitdiagram.com/watchdogpolska/poradnia
- Repository: https://github.com/watchdogpolska/poradnia

## Overview

Poradnia is a Django application supporting client assistance at the Polish NGO Access to Public Information Center, with staff and experts handling cases and related communications. Its domain includes advice classification, letters and attachments, scheduled events, and court-session records; dashboards provide quantitative support reporting. Celery tasks automate reminders, case follow-up, attachment text extraction, and court parsing. The graph highlights these areas and their evidenced dependencies. Some views and integrations are unsampled, so their wiring is omitted or shown as unverified.

Main entry points: [`poradnia/cases/models.py`](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/cases/models.py) (Cases), [`poradnia/letters/models.py`](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/letters/models.py) (Letters And Attachments), [`poradnia/users/models.py`](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/users/models.py) (Users And Profiles), [`poradnia/judgements/models.py`](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/models.py) (Court Sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Casework"]
  node_case_views["Case Workspace<br/>[cases.py]"]
  node_cases[("Cases<br/>[models.py]")]
  node_records[("Support Records<br/>[models.py]")]
end

subgraph group_knowledge["Advice And Research"]
  node_advice[("Advice Catalog<br/>[models.py]")]
  node_ai[("AI Assistant<br/>[models.py]")]
  node_judgements[("Court Sessions<br/>[models.py]")]
  node_parser_registry["Parser Registry<br/>[registry.py]"]
  node_court_parsers["Court Parsers<br/>[nsa.py]"]
  node_court_tasks["Court Parsing<br/>[tasks.py]"]
end

subgraph group_operations["Communications"]
  node_letters[("Letters And Attachments<br/>[models.py]")]
  node_letter_tasks["Attachment Processing<br/>[tasks.py]"]
  node_events[("Events<br/>[models.py]")]
  node_event_tasks["Event Reminders<br/>[tasks.py]"]
end

subgraph group_insight["Reporting"]
  node_dashboard["Support Reports<br/>[reports.py]"]
end

subgraph group_platform["Identity And Background Work"]
  node_users[("Users And Profiles<br/>[models.py]")]
  node_mail["Template Mail<br/>[utils.py]"]
  node_celery["Task Runtime<br/>[celery.py]"]
  node_monitor[("Task Monitoring<br/>[models.py]")]
end

node_client(("Client / Staff"))
node_text_service{{"File-To-Text Service"}}

node_client -.->|"uses"| node_case_views
node_cases -->|"references"| node_letters
node_cases -->|"uses"| node_advice
node_cases -->|"uses"| node_ai
node_cases -->|"uses helpers"| node_records
node_letters -->|"references"| node_cases
node_letters -->|"uses helpers"| node_records
node_letters -->|"references"| node_users
node_letters -->|"submits files"| node_text_service
node_letter_tasks -->|"processes"| node_letters
node_event_tasks -->|"reads events"| node_events
node_event_tasks -->|"notifies"| node_users
node_events -->|"references"| node_records
node_events -->|"references"| node_users
node_judgements -->|"links sessions"| node_events
node_judgements -->|"extends"| node_records
node_judgements -->|"looks up parser"| node_parser_registry
node_court_parsers -->|"registers parser"| node_parser_registry
node_court_tasks -->|"processes courts"| node_judgements
node_court_tasks -->|"selects parser"| node_parser_registry
node_cases -->|"references"| node_users
node_users -->|"sends template mail"| node_mail
node_celery -->|"discovers tasks"| node_letter_tasks
node_celery -->|"discovers tasks"| node_event_tasks
node_celery -->|"discovers tasks"| node_court_tasks
node_letter_tasks -->|"reports status"| node_monitor

click node_case_views "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/cases/views/cases.py"
click node_cases "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/cases/models.py"
click node_records "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/records/models.py"
click node_letters "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/letters/models.py"
click node_letter_tasks "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/letters/tasks.py"
click node_advice "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/advicer/models.py"
click node_ai "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/ai_assistant/models.py"
click node_events "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/events/models.py"
click node_event_tasks "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/events/tasks.py"
click node_judgements "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/models.py"
click node_parser_registry "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/registry.py"
click node_court_parsers "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/parsers/nsa.py"
click node_court_tasks "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/tasks.py"
click node_dashboard "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/dashboard/reports.py"
click node_users "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/users/models.py"
click node_mail "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/template_mail/utils.py"
click node_celery "https://github.com/watchdogpolska/poradnia/blob/master/config/celery.py"
click node_monitor "https://github.com/watchdogpolska/poradnia/blob/master/poradnia/celery_monitor/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_case_views,node_cases,node_records,node_client toneBlue
class node_advice,node_ai,node_judgements,node_parser_registry,node_court_parsers,node_court_tasks toneAmber
class node_letters,node_letter_tasks,node_events,node_event_tasks toneMint
class node_dashboard toneRose
class node_users,node_mail,node_celery,node_monitor,node_text_service toneIndigo
```

## Components

### Casework

- [Case Workspace](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/cases/views/cases.py): `poradnia/cases/views/cases.py`
- [Cases](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/cases/models.py): `poradnia/cases/models.py`
- [Support Records](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/records/models.py): `poradnia/records/models.py`

### Advice And Research

- [Advice Catalog](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/advicer/models.py): `poradnia/advicer/models.py`
- [AI Assistant](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/ai_assistant/models.py): `poradnia/ai_assistant/models.py`
- [Court Sessions](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/models.py): `poradnia/judgements/models.py`
- [Parser Registry](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/registry.py): `poradnia/judgements/registry.py`
- [Court Parsers](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/parsers/nsa.py): `poradnia/judgements/parsers/nsa.py`
- [Court Parsing](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/judgements/tasks.py): `poradnia/judgements/tasks.py`

### Communications

- [Letters And Attachments](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/letters/models.py): `poradnia/letters/models.py`
- [Attachment Processing](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/letters/tasks.py): `poradnia/letters/tasks.py`
- [Events](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/events/models.py): `poradnia/events/models.py`
- [Event Reminders](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/events/tasks.py): `poradnia/events/tasks.py`

### Reporting

- [Support Reports](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/dashboard/reports.py): `poradnia/dashboard/reports.py`

### Identity And Background Work

- [Users And Profiles](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/users/models.py): `poradnia/users/models.py`
- [Template Mail](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/template_mail/utils.py): `poradnia/template_mail/utils.py`
- [Task Runtime](https://github.com/watchdogpolska/poradnia/blob/master/config/celery.py): `config/celery.py`
- [Task Monitoring](https://github.com/watchdogpolska/poradnia/blob/master/poradnia/celery_monitor/models.py): `poradnia/celery_monitor/models.py`

### Other components

- **Client / Staff**
- **File-To-Text Service**

## Connections

- Client / Staff → Case Workspace: uses
- Cases → Letters And Attachments: references (evidence: `poradnia/cases/models.py`)
- Cases → Advice Catalog: uses (evidence: `poradnia/cases/models.py`)
- Cases → AI Assistant: uses (evidence: `poradnia/cases/models.py`)
- Cases → Support Records: uses helpers (evidence: `poradnia/cases/models.py`)
- Letters And Attachments → Cases: references (evidence: `poradnia/letters/models.py`)
- Letters And Attachments → Support Records: uses helpers (evidence: `poradnia/letters/models.py`)
- Letters And Attachments → Users And Profiles: references (evidence: `poradnia/letters/models.py`)
- Letters And Attachments → File-To-Text Service: submits files (evidence: `poradnia/letters/models.py`)
- Attachment Processing → Letters And Attachments: processes (evidence: `poradnia/letters/tasks.py`)
- Event Reminders → Events: reads events (evidence: `poradnia/events/tasks.py`)
- Event Reminders → Users And Profiles: notifies (evidence: `poradnia/events/tasks.py`)
- Events → Support Records: references (evidence: `poradnia/events/models.py`)
- Events → Users And Profiles: references (evidence: `poradnia/events/models.py`)
- Court Sessions → Events: links sessions (evidence: `poradnia/judgements/models.py`)
- Court Sessions → Support Records: extends (evidence: `poradnia/judgements/models.py`)
- Court Sessions → Parser Registry: looks up parser (evidence: `poradnia/judgements/models.py`)
- Court Parsers → Parser Registry: registers parser (evidence: `poradnia/judgements/parsers/nsa.py`)
- Court Parsing → Court Sessions: processes courts (evidence: `poradnia/judgements/tasks.py`)
- Court Parsing → Parser Registry: selects parser (evidence: `poradnia/judgements/tasks.py`)
- Cases → Users And Profiles: references (evidence: `poradnia/users/models.py`)
- Users And Profiles → Template Mail: sends template mail (evidence: `poradnia/users/models.py`)
- Task Runtime → Attachment Processing: discovers tasks (evidence: `config/celery.py`)
- Task Runtime → Event Reminders: discovers tasks (evidence: `config/celery.py`)
- Task Runtime → Court Parsing: discovers tasks (evidence: `config/celery.py`)
- Attachment Processing → Task Monitoring: reports status (evidence: `poradnia/letters/tasks.py`)
