chore: initial import of CoHaiSe Cloud
PR — Ouverture automatique / create-pr (push) Failing after 1s

Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs.

Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
This commit is contained in:
2026-10-14 15:24:06 +02:00
commit cc397e96d8
113 changed files with 12678 additions and 0 deletions
+93
View File
@@ -0,0 +1,93 @@
# Workflow — CoHaiSe Cloud
## Boucle de développement
```sh
make dev # Vite sur http://localhost:5174, proxy /api → 127.0.0.1:3101
```
Le front tourne hors Docker ; l'API et la base doivent être levées :
```sh
make up # db + migrate + api (+ nginx si besoin)
```
Le proxy `vite.config.ts` envoie `/api` vers `3101`, donc les appels
`fetch('/api/cloud/…')` du code source fonctionnent à l'identique en dev et en
prod.
## Vérification
```sh
make check # npm run typecheck puis npm run build
curl -I http://localhost:8083/healthz
curl -s http://localhost:3101/healthz
```
Il n'y a **ni linter, ni framework de test, ni CI** : `typecheck` + `build`
sont les seules garanties automatiques. `.editorconfig` porte les conventions.
Après un changement de `docker/nginx/cloud.conf` : l'image doit être
reconstruite (`docker compose build nginx && docker compose up -d nginx`) — le
fichier est copié dans l'image, pas monté.
## Modifier une route
1. Schéma d'entrée : Zod dans `backend/cloud/src/routes/<entity>.ts`.
2. Droits : passer par `backend/cloud/src/access.ts` (jamais par un paramètre
venu du client).
3. Réponse : renvoyer **404** si la ressource n'est pas censée exister pour ce
compte, 403 seulement pour une règle explicite.
4. Erreur métier : `AppError` depuis `backend/shared/src/errors.ts`.
5. Audit si l'action est sensible (`audit()` dans `access.ts`).
6. `make check`, puis redémarrage de l'API (`docker compose up -d api`).
## Modifier le schéma
1. Écrire `backend/cloud/migrations/00N_….sql` (número suivant, jamais éditer
un fichier déjà appliqué).
2. Vérifier : `docker compose run --rm migrate node dist/cli.js --dir /migrations --check`
3. Appliquer : `make migrate` ou redémarrage de l'API.
4. Décrire la migration dans `docs/api.md` (tableau des migrations).
Le DDL MariaDB n'est pas transactionnel : une migration interrompue peut
laisser la base à moitié migrée. Dans ce cas, corriger par une **nouvelle**
migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
## Modifier le design system
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
- `tokens.css` porte les couleurs et typographies ; ne pas en coder ailleurs.
- Après modification : `npm run build --workspace=frontend/shared && make front`.
## Où changer quoi
| Besoin | Fichier |
| --- | --- |
| Droit d'accès à un dossier/fichier | `backend/cloud/src/access.ts` |
| Taille/quota par défaut | migration `004`, table `users` / `settings` |
| Chemin physique des fichiers | `backend/cloud/src/storage.ts` |
| En-têtes, CORS, healthz | `backend/shared/src/http.ts` |
| Durée de session | `SESSION_TTL_HOURS` |
| Port | `COHAISE_HTTP_PORT` (nginx), `COHAISE_API_PORT` (API) |
| Interface (parcours dossiers) | `frontend/cloud/src/pages/Browser.tsx` |
| Routes et gardes du front | `frontend/cloud/src/App.tsx` |
| Couleurs / composants | `frontend/shared/src/styles/tokens.css` |
## Git
- Branche `main`, remote `origin https://git.cohaise.dev/Esiah/CoHaiSe-CLOUD.git`.
- **Aucun commit pour l'instant** : l'historique est vierge.
- `.gitignore` exclut `.env`, `.env.*` (sauf `.env.example`), `backups/`,
`node_modules/`, `dist/`, `*.tsbuildinfo`.
## Pièges connus
1. **`.env` local désynchronisé** de `.env.example` : les clés `COHAISE_*`
manquantes basculent silencieusement sur les défauts compose.
2. **README de paquet** (`docker/README.md`, `backend/cloud/README.md`) : états
antérieurs du dépôt. Se fier à ce dossier `docs/`.
3. **Limitation de débit active** (applicatif + nginx) : une rafale peut renvoyer
`419`/`503`.
4. **CSP stricte** : aucun script inline dans `index.html` (voir `public/theme.js`).