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
This commit is contained in:
2026-10-16 11:59:34 +02:00
parent f564908650
commit 739bc26b43
18 changed files with 382 additions and 11 deletions
+3
View File
@@ -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.
+22 -1
View File
@@ -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
+8
View File
@@ -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),
+3
View File
@@ -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 {
+7
View File
@@ -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,
+133
View File
@@ -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, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;")
.replace(/'/g, "&#39;");
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) =>
`<p style="margin:0 0 16px;font-size:15px;line-height:1.6;color:#3f3f46;">${escapeHtml(paragraph)}</p>`,
)
.join("");
const credentials = content.credentials
? `
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin:0 0 24px;background:#fafafa;border:1px solid #e4e4e7;border-radius:10px;">
<tr><td style="padding:16px 18px;font-family:${FONT};">
<p style="margin:0 0 10px;font:600 12px ${FONT};letter-spacing:.04em;text-transform:uppercase;color:#71717a;">Vos identifiants</p>
<p style="margin:0 0 6px;font:400 14px ${FONT};color:#3f3f46;">Adresse : <strong style="color:#18181b;">${escapeHtml(content.credentials.email)}</strong></p>
<p style="margin:0;font:400 14px ${FONT};color:#3f3f46;">Mot de passe temporaire :
<span style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:14px;background:#ffffff;border:1px solid #e4e4e7;border-radius:6px;padding:2px 8px;color:#18181b;">${escapeHtml(content.credentials.password)}</span>
</p>
</td></tr>
</table>`
: "";
const cta = content.cta
? `
<table role="presentation" cellpadding="0" cellspacing="0" style="margin:0 0 24px;">
<tr><td align="center" style="background:${brand.color};border-radius:10px;">
<a href="${escapeHtml(content.cta.url)}" style="display:inline-block;padding:13px 30px;font:600 15px ${FONT};color:#ffffff;text-decoration:none;">${escapeHtml(content.cta.label)}</a>
</td></tr>
</table>`
: "";
const note = content.note
? `
<p style="margin:0;font:400 13px ${FONT};line-height:1.6;color:#71717a;">${escapeHtml(content.note)}</p>`
: "";
const html = `<!doctype html>
<html lang="fr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light only">
<title>${escapeHtml(content.heading)}</title>
</head>
<body style="margin:0;padding:0;background:#f4f4f5;">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:#f4f4f5;">${escapeHtml(content.preview)}</div>
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f4f4f5;padding:32px 12px;">
<tr><td align="center">
<table role="presentation" width="560" cellpadding="0" cellspacing="0" style="width:100%;max-width:560px;background:#ffffff;border:1px solid #e4e4e7;border-radius:14px;overflow:hidden;">
<tr><td style="background:${brand.color};padding:18px 28px;">
<a href="${escapeHtml(brand.origin)}" style="text-decoration:none;">
<img src="${escapeHtml(brand.logoUrl)}" width="34" height="34" alt="" style="vertical-align:middle;border:0;border-radius:9px;background:#ffffff;">
<span style="vertical-align:middle;margin-left:12px;font:600 17px ${FONT};color:#ffffff;">${escapeHtml(brand.appName)}</span>
</a>
</td></tr>
<tr><td style="padding:32px 28px 6px;font-family:${FONT};">
<h1 style="margin:0 0 16px;font:600 21px ${FONT};line-height:1.3;color:#18181b;">${escapeHtml(content.heading)}</h1>
<p style="margin:0 0 16px;font:400 15px ${FONT};line-height:1.6;color:#3f3f46;">${escapeHtml(content.intro)}</p>
${paragraphs}${credentials}${cta}${note}
</td></tr>
<tr><td style="padding:20px 28px 28px;font-family:${FONT};">
<hr style="border:0;border-top:1px solid #e4e4e7;margin:0 0 16px;">
<p style="margin:0 0 4px;font:400 12px ${FONT};line-height:1.6;color:#71717a;">Message automatique : merci de ne pas repondre a cet e-mail.</p>
<p style="margin:0;font:400 12px ${FONT};line-height:1.6;color:#a1a1aa;">${escapeHtml(brand.footer)}</p>
</td></tr>
</table>
<p style="margin:18px 0 0;font:400 12px ${FONT};color:#a1a1aa;">${escapeHtml(brand.appName)} — <a href="${escapeHtml(brand.origin)}" style="color:#a1a1aa;">${escapeHtml(brand.origin.replace(/^https?:\/\//, ""))}</a></p>
</td></tr>
</table>
</body>
</html>`;
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") };
};
+3
View File
@@ -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 } : {}),
});
},
};
+28 -3
View File
@@ -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<typeof clientIp>[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);
+69 -2
View File
@@ -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<typeof currentUser>[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<void> => {
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<AdminUserRow>(`${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[] = [];
+11
View File
@@ -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);
+28 -1
View File
@@ -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<boolean> => {
};
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<DiskUsage | null> => {
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;
}
};
+1
View File
@@ -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}
+21
View File
@@ -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;
+14
View File
@@ -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
+1 -1
View File
@@ -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)
+28 -2
View File
@@ -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-<stamp>.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
+2 -1
View File
@@ -7,7 +7,8 @@
<meta name="theme-color" content="#b71c1c" />
<title>CoHaiSe Cloud</title>
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="apple-touch-icon" href="/favicon.ico" />
<link rel="icon" type="image/png" href="/logo.png" />
<link rel="apple-touch-icon" href="/logo.png" />
<script src="/theme.js"></script>
</head>
<body>
Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB