From a0bcea4eb1cc533026369c8eef0b9ba33f900cbe Mon Sep 17 00:00:00 2001 From: Yugonito Date: Tue, 27 Oct 2026 18:38:24 +0100 Subject: [PATCH] feat: production docker stack with nightly backups and README Co-Authored-By: Claude Opus 5.5 --- .dockerignore | 12 +++++++ .env.example | 10 ++++-- Dockerfile | 37 ++++++++++++++++++++ README.md | 80 ++++++++++++++++++++++++++++++++++++++++++++ docker-compose.yml | 48 ++++++++++++++++++++++++++ docker/backup.sh | 27 +++++++++++++++ docker/entrypoint.sh | 6 ++++ 7 files changed, 218 insertions(+), 2 deletions(-) create mode 100644 .dockerignore create mode 100644 Dockerfile create mode 100644 README.md create mode 100644 docker-compose.yml create mode 100644 docker/backup.sh create mode 100644 docker/entrypoint.sh diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..788770c --- /dev/null +++ b/.dockerignore @@ -0,0 +1,12 @@ +node_modules +.next +.git +.env +.env.* +!.env.example +.superpowers +backups +dist +tests +docs +*.log diff --git a/.env.example b/.env.example index 56b8c7d..d3ec395 100644 --- a/.env.example +++ b/.env.example @@ -1,4 +1,10 @@ -# Développement local (voir docker-compose.dev.yml) +# --- Production (docker-compose.yml) --- +# Générer chaque secret avec : openssl rand -hex 32 +MARIADB_ROOT_PASSWORD= +MARIADB_PASSWORD= +SESSION_SECRET= +APP_PORT=3000 + +# --- Développement local uniquement (docker-compose.dev.yml + npm run dev) --- DATABASE_URL="mysql://root:dev@localhost:3307/finances" TEST_DATABASE_URL="mysql://root:dev@localhost:3307/finances_test" -SESSION_SECRET="change-me-to-32+chars-random-string-xxxxxxxx" diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..f5f558c --- /dev/null +++ b/Dockerfile @@ -0,0 +1,37 @@ +# --- Dépendances --- +FROM node:24-alpine AS deps +WORKDIR /app +RUN apk add --no-cache openssl +COPY package.json package-lock.json ./ +RUN npm ci + +# --- Build Next.js (standalone) + scripts compilés --- +FROM node:24-alpine AS build +WORKDIR /app +RUN apk add --no-cache openssl +COPY --from=deps /app/node_modules ./node_modules +COPY . . +RUN npx prisma generate \ + && npm run build \ + && npx esbuild prisma/seed.ts scripts/reset-password.ts --bundle --platform=node --format=cjs \ + --packages=external --entry-names=[name] --outdir=dist + +# --- Image finale --- +FROM node:24-alpine AS runner +WORKDIR /app +ENV NODE_ENV=production TZ=Europe/Paris PORT=3000 HOSTNAME=0.0.0.0 NEXT_TELEMETRY_DISABLED=1 +RUN apk add --no-cache openssl tzdata \ + && npm install -g prisma@6.19.3 \ + && addgroup -S app && adduser -S app -G app +COPY --from=build --chown=app:app /app/.next/standalone ./ +COPY --from=build --chown=app:app /app/.next/static ./.next/static +COPY --from=build --chown=app:app /app/public ./public +COPY --from=build --chown=app:app /app/prisma ./prisma +COPY --from=build --chown=app:app /app/dist ./dist +COPY --from=build --chown=app:app /app/node_modules/.prisma ./node_modules/.prisma +COPY --from=build --chown=app:app /app/node_modules/@prisma/client ./node_modules/@prisma/client +COPY --from=build --chown=app:app /app/node_modules/bcryptjs ./node_modules/bcryptjs +COPY --chmod=755 docker/entrypoint.sh /entrypoint.sh +USER app +EXPOSE 3000 +ENTRYPOINT ["/entrypoint.sh"] diff --git a/README.md b/README.md new file mode 100644 index 0000000..ccea22c --- /dev/null +++ b/README.md @@ -0,0 +1,80 @@ +# Finances du foyer + +Suivi des entrées, dépenses et charges partagées d'un foyer de deux personnes : +répartition en %, « qui doit combien à qui », récurrents, dépenses prévues, budgets, +remboursements employeur affectés à une charge (IK, part de loyer…) et crédits. + +Stack : Next.js 15 (TypeScript) + MariaDB, le tout sous Docker Compose. Accès réseau local uniquement (HTTP). + +## Installation sur la VM + +Prérequis : Docker et le plugin `docker compose`, git, et un accès Internet pendant le build (paquets npm, police Inter). + +```bash +git clone git@git.fabout.it:hcloez/hcl-finances-manager.git +cd hcl-finances-manager +cp .env.example .env +# Renseigner les 3 secrets dans .env (un par ligne) : +openssl rand -hex 32 # → MARIADB_ROOT_PASSWORD +openssl rand -hex 32 # → MARIADB_PASSWORD +openssl rand -hex 32 # → SESSION_SECRET +docker compose up -d --build +``` + +Ouvrir ensuite **http://192.168.1.211:3000**. Au premier accès, un écran d'installation crée les deux comptes +(prénom, identifiant, mot de passe, couleur), la répartition par défaut et un éventuel solde d'ouverture. + +Les variables `DATABASE_URL` / `TEST_DATABASE_URL` de `.env` ne servent qu'au développement local ; elles sont ignorées par la stack de production. + +## Mise à jour + +```bash +git pull +docker compose up -d --build +``` + +Les migrations de la base s'appliquent automatiquement au démarrage du conteneur `app`. + +## Sauvegardes + +- Le service `backup` fait un dump compressé de la base **au démarrage puis chaque nuit à 03:00** (heure de Paris) + dans `./backups/finances-AAAA-MM-JJ_HHMM.sql.gz`. Les dumps de plus de **30 jours** sont supprimés. +- La VM entière est par ailleurs sauvegardée par Proxmox Backup Server. +- Vérifier les sauvegardes : `ls -lh backups/` et `docker compose logs backup`. + +### Restaurer un dump + +```bash +docker compose stop app +gunzip -c backups/finances-AAAA-MM-JJ_HHMM.sql.gz \ + | docker compose exec -T db sh -c 'mariadb -u root -p"$MARIADB_ROOT_PASSWORD" finances' +docker compose start app +``` + +## Mot de passe oublié + +Chacun change son propre mot de passe dans **Réglages**. En cas d'oubli : + +```bash +docker compose exec app node dist/reset-password.js +``` + +## Développement local + +```bash +npm install +cp .env.example .env # garder les variables de la section « Développement local », ajouter SESSION_SECRET +docker compose -f docker-compose.dev.yml up -d # MariaDB sur le port 3307 (bases finances et finances_test) +npx prisma migrate dev +npm run db:seed +npm run dev # http://localhost:3000 +npm test # tests unitaires + intégration (base finances_test) +``` + +Organisation du code : + +- `src/domain/` : règles de calcul pures et testées (centimes entiers, répartitions en points de base) : + équilibre entre personnes, flux mensuels, charges nettes, budgets, amortissement, récurrences. +- `src/server/` : accès base (Prisma), authentification, services métier (`services/`) et Server Actions (`actions/`). +- `src/app/` : pages (tableau de bord, opérations, récurrents & prévu, budgets, crédits, réglages). +- `docs/superpowers/specs/` : document de conception ; `docs/superpowers/plans/` : plan d'implémentation. diff --git a/docker-compose.yml b/docker-compose.yml new file mode 100644 index 0000000..8b77937 --- /dev/null +++ b/docker-compose.yml @@ -0,0 +1,48 @@ +# Stack de production : docker compose up -d --build +services: + db: + image: mariadb:latest + restart: unless-stopped + environment: + MARIADB_DATABASE: finances + MARIADB_USER: finances + MARIADB_PASSWORD: ${MARIADB_PASSWORD:?à définir dans .env} + MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD:?à définir dans .env} + TZ: Europe/Paris + volumes: + - db_data:/var/lib/mysql + healthcheck: + test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"] + interval: 10s + timeout: 5s + retries: 10 + start_period: 20s + + app: + build: . + restart: unless-stopped + depends_on: + db: + condition: service_healthy + environment: + DATABASE_URL: mysql://finances:${MARIADB_PASSWORD}@db:3306/finances + SESSION_SECRET: ${SESSION_SECRET:?à définir dans .env (32 caractères minimum)} + ports: + - "${APP_PORT:-3000}:3000" + + backup: + image: mariadb:latest + restart: unless-stopped + depends_on: + db: + condition: service_healthy + entrypoint: ["bash", "/backup.sh"] + environment: + MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD} + TZ: Europe/Paris + volumes: + - ./docker/backup.sh:/backup.sh:ro + - ./backups:/backups + +volumes: + db_data: diff --git a/docker/backup.sh b/docker/backup.sh new file mode 100644 index 0000000..3821249 --- /dev/null +++ b/docker/backup.sh @@ -0,0 +1,27 @@ +#!/bin/bash +# Sauvegarde quotidienne de la base (03:00, heure de Paris), rétention 30 jours. +set -u + +dump() { + local file="/backups/finances-$(date +%F_%H%M).sql.gz" + if mariadb-dump -h db -u root -p"$MARIADB_ROOT_PASSWORD" --single-transaction --routines finances | gzip > "$file.tmp"; then + mv "$file.tmp" "$file" + echo "$(date '+%F %T') sauvegarde OK : $file" + else + rm -f "$file.tmp" + echo "$(date '+%F %T') ÉCHEC de la sauvegarde" >&2 + fi + find /backups -name 'finances-*.sql.gz' -mtime +30 -delete +} + +# Attend que la base réponde, puis une première sauvegarde au démarrage. +until mariadb-admin ping -h db -u root -p"$MARIADB_ROOT_PASSWORD" --silent; do sleep 5; done +dump + +while true; do + now=$(date +%s) + next=$(date -d "tomorrow 03:00" +%s) + [ "$(date +%H)" -lt 3 ] && next=$(date -d "today 03:00" +%s) + sleep $((next - now)) + dump +done diff --git a/docker/entrypoint.sh b/docker/entrypoint.sh new file mode 100644 index 0000000..43b1cce --- /dev/null +++ b/docker/entrypoint.sh @@ -0,0 +1,6 @@ +#!/bin/sh +set -e +# Migrations du schéma puis catégories de départ (idempotent), puis serveur Next.js. +prisma migrate deploy --schema prisma/schema.prisma +node dist/seed.js +exec node server.js