# kaa-ghost/weekly-participation architecture

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

- Interactive diagram: https://gitdiagram.com/kaa-ghost/weekly-participation
- Repository: https://github.com/kaa-ghost/weekly-participation

## Overview

Приложение ведёт недельный учёт фактической и плановой занятости пользователей по проектам: пользователь вносит проценты, а руководители и администраторы получают сводки и управляют справочниками. Внутренний слой моделей хранит пользователей, группы, проекты и записи участия через Flask-SQLAlchemy. На графе сохранены также месячный отчёт с XLSX-выгрузкой и сценарии тимлида. Некоторые связи показаны только по README: excerpts охватывают лишь часть маршрутов, поэтому несэмплированные детали не предполагаются.

Main entry points: [`models.py`](https://github.com/kaa-ghost/weekly-participation/blob/main/models.py) (Модели предметной области), [`app.py`](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py) (Недельный ввод), [`templates/dashboard.html`](https://github.com/kaa-ghost/weekly-participation/blob/main/templates/dashboard.html) (Панель учёта), [`templates/summary.html`](https://github.com/kaa-ghost/weekly-participation/blob/main/templates/summary.html) (Шаблон сводки)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Доступ"]
  node_auth["Вход и регистрация<br/>[app.py]"]
end

subgraph group_tracking["Учёт занятости"]
  node_dashboard["Недельный ввод<br/>[app.py]"]
  node_dashboard_view["Панель учёта<br/>[dashboard.html]"]
  node_weekly_ops["Записи недели<br/>[app.py]"]
end

subgraph group_reporting["Отчёты"]
  node_summary["Сводка факт/план<br/>[app.py]"]
  node_summary_view["Шаблон сводки<br/>[summary.html]"]
  node_monthly["Месячный отчёт<br/>[app.py]"]
  node_monthly_view["Шаблон месяца<br/>[monthly.html]"]
  node_xlsx["Экспорт XLSX<br/>[app.py]"]
end

subgraph group_management["Управление"]
  node_admin_users["Управление людьми<br/>[app.py]"]
  node_admin_projects["Управление проектами<br/>[app.py]"]
  node_admin_groups["Управление группами<br/>[app.py]"]
  node_teamlead["Управление участниками<br/>[app.py]"]
end

subgraph group_domain["Данные"]
  node_models["Модели предметной области<br/>[models.py]"]
  node_database[("Реляционная БД<br/>[models.py]")]
end

node_user(("Пользователь"))

node_user -->|"регистрируется / входит"| node_auth
node_user -->|"вводит занятость"| node_dashboard
node_dashboard -->|"показывает"| node_dashboard_view
node_dashboard -->|"сохраняет записи"| node_weekly_ops
node_weekly_ops -->|"использует модели"| node_models
node_summary -->|"читает записи"| node_models
node_summary -->|"рендерит"| node_summary_view
node_monthly -->|"рендерит"| node_monthly_view
node_xlsx -->|"вызывает расчёт"| node_monthly
node_xlsx -->|"читает данные"| node_models
node_user -->|"просматривает"| node_summary
node_user -->|"просматривает"| node_monthly
node_user -->|"выгружает отчёт"| node_xlsx
node_admin_users -->|"изменяет пользователей"| node_models
node_admin_projects -->|"изменяет проекты"| node_models
node_admin_groups -.->|"изменяет группы"| node_models
node_teamlead -->|"добавляет участников"| node_models
node_models -->|"хранит данные"| node_database

click node_auth "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_dashboard "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_dashboard_view "https://github.com/kaa-ghost/weekly-participation/blob/main/templates/dashboard.html"
click node_weekly_ops "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_summary "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_summary_view "https://github.com/kaa-ghost/weekly-participation/blob/main/templates/summary.html"
click node_monthly "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_monthly_view "https://github.com/kaa-ghost/weekly-participation/blob/main/templates/monthly.html"
click node_xlsx "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_admin_users "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_admin_projects "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_admin_groups "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_teamlead "https://github.com/kaa-ghost/weekly-participation/blob/main/app.py"
click node_models "https://github.com/kaa-ghost/weekly-participation/blob/main/models.py"
click node_database "https://github.com/kaa-ghost/weekly-participation/blob/main/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_auth toneBlue
class node_dashboard,node_dashboard_view,node_weekly_ops toneAmber
class node_summary,node_summary_view,node_monthly,node_monthly_view,node_xlsx toneMint
class node_admin_users,node_admin_projects,node_admin_groups,node_teamlead toneRose
class node_models,node_database,node_user toneIndigo
```

## Components

### Доступ

- [Вход и регистрация](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`

### Учёт занятости

- [Недельный ввод](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Панель учёта](https://github.com/kaa-ghost/weekly-participation/blob/main/templates/dashboard.html): `templates/dashboard.html`
- [Записи недели](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`

### Отчёты

- [Сводка факт/план](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Шаблон сводки](https://github.com/kaa-ghost/weekly-participation/blob/main/templates/summary.html): `templates/summary.html`
- [Месячный отчёт](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Шаблон месяца](https://github.com/kaa-ghost/weekly-participation/blob/main/templates/monthly.html): `templates/monthly.html`
- [Экспорт XLSX](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`

### Управление

- [Управление людьми](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Управление проектами](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Управление группами](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`
- [Управление участниками](https://github.com/kaa-ghost/weekly-participation/blob/main/app.py): `app.py`

### Данные

- [Модели предметной области](https://github.com/kaa-ghost/weekly-participation/blob/main/models.py): `models.py`
- [Реляционная БД](https://github.com/kaa-ghost/weekly-participation/blob/main/models.py): `models.py`

### Other components

- **Пользователь**

## Connections

- Пользователь → Вход и регистрация: регистрируется / входит (evidence: `README.md`)
- Пользователь → Недельный ввод: вводит занятость (evidence: `README.md`)
- Недельный ввод → Панель учёта: показывает (evidence: `README.md`)
- Недельный ввод → Записи недели: сохраняет записи (evidence: `app.py`)
- Записи недели → Модели предметной области: использует модели (evidence: `app.py`)
- Сводка факт/план → Модели предметной области: читает записи (evidence: `app.py`)
- Сводка факт/план → Шаблон сводки: рендерит (evidence: `app.py`)
- Месячный отчёт → Шаблон месяца: рендерит (evidence: `app.py`)
- Экспорт XLSX → Месячный отчёт: вызывает расчёт (evidence: `app.py`)
- Экспорт XLSX → Модели предметной области: читает данные (evidence: `app.py`)
- Пользователь → Сводка факт/план: просматривает (evidence: `README.md`)
- Пользователь → Месячный отчёт: просматривает (evidence: `README.md`)
- Пользователь → Экспорт XLSX: выгружает отчёт (evidence: `app.py`)
- Управление людьми → Модели предметной области: изменяет пользователей (evidence: `app.py`)
- Управление проектами → Модели предметной области: изменяет проекты (evidence: `app.py`)
- Управление группами → Модели предметной области: изменяет группы (evidence: `app.py`)
- Управление участниками → Модели предметной области: добавляет участников (evidence: `app.py`)
- Модели предметной области → Реляционная БД: хранит данные (evidence: `models.py`)
