> ## Documentation Index
> Fetch the complete documentation index at: https://docs.models.dunsky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Comprendre l’architecture

> Découvrez comment développer et maintenir la plateforme Dunsky : comprendre l’architecture. Guide fondé sur le dépôt core-app.

core-app est un monorepo composé de deux paquets. Son interface React appelle un backend FastAPI qui coordonne les données applicatives, les requêtes des tableaux de bord, les exécutions et les résultats.

| Composant | Responsabilité |
| - | - |
| `src/platform` | Interface React, TypeScript, Vite, Mantine et Plotly |
| `src/api` | Routes FastAPI, validation Pydantic et services |
| PostgreSQL / Lakebase | Schémas applicatifs, tenancy et mesures |
| Databricks | Requêtes SQL et calculs lourds ou planifiés |
| Models API | Service d’exécution utilisé par l’application |
| Azure Blob Storage | Fichiers d’entrée et de sortie |
| Redis | Cache et verrous distribués |
| nginx | Distribution du frontend compilé et relais API |

## Organisation du code

Le backend se trouve dans `src/api/src/core` : `routes`, `services`, `clients`, `db`, `auth`, `runners` et `formula_engine`. Le frontend, dans `src/platform/src`, comprend `pages`, `components`, `clients`, `contexts`, `hooks` et `config`.

## Répartition du calcul

Les opérations liées aux requêtes passent par FastAPI et ses services. Les calculs lourds ou planifiés sont exécutés dans Databricks. Redis ne sert pas de file de tâches et aucun worker Celery n’est à démarrer.

FastAPI démarre une boucle de réconciliation dans son cycle de vie. Les ressources applicatives sont montées sous `/rest/v1`; `/health` est distinct.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.