Files
CoHaiSe-CLOUD/README.md
T
Gitea ActionsandEsiah 9dd1ad72e0
CD — Déploiement / deploy (push) Failing after 25s
feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres (#4)
- logo embarque dans les e-mails (CID) et gabarit repense en mode sombre
- favicon multi-tailles + icone PNG, logo a gauche du titre (app et auth)
- modale de confirmation animee a la place de window.confirm
- bouton retour et fil d'ariane dans l'explorateur

---------

Co-authored-by: xEsiah <[email protected]>
Reviewed-on: #4
Reviewed-by: Esiah <[email protected]>
Co-authored-by: Gitea Actions <-[email protected]>
2026-10-16 11:08:47 +00:00

90 lines
3.1 KiB
Markdown

# CoHaiSe Cloud
Fichiers et médias : arborescence de dossiers, envoi, téléchargement.
Application autonome — front **et** back dans ce dépôt.
## Structure
```
frontend application React + Vite, design system inclus (src/ui, src/styles)
backend API : socle serveur (src/lib), auth, dossiers, fichiers, médias
docker/ images nginx et API
```
Chaque application porte son propre code : le socle serveur (`backend/src/lib`)
et le design system (`frontend/src/ui`) appartiennent au Cloud et ne sont
partagés avec aucun autre dépôt.
## Démarrer
```bash
cp .env.example .env # puis renseigner les mots de passe et SESSION_SECRET
make up # front + API + base, migrations comprises
make front # reconstruire et publier le front
```
L'app répond sur **`http://localhost:8083`** (variable `COHAISE_HTTP_PORT`).
| Variable | Rôle | Défaut |
|---|---|---|
| `COHAISE_HTTP_PORT` | port nginx côté machine hôte | `8083` |
| `COHAISE_API_PORT` | port de l'API | `3101` |
| `COHAISE_DB_PORT` | port MariaDB | `3407` |
| `CLOUD_DB_USER` / `CLOUD_DB_PASSWORD` | identifiants base | — |
| `CLOUD_DB_ROOT_PASSWORD` | root, pour la sauvegarde | — |
| `SESSION_SECRET` | signature des sessions, obligatoire | — |
Le démarrage échoue avec la liste exacte des variables manquantes ou mal formées,
avant l'ouverture d'aucun port. C'est voulu.
## Commandes
```bash
make help # liste complète
make ps # état des conteneurs
make logs # journaux
make front # reconstruire et publier le front
make migrate # appliquer les migrations SQL explicitement
make backup # dump horodaté dans ./backups
make admin ARGS=... # créer ou réinitialiser un compte
make dev # Vite sur 5174, API sur 3101, sans Docker
make check # typecheck + build
```
### Comptes
Le premier compte se crée par CLI, jamais par une route publique :
```bash
make admin ARGS="--email [email protected] --first Jean --last Dupont"
make admin ARGS="--email [email protected] --reset"
```
Les mots de passe sont lus par le conteneur lui-même : ils ne transitent ni par la
ligne de commande ni par le dépôt.
## Migrations
Les fichiers sont numérotés et appliqués dans l'ordre. Une migration déjà appliquée
ne se modifie jamais : une correction passe par un nouveau fichier.
| Fichier | Contenu |
|---|---|
| `000_schema_migrations.sql` | table de suivi des versions |
| `001_initial_schema.sql` | schéma initial |
| `002_reference_data.sql` | rôles, étapes, pays, réglages |
| `003_integrity_backstop.sql` | clé étrangère `users.role_id`, `CHECK` d'intégrité |
| `004_cloud_requirements.sql` | exigences du Cloud |
| `005_storage_location_realign.sql` | emplacement physique des fichiers |
Au démarrage, `runMigrations()` ne joue que les migrations manquantes, et
`assertNoDrift()` refuse de servir si un fichier déjà appliqué a été modifié entre
temps : une base non maîtrisée rend l'API inaccessible plutôt que de renvoyer des
erreurs 500.
## Tests
```bash
make check # types + build
```