From 739bc26b438b102d328e15b0b1b98ba3c3d4193e Mon Sep 17 00:00:00 2001 From: xEsiah Date: Fri, 16 Oct 2026 11:59:34 +0200 Subject: [PATCH] feat: e-mails brandes, controle d'espace disque, maintenance Courriels - gabarit HTML brande (logo, couleur #b71c1c, bouton, mention ne pas repondre) dans backend/src/lib/mail-template.ts ; repli texte conserve - MailMessage gagne un champ html optionnel - MAIL_LOGO_URL (defaut PUBLIC_ORIGIN/logo.png) + logo.png servi par le front - notification au nouvel utilisateur a la creation du compte admin - forgot-password, email-change et reset-password passent par le gabarit Espace disque - diskUsage() (statfs) dans storage.ts (total/free/available) - upload et avatar refuses si le disque est plein (507 INSUFFICIENT_STORAGE) - quota d'emplacement borne par la capacite reelle du disque - statistiques disque exposees aux endpoints admin Exploitation - make purge-logs : vide le journal d'audit - make reset : cloud vierge en conservant les administrateurs - docker/reset-cloud.sql ; documentation deployment.md et api.md --- .env.example | 3 + Makefile | 23 +++++- backend/src/lib/config.ts | 8 ++ backend/src/lib/errors.ts | 3 + backend/src/lib/index.ts | 7 ++ backend/src/lib/mail-template.ts | 133 +++++++++++++++++++++++++++++++ backend/src/lib/mail.ts | 3 + backend/src/routes/account.ts | 31 ++++++- backend/src/routes/admin.ts | 71 ++++++++++++++++- backend/src/routes/files.ts | 11 +++ backend/src/storage.ts | 29 ++++++- docker-compose.yml | 1 + docker/reset-cloud.sql | 21 +++++ docs/api.md | 14 ++++ docs/architecture.md | 2 +- docs/deployment.md | 30 ++++++- frontend/index.html | 3 +- frontend/public/logo.png | Bin 0 -> 51332 bytes 18 files changed, 382 insertions(+), 11 deletions(-) create mode 100644 backend/src/lib/mail-template.ts create mode 100644 docker/reset-cloud.sql create mode 100644 frontend/public/logo.png diff --git a/.env.example b/.env.example index e6055d4..a211477 100644 --- a/.env.example +++ b/.env.example @@ -47,6 +47,9 @@ SMTP_PASSWORD= SMTP_FROM= # true si le serveur SMTP exige TLS des la connexion (port 465). SMTP_SECURE=false +# Logo des courriels. Par defaut PUBLIC_ORIGIN/logo.png ; a surcharger si le +# logo est heberge ailleurs. URL joignable depuis Internet. +MAIL_LOGO_URL= # --- Limitation des connexions ------------------------------------------- # Tentatives de connexion autorisees par fenetre et par IP. diff --git a/Makefile b/Makefile index 7643f3b..76f9a89 100644 --- a/Makefile +++ b/Makefile @@ -1,6 +1,6 @@ COMPOSE=docker compose -.PHONY: help up down build logs ps front front-build db migrate admin backup dev typecheck check +.PHONY: help up down build logs ps front front-build db migrate admin backup purge-logs reset dev typecheck check help: @echo "CoHaiSe Cloud" @@ -20,6 +20,8 @@ help: @echo " make migrate Appliquer les migrations SQL" @echo " make backup Sauvegarder la base dans ./backups" @echo " make admin ARGS=... Creer ou reinitialiser un compte" + @echo " make purge-logs Vider le journal d'audit" + @echo " make reset Cloud vierge, hors administrateurs" @echo "" @echo "Developpement, sans Docker" @echo " make dev Vite sur 5174, API sur 3101" @@ -75,6 +77,25 @@ backup: admin: $(COMPOSE) run --rm --no-deps api node dist/admin.js $(ARGS) +# Vide le journal d'audit. La base est deja en marche : la commande passe par +# le conteneur, aucun client MariaDB n'est requis sur l'hote. +purge-logs: + $(COMPOSE) exec -T db sh -c 'mariadb --password="$$MARIADB_ROOT_PASSWORD" "$$MARIADB_DATABASE" -e "DELETE FROM audit_logs;"' + @echo " journal d'audit vide" + +# Repart d'un cloud vierge : fichiers, dossiers, partages, sessions et jetons +# sont supprimes, les administrateurs sont conserves. Les medias sur disque +# sont effaces dans la foulee. +reset: + @printf "Cette commande efface toutes les donnees sauf les administrateurs. Continuer ? [o/N] "; \ + read answer; \ + if [ "$$answer" != "o" ] && [ "$$answer" != "O" ] && [ "$$answer" != "y" ]; then \ + echo " annule"; exit 1; \ + fi + $(COMPOSE) exec -T db sh -c 'mariadb --password="$$MARIADB_ROOT_PASSWORD" "$$MARIADB_DATABASE"' < docker/reset-cloud.sql + $(COMPOSE) run --rm --no-deps --entrypoint sh api -c 'find /data/media -mindepth 1 -delete' + @echo " cloud remis a zero" + dev: npm run dev --workspace=frontend diff --git a/backend/src/lib/config.ts b/backend/src/lib/config.ts index a7d99bb..ffffc78 100644 --- a/backend/src/lib/config.ts +++ b/backend/src/lib/config.ts @@ -59,6 +59,14 @@ const schema = z.object({ SMTP_PASSWORD: z.string().optional().transform((v) => (v ? v : null)), SMTP_FROM: z.string().min(3), SMTP_SECURE: bool(false), + /** + * Logo des courriels. Par defaut celui publie par le front + * (`PUBLIC_ORIGIN/logo.png`) ; l'URL doit etre joignable depuis Internet. + */ + MAIL_LOGO_URL: z + .string() + .optional() + .transform((v) => (v ? v : null)), // Limitation des tentatives de connexion, appliquee dans le processus. RATE_LIMIT_LOGIN_MAX: positiveInt(10), diff --git a/backend/src/lib/errors.ts b/backend/src/lib/errors.ts index 5e6d87a..3c81928 100644 --- a/backend/src/lib/errors.ts +++ b/backend/src/lib/errors.ts @@ -41,6 +41,9 @@ export class AppError extends Error { static serviceUnavailable(message = "Service momentanement indisponible.") { return new AppError(503, "UNAVAILABLE", message); } + static insufficientStorage(message = "Espace de stockage insuffisant sur le serveur.") { + return new AppError(507, "INSUFFICIENT_STORAGE", message); + } } export interface SafeError { diff --git a/backend/src/lib/index.ts b/backend/src/lib/index.ts index ca4ba65..c8f191e 100644 --- a/backend/src/lib/index.ts +++ b/backend/src/lib/index.ts @@ -41,6 +41,13 @@ export { type MigrationResult, } from "./migrate.js"; export { createMailer, link, type Mailer, type MailMessage } from "./mail.js"; +export { + branding, + renderMail, + type Branding, + type MailContent, + type RenderedMail, +} from "./mail-template.js"; export { createRateLimiter, rateLimitKey, type RateLimiter } from "./ratelimit.js"; export { prepareService, diff --git a/backend/src/lib/mail-template.ts b/backend/src/lib/mail-template.ts new file mode 100644 index 0000000..9798b0c --- /dev/null +++ b/backend/src/lib/mail-template.ts @@ -0,0 +1,133 @@ +import type { Config } from "./config.js"; + +/** + * Gabarit de courriel de marque, sans dependance ni feuille de style externe : + * les clients de messagerie n'interpretent qu'une partie du CSS, tout est donc + * ecrit en ligne et pose sur des tableaux, y compris pour Outlook. + */ + +export interface Branding { + appName: string; + origin: string; + logoUrl: string; + color: string; + /** Adresse d'expedition, reprise en pied pour dire ou ne pas repondre. */ + footer: string; +} + +export const branding = (config: Config): Branding => ({ + appName: "CoHaiSe Cloud", + origin: config.PUBLIC_ORIGIN, + logoUrl: config.MAIL_LOGO_URL ?? new URL("/logo.png", config.PUBLIC_ORIGIN).toString(), + color: "#b71c1c", + footer: config.SMTP_FROM, +}); + +export interface MailContent { + /** Aperçu affiche par le client, avant ouverture (texte brut). */ + preview: string; + heading: string; + intro: string; + paragraphs?: string[]; + /** Identifiants d'acces, presentes dans un encadre monospace. */ + credentials?: { email: string; password: string }; + cta?: { label: string; url: string }; + note?: string; +} + +export interface RenderedMail { + html: string; + text: string; +} + +const escapeHtml = (value: string): string => + value + .replace(/&/g, "&") + .replace(//g, ">") + .replace(/"/g, """) + .replace(/'/g, "'"); + +const FONT = "-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif"; + +export const renderMail = (brand: Branding, content: MailContent): RenderedMail => { + const paragraphs = (content.paragraphs ?? []) + .map( + (paragraph) => + `

