chore: initial import of CoHaiSe Cloud
PR — Ouverture automatique / create-pr (push) Failing after 1s
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:
@@ -0,0 +1,90 @@
|
||||
# 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/shared design system (@cohaise/ui) — copie propre à cette app
|
||||
frontend/cloud application React + Vite
|
||||
backend/shared couche serveur (@cohaise/server) : config, base, sessions
|
||||
backend/cloud API : auth, dossiers, fichiers
|
||||
docker/ images nginx et API
|
||||
```
|
||||
|
||||
Les paquets `shared` (design system et couche serveur) vivent dans ce dépôt et en
|
||||
suivent le cycle de vie : un correctif ici n'a pas à être répliqué ailleurs.
|
||||
|
||||
## 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
|
||||
```
|
||||
Reference in New Issue
Block a user