# onsjannet/tim_project architecture

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

- Interactive diagram: https://gitdiagram.com/onsjannet/tim_project
- Repository: https://github.com/onsjannet/tim_project

## Overview

TIM is a Flask-based ERP for handling business data. A user enters through the web application and authenticated routes; the product exposes operational and financial analysis screens that use MongoDB-backed business records. The graph separates authentication, operational inputs, financial analysis, and persistence. The README gives only a brief product description, and source excerpts are incomplete, so edges are limited to registrations, calls, and database interactions visible in the supplied evidence.

Main entry points: [`TIM_Flask/app.py`](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/app.py) (Flask application), [`TIM_Flask/services/mongodb_interactions.py`](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/services/mongodb_interactions.py) (Mongo interactions), [`TIM_Flask/Bleuprints/auth.py`](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/auth.py) (Authentication), [`TIM_Flask/Bleuprints/turnoverservices.py`](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/turnoverservices.py) (Service turnover)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application and access"]
  node_flask["Flask application<br/>[app.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_user_model["User model<br/>[user.py]"]
  node_email["Email service"]
end

subgraph group_operations["Business operations"]
  node_operations_inputs["Operations inputs"]
  node_vehicle_parc["Vehicle parc<br/>[vehicleparc.py]"]
  node_turnover_services["Service turnover"]
end

subgraph group_finance["Financial analysis"]
  node_activity_analysis["Activity analysis"]
  node_activity_contribution["Activity contribution"]
  node_short_calculation["Short calculations"]
  node_financial_reports["Financial reports"]
  node_sales_salaries["Sales and salaries<br/>[salaries.py]"]
end

subgraph group_storage["Persistence"]
  node_db_routes["Database routes<br/>[db_routes.py]"]
  node_mongo_service["Mongo interactions"]
  node_base_model["Base model<br/>[base_model.py]"]
  node_mongo[("MongoDB")]
end

node_user(("ERP user"))

node_user -.->|"uses"| node_flask
node_flask -->|"registers routes"| node_auth
node_flask -->|"registers routes"| node_vehicle_parc
node_flask -->|"registers routes"| node_activity_analysis
node_flask -->|"registers routes"| node_activity_contribution
node_flask -->|"registers routes"| node_short_calculation
node_flask -->|"registers routes"| node_sales_salaries
node_flask -->|"registers routes"| node_turnover_services
node_flask -->|"registers routes"| node_financial_reports
node_flask -->|"registers routes"| node_db_routes
node_auth -->|"creates users"| node_user_model
node_auth -->|"sends messages"| node_email
node_auth -.->|"reads and writes"| node_mongo
node_user_model -->|"inherits from"| node_base_model
node_base_model -->|"delegates persistence"| node_mongo_service
node_mongo_service -->|"uses database accessor"| node_db_routes
node_db_routes -->|"connects to"| node_mongo
node_activity_analysis -->|"imports helpers"| node_mongo_service
node_activity_contribution -.->|"imports helpers"| node_mongo_service
node_short_calculation -.->|"imports helpers"| node_mongo_service
node_turnover_services -->|"converts form data"| node_mongo_service
node_turnover_services -.->|"reads records"| node_mongo
node_activity_contribution -->|"uses selling inputs"| node_sales_salaries

click node_flask "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/app.py"
click node_auth "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/auth.py"
click node_user_model "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/models/user.py"
click node_email "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/services/emails_credencials.py"
click node_operations_inputs "https://github.com/onsjannet/tim_project/tree/main/TIM_Flask/Bleuprints"
click node_vehicle_parc "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/vehicleparc.py"
click node_turnover_services "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/turnoverservices.py"
click node_activity_analysis "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/activityanalysis.py"
click node_activity_contribution "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/activitycontribution.py"
click node_short_calculation "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/calculationshort.py"
click node_financial_reports "https://github.com/onsjannet/tim_project/tree/main/TIM_Flask/Bleuprints"
click node_sales_salaries "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/salaries.py"
click node_db_routes "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/db_routes.py"
click node_mongo_service "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/services/mongodb_interactions.py"
click node_base_model "https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/models/base_model.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_flask,node_auth,node_user_model,node_email,node_user toneBlue
class node_operations_inputs,node_vehicle_parc,node_turnover_services toneAmber
class node_activity_analysis,node_activity_contribution,node_short_calculation,node_financial_reports,node_sales_salaries toneMint
class node_db_routes,node_mongo_service,node_base_model,node_mongo toneRose
```

## Components

### Application and access

- [Flask application](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/app.py): `TIM_Flask/app.py`
- [Authentication](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/auth.py): `TIM_Flask/Bleuprints/auth.py`
- [User model](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/models/user.py): `TIM_Flask/models/user.py`
- [Email service](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/services/emails_credencials.py): `TIM_Flask/services/emails_credencials.py`

### Business operations

- [Operations inputs](https://github.com/onsjannet/tim_project/tree/main/TIM_Flask/Bleuprints): `TIM_Flask/Bleuprints`
- [Vehicle parc](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/vehicleparc.py): `TIM_Flask/Bleuprints/vehicleparc.py`
- [Service turnover](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/turnoverservices.py): `TIM_Flask/Bleuprints/turnoverservices.py`

### Financial analysis

- [Activity analysis](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/activityanalysis.py): `TIM_Flask/Bleuprints/activityanalysis.py`
- [Activity contribution](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/activitycontribution.py): `TIM_Flask/Bleuprints/activitycontribution.py`
- [Short calculations](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/calculationshort.py): `TIM_Flask/Bleuprints/calculationshort.py`
- [Financial reports](https://github.com/onsjannet/tim_project/tree/main/TIM_Flask/Bleuprints): `TIM_Flask/Bleuprints`
- [Sales and salaries](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/salaries.py): `TIM_Flask/Bleuprints/salaries.py`

### Persistence

- [Database routes](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/Bleuprints/db_routes.py): `TIM_Flask/Bleuprints/db_routes.py`
- [Mongo interactions](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/services/mongodb_interactions.py): `TIM_Flask/services/mongodb_interactions.py`
- [Base model](https://github.com/onsjannet/tim_project/blob/main/TIM_Flask/models/base_model.py): `TIM_Flask/models/base_model.py`
- **MongoDB**

### Other components

- **ERP user**

## Connections

- ERP user → Flask application: uses
- Flask application → Authentication: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Vehicle parc: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Activity analysis: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Activity contribution: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Short calculations: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Sales and salaries: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Service turnover: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Financial reports: registers routes (evidence: `TIM_Flask/app.py`)
- Flask application → Database routes: registers routes (evidence: `TIM_Flask/app.py`)
- Authentication → User model: creates users (evidence: `TIM_Flask/Bleuprints/auth.py`)
- Authentication → Email service: sends messages (evidence: `TIM_Flask/Bleuprints/auth.py`)
- Authentication → MongoDB: reads and writes
- User model → Base model: inherits from (evidence: `TIM_Flask/models/user.py`)
- Base model → Mongo interactions: delegates persistence (evidence: `TIM_Flask/models/base_model.py`)
- Mongo interactions → Database routes: uses database accessor (evidence: `TIM_Flask/services/mongodb_interactions.py`)
- Database routes → MongoDB: connects to (evidence: `TIM_Flask/Bleuprints/db_routes.py`)
- Activity analysis → Mongo interactions: imports helpers (evidence: `TIM_Flask/Bleuprints/activityanalysis.py`)
- Activity contribution → Mongo interactions: imports helpers (evidence: `TIM_Flask/Bleuprints/activitycontribution.py`)
- Short calculations → Mongo interactions: imports helpers (evidence: `TIM_Flask/Bleuprints/calculationshort.py`)
- Service turnover → Mongo interactions: converts form data (evidence: `TIM_Flask/Bleuprints/turnoverservices.py`)
- Service turnover → MongoDB: reads records
- Activity contribution → Sales and salaries: uses selling inputs (evidence: `TIM_Flask/Bleuprints/activitycontribution.py`)
