# parcella-garden/parcella architecture

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

- Interactive diagram: https://gitdiagram.com/parcella-garden/parcella
- Repository: https://github.com/parcella-garden/parcella

## Overview

Parcella is a web application for allotment-garden associations. Board members and other authorized users sign in, manage association records and operational modules through web pages or REST endpoints, and produce reports or coordinate work; selected workflows also connect to cloud storage, email, helpdesks, and club websites. The graph groups the documented domain areas and shared application layers. Some feature implementations are represented by their existing directories because their source was not sampled; edges are limited to relationships visible in excerpts, the source index, or README documentation.

Main entry points: [`app/main.py`](https://github.com/parcella-garden/parcella/blob/main/app/main.py) (Web application), [`app/routers/tasks.py`](https://github.com/parcella-garden/parcella/blob/main/app/routers/tasks.py) (Task routes), [`app/database.py`](https://github.com/parcella-garden/parcella/blob/main/app/database.py) (Association database), [`app/website_connectors`](https://github.com/parcella-garden/parcella/tree/main/app/website_connectors) (Website connectors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry and access"]
  node_webapp["Web application<br/>[main.py]"]
  node_authroutes["Login routes<br/>[auth.py]"]
  node_apiroutes["REST endpoints"]
end

subgraph group_association["Association records"]
  node_members["Member records<br/>[members.py]"]
  node_parcels["Parcel records<br/>[parcels.py]"]
  node_applicants["Plot applicants<br/>[applicants.py]"]
end

subgraph group_operations["Work and administration"]
  node_workhours["Work hours<br/>[work_hours.py]"]
  node_sessions["Work sessions<br/>[work_hours.py]"]
  node_taskboard["Task board<br/>[task_board.py]"]
  node_taskroutes["Task routes<br/>[tasks.py]"]
  node_finances["Finances and purchases<br/>[finances.py]"]
  node_metering["Utility metering<br/>[metering.py]"]
  node_insurance["Insurance tracking<br/>[insurance.py]"]
  node_inventory["Asset inventory<br/>[inventory.py]"]
  node_calendar["Calendar and birthdays<br/>[calendar.py]"]
end

subgraph group_integrations["External services and publishing"]
  node_announcements["Announcements<br/>[announcements.py]"]
  node_website["Website connectors"]
  node_cmsplugins["CMS connectors"]
  node_cloud["Cloud storage<br/>[cloud_storage.py]"]
  node_helpdesk["Helpdesk adapters"]
  node_joomla["Joomla connector"]
end

subgraph group_shared["Shared runtime layers"]
  node_database[("Association database<br/>[database.py]")]
  node_models["Domain models<br/>[models.py]"]
  node_auth["Session and permissions<br/>[auth.py]"]
  node_permissions["Role permissions<br/>[permissions.py]"]
  node_flags["Module switches<br/>[module_flags.py]"]
  node_templates["Page rendering<br/>[templating.py]"]
  node_i18n["Translations<br/>[i18n.py]"]
  node_l10n["Regional formatting<br/>[l10n.py]"]
  node_notes["Notes service<br/>[notes.py]"]
  node_note_files["Note files<br/>[note_files.py]"]
  node_parcel_folders["Parcel cloud folders"]
  node_config["Runtime configuration<br/>[config.py]"]
end

node_user(("Association users"))

node_user -->|"uses"| node_webapp
node_webapp -->|"registers routes"| node_authroutes
node_webapp -->|"registers routes"| node_apiroutes
node_user -->|"manages"| node_members
node_user -->|"manages"| node_parcels
node_user -->|"coordinates"| node_sessions
node_user -->|"manages tasks"| node_taskroutes
node_taskroutes -->|"uses"| node_taskboard
node_sessions -->|"uses"| node_workhours
node_user -->|"manages"| node_finances
node_user -->|"records readings"| node_metering
node_user -->|"tracks policies"| node_insurance
node_user -->|"tracks assets"| node_inventory
node_user -->|"uses"| node_calendar
node_user -->|"authors news"| node_announcements
node_announcements -->|"creates drafts"| node_website
node_website -->|"uses protocol"| node_cmsplugins
node_website -->|"uses storage"| node_cloud
node_user -->|"gets support"| node_helpdesk
node_members -.->|"reads and writes"| node_database
node_parcels -.->|"reads and writes"| node_database
node_database -->|"uses schema"| node_models
node_authroutes -->|"uses"| node_auth
node_auth -->|"checks access"| node_permissions
node_webapp -->|"loads module flags"| node_flags
node_taskroutes -->|"renders pages"| node_templates
node_taskroutes -->|"checks modules"| node_flags
node_notes -->|"reads and writes files"| node_cloud
node_parcel_folders -->|"uses provider"| node_cloud
node_database -->|"loads settings"| node_config
node_joomla -.->|"accepts signups"| node_user

click node_webapp "https://github.com/parcella-garden/parcella/blob/main/app/main.py"
click node_authroutes "https://github.com/parcella-garden/parcella/blob/main/app/routers/auth.py"
click node_apiroutes "https://github.com/parcella-garden/parcella/tree/main/app/routers"
click node_members "https://github.com/parcella-garden/parcella/blob/main/app/routers/members.py"
click node_parcels "https://github.com/parcella-garden/parcella/blob/main/app/routers/parcels.py"
click node_applicants "https://github.com/parcella-garden/parcella/blob/main/app/services/applicants.py"
click node_workhours "https://github.com/parcella-garden/parcella/blob/main/app/services/work_hours.py"
click node_sessions "https://github.com/parcella-garden/parcella/blob/main/app/routers/work_hours.py"
click node_taskboard "https://github.com/parcella-garden/parcella/blob/main/app/task_board.py"
click node_taskroutes "https://github.com/parcella-garden/parcella/blob/main/app/routers/tasks.py"
click node_finances "https://github.com/parcella-garden/parcella/blob/main/app/routers/finances.py"
click node_metering "https://github.com/parcella-garden/parcella/blob/main/app/routers/metering.py"
click node_insurance "https://github.com/parcella-garden/parcella/blob/main/app/routers/insurance.py"
click node_inventory "https://github.com/parcella-garden/parcella/blob/main/app/routers/inventory.py"
click node_calendar "https://github.com/parcella-garden/parcella/blob/main/app/routers/calendar.py"
click node_announcements "https://github.com/parcella-garden/parcella/blob/main/app/routers/announcements.py"
click node_website "https://github.com/parcella-garden/parcella/tree/main/app/website_connectors"
click node_cmsplugins "https://github.com/parcella-garden/parcella/tree/main/integrations"
click node_cloud "https://github.com/parcella-garden/parcella/blob/main/app/cloud_storage.py"
click node_helpdesk "https://github.com/parcella-garden/parcella/tree/main/app/helpdesk"
click node_database "https://github.com/parcella-garden/parcella/blob/main/app/database.py"
click node_models "https://github.com/parcella-garden/parcella/blob/main/app/models.py"
click node_auth "https://github.com/parcella-garden/parcella/blob/main/app/auth.py"
click node_permissions "https://github.com/parcella-garden/parcella/blob/main/app/permissions.py"
click node_flags "https://github.com/parcella-garden/parcella/blob/main/app/module_flags.py"
click node_templates "https://github.com/parcella-garden/parcella/blob/main/app/templating.py"
click node_i18n "https://github.com/parcella-garden/parcella/blob/main/app/i18n.py"
click node_l10n "https://github.com/parcella-garden/parcella/blob/main/app/l10n.py"
click node_notes "https://github.com/parcella-garden/parcella/blob/main/app/services/notes.py"
click node_note_files "https://github.com/parcella-garden/parcella/blob/main/app/note_files.py"
click node_parcel_folders "https://github.com/parcella-garden/parcella/blob/main/app/parcel_cloud_folders.py"
click node_config "https://github.com/parcella-garden/parcella/blob/main/app/config.py"
click node_joomla "https://github.com/parcella-garden/parcella/blob/main/integrations/joomla/plg_system_parcellaconnector/src/Extension/ParcellaConnector.php"

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_webapp,node_authroutes,node_apiroutes,node_user toneBlue
class node_members,node_parcels,node_applicants toneAmber
class node_workhours,node_sessions,node_taskboard,node_taskroutes,node_finances,node_metering,node_insurance,node_inventory,node_calendar toneMint
class node_announcements,node_website,node_cmsplugins,node_cloud,node_helpdesk,node_joomla toneRose
class node_database,node_models,node_auth,node_permissions,node_flags,node_templates,node_i18n,node_l10n,node_notes,node_note_files,node_parcel_folders,node_config toneIndigo
```

## Components

### Application entry and access

- [Web application](https://github.com/parcella-garden/parcella/blob/main/app/main.py): `app/main.py`
- [Login routes](https://github.com/parcella-garden/parcella/blob/main/app/routers/auth.py): `app/routers/auth.py`
- [REST endpoints](https://github.com/parcella-garden/parcella/tree/main/app/routers): `app/routers`

### Association records

- [Member records](https://github.com/parcella-garden/parcella/blob/main/app/routers/members.py): `app/routers/members.py`
- [Parcel records](https://github.com/parcella-garden/parcella/blob/main/app/routers/parcels.py): `app/routers/parcels.py`
- [Plot applicants](https://github.com/parcella-garden/parcella/blob/main/app/services/applicants.py): `app/services/applicants.py`

### Work and administration

- [Work hours](https://github.com/parcella-garden/parcella/blob/main/app/services/work_hours.py): `app/services/work_hours.py`
- [Work sessions](https://github.com/parcella-garden/parcella/blob/main/app/routers/work_hours.py): `app/routers/work_hours.py`
- [Task board](https://github.com/parcella-garden/parcella/blob/main/app/task_board.py): `app/task_board.py`
- [Task routes](https://github.com/parcella-garden/parcella/blob/main/app/routers/tasks.py): `app/routers/tasks.py`
- [Finances and purchases](https://github.com/parcella-garden/parcella/blob/main/app/routers/finances.py): `app/routers/finances.py`
- [Utility metering](https://github.com/parcella-garden/parcella/blob/main/app/routers/metering.py): `app/routers/metering.py`
- [Insurance tracking](https://github.com/parcella-garden/parcella/blob/main/app/routers/insurance.py): `app/routers/insurance.py`
- [Asset inventory](https://github.com/parcella-garden/parcella/blob/main/app/routers/inventory.py): `app/routers/inventory.py`
- [Calendar and birthdays](https://github.com/parcella-garden/parcella/blob/main/app/routers/calendar.py): `app/routers/calendar.py`

### External services and publishing

- [Announcements](https://github.com/parcella-garden/parcella/blob/main/app/routers/announcements.py): `app/routers/announcements.py`
- [Website connectors](https://github.com/parcella-garden/parcella/tree/main/app/website_connectors): `app/website_connectors`
- [CMS connectors](https://github.com/parcella-garden/parcella/tree/main/integrations): `integrations`
- [Cloud storage](https://github.com/parcella-garden/parcella/blob/main/app/cloud_storage.py): `app/cloud_storage.py`
- [Helpdesk adapters](https://github.com/parcella-garden/parcella/tree/main/app/helpdesk): `app/helpdesk`
- [Joomla connector](https://github.com/parcella-garden/parcella/blob/main/integrations/joomla/plg_system_parcellaconnector/src/Extension/ParcellaConnector.php): `integrations/joomla/plg_system_parcellaconnector/src/Extension/ParcellaConnector.php`

### Shared runtime layers

- [Association database](https://github.com/parcella-garden/parcella/blob/main/app/database.py): `app/database.py`
- [Domain models](https://github.com/parcella-garden/parcella/blob/main/app/models.py): `app/models.py`
- [Session and permissions](https://github.com/parcella-garden/parcella/blob/main/app/auth.py): `app/auth.py`
- [Role permissions](https://github.com/parcella-garden/parcella/blob/main/app/permissions.py): `app/permissions.py`
- [Module switches](https://github.com/parcella-garden/parcella/blob/main/app/module_flags.py): `app/module_flags.py`
- [Page rendering](https://github.com/parcella-garden/parcella/blob/main/app/templating.py): `app/templating.py`
- [Translations](https://github.com/parcella-garden/parcella/blob/main/app/i18n.py): `app/i18n.py`
- [Regional formatting](https://github.com/parcella-garden/parcella/blob/main/app/l10n.py): `app/l10n.py`
- [Notes service](https://github.com/parcella-garden/parcella/blob/main/app/services/notes.py): `app/services/notes.py`
- [Note files](https://github.com/parcella-garden/parcella/blob/main/app/note_files.py): `app/note_files.py`
- [Parcel cloud folders](https://github.com/parcella-garden/parcella/blob/main/app/parcel_cloud_folders.py): `app/parcel_cloud_folders.py`
- [Runtime configuration](https://github.com/parcella-garden/parcella/blob/main/app/config.py): `app/config.py`

### Other components

- **Association users**

## Connections

- Association users → Web application: uses
- Web application → Login routes: registers routes (evidence: `app/main.py`)
- Web application → REST endpoints: registers routes (evidence: `app/main.py`)
- Association users → Member records: manages
- Association users → Parcel records: manages
- Association users → Work sessions: coordinates
- Association users → Task routes: manages tasks
- Task routes → Task board: uses (evidence: `app/routers/tasks.py`)
- Work sessions → Work hours: uses (evidence: `app/services/work_hours.py`)
- Association users → Finances and purchases: manages
- Association users → Utility metering: records readings
- Association users → Insurance tracking: tracks policies
- Association users → Asset inventory: tracks assets
- Association users → Calendar and birthdays: uses
- Association users → Announcements: authors news
- Announcements → Website connectors: creates drafts
- Website connectors → CMS connectors: uses protocol
- Website connectors → Cloud storage: uses storage (evidence: `app/website_connectors/markdown_folder.py`)
- Association users → Helpdesk adapters: gets support
- Member records → Association database: reads and writes
- Parcel records → Association database: reads and writes
- Association database → Domain models: uses schema (evidence: `app/database.py`)
- Login routes → Session and permissions: uses (evidence: `app/routers/auth.py`)
- Session and permissions → Role permissions: checks access (evidence: `app/auth.py`)
- Web application → Module switches: loads module flags (evidence: `app/main.py`)
- Task routes → Page rendering: renders pages (evidence: `app/routers/tasks.py`)
- Task routes → Module switches: checks modules (evidence: `app/routers/tasks.py`)
- Notes service → Cloud storage: reads and writes files (evidence: `app/services/notes.py`)
- Parcel cloud folders → Cloud storage: uses provider (evidence: `app/parcel_cloud_folders.py`)
- Association database → Runtime configuration: loads settings (evidence: `app/database.py`)
- Joomla connector → Association users: accepts signups