${escapeHtml(paragraph)}

`, + ) + .join(""); + + const credentials = content.credentials + ? ` + + +
+

Vos identifiants

+

Adresse : ${escapeHtml(content.credentials.email)}

+

Mot de passe temporaire : + ${escapeHtml(content.credentials.password)} +

+
` + : ""; + + const cta = content.cta + ? ` + + +
+ ${escapeHtml(content.cta.label)} +
` + : ""; + + const note = content.note + ? ` +

${escapeHtml(content.note)}

` + : ""; + + const html = ` + + + + + +${escapeHtml(content.heading)} + + +
${escapeHtml(content.preview)}
+ + +
+ + + + +
+ + + ${escapeHtml(brand.appName)} + +
+

${escapeHtml(content.heading)}

+

${escapeHtml(content.intro)}

+ ${paragraphs}${credentials}${cta}${note} +
+
+

Message automatique : merci de ne pas repondre a cet e-mail.

+

${escapeHtml(brand.footer)}

+
+

${escapeHtml(brand.appName)} — ${escapeHtml(brand.origin.replace(/^https?:\/\//, ""))}

+
+ +`; + + const lines = [content.intro, ...(content.paragraphs ?? [])]; + if (content.credentials) { + lines.push(`Adresse : ${content.credentials.email}`, `Mot de passe temporaire : ${content.credentials.password}`); + } + if (content.cta) lines.push(`${content.cta.label} : ${content.cta.url}`); + if (content.note) lines.push(content.note); + lines.push("", "Message automatique : merci de ne pas repondre a cet e-mail.", brand.footer); + + return { html, text: lines.join("\n") }; +}; \ No newline at end of file diff --git a/backend/src/lib/mail.ts b/backend/src/lib/mail.ts index 9512130..ff9d164 100644 --- a/backend/src/lib/mail.ts +++ b/backend/src/lib/mail.ts @@ -13,6 +13,8 @@ export interface MailMessage { to: string; subject: string; text: string; + /** Version enrichie ; les clients texte recoivent `text`, les autres `html`. */ + html?: string; } export interface Mailer { @@ -38,6 +40,7 @@ export const createMailer = (config: Config): Mailer => { to: message.to, subject: message.subject, text: message.text, + ...(message.html ? { html: message.html } : {}), }); }, }; diff --git a/backend/src/routes/account.ts b/backend/src/routes/account.ts index 2bc240e..38b4890 100644 --- a/backend/src/routes/account.ts +++ b/backend/src/routes/account.ts @@ -7,6 +7,7 @@ import sharp from "sharp"; import { AppError, attachUser, + branding, clientIp, createMailer, createRateLimiter, @@ -14,6 +15,7 @@ import { hashPassword, link, rateLimitKey, + renderMail, requireAuth, sha256, verifyPassword, @@ -23,7 +25,7 @@ import { type SessionUser, } from "../lib/index.js"; import { audit } from "../access.js"; -import { absolutePath, fileExists, openForDownload } from "../storage.js"; +import { absolutePath, diskUsage, fileExists, openForDownload } from "../storage.js"; const AVATAR_MAX_BYTES = 8 * 1024 * 1024; const AVATAR_PX = 512; @@ -65,6 +67,7 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => app.use("/api/cloud/account/*", attachUser(db)); app.use("/api/cloud/account", attachUser(db)); const mailer = createMailer(config); + const brand = branding(config); const limiter = createRateLimiter(config.RATE_LIMIT_LOGIN_MAX, config.RATE_LIMIT_LOGIN_WINDOW_MS); const throttle = (context: Parameters[0], extra: string): void => { @@ -167,6 +170,11 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => ); if (!location) throw AppError.serviceUnavailable("Aucun emplacement de stockage disponible."); + const disk = await diskUsage(config.VARIANT_DIR); + if (disk !== null && processed.byteLength > disk.available_bytes) { + throw AppError.insufficientStorage("Espace disque insuffisant sur le serveur."); + } + const relative = avatarRelativePath(user.id); const destination = absolutePath(config.VARIANT_DIR, relative); await mkdir(path.dirname(destination), { recursive: true }); @@ -257,11 +265,19 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => [randomUUID(), user.id, sha256(token), new Date(Date.now() + HOUR_MS)], ); const url = link(config, `/reset-password?token=${encodeURIComponent(token)}`); + const mail = renderMail(brand, { + preview: "Reinitialisez le mot de passe de votre compte.", + heading: "Reinitialisation du mot de passe", + intro: + "Une reinitialisation de mot de passe a ete demandee pour votre compte CoHaiSe Cloud. Choisissez un nouveau mot de passe en suivant le lien ci-dessous.", + cta: { label: "Choisir un mot de passe", url }, + note: "Ce lien expire dans une heure. Si vous n'etes pas a l'origine de cette demande, ignorez ce message : votre mot de passe reste inchange.", + }); await mailer .send({ to: user.email, subject: "CoHaiSe Cloud — reinitialisation du mot de passe", - text: `Une reinitialisation de mot de passe a ete demandee pour ce compte.\n\n${url}\n\nCe lien expire dans une heure. Si vous n'etes pas a l'origine de cette demande, ignorez ce message.`, + ...mail, }) .catch(() => undefined); } @@ -344,11 +360,20 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => ); const url = link(config, `/confirm-email?token=${encodeURIComponent(token)}`); + const mail = renderMail(brand, { + preview: "Confirmez votre nouvelle adresse e-mail.", + heading: "Confirmez votre nouvelle adresse", + intro: + "Une demande de changement d'adresse a ete faite pour votre compte CoHaiSe Cloud. Confirmez la nouvelle adresse en suivant le lien ci-dessous.", + cta: { label: "Confirmer l'adresse", url }, + note: "Ce lien expire dans une heure. Sans confirmation, l'adresse reste inchangee.", + }); await mailer .send({ to: data.new_email, subject: "CoHaiSe Cloud — confirmez votre nouvelle adresse", - text: `Une demande de changement d'adresse a ete faite pour votre compte CoHaiSe Cloud.\n\n${url}\n\nCe lien expire dans une heure. Sans confirmation, l'adresse reste inchangee.`, + text: mail.text, + html: mail.html, }) .catch(() => undefined); diff --git a/backend/src/routes/admin.ts b/backend/src/routes/admin.ts index 8047024..8dc9113 100644 --- a/backend/src/routes/admin.ts +++ b/backend/src/routes/admin.ts @@ -3,14 +3,18 @@ import { z } from "zod"; import { AppError, attachUser, + branding, createMailer, currentUser, hashPassword, + link, + renderMail, requireAuth, type App, type Config, type Db, } from "../lib/index.js"; +import { diskUsage } from "../storage.js"; const uuidParam = z .string() @@ -96,6 +100,19 @@ const SELECT_USER = ` FROM users u JOIN roles r ON r.id = u.role_id`; +const UNITS = ["o", "Ko", "Mo", "Go", "To", "Po"]; + +/** Taille lisible, pour les messages d'erreur destines a l'administrateur. */ +const humanBytes = (bytes: number): string => { + let value = bytes; + let unit = 0; + while (value >= 1024 && unit < UNITS.length - 1) { + value /= 1024; + unit += 1; + } + return `${value.toFixed(unit === 0 || value >= 10 ? 0 : 1)} ${UNITS[unit]}`; +}; + /** Mot de passe aleatoire, lisible a la frappe, sans caractere ambigu. */ const generatePasswordValue = (): string => { const alphabet = "abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789"; @@ -110,11 +127,27 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { app.use("/api/cloud/admin/*", attachUser(db)); app.use("/api/cloud/admin", attachUser(db)); const mailer = createMailer(config); + const brand = branding(config); const requireAdmin = (context: Parameters[0]): void => { if (currentUser(context).role_slug !== "admin") throw AppError.forbidden(); }; + /** + * Un quota ne peut depasser la capacite reelle du disque qui porte les + * medias : au-dela, la limite est un chiffre mort que le support ne pourra + * jamais honorer. Le controle est ignore si le support n'est pas lisible + * (chemin absent dans le conteneur), pour ne pas bloquer la configuration. + */ + const assertQuotaFits = async (quota: number): Promise => { + const disk = await diskUsage(config.MEDIA_DIR); + if (disk !== null && quota > disk.total_bytes) { + throw AppError.badRequest( + `Le quota depasse la capacite du disque (${humanBytes(disk.total_bytes)}).`, + ); + } + }; + app.get("/api/cloud/admin/stats", requireAuth, async (context) => { requireAdmin(context); const [users] = await db.query<{ count: number }>( @@ -145,6 +178,7 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { usedBytes: Number(files?.bytes ?? 0), trashFiles: trash?.count ?? 0, locations, + disk: await diskUsage(config.MEDIA_DIR), }); }); @@ -191,6 +225,24 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { ); const created = await db.required(`${SELECT_USER} WHERE u.id = ?`, [id]); + + const mail = renderMail(brand, { + preview: "Votre acces CoHaiSe Cloud est pret.", + heading: "Votre compte a ete cree", + intro: `Un compte CoHaiSe Cloud vient d'etre ouvert pour ${data.first_name}. Connectez-vous avec les identifiants ci-dessous.`, + credentials: { email: data.email, password }, + cta: { label: "Se connecter", url: link(config, "/login") }, + note: "Ce mot de passe est temporaire : il vous sera demande de le changer des la premiere connexion.", + }); + await mailer + .send({ + to: data.email, + subject: "CoHaiSe Cloud — votre compte est pret", + text: mail.text, + html: mail.html, + }) + .catch(() => undefined); + return context.json({ user: publicUser(created), password }, 201); }); @@ -293,11 +345,20 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { // Le mot de passe est rendu une seule fois et envoye au compte. Un echec // d'envoi n'invalide pas la reinitialisation. + const mail = renderMail(brand, { + preview: "Un nouveau mot de passe a ete genere pour votre compte.", + heading: "Mot de passe reinitialise", + intro: "Un administrateur a reinitialise le mot de passe de votre compte CoHaiSe Cloud.", + credentials: { email: user.email, password }, + cta: { label: "Se connecter", url: link(config, "/login") }, + note: "Ce mot de passe est temporaire : il vous sera demande de le changer des la premiere connexion.", + }); await mailer .send({ to: user.email, subject: "CoHaiSe Cloud — mot de passe reinitialise", - text: `Un administrateur a reinitialise le mot de passe de votre compte.\n\nMot de passe provisoire : ${password}\n\nIl vous sera demande de le changer a la prochaine connexion.`, + text: mail.text, + html: mail.html, }) .catch(() => undefined); @@ -310,12 +371,15 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { `SELECT id, name, slug, mount_path, quota_bytes, used_bytes, is_active, created_at FROM storage_locations WHERE deleted_at IS NULL ORDER BY id`, ); - return context.json({ locations: rows }); + return context.json({ locations: rows, disk: await diskUsage(config.MEDIA_DIR) }); }); app.post("/api/cloud/admin/storage-locations", requireAuth, async (context) => { requireAdmin(context); const data = parse(createLocationSchema, await context.req.json().catch(() => null)); + if (data.quota_bytes !== undefined && data.quota_bytes !== null) { + await assertQuotaFits(data.quota_bytes); + } try { await db.exec( `INSERT INTO storage_locations (name, slug, mount_path, quota_bytes) @@ -345,6 +409,9 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { if (data.quota_bytes !== undefined && data.quota_bytes !== null && data.quota_bytes < row.used_bytes) { throw AppError.badRequest("Le quota est inferieur a l'espace deja utilise."); } + if (data.quota_bytes !== undefined && data.quota_bytes !== null) { + await assertQuotaFits(data.quota_bytes); + } const fields: string[] = []; const values: unknown[] = []; diff --git a/backend/src/routes/files.ts b/backend/src/routes/files.ts index 44267b2..d5e73a1 100644 --- a/backend/src/routes/files.ts +++ b/backend/src/routes/files.ts @@ -18,6 +18,7 @@ import { absolutePath, chooseLocation, discard, + diskUsage, ensureDir, fileExists, openForDownload, @@ -180,6 +181,16 @@ export const registerFileRoutes = (app: App, db: Db, config: Config): void => { ); if (duplicate) throw AppError.conflict("Ce nom existe deja ici."); + // Le disque est verifie avant l'ecriture : sans cela un support plein + // ferait echouer le depot en cours de route (ENOSPC), apres avoir + // annonce au client que le quota etait disponible. + const disk = await diskUsage(config.MEDIA_DIR); + if (disk !== null && declared > disk.available_bytes) { + throw AppError.insufficientStorage( + "Espace disque insuffisant sur le serveur pour ce fichier.", + ); + } + const location = await chooseLocation(db, BigInt(declared)); const id = randomUUID(); const relative = relativePathFor(location.slug, id, name); diff --git a/backend/src/storage.ts b/backend/src/storage.ts index 36809ce..43366ed 100644 --- a/backend/src/storage.ts +++ b/backend/src/storage.ts @@ -1,6 +1,6 @@ import { createHash, randomUUID } from "node:crypto"; import { createReadStream, createWriteStream } from "node:fs"; -import { mkdir, rename, rm, stat } from "node:fs/promises"; +import { mkdir, rename, rm, stat, statfs } from "node:fs/promises"; import path from "node:path"; import { Readable, Transform } from "node:stream"; import { pipeline } from "node:stream/promises"; @@ -140,3 +140,30 @@ export const fileExists = async (absolute: string): Promise => { }; export const openForDownload = (absolute: string) => createReadStream(absolute); + +/** + * Occupation reelle du support qui porte `target`. Sert a refuser un quota + * plus grand que le disque et a prevenir un eclatement d'ENOSPC : l'espace + * logique (used_bytes) peut etre disponible alors que le disque est plein. + */ +export interface DiskUsage { + total_bytes: number; + /** Blocs libres, blocs reserves du systeme de fichiers inclus. */ + free_bytes: number; + /** Blocs utilisables par le processus (hors reserve root). */ + available_bytes: number; +} + +export const diskUsage = async (target: string): Promise => { + try { + const info = await statfs(target, { bigint: true }); + return { + total_bytes: Number(info.blocks * info.bsize), + free_bytes: Number(info.bfree * info.bsize), + available_bytes: Number(info.bavail * info.bsize), + }; + } catch { + // Support absent ou non monté : l'appelant decide du repli. + return null; + } +}; diff --git a/docker-compose.yml b/docker-compose.yml index 8db5695..e7bedc1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -147,6 +147,7 @@ services: SMTP_PASSWORD: ${SMTP_PASSWORD:-} SMTP_FROM: ${SMTP_FROM} SMTP_SECURE: ${SMTP_SECURE:-false} + MAIL_LOGO_URL: ${MAIL_LOGO_URL:-} RATE_LIMIT_LOGIN_MAX: ${RATE_LIMIT_LOGIN_MAX:-10} RATE_LIMIT_LOGIN_WINDOW_MS: ${RATE_LIMIT_LOGIN_WINDOW_MS:-60000} TRUST_PROXY: ${TRUST_PROXY:-true} diff --git a/docker/reset-cloud.sql b/docker/reset-cloud.sql new file mode 100644 index 0000000..ebbf195 --- /dev/null +++ b/docker/reset-cloud.sql @@ -0,0 +1,21 @@ +-- Remise a zero du cloud en conservant les comptes administrateurs. +-- Execute par `make reset`. Les tables enfants partent avant les parents pour +-- rester compatible avec les contraintes de cle etrangere. + +DELETE FROM file_variants; +DELETE FROM media_metadata; +DELETE FROM share_links; +DELETE FROM files; +DELETE FROM folder_permissions; +DELETE FROM folders; +DELETE FROM user_avatars; +DELETE FROM password_reset_tokens; +DELETE FROM email_change_requests; +DELETE FROM user_sessions; +DELETE FROM audit_logs; + +-- Les comptes utilisateurs disparaissent, les administrateurs restent. +DELETE FROM users WHERE role_id NOT IN (SELECT id FROM roles WHERE slug = 'admin'); + +-- Le compteur logique des supports repart de zero en meme temps que le disque. +UPDATE storage_locations SET used_bytes = 0; diff --git a/docs/api.md b/docs/api.md index 88a8a38..6a9da17 100644 --- a/docs/api.md +++ b/docs/api.md @@ -106,10 +106,24 @@ par tous les membres authentifiés, en écriture pour son propriétaire. | Corps | `PUT /files` en flux brut (pas de multipart), `?name=` et `?folderId=` | | Taille | plafond `users.max_file_bytes`, vérifié en flux (coupure si dépassement) | | Quota | `users.used_bytes` + quota `storage_locations`, revérifiés avant écriture | +| Disque | `diskUsage()` (`statfs`) avant écriture ; `507` `INSUFFICIENT_STORAGE` si le support est plein | +| Quota support | un quota d'emplacement ne peut dépasser la capacité réelle du disque (`assertQuotaFits`) | | Chemin disque | dérivé du slug + UUID, jamais du nom affiché (`storage.ts`) | | Renommage | `PATCH /files/:id { name }`, `PATCH /folders/:id { name, description }` | | Déplacement | `folderId`/`parentId` : refuse de placer un dossier dans son propre sous-arbre | +## Courriels + +Les messages sortants sont construits par `backend/src/lib/mail-template.ts` : +gabarit HTML aux couleurs de l'app (`#b71c1c`), logo (`MAIL_LOGO_URL`, défaut +`PUBLIC_ORIGIN/logo.png`), bouton d'action et mention **ne pas répondre**. Un +repli texte accompagne chaque envoi. + +Points d'envoi : réinitialisation du mot de passe, changement d'adresse, et +**notification au nouvel utilisateur** à la création d'un compte admin +(identifiants temporaires + lien de connexion). Un échec d'envoi n'annule jamais +l'opération en base. + ## Modèle de données `backend/migrations/` — application stricte dans l'ordre, checksum SHA-256 diff --git a/docs/architecture.md b/docs/architecture.md index 73a4e20..88641cd 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -18,7 +18,7 @@ Node/TypeScript, une base MariaDB, un stockage de fichiers monté en volume. ## Découpage ``` -backend/src/lib/ socle serveur : config, db, mail, ratelimit, http, service, auth, errors +backend/src/lib/ socle serveur : config, db, mail, mail-template, ratelimit, http, service, auth, errors backend/src/ routes/, access.ts, storage.ts, media.ts, admin.ts backend/migrations/ 000 … 006 frontend/src/ui/ design system (boutons, cartes, champs, spinner) diff --git a/docs/deployment.md b/docs/deployment.md index 92ee400..c452d73 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -35,6 +35,7 @@ pose problème (`backend/src/lib/config.ts`). | `SMTP_USER` / `SMTP_PASSWORD` | authentification (vides = relais local) | vide | | `SMTP_FROM` | adresse d'expédition | — | | `SMTP_SECURE` | TLS implicite (port 465) | `false` | +| `MAIL_LOGO_URL` | logo des courriels (défaut `PUBLIC_ORIGIN/logo.png`) | vide | | `RATE_LIMIT_LOGIN_MAX` | tentatives par fenêtre | `10` | | `RATE_LIMIT_LOGIN_WINDOW_MS` | largeur de fenêtre | `60000` | | `LOG_LEVEL` | `silent…debug` | `info` | @@ -85,13 +86,38 @@ make db # redémarrer la base make migrate # rejouer explicitement les migrations (hors démarrage) make backup # dump horodaté → ./backups/cloud-.sql.gz make admin ARGS=... # créer / réinitialiser un compte +make purge-logs # vider le journal d'audit +make reset # cloud vierge, administrateurs conservés (confirmation) make dev # Vite 5174, proxy /api → 3101 make check # typecheck + build make down # arrêt, volumes conservés ``` -`make backup` lit le mot de passe **dans le conteneur** : il ne passe ni par la -commande, ni par le dépôt. +`make backup`, `make purge-logs` et `make reset` lisent le mot de passe **dans +le conteneur** : il ne passe ni par la commande, ni par le dépôt. + +## Maintenance + +### Vider les journaux + +`make purge-logs` supprime le contenu de `audit_logs` (table +`docker/reset-cloud.sql` mise à part). Les comptes, fichiers et dossiers sont +intacts. + +### Remettre le cloud à zéro + +`make reset` repart d'une instance vierge **en conservant les comptes +administrateurs** : + +- supprime fichiers, dossiers, partages, permissions, avatars, sessions, jetons + (réinitialisation, changement d'adresse) et journaux d'audit ; +- supprime tous les comptes **sauf** ceux dont le rôle est `admin` ; +- remet `storage_locations.used_bytes` à zéro ; +- efface les médias sur disque (`$CLOUD_MEDIA_DIR`), originaux, vignettes et + avatars compris. + +La commande demande une confirmation (`o`/`y`). Enchaîner `make backup` avant +si l'état doit être conservé. ## Migrations diff --git a/frontend/index.html b/frontend/index.html index 99cf0e3..86b8080 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -7,7 +7,8 @@ CoHaiSe Cloud - + + diff --git a/frontend/public/logo.png b/frontend/public/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..59bda2071c3d7092d4b67e9f338e316af6649555 GIT binary patch literal 51332 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