# didierherlin/deploiement-front-back-ci-cd architecture

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

- Interactive diagram: https://gitdiagram.com/didierherlin/deploiement-front-back-ci-cd
- Repository: https://github.com/didierherlin/deploiement-front-back-ci-cd

## Overview

This is a real-estate management product: users work through role-specific Next.js spaces to browse properties and manage reservations, leases, payments, profiles, notifications, and reporting. The backend provides Django REST endpoints and domain logic; PostgreSQL persists application state. The graph preserves the major frontend and backend domain stages, plus contract/payment automation and notification services. Some subsystems are represented from the file tree and README rather than sampled implementation; those uncertain connections are omitted.

Main entry points: [`Front/lib/api.ts`](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/api.ts) (API client), [`Back-end/configuration/paiement/signals.py`](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/paiement/signals.py) (Payment schedules and status), [`Back-end/configuration/urls.py`](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/urls.py) (Django REST API), [`Back-end/configuration/contrats/signals.py`](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/contrats/signals.py) (Contract status sync)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_role_spaces["Role-based spaces"]
  node_owner_dashboard["Owner dashboard"]
end

subgraph group_access["API access"]
  node_api_client["API client<br/>[api.ts]"]
  node_auth["Token and session auth<br/>[auth.ts]"]
  node_api_config["API URL configuration<br/>[config.ts]"]
end

subgraph group_domain["Rental domains"]
  node_django_api["Django REST API<br/>[urls.py]"]
  node_accounts["Users and profiles<br/>[models.py]"]
  node_properties["Properties<br/>[models.py]"]
  node_reservations["Reservations"]
  node_contracts["Contracts<br/>[models.py]"]
  node_payments["Payments<br/>[models.py]"]
  node_notifications["Notifications<br/>[models.py]"]
end

subgraph group_automation["Domain automation"]
  node_contract_automation["Contract status sync<br/>[signals.py]"]
  node_payment_automation["Payment schedules and status<br/>[signals.py]"]
  node_notification_service["Notification delivery<br/>[services.py]"]
  node_pdf_utils["PDF and money utilities<br/>[utils.py]"]
end

node_users(("Tenants, owners, staff"))
node_postgres[("PostgreSQL")]

node_users -->|"use"| node_role_spaces
node_role_spaces -->|"accesses"| node_django_api
node_owner_dashboard -->|"requests profile and stats"| node_api_client
node_api_client -->|"sends API requests"| node_django_api
node_api_client -->|"refreshes tokens"| node_auth
node_api_client -->|"gets API URL"| node_api_config
node_auth -->|"gets API URL"| node_api_config
node_django_api -->|"persists domain data"| node_postgres
node_contract_automation -->|"observes saves and deletes"| node_contracts
node_contract_automation -->|"updates status"| node_properties
node_payment_automation -->|"builds schedules from"| node_contracts
node_payment_automation -->|"creates and updates"| node_payments
node_payment_automation -->|"updates status"| node_properties
node_notification_service -->|"creates notifications"| node_notifications
node_notification_service -->|"formats amounts"| node_pdf_utils

click node_role_spaces "https://github.com/didierherlin/deploiement-front-back-ci-cd/tree/main/Front/app"
click node_owner_dashboard "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/proprietaire/views/ProprietaireDashboard.tsx"
click node_api_client "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/api.ts"
click node_auth "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/auth.ts"
click node_api_config "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/config.ts"
click node_django_api "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/urls.py"
click node_accounts "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/utilisateur/models.py"
click node_properties "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/bien/models.py"
click node_reservations "https://github.com/didierherlin/deploiement-front-back-ci-cd/tree/main/Back-end/configuration/reservation"
click node_contracts "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/contrats/models.py"
click node_payments "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/paiement/models.py"
click node_notifications "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/notifications/models.py"
click node_contract_automation "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/contrats/signals.py"
click node_payment_automation "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/paiement/signals.py"
click node_notification_service "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/notifications/services.py"
click node_pdf_utils "https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/common/utils.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_role_spaces,node_owner_dashboard toneBlue
class node_api_client,node_auth,node_api_config,node_postgres toneAmber
class node_django_api,node_accounts,node_properties,node_reservations,node_contracts,node_payments,node_notifications toneMint
class node_contract_automation,node_payment_automation,node_notification_service,node_pdf_utils toneRose
class node_users toneIndigo
```

## Components

### Web application

- [Role-based spaces](https://github.com/didierherlin/deploiement-front-back-ci-cd/tree/main/Front/app): `Front/app`
- [Owner dashboard](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/proprietaire/views/ProprietaireDashboard.tsx): `Front/proprietaire/views/ProprietaireDashboard.tsx`

### API access

- [API client](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/api.ts): `Front/lib/api.ts`
- [Token and session auth](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/auth.ts): `Front/lib/auth.ts`
- [API URL configuration](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Front/lib/config.ts): `Front/lib/config.ts`

### Rental domains

- [Django REST API](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/urls.py): `Back-end/configuration/urls.py`
- [Users and profiles](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/utilisateur/models.py): `Back-end/configuration/utilisateur/models.py`
- [Properties](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/bien/models.py): `Back-end/configuration/bien/models.py`
- [Reservations](https://github.com/didierherlin/deploiement-front-back-ci-cd/tree/main/Back-end/configuration/reservation): `Back-end/configuration/reservation`
- [Contracts](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/contrats/models.py): `Back-end/configuration/contrats/models.py`
- [Payments](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/paiement/models.py): `Back-end/configuration/paiement/models.py`
- [Notifications](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/notifications/models.py): `Back-end/configuration/notifications/models.py`

### Domain automation

- [Contract status sync](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/contrats/signals.py): `Back-end/configuration/contrats/signals.py`
- [Payment schedules and status](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/paiement/signals.py): `Back-end/configuration/paiement/signals.py`
- [Notification delivery](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/notifications/services.py): `Back-end/configuration/notifications/services.py`
- [PDF and money utilities](https://github.com/didierherlin/deploiement-front-back-ci-cd/blob/main/Back-end/configuration/common/utils.py): `Back-end/configuration/common/utils.py`

### Other components

- **Tenants, owners, staff**
- **PostgreSQL**

## Connections

- Tenants, owners, staff → Role-based spaces: use (evidence: `README.md`)
- Role-based spaces → Django REST API: accesses (evidence: `README.md`)
- Owner dashboard → API client: requests profile and stats (evidence: `Front/proprietaire/views/ProprietaireDashboard.tsx`)
- API client → Django REST API: sends API requests (evidence: `README.md`)
- API client → Token and session auth: refreshes tokens (evidence: `Front/lib/api.ts`)
- API client → API URL configuration: gets API URL (evidence: `Front/lib/api.ts`)
- Token and session auth → API URL configuration: gets API URL (evidence: `Front/lib/auth.ts`)
- Django REST API → PostgreSQL: persists domain data (evidence: `README.md`)
- Contract status sync → Contracts: observes saves and deletes (evidence: `Back-end/configuration/contrats/signals.py`)
- Contract status sync → Properties: updates status (evidence: `Back-end/configuration/contrats/signals.py`)
- Payment schedules and status → Contracts: builds schedules from (evidence: `Back-end/configuration/paiement/signals.py`)
- Payment schedules and status → Payments: creates and updates (evidence: `Back-end/configuration/paiement/signals.py`)
- Payment schedules and status → Properties: updates status (evidence: `Back-end/configuration/paiement/signals.py`)
- Notification delivery → Notifications: creates notifications (evidence: `Back-end/configuration/notifications/services.py`)
- Notification delivery → PDF and money utilities: formats amounts (evidence: `Back-end/configuration/notifications/services.py`)
