53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# Règles — Architecture (Pena-tauri)
|
|
|
|
## Principe
|
|
|
|
L'architecture est **Clean Architecture**. Toute nouvelle fonctionnalité doit respecter ce découpage sans exception.
|
|
|
|
## Structure Rust (`src-tauri/src/`)
|
|
|
|
```
|
|
domain/ — entités et traits purs, zéro dépendance externe
|
|
application/ — services métier, dépend uniquement de domain/
|
|
infrastructure/ — implémentations concrètes des traits de domain/
|
|
commands/ — points d'entrée Tauri (#[tauri::command]), orchestrent application/
|
|
```
|
|
|
|
## Structure JS (`src/`)
|
|
|
|
```
|
|
services/ — appels Tauri (invoke), logique de données
|
|
state/ — état global de l'application
|
|
ui/ — composants d'affichage, sans logique métier
|
|
```
|
|
|
|
## Règles de dépendance
|
|
|
|
| Couche | Peut dépendre de | Ne peut PAS dépendre de |
|
|
|---|---|---|
|
|
| `domain` | rien | `application`, `infrastructure`, `commands` |
|
|
| `application` | `domain` | `infrastructure`, `commands` |
|
|
| `infrastructure` | `domain` | `application`, `commands` |
|
|
| `commands` | `application`, `domain` | `infrastructure` directement |
|
|
| `ui/` (JS) | `services/`, `state/` | rien d'externe hors Tauri |
|
|
| `services/` (JS) | invoke Tauri | `ui/` |
|
|
|
|
## Ce qui est interdit
|
|
|
|
- Instancier une implémentation concrète (`ComrakRenderer`, `FileRepository`, etc.) depuis `application/` ou `commands/` — passer par injection de dépendance ou par le point d'assemblage (`lib.rs`).
|
|
- Mettre de la logique métier dans `commands/` ou `ui/`.
|
|
- Mettre des appels Tauri (`invoke`) dans `ui/` — les déléguer à `services/`.
|
|
- Créer un module hors de ces quatre couches Rust sans justification explicite.
|
|
|
|
## Point d'assemblage
|
|
|
|
`lib.rs` est le seul endroit où les implémentations concrètes sont instanciées et câblées aux services.
|
|
|
|
## Nouveau code
|
|
|
|
Avant d'ajouter un fichier, se poser la question : **dans quelle couche appartient cette responsabilité ?**
|
|
- Règle métier / contrat → `domain/`
|
|
- Orchestration d'un cas d'usage → `application/`
|
|
- Accès I/O, filesystem, bibliothèque tierce → `infrastructure/`
|
|
- Commande exposée à Tauri → `commands/`
|