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
+9
View File
@@ -0,0 +1,9 @@
FROM nginx:1.27-alpine
RUN rm -f /etc/nginx/conf.d/default.conf \
&& mkdir -p /usr/share/nginx/html
COPY docker/nginx/cloud.conf /etc/nginx/conf.d/app.conf
COPY docker/nginx/snippets /etc/nginx/snippets
EXPOSE 80
+39
View File
@@ -0,0 +1,39 @@
# Image des services API Node du Cloud. APP_DIR choisit le paquet a construire
# (API ou CLI de migration) ; les deux partagent la meme methode de build.
FROM node:22-alpine AS builder
ARG APP_DIR
WORKDIR /repo
COPY package.json package-lock.json tsconfig.json tsconfig.base.json ./
COPY backend ./backend
RUN --mount=type=cache,target=/root/.npm npm ci
RUN npm run build --workspace=backend/shared
RUN npm run build --workspace=${APP_DIR}
# On ne embarque pas les devDependencies dans l'image de production.
RUN npm prune --omit=dev && npm cache clean --force
FROM node:22-alpine AS export
ARG APP_DIR
ENV NODE_ENV=production
WORKDIR /repo
COPY --from=builder /repo/package.json ./package.json
COPY --from=builder /repo/package-lock.json ./package-lock.json
COPY --from=builder /repo/node_modules ./node_modules
# backend/shared est le paquet @cohaise/server : les liens de workspace
# de node_modules pointent dessus, il doit donc voyager avec l'application.
COPY --from=builder /repo/backend/shared ./backend/shared
COPY --from=builder /repo/${APP_DIR} ./${APP_DIR}
WORKDIR /repo/${APP_DIR}
EXPOSE 8080
CMD ["node", "dist/index.js"]
+18
View File
@@ -0,0 +1,18 @@
FROM node:22-alpine AS builder
WORKDIR /repo
ARG APP_DIR
COPY package.json package-lock.json tsconfig.json tsconfig.base.json ./
COPY frontend ./frontend
RUN --mount=type=cache,target=/root/.npm npm ci
RUN npm run build --workspace=frontend/shared
RUN npm run build --workspace=${APP_DIR}
FROM alpine:3.21 AS export
ARG APP_DIR
COPY --from=builder /repo/${APP_DIR}/dist /app/dist
+102
View File
@@ -0,0 +1,102 @@
# docker/ — images du Cloud
Tout ce qui touche aux images : build du front, image nginx, image API,
configuration et publication. Ce dépôt en fabrique **quatre** (nginx, front,
API, CLI de migration), d'où ce dossier dédié plutôt que des `Dockerfile` à la
racine.
Fonctionnement du service (ordre `db → migrate → api`, ports, healthchecks) :
[`../docs/deployment.md`](../docs/deployment.md). En-têtes et limites
d'upload : [`../docs/security.md`](../docs/security.md).
## Fichiers
| Fichier | Rôle | Consommé par |
| --- | --- | --- |
| `Dockerfile` | `nginx:1.27-alpine` + `nginx/cloud.conf` | service `nginx` |
| `Dockerfile.app` | build Vite (`node:22-alpine`), export `dist/` | service `app-build` |
| `Dockerfile.api` | build d'un paquet backend, `npm prune --omit=dev` | services `migrate` **et** `api` |
| `nginx/cloud.conf` | serveur : `/healthz`, proxy `/api/`, caches, SPA | copié dans l'image |
| `nginx/snippets/` | en-têtes de sécurité, règles de cache | inclus par `cloud.conf` |
| `publish.sh` | publication atomique dans `app_data` | monté dans `app-build` |
## Images
```sh
docker compose build # toutes
docker compose build api # seulement l'API
```
### `Dockerfile` (nginx)
Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
`EXPOSE 80`. Aucun module ajouté.
### `Dockerfile.app` (front)
- `ARG APP_DIR` → `frontend/cloud` (passé par compose).
- Stage `builder` : `npm ci` (cache npm), puis
`npm run build --workspace=frontend/shared` **avant**
`--workspace=${APP_DIR}` — l'ordre est obligatoire, le front importe le
design system.
- Stage `export` : recopie `dist/` seul, sans sources ni `node_modules`.
### `Dockerfile.api` (back, utilisé deux fois)
`ARG APP_DIR` accepte deux valeurs :
| Service | `APP_DIR` | Résultat |
| --- | --- | --- |
| `migrate` | `backend/shared` | binaire `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend/cloud` | serveur Hono (`dist/index.js`) |
Même image, deux cibles : le conteneur `migrate` sert, joue les migrations puis
s'arrête ; `api` tourne en continu (`restart: unless-stopped`).
## Le proxy nginx
```nginx
location /healthz { … }
location /api/ { proxy_pass $cohaise_api$request_uri; client_max_body_size 5g; … }
location /assets/ { immutable 1 an }
location / { no-cache, fallback SPA → @spa }
```
- L'upstream `api` est résolu depuis `proxy.conf` (variable `cohaise_api`) :
l'API est appelée **en interne** sur le réseau compose, jamais via le port
`3101` publié — ce port sert au debug.
- `client_max_body_size 5g` doit rester **aligné** avec `users.max_file_bytes`
(défaut 5 Go) : nginx rejette avant que l'API ne renvoie son erreur métier.
## Publication du front
Service `app-build` : `command: sh /publish.sh` avec `app_data` monté.
1. copie de `dist/` vers `releases/<UTC>-<pid>` ;
2. bascule atomique du lien `current` (`ln -sfn` puis `mv -T`) ;
3. purge des releases plus vieilles que 5 minutes.
Pendant la copie, nginx sert l'ancienne version : aucun reload, aucune coupure.
## Migrations
Le service `migrate` monte `./backend/cloud/migrations:/migrations:ro` (lecture
seule) et lance :
```sh
node dist/cli.js --dir /migrations # défaut, à chaque démarrage
node dist/cli.js --dir /migrations --dry-run # simulation
node dist/cli.js --dir /migrations --check # 1 s'il en reste
```
Codes de sortie : `0` OK · `1` erreur ou dérive de checksum · `2` configuration.
## Modifier la configuration
`nginx/cloud.conf` et les snippets sont **copiés** dans l'image, pas montés :
```sh
docker compose build nginx && docker compose up -d nginx
```
Une simple modification sur disque ne change rien au service en cours.
+62
View File
@@ -0,0 +1,62 @@
# Limitation de debit. La zone `login` couvre les points sensibles (connexion,
# reinitialisation) ; la zone `api` un trafic general soutenu sans etouffer les
# envois volumineux (burst eleve, pas de mise en file).
limit_req_zone $binary_remote_addr zone=login:10m rate=15r/m;
limit_req_zone $binary_remote_addr zone=api:10m rate=60r/s;
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
root /usr/share/nginx/html/current;
index index.html;
include /etc/nginx/snippets/security-headers.conf;
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/javascript application/json image/svg+xml application/manifest+json;
location = /healthz {
access_log off;
default_type text/plain;
return 200 "ok\n";
}
# Points d'entree sensibles : limitation serree par IP. Une expression
# reguliere prend le pas sur le prefixe /api/ ci-dessous.
location ~ ^/api/cloud/(auth/login|account/forgot-password|account/reset-password|account/email-change) {
include /etc/nginx/snippets/security-headers.conf;
limit_req zone=login burst=5 nodelay;
limit_req_status 429;
include /etc/nginx/snippets/proxy-api.conf;
}
# L'API. Le resolver Docker est declare dans le snippet pour que le
# conteneur soit resolu a la demande : nginx peut demarrer avant l'API, et
# le front reste servi pendant un redemarrage de celle-ci.
location /api/ {
include /etc/nginx/snippets/security-headers.conf;
limit_req zone=api burst=120 nodelay;
include /etc/nginx/snippets/proxy-api.conf;
}
location /assets/ {
include /etc/nginx/snippets/security-headers.conf;
include /etc/nginx/snippets/cache-immutable.conf;
expires 1y;
try_files $uri =404;
}
location / {
include /etc/nginx/snippets/security-headers.conf;
include /etc/nginx/snippets/cache-no-cache.conf;
try_files $uri $uri/ @spa;
}
location @spa {
try_files /index.html =404;
}
}
@@ -0,0 +1 @@
add_header Cache-Control "public, immutable" always;
@@ -0,0 +1 @@
add_header Cache-Control "no-cache" always;
+14
View File
@@ -0,0 +1,14 @@
# Relay vers l'API. Resolver Docker declare pour resoudre le conteneur a la
# demande : nginx peut demarrer avant l'API et lui survit pendant un
# redemarrage.
resolver 127.0.0.11 valid=30s ipv6=off;
set $cohaise_api http://api:8080;
proxy_pass $cohaise_api$request_uri;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 60s;
# Aligne sur la borne de depot du Cloud.
client_max_body_size 5g;
@@ -0,0 +1,8 @@
# En-tetes de securite communs. CSP stricte : aucun script en ligne, aucun
# cadre, aucune origine externe. Les styles tolerent l'inline (attributs
# `style=` de React) : c'est une concession sans effet sur l'execution de code.
add_header Content-Security-Policy "default-src 'self'; base-uri 'none'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; media-src 'self' blob:; font-src 'self' data:; connect-src 'self'" always;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
+17
View File
@@ -0,0 +1,17 @@
#!/bin/sh
set -eu
SRC="${1:-/app/dist}"
DEST="${2:-/output}"
REL="releases/$(date -u +%Y%m%dT%H%M%SZ)-$$"
KEEP=$(basename "$REL")
mkdir -p "$DEST/$REL"
cp -a "$SRC/." "$DEST/$REL/"
touch "$DEST/$REL"
ln -sfn "$REL" "$DEST/.current.tmp"
mv -T "$DEST/.current.tmp" "$DEST/current"
find "$DEST/releases" -mindepth 1 -maxdepth 1 -type d ! -name "$KEEP" -mmin +5 -exec rm -rf {} + 2>/dev/null || true