# nunesdanielpt/claquete architecture

> Architecture diagram of the GitHub repository nunesdanielpt/claquete, 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/nunesdanielpt/claquete
- Repository: https://github.com/nunesdanielpt/claquete

## Overview

Claquete is a multi-user organizer for audiovisual freelancers, not an invoicing issuer. The main workflow is to maintain clients, schedule events, track invoice and payment status, review tax/statistics, and export summaries. The application also provides chat, freelancer discovery, support, announcements, and administration. The sampled backend is a large monolith; README statements establish several capabilities whose individual handlers were not excerpted, so those relationships are documented rather than inferred from module names.

Main entry points: [`app.js`](https://github.com/nunesdanielpt/claquete/blob/main/app.js) (Web interface), [`app.py`](https://github.com/nunesdanielpt/claquete/blob/main/app.py) (Chat and presence), [`mailer.py`](https://github.com/nunesdanielpt/claquete/blob/main/mailer.py) (Invoice email), [`people.py`](https://github.com/nunesdanielpt/claquete/blob/main/people.py) (AV freelancer network)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Work management"]
  node_web["Web interface<br/>[app.js]"]
  node_clients["Client records<br/>[app.py]"]
  node_events["Event planner<br/>[app.py]"]
  node_invoice["Invoice tracking<br/>[app.py]"]
  node_tax["Tax settings<br/>[app.py]"]
  node_mailer["Invoice email<br/>[mailer.py]"]
end

subgraph group_insight["Reports and exports"]
  node_stats["Statistics<br/>[app.py]"]
  node_export["PDF and Excel<br/>[export.py]"]
end

subgraph group_community["Communication and network"]
  node_chat["Chat and presence<br/>[app.py]"]
  node_chat_ui["Chat interface<br/>[app.js]"]
  node_websocket["WebSocket hub<br/>[ws.py]"]
  node_people["AV freelancer network<br/>[people.py]"]
  node_support["Support conversations<br/>[app.py]"]
end

subgraph group_platform["Accounts and platform"]
  node_database[("SQLite data<br/>[app.py]")]
  node_accounts["Accounts and admin<br/>[app.py]"]
  node_announcements["Announcements<br/>[app.py]"]
  node_translations["Translations<br/>[i18n.py]"]
  node_guide["Product guide<br/>[guide.py]"]
end

node_user(("Freelancer"))
node_smtp["SMTP service"]

node_user -->|"uses"| node_web
node_web -->|"manages"| node_clients
node_web -->|"schedules"| node_events
node_web -->|"tracks status"| node_invoice
node_events -->|"references"| node_clients
node_web -->|"sets defaults"| node_tax
node_web -->|"views"| node_stats
node_stats -->|"exports"| node_export
node_web -->|"opens chat"| node_chat_ui
node_chat_ui -->|"polls and sends"| node_chat
node_chat -->|"dispatches messages"| node_websocket
node_chat -->|"stores messages"| node_database
node_web -->|"searches profiles"| node_people
node_people -->|"routes messages"| node_chat
node_web -->|"opens conversations"| node_support
node_support -.->|"emails updates"| node_smtp
node_invoice -->|"sends invoice"| node_mailer
node_mailer -->|"sends email"| node_smtp
node_web -->|"administers"| node_accounts
node_accounts -->|"publishes"| node_announcements
node_web -->|"translates pages"| node_translations
node_web -->|"serves guide"| node_guide
node_web -->|"reads and writes"| node_database
node_web -->|"shows updates"| node_announcements

click node_web "https://github.com/nunesdanielpt/claquete/blob/main/app.js"
click node_clients "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_events "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_invoice "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_tax "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_stats "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_export "https://github.com/nunesdanielpt/claquete/blob/main/export.py"
click node_database "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_chat "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_chat_ui "https://github.com/nunesdanielpt/claquete/blob/main/app.js"
click node_websocket "https://github.com/nunesdanielpt/claquete/blob/main/ws.py"
click node_people "https://github.com/nunesdanielpt/claquete/blob/main/people.py"
click node_support "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_mailer "https://github.com/nunesdanielpt/claquete/blob/main/mailer.py"
click node_accounts "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_announcements "https://github.com/nunesdanielpt/claquete/blob/main/app.py"
click node_translations "https://github.com/nunesdanielpt/claquete/blob/main/i18n.py"
click node_guide "https://github.com/nunesdanielpt/claquete/blob/main/guide.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_web,node_clients,node_events,node_invoice,node_tax,node_mailer toneBlue
class node_stats,node_export toneAmber
class node_chat,node_chat_ui,node_websocket,node_people,node_support toneMint
class node_database,node_accounts,node_announcements,node_translations,node_guide toneRose
class node_user,node_smtp toneIndigo
```

## Components

### Work management

- [Web interface](https://github.com/nunesdanielpt/claquete/blob/main/app.js): `app.js`
- [Client records](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Event planner](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Invoice tracking](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Tax settings](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Invoice email](https://github.com/nunesdanielpt/claquete/blob/main/mailer.py): `mailer.py`

### Reports and exports

- [Statistics](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [PDF and Excel](https://github.com/nunesdanielpt/claquete/blob/main/export.py): `export.py`

### Communication and network

- [Chat and presence](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Chat interface](https://github.com/nunesdanielpt/claquete/blob/main/app.js): `app.js`
- [WebSocket hub](https://github.com/nunesdanielpt/claquete/blob/main/ws.py): `ws.py`
- [AV freelancer network](https://github.com/nunesdanielpt/claquete/blob/main/people.py): `people.py`
- [Support conversations](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`

### Accounts and platform

- [SQLite data](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Accounts and admin](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Announcements](https://github.com/nunesdanielpt/claquete/blob/main/app.py): `app.py`
- [Translations](https://github.com/nunesdanielpt/claquete/blob/main/i18n.py): `i18n.py`
- [Product guide](https://github.com/nunesdanielpt/claquete/blob/main/guide.py): `guide.py`

### Other components

- **Freelancer**
- **SMTP service**

## Connections

- Freelancer → Web interface: uses (evidence: `README.md`)
- Web interface → Client records: manages (evidence: `README.md`)
- Web interface → Event planner: schedules (evidence: `README.md`)
- Web interface → Invoice tracking: tracks status (evidence: `README.md`)
- Event planner → Client records: references (evidence: `README.md`)
- Web interface → Tax settings: sets defaults (evidence: `README.md`)
- Web interface → Statistics: views (evidence: `README.md`)
- Statistics → PDF and Excel: exports (evidence: `README.md`)
- Web interface → Chat interface: opens chat (evidence: `README.md`)
- Chat interface → Chat and presence: polls and sends (evidence: `app.js`)
- Chat and presence → WebSocket hub: dispatches messages (evidence: `app.py`)
- Chat and presence → SQLite data: stores messages (evidence: `README.md`)
- Web interface → AV freelancer network: searches profiles (evidence: `README.md`)
- AV freelancer network → Chat and presence: routes messages (evidence: `README.md`)
- Web interface → Support conversations: opens conversations (evidence: `README.md`)
- Support conversations → SMTP service: emails updates (evidence: `README.md`)
- Invoice tracking → Invoice email: sends invoice (evidence: `README.md`)
- Invoice email → SMTP service: sends email (evidence: `mailer.py`)
- Web interface → Accounts and admin: administers (evidence: `README.md`)
- Accounts and admin → Announcements: publishes (evidence: `README.md`)
- Web interface → Translations: translates pages
- Web interface → Product guide: serves guide
- Web interface → SQLite data: reads and writes (evidence: `app.py`)
- Web interface → Announcements: shows updates (evidence: `README.md`)
