feat: logo et favicon, confirmation modale, fil d'ariane, e-mails sombres #4

Merged
Esiah merged 4 commits from feat/standalone-app into main 2026-10-16 11:08:47 +00:00
105 changed files with 2638 additions and 592 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 le logo embarque (backend/src/assets/logo.png,
# joint au message) ; renseigner une URL pour forcer une image distante.
MAIL_LOGO_URL=
# --- Limitation des connexions -------------------------------------------
# Tentatives de connexion autorisees par fenetre et par IP.
+1 -1
View File
@@ -32,7 +32,7 @@ jobs:
git pull --ff-only origin main
# Le build des images compile et typecheck chaque workspace (tsc) :
# aucune toolchain Node n'est requise sur l'hote.
docker compose build api nginx
docker compose build api migrate nginx
make front
docker compose up -d api nginx
docker image prune -f
+23 -2
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,8 +77,27 @@ 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/cloud
npm run dev --workspace=frontend
typecheck:
npm run typecheck
+5 -6
View File
@@ -6,15 +6,14 @@ 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
frontend application React + Vite, design system inclus (src/ui, src/styles)
backend API : socle serveur (src/lib), auth, dossiers, fichiers, médias
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.
Chaque application porte son propre code : le socle serveur (`backend/src/lib`)
et le design system (`frontend/src/ui`) appartiennent au Cloud et ne sont
partagés avec aucun autre dépôt.
## Démarrer
-17
View File
@@ -1,17 +0,0 @@
{
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.base.json",
"compilerOptions": {
"module": "NodeNext",
"moduleResolution": "NodeNext",
"lib": ["ES2023"],
"types": ["node"],
"rootDir": "src",
"outDir": "dist",
"composite": true,
"declaration": true,
"sourceMap": true
},
"include": ["src/**/*.ts"],
"references": [{ "path": "../shared" }]
}
@@ -11,7 +11,9 @@
"admin": "node dist/admin.js"
},
"dependencies": {
"@cohaise/server": "*",
"@hono/node-server": "^2.1.3",
"hono": "^4.13.13",
"mysql2": "^3.24.5",
"nodemailer": "^10.1.1",
"sharp": "^0.35.5",
"zod": "^4.6.5"
@@ -22,6 +24,7 @@
"typescript": "^7.0.2"
},
"bin": {
"cohaise-admin": "./dist/admin.js"
"cohaise-admin": "./dist/admin.js",
"cohaise-migrate": "./dist/cli.js"
}
}
-33
View File
@@ -1,33 +0,0 @@
{
"name": "@cohaise/server",
"version": "0.0.0",
"private": true,
"type": "module",
"exports": {
".": {
"types": "./dist/index.d.ts",
"default": "./dist/index.js"
}
},
"files": [
"dist"
],
"scripts": {
"build": "tsc --build",
"clean": "node --eval \"import('node:fs').then(fs => { fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('tsconfig.tsbuildinfo', { force: true }); })\"",
"typecheck": "tsc --noEmit"
},
"devDependencies": {
"@types/node": "^24.0.0",
"typescript": "^7.0.2"
},
"dependencies": {
"@hono/node-server": "^2.1.3",
"hono": "^4.13.13",
"mysql2": "^3.24.5",
"zod": "^4.6.5"
},
"bin": {
"cohaise-migrate": "./dist/cli.js"
}
}
@@ -1,5 +1,5 @@
import type { Context } from "hono";
import { clientIp as sharedClientIp, type Db, type SessionUser } from "@cohaise/server";
import { clientIp as sharedClientIp, type Db, type SessionUser } from "./lib/index.js";
/**
* Les droits sont toujours recalcules depuis la session serveur. Le role de
@@ -1,6 +1,6 @@
#!/usr/bin/env node
import { randomUUID } from "node:crypto";
import { ConfigError, loadDbConfig, hashPassword, AppError, toSafeError } from "@cohaise/server";
import { ConfigError, loadDbConfig, hashPassword, AppError, toSafeError } from "./lib/index.js";
/**
* Creation et reinitialisation des comptes, en dehors de toute requete HTTP.
@@ -98,7 +98,7 @@ const main = async (argv: string[]): Promise<number> => {
throw error;
}
const { Db } = await import("@cohaise/server");
const { Db } = await import("./lib/index.js");
const db = new Db(config);
try {
Binary file not shown.

After

Width:  |  Height:  |  Size: 138 KiB

@@ -1,6 +1,6 @@
import { dirname, join } from "node:path";
import { fileURLToPath } from "node:url";
import { purgeExpiredSessions, startService } from "@cohaise/server";
import { purgeExpiredSessions, startService } from "./lib/index.js";
import { registerAccountRoutes } from "./routes/account.js";
import { registerAdminRoutes } from "./routes/admin.js";
import { registerAuthRoutes } from "./routes/auth.js";
@@ -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 le logo embarque (`backend/src/assets/logo.png`,
* joint au message) ; renseigner une URL pour forcer une image distante.
*/
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),
@@ -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 {
@@ -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,
+147
View File
@@ -0,0 +1,147 @@
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;
}
/**
* Identifiant de la piece jointe du logo. Le logo est embarque dans le message
* (voir `mail.ts`) : l'image s'affiche meme si le client bloque les ressources
* distantes. `MAIL_LOGO_URL` force une image distante a la place.
*/
export const LOGO_CID = "cohaise-logo";
export const branding = (config: Config): Branding => ({
appName: "CoHaiSe Cloud",
origin: config.PUBLIC_ORIGIN,
logoUrl: config.MAIL_LOGO_URL ?? `cid:${LOGO_CID}`,
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:#c9c2c2;text-align:center;">${escapeHtml(paragraph)}</p>`,
)
.join("");
const credentials = content.credentials
? `
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="margin:0 auto 26px;max-width:420px;background:#1b1212;border:1px solid #332222;border-radius:10px;">
<tr><td style="padding:16px 18px;font-family:${FONT};text-align:left;">
<p style="margin:0 0 10px;font:600 12px ${FONT};letter-spacing:.04em;text-transform:uppercase;color:#9c9292;">Vos identifiants</p>
<p style="margin:0 0 6px;font:400 14px ${FONT};color:#c9c2c2;">Adresse : <strong style="color:#f7f5f5;">${escapeHtml(content.credentials.email)}</strong></p>
<p style="margin:0;font:400 14px ${FONT};color:#c9c2c2;">Mot de passe temporaire :
<span style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:14px;background:#241818;border:1px solid #3a2828;border-radius:6px;padding:2px 8px;color:#f7f5f5;">${escapeHtml(content.credentials.password)}</span>
</p>
</td></tr>
</table>`
: "";
const cta = content.cta
? `
<table role="presentation" cellpadding="0" cellspacing="0" align="center" style="margin:0 auto 26px;">
<tr><td align="center" style="background:${brand.color};border-radius:10px;">
<a href="${escapeHtml(content.cta.url)}" style="display:inline-block;padding:14px 32px;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:#8a8282;text-align:center;">${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="dark only">
<meta name="supported-color-schemes" content="dark only">
<title>${escapeHtml(content.heading)}</title>
</head>
<body style="margin:0;padding:0;background:#050000;">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:#050000;">${escapeHtml(content.preview)}</div>
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#050000;padding:32px 12px;">
<tr><td align="center">
<table role="presentation" width="560" cellpadding="0" cellspacing="0" style="width:100%;max-width:560px;background:#140d0d;border:1px solid #2a1c1c;border-radius:14px;overflow:hidden;">
<tr><td style="background:${brand.color};padding:17px 28px;text-align:center;">
<span style="font:700 14px ${FONT};letter-spacing:.18em;text-transform:uppercase;color:#ffffff;">${escapeHtml(brand.appName)}</span>
</td></tr>
<tr><td style="padding:40px 30px 6px;font-family:${FONT};text-align:center;">
<h1 style="margin:0 0 18px;font:700 28px ${FONT};line-height:1.25;color:#f7f5f5;">${escapeHtml(content.heading)}</h1>
<p style="margin:0 0 28px;font:400 15px ${FONT};line-height:1.65;color:#c9c2c2;">${escapeHtml(content.intro)}</p>
</td></tr>
<tr><td style="padding:0 30px 14px;font-family:${FONT};text-align:center;">
${paragraphs}${credentials}${cta}${note}
</td></tr>
<tr><td style="padding:20px 28px 24px;background:#0d0808;border-top:1px solid #2a1c1c;">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0">
<tr>
<td style="vertical-align:middle;font-family:${FONT};">
<p style="margin:0 0 4px;font:400 12px ${FONT};line-height:1.6;color:#8a8282;">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:#8a8282;">${escapeHtml(brand.footer)}</p>
</td>
<td align="right" style="vertical-align:middle;padding-left:16px;">
<img src="${escapeHtml(brand.logoUrl)}" width="44" height="44" alt="" style="display:block;border:0;border-radius:10px;background:#ffffff;">
</td>
</tr>
</table>
</td></tr>
</table>
</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") };
};
@@ -1,5 +1,7 @@
import { readFileSync } from "node:fs";
import { createTransport, type Transporter } from "nodemailer";
import type { Config } from "./config.js";
import { LOGO_CID } from "./mail-template.js";
/**
* Envoi de courriel via SMTP.
@@ -9,10 +11,26 @@ import type { Config } from "./config.js";
* laisser une reinitialisation de mot de passe silencieusement sans effet.
*/
/**
* Logo embarque dans les messages. Le chemin remonte depuis `src/lib` ou
* `dist/lib` vers `backend/src/assets/logo.png`, present dans l'image.
*/
const LOGO_PATH = new URL("../../src/assets/logo.png", import.meta.url);
const loadLogo = (): Buffer | null => {
try {
return readFileSync(LOGO_PATH);
} catch {
return null;
}
};
export interface MailMessage {
to: string;
subject: string;
text: string;
/** Version enrichie ; les clients texte recoivent `text`, les autres `html`. */
html?: string;
}
export interface Mailer {
@@ -31,13 +49,22 @@ export const createMailer = (config: Config): Mailer => {
disableUrlAccess: true,
});
// Logo embarque une seule fois. `MAIL_LOGO_URL` le remplace par une image
// distante : dans ce cas on n'attache rien.
const logo = config.MAIL_LOGO_URL ? null : loadLogo();
return {
send: async (message) => {
const inlineLogo = logo !== null && message.html?.includes(`cid:${LOGO_CID}`) === true;
await transport.sendMail({
from: config.SMTP_FROM,
to: message.to,
subject: message.subject,
text: message.text,
...(message.html ? { html: message.html } : {}),
...(inlineLogo
? { attachments: [{ filename: "logo.png", content: logo, cid: LOGO_CID }] }
: {}),
});
},
};
@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
import { mkdir, stat } from "node:fs/promises";
import path from "node:path";
import sharp from "sharp";
import type { Config, Db } from "@cohaise/server";
import type { Config, Db } from "./lib/index.js";
import { absolutePath } from "./storage.js";
/**
@@ -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,
@@ -21,9 +23,9 @@ import {
type Config,
type Db,
type SessionUser,
} from "@cohaise/server";
} 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);
@@ -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 "@cohaise/server";
} 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[] = [];
@@ -18,7 +18,7 @@ import {
type App,
type Config,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
const credentials = z.object({
email: z.string().trim().min(3).max(255),
@@ -11,13 +11,14 @@ import {
type App,
type Config,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
import { audit, canRead, canWrite, canWriteExplicit } from "../access.js";
import { indexMedia, thumbnailSize } from "../media.js";
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);
@@ -9,7 +9,7 @@ import {
type App,
type Config,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
import { audit, canManageFolder, canRead, canWrite } from "../access.js";
const uuid = z
@@ -5,7 +5,7 @@ import {
requireAuth,
type App,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
/**
* Galerie : liste des fichiers accompagnes de leur nature (image, video,
@@ -5,7 +5,7 @@ import {
requireAuth,
type App,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
/**
* Recherche par nom, filtree par les droits de la session. Le motif est
@@ -7,7 +7,7 @@ import {
type App,
type Config,
type Db,
} from "@cohaise/server";
} from "../lib/index.js";
import { audit } from "../access.js";
import { absolutePath, discard } from "../storage.js";
@@ -1,10 +1,10 @@
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";
import { AppError, type Db } from "@cohaise/server";
import { AppError, type Db } from "./lib/index.js";
/**
* Chemin physique : ${MEDIA_DIR}/${slug emplacement}/${uuid}.
@@ -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,6 +1,6 @@
{
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.base.json",
"extends": "../tsconfig.base.json",
"compilerOptions": {
"module": "NodeNext",
"moduleResolution": "NodeNext",
@@ -10,7 +10,6 @@
"outDir": "dist",
"composite": true,
"declaration": true,
"declarationMap": true,
"sourceMap": true
},
"include": ["src/**/*.ts"]
+8 -8
View File
@@ -18,10 +18,9 @@ x-app: &app
volumes:
- ./docker/publish.sh:/publish.sh:ro
# Les services de migration tournent l'executable cohaise-migrate depuis
# backend/shared. Ils ne lisent aucun fichier .env : Docker resout les
# variables ci-dessous au lancement, elles ne passent donc jamais par un
# terminal ni par le depot.
# Les services de migration tournent la CLI cohaise-migrate deposee par le
# backend. Ils ne lisent aucun fichier .env : Docker resout les variables
# ci-dessous au lancement, elles ne passent donc jamais par un terminal.
x-migrate-build: &migrate-build
context: .
dockerfile: docker/Dockerfile.api
@@ -29,7 +28,7 @@ x-migrate-build: &migrate-build
# DNS mort (routeur), ce qui casse `npm ci` dans le conteneur.
network: host
args:
APP_DIR: backend/shared
APP_DIR: backend
services:
app-build:
@@ -40,7 +39,7 @@ services:
target: export
network: host
args:
APP_DIR: frontend/cloud
APP_DIR: frontend
volumes:
- app_data:/output
- ./docker/publish.sh:/publish.sh:ro
@@ -111,7 +110,7 @@ services:
DB_NAME: ${CLOUD_DATABASE}
command: ["node", "dist/cli.js", "--dir", "/migrations"]
volumes:
- ./backend/cloud/migrations:/migrations:ro
- ./backend/migrations:/migrations:ro
api:
container_name: cohaise-cloud-api
@@ -120,7 +119,7 @@ services:
dockerfile: docker/Dockerfile.api
network: host
args:
APP_DIR: backend/cloud
APP_DIR: backend
image: cohaise-cloud-api
restart: unless-stopped
depends_on:
@@ -148,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}
-4
View File
@@ -10,7 +10,6 @@ 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.
@@ -27,9 +26,6 @@ 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}
-1
View File
@@ -8,7 +8,6 @@ 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
+6 -7
View File
@@ -34,11 +34,10 @@ Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
### `Dockerfile.app` (front)
- `ARG APP_DIR` → `frontend/cloud` (passé par compose).
- `ARG APP_DIR` → `frontend` (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.
`npm run build --workspace=${APP_DIR}` — le design system est dans le même
paquet, aucun build préalable n'est nécessaire.
- Stage `export` : recopie `dist/` seul, sans sources ni `node_modules`.
### `Dockerfile.api` (back, utilisé deux fois)
@@ -47,8 +46,8 @@ Supprime le `default.conf` par défaut, copie `cloud.conf` et les snippets,
| Service | `APP_DIR` | Résultat |
| --- | --- | --- |
| `migrate` | `backend/shared` | binaire `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend/cloud` | serveur Hono (`dist/index.js`) |
| `migrate` | `backend` | CLI `cohaise-migrate` (`dist/cli.js`) |
| `api` | `backend` | 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`).
@@ -80,7 +79,7 @@ Pendant la copie, nginx sert l'ancienne version : aucun reload, aucune coupure.
## Migrations
Le service `migrate` monte `./backend/cloud/migrations:/migrations:ro` (lecture
Le service `migrate` monte `./backend/migrations:/migrations:ro` (lecture
seule) et lance :
```sh
+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;
+3 -3
View File
@@ -46,18 +46,18 @@ CI). L'exécuter avant de déclarer un travail fini.
- Erreurs : `AppError` + codes (`errors.ts`) — jamais `throw` brut, jamais de
détail de schéma dans une 500.
- SQL : requêtes préparées uniquement, pas de `raw()` hors DDL.
- Front : un seul client HTTP (`frontend/cloud/src/lib/api.ts`),
- Front : un seul client HTTP (`frontend/src/lib/api.ts`),
`credentials: "same-origin"`. React Router 7 (`App.tsx`) + `AppShell`, contexte
de session dans `lib/session.tsx`.
- `.editorconfig` : 2 espaces, LF, UTF-8.
## Design system
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
Le design system vit dans `frontend/src/ui`.
- `tokens.css` est la source unique des couleurs et typographies ; ne pas coder
de couleur en dur ailleurs.
- Un composant propre à une page se développe dans `frontend/cloud`, pas dans le
- Un composant propre à une page se développe dans `frontend`, pas dans le
design system.
- Palette : accent carmin `#b71c1c`, destructif rouge `#d32f2f`/`#ef4444`,
avertissement jaune. Aucune orange.
+20 -3
View File
@@ -84,7 +84,7 @@ d'adresse).
## Droits d'accès
Calculés **en base à chaque requête**, depuis la session — jamais depuis un
en-tête (`backend/cloud/src/access.ts`).
en-tête (`backend/src/access.ts`).
| Concept | Règle |
| --- | --- |
@@ -106,13 +106,30 @@ 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, bouton d'action et mention
**ne pas répondre**. Un repli texte accompagne chaque envoi.
Le logo `backend/src/assets/logo.png` est **embarqué** dans le message (pièce
jointe `cid`), donc visible même quand le client bloque les images distantes.
`MAIL_LOGO_URL` force une image distante à la place.
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/cloud/migrations/` — application stricte dans l'ordre, checksum SHA-256
`backend/migrations/` — application stricte dans l'ordre, checksum SHA-256
par fichier, dérive refusée au démarrage.
| Fichier | Contenu |
@@ -131,7 +148,7 @@ password_reset_tokens, email_change_requests, audit_logs`.
## Erreurs métier
`AppError` avec codes stables (`backend/shared/src/errors.ts`). Correspondances
`AppError` avec codes stables (`backend/src/lib/errors.ts`). Correspondances
MariaDB : `1062` → 409, `1146` → 503 `NOT_MIGRATED`, `1406` → 422. Le corps d'une
500 ne contient jamais de détail de schéma. Réponse normalisée :
+18 -17
View File
@@ -8,27 +8,28 @@ Node/TypeScript, une base MariaDB, un stockage de fichiers monté en volume.
| Élément | Où |
| --- | --- |
| React 19 + Vite 8 + Tailwind 4 + react-router-dom 7 | `frontend/cloud` |
| Hono | `backend/cloud/src/index.ts` (`@cohaise/server` pour le socle) |
| MariaDB (`mysql2`) | `backend/shared/src/db.ts` |
| Nodemailer | `backend/shared/src/mail.ts` |
| sharp (vignettes) | `backend/cloud/src/media.ts` |
| Validation Zod | `backend/shared/src/config.ts` et chaque route |
| React 19 + Vite 8 + Tailwind 4 + react-router-dom 7 | `frontend` |
| Hono | `backend/src/index.ts` (`src/lib` pour le socle) |
| MariaDB (`mysql2`) | `backend/src/lib/db.ts` |
| Nodemailer | `backend/src/lib/mail.ts` |
| sharp (vignettes) | `backend/src/media.ts` |
| Validation Zod | `backend/src/lib/config.ts` et chaque route |
## Découpage
```
backend/shared/ @cohaise/server : config, db, mail, ratelimit, http, service, auth, errors
backend/cloud/ routes/, access.ts, storage.ts, media.ts, cli.ts
backend/cloud/migrations/ 000 … 006
frontend/shared/ @cohaise/ui : Design System (boutons, cartes, champs, spinner)
frontend/cloud/ router + AppShell + pages/
docker/ Dockerfile(.app/.api), nginx/, publish.sh
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)
frontend/src/ router + AppShell + pages/
docker/ Dockerfile(.app/.api), nginx/, publish.sh
```
`backend/shared` est générique (sessions, erreurs, migrations, courriel,
limitation de débit) ; `backend/cloud` porte le métier : droits, quotas, chemins
disque, traitement média.
`backend/src/lib` porte la mécanique générique (sessions, erreurs,
migrations, courriel, limitation de débit), le reste de `backend` porte le
métier : droits, quotas, chemins disque, traitement média. Tout vit dans un seul
paquet, sans dépendance de workspace.
## Chaîne de démarrage
@@ -41,7 +42,7 @@ db ──healthy──▶ migrate (runMigrations + assertNoDrift, puis s'arrête
app-build (publish.sh, terminé avant nginx)
```
- `migrate` monte `./backend/cloud/migrations:/migrations:ro`.
- `migrate` monte `./backend/migrations:/migrations:ro`.
- `api` refuse de démarrer si une migration appliquée a été modifiée (dérive de
checksum). `onReady` purge les sessions et la corbeille expirées.
- stockage : `app_data` (volume Docker, HTML), `$CLOUD_DB_DIR` (MariaDB) et
@@ -50,7 +51,7 @@ app-build (publish.sh, terminé avant nginx)
## API et front
- API `/api/cloud` : voir [`api.md`](api.md).
- Front : React Router (`frontend/cloud/src/App.tsx`) avec gardes
- Front : React Router (`frontend/src/App.tsx`) avec gardes
`RequireAuth` / `RequireReady` / `RequireAdmin` et `AppShell`
(`components/AppShell.tsx`) : navigation latérale, en-tête, contenu.
- Pages : `Login`, `ForgotPassword`, `ResetPassword`, `ConfirmEmail`,
+29 -3
View File
@@ -12,7 +12,7 @@ Réponse sur **`http://localhost:8083`**.
La configuration est validée **avant** l'ouverture d'aucun port : si une variable
manque ou est mal formée, le process s'arrête en listant exactement ce qui
pose problème (`backend/shared/src/config.ts`).
pose problème (`backend/src/lib/config.ts`).
## Variables
@@ -35,6 +35,7 @@ pose problème (`backend/shared/src/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 distant des courriels (sinon logo embarqué `backend/src/assets/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
+3 -3
View File
@@ -17,7 +17,7 @@
### Limitation de débit
- **Applicatif** : `createRateLimiter` (`backend/shared/src/ratelimit.ts`) par IP
- **Applicatif** : `createRateLimiter` (`backend/src/lib/ratelimit.ts`) par IP
sur `auth/login`, `account/forgot-password`, `account/reset-password`,
`account/email-change`. Réglages `RATE_LIMIT_LOGIN_MAX` (10) et
`RATE_LIMIT_LOGIN_WINDOW_MS` (60 s).
@@ -27,14 +27,14 @@
### Droits d'accès
Calculés **en base à chaque requête**, depuis la session — jamais depuis un
en-tête (`backend/cloud/src/access.ts`). Lecture : propriétaire, permission
en-tête (`backend/src/access.ts`). Lecture : propriétaire, permission
`folder_permissions` (`read`/`write`/`admin`), ou dossier `public`. Écriture :
`write`/`admin`. **404 plutôt que 403** : jamais d'indice sur l'existence d'une
ressource.
### Courriel
Nodemailer (`backend/shared/src/mail.ts`) avec `SMTP_HOST`. `PUBLIC_ORIGIN`
Nodemailer (`backend/src/lib/mail.ts`) avec `SMTP_HOST`. `PUBLIC_ORIGIN`
(obligatoire) construit les liens de réinitialisation et de confirmation ;
aucun HTML utilisateur n'est injecté dans les messages.
+7 -6
View File
@@ -9,7 +9,7 @@ désactivé pour les `.md`. Aucun Prettier/ESLint installé.
## Palette
Source unique : `frontend/shared/src/styles/tokens.css`.
Source unique : `frontend/src/styles/tokens.css`.
| Jeton | Rôle | Valeur |
| --- | --- | --- |
@@ -32,15 +32,16 @@ Règles :
## Typographies
Poppins (texte), Orbitron et Cinzel (display), JetBrains Mono (code) —
woff2 hébergés dans `frontend/shared/fonts/`, jamais par CDN.
woff2 hébergés dans `frontend/src/fonts/`, jamais par CDN.
## Composants
`@cohaise/ui` : `Button`, `Card`, `Input`, `Skeleton`, `Spinner`, `cn`.
Design system local à `frontend/src/ui` : `Button`, `Card`, `Input`,
`Skeleton`, `Spinner`, `cn`.
- Les composants du design system ne connaissent **jamais** le métier du Cloud.
- Une variante propre à cette app se développe dans `frontend/cloud`, pas dans
`frontend/shared`.
- Une variante propre à cette app se développe dans `frontend/src`, jamais
dans `src/ui`.
## Côté serveur
@@ -53,7 +54,7 @@ woff2 hébergés dans `frontend/shared/fonts/`, jamais par CDN.
| Élément | Attendu |
| --- | --- |
| `shared` | vit dans ce dépôt, cycle de vie commun |
| Socle & design system | internes à `backend/src/lib` et `frontend/src/ui` |
| Port HTTP | `8083` (`COHAISE_HTTP_PORT`) |
| Dépôt | autonome, importance égale front et back |
| `.env` | jamais versionné (`.env.example` seulement) |
+13 -13
View File
@@ -33,18 +33,18 @@ fichier est copié dans l'image, pas monté.
## Modifier une route
1. Schéma d'entrée : Zod dans `backend/cloud/src/routes/<entity>.ts`.
2. Droits : passer par `backend/cloud/src/access.ts` (jamais par un paramètre
1. Schéma d'entrée : Zod dans `backend/src/routes/<entity>.ts`.
2. Droits : passer par `backend/src/access.ts` (jamais par un paramètre
venu du client).
3. Réponse : renvoyer **404** si la ressource n'est pas censée exister pour ce
compte, 403 seulement pour une règle explicite.
4. Erreur métier : `AppError` depuis `backend/shared/src/errors.ts`.
4. Erreur métier : `AppError` depuis `backend/src/lib/errors.ts`.
5. Audit si l'action est sensible (`audit()` dans `access.ts`).
6. `make check`, puis redémarrage de l'API (`docker compose up -d api`).
## Modifier le schéma
1. Écrire `backend/cloud/migrations/00N_….sql` (número suivant, jamais éditer
1. Écrire `backend/migrations/00N_….sql` (número suivant, jamais éditer
un fichier déjà appliqué).
2. Vérifier : `docker compose run --rm migrate node dist/cli.js --dir /migrations --check`
3. Appliquer : `make migrate` ou redémarrage de l'API.
@@ -56,24 +56,24 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
## Modifier le design system
`frontend/shared` (`@cohaise/ui`) vit dans ce dépôt.
Le design system vit dans `frontend/src/ui` (+ `src/styles`).
- `tokens.css` porte les couleurs et typographies ; ne pas en coder ailleurs.
- Après modification : `npm run build --workspace=frontend/shared && make front`.
- Après modification : `make front` (le build Vite reprend tout).
## Où changer quoi
| Besoin | Fichier |
| --- | --- |
| Droit d'accès à un dossier/fichier | `backend/cloud/src/access.ts` |
| Droit d'accès à un dossier/fichier | `backend/src/access.ts` |
| Taille/quota par défaut | migration `004`, table `users` / `settings` |
| Chemin physique des fichiers | `backend/cloud/src/storage.ts` |
| En-têtes, CORS, healthz | `backend/shared/src/http.ts` |
| Chemin physique des fichiers | `backend/src/storage.ts` |
| En-têtes, CORS, healthz | `backend/src/lib/http.ts` |
| Durée de session | `SESSION_TTL_HOURS` |
| Port | `COHAISE_HTTP_PORT` (nginx), `COHAISE_API_PORT` (API) |
| Interface (parcours dossiers) | `frontend/cloud/src/pages/Browser.tsx` |
| Routes et gardes du front | `frontend/cloud/src/App.tsx` |
| Couleurs / composants | `frontend/shared/src/styles/tokens.css` |
| Interface (parcours dossiers) | `frontend/src/pages/Browser.tsx` |
| Routes et gardes du front | `frontend/src/App.tsx` |
| Couleurs / composants | `frontend/src/styles/tokens.css` |
## Git
@@ -86,7 +86,7 @@ migration, pas en éditant l'ancienne (le checksum bloquerait le démarrage).
1. **`.env` local désynchronisé** de `.env.example` : les clés `COHAISE_*`
manquantes basculent silencieusement sur les défauts compose.
2. **README de paquet** (`docker/README.md`, `backend/cloud/README.md`) : états
2. **README de paquet** (`docker/README.md`, `backend/README.md`) : états
antérieurs du dépôt. Se fier à ce dossier `docs/`.
3. **Limitation de débit active** (applicatif + nginx) : une rafale peut renvoyer
`419`/`503`.
-4
View File
@@ -1,4 +0,0 @@
@import "tailwindcss";
@import "@cohaise/ui/styles";
@source "../../../../frontend/shared/src";
@@ -4,7 +4,11 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="color-scheme" content="light dark" />
<meta name="theme-color" content="#b71c1c" />
<title>CoHaiSe Cloud</title>
<link rel="icon" href="/favicon.ico" sizes="any" />
<link rel="icon" type="image/png" href="/icon.png" />
<link rel="apple-touch-icon" href="/icon.png" />
<script src="/theme.js"></script>
</head>
<body>
@@ -10,10 +10,11 @@
"preview": "vite preview"
},
"dependencies": {
"@cohaise/ui": "*",
"clsx": "^2.1.1",
"react": "^19.3.0",
"react-dom": "^19.3.0",
"react-router-dom": "^7.18.4"
"react-router-dom": "^7.18.4",
"tailwind-merge": "^3.7.0"
},
"devDependencies": {
"@tailwindcss/vite": "^4.3.3",
Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 138 KiB

-186
View File
@@ -1,186 +0,0 @@
# @cohaise/ui
Design system du Cloud. Point d'entrée unique des jetons de style
utilisés par `frontend/cloud`, garantissant une identité visuelle
homogène et la thématisation dynamique clair/sombre.
## Couche de jetons
Ce paquet expose une chaîne CSS en trois fichiers, du plus primitif au plus dérivé.
| Fichier | Rôle |
|---|---|
| `src/styles/tokens.css` | Variables CSS brutes (`--cohaise-*`). Échelle de gris en `oklch`, jetons sémantiques, ombres, typographie, rayons, courbes et durées de mouvement. |
| `src/styles/theme.css` | Directive `@theme inline` mappant les variables brutes vers les utilitaires Tailwind (`bg-surface`, `text-muted-foreground`, `border-border`...). |
| `src/styles/index.css` | Point d'entrée, importe les deux fichiers ci-dessus. |
### Mouvement
Tailwind v4 ne réserve pas de namespace de thème aux durées : `duration-*` est un
utilitaire à valeur nue. Les trois durées sont donc exposées via `@utility` dans
`theme.css`, adossées aux jetons `--cohaise-duration-*`.
`--default-transition-duration` et `--default-transition-timing-function` sont
également déclarés, si bien que toute classe `transition-*` hérite du mouvement du
design system sans avoir à le répéter :
```css
.transition-colors {
transition-timing-function: var(--tw-ease, var(--cohaise-ease-out-soft));
transition-duration: var(--tw-duration, var(--cohaise-duration-base));
}
```
Les utilitaires `duration-fast`, `duration-base`, `duration-slow` et `ease-out-soft`
surchargent ces valeurs au cas par cas.
### Chaîne de résolution
```mermaid
flowchart TD
A["tokens.css<br/>--cohaise-gray-*, --cohaise-crimson-*"] --> B["tokens.css<br/>--cohaise-background, --cohaise-border, ..."]
B --> C["theme.css<br/>@theme inline"]
C --> D["Tailwind CSS<br/>compile les utilitaires"]
D --> E["frontend/cloud"]
F["Classe .dark sur &lt;html&gt;"] -.->|surcharge les jetons sémantiques| B
```
L'échelle de gris et l'échelle carmin sont les seules sources de vérité des couleurs
brutes. Les jetons sémantiques n'y font référence que par `var()`, jamais par une valeur
littérale, sauf pour les statuts (`success`, `warning`, `info`) et l'ombre carmin, qui
n'existent que dans le mode sombre.
La source de vérité du rouge est `--clr-accent` du site, soit `#b71c1c`, et non le
carmin `#c3073f` qui apparaît davantage dans la feuille de style compilée. Les deux
valeurs ont été retenues à un moment de la construction du thème : le carmin est plus
vif, la valeur déclarée plus profonde et moins magenta. Sur un outil de gestion de
fichiers, c'est la seconde qui tient le mieux sur de grandes surfaces.
## Couleurs
Les valeurs viennent de `esiah.dev`. Le fond sombre est un noir à dominante rouge
(`#050000`), pas un gris neutre, et l'accent est le carmin `#b71c1c`.
| Rôle | Clair | Sombre |
|---|---|---|
| Fond | `#f7f5f4` | `#050000` |
| Surface | `#ffffff` | `#1a0505` |
| Surface surélevée | `#ffffff` | `#1e1e22` |
| Texte | `#1a1a1a` | `#f4f4f2` |
| Texte atténué | `#5c5656` | `#a8a0a0` |
| Primaire | `#b71c1c` | `#b71c1c` |
| Accent graphique | `#b71c1c` | `#c92a2a` |
| Filet de séparation | `#e8dcdc` | `#2e1c1c` |
Un seul rouge de marque dans les deux modes, ce qui rend les captures et les
comparaisons d'écran reproductibles. Il n'est appliqué qu'en aplat plein, avec du texte
blanc dessus, où il atteint 6,57:1.
`accent-graphic` est un ton séparé, réservé aux **petits éléments posés sur** une
surface : filet de carte, carré de liste, anneau de focus. Ces éléments sont lus comme
interface et relèvent du seuil de 3:1, or le rouge de marque ne donne que 2,65:1 sur la
surface sombre. Le même raisonnement impose une bordure de champ distincte, à 3,57:1 en
sombre et 3,73:1 en clair.
**Le destructif est ambre, pas rouge.** C'est une décision de lisibilité, pas un goût :
l'accent du site est un rouge, donc un bouton « supprimer » rouge serait confondu avec un
bouton d'accent. `destructive` occupe donc le ton `oklch(0.768 0.188 70)`, déjà présent
dans la palette, et `warning` garde le jaune plus clair. Le prix à payer est que
« supprimer » et « attention » sont proches en teinte ; ils ne se croisent jamais dans le
même écran, et c'est un choix à revoir si l'interface grossit.
**Les bordures de champs de formulaire ont leur propre jeton.** Les bordures
décoratives restent très discrètes, `1.2:1` sur le fond en mode sombre, pour respecter le
grain du site. Un champ de formulaire doit en revanche pouvoir être identifié sans le
remplir ni le survoler, ce que la WCAG 1.4.11 chiffre à `3:1`. `border-control` est
donc nettement plus clair, `3.5:1` en sombre et `3.7:1` en clair, et c'est lui que
`Input` utilise. Les deux valeurs ont été retenues en mesurant le contraste réel plutôt
qu'à l'œil.
## Polices
| Usage | Police | Variable |
|---|---|---|
| Titres, libellés, boutons | Orbitron | `--cohaise-font-display` |
| Texte courant et paragraphes | Poppins | `--cohaise-font-sans` |
| Marque | Orbitron | `--cohaise-font-logo` |
| Accroche courte, registre éditorial | Cinzel | `--cohaise-font-serif` |
| Code | JetBrains Mono et replis | `--cohaise-font-mono` |
Le partage vient du site, où `body` est en Orbitron. Orbitron a une chasse très large : à
32 px, un titre paraît écrit à la main, et un mot-symbole doit être resserré pour ne pas
s'éparpiller. D'où quatre jetons d'interlettrage dédiés, dont un négatif pour les titres.
Orbitron est donc cantonnée aux **chaînes courtes** — titres jusqu'à `h3`, libellés en
capitales, boutons — avec `tracking-label` en positif. Au-delà de `h3`, la chasse est trop
large pour la taille du texte. Le flux est en Poppins. C'est pourquoi `font-display` est
appliqué dans la couche `base` plutôt que laissé au soin de chaque composant : c'est la
seule façon d'éviter qu'un titre revienne en Poppins parce qu'un écran l'a oublié.
Cinzel est conservée en réserve. C'est un bon caractère, mais une serif d'inscription
romaine sur des libellés d'interface ou un paragraphe devient vite illisible, et c'est
précisément ce qui donnait au premier jet de ce thème son aspect de thème généré.
Les trois faces sont **auto-hébergées** dans `frontend/shared/fonts`, 53,6 Ko au total,
soit 30 Ko de moins que Roboto seul. Un appel à Google Fonts aurait fait fuiter l'adresse
IP de chaque visiteur de ton NAS vers un tiers, ce qui n'a pas sa place dans une
application privée.
## Modes clair et sombre
Le mode est piloté par la classe `.dark` appliquée sur `<html>`. `:root` porte le mode
clair, `.dark` surcharge l'ensemble des jetons sémantiques. `color-scheme` est défini
sur les deux blocs pour aligner les contrôles natifs et les barres de défilement.
```mermaid
flowchart LR
subgraph Light["`:root` — mode clair"]
LA["--cohaise-background<br/>#f7f5f4"]
LB["--cohaise-foreground<br/>#1a1a1a"]
LC["--cohaise-primary<br/>#b71c1c"]
end
subgraph Dark["`.dark` — mode sombre"]
DA["--cohaise-background<br/>#050000"]
DB["--cohaise-foreground<br/>#f4f4f2"]
DC["--cohaise-primary<br/>#b71c1c"]
end
Light -->|bascule de classe| Dark
```
Aucune règle `@media (prefers-color-scheme)` n'est déclarée : la bascule est
explicite, ce qui garantit un comportement unique quelle que soit la préférence
système.
## Forme
Les rayons sont quasi nuls, de 2 à 6 px, contre 4 à 12 px pour les valeurs par défaut de
Tailwind. Les tuiles à coins arrondis sont la signature la plus immédiate d'une interface
sans intention, et un registre d'instrument se lit dans l'angle autant que dans la
couleur.
Trois marques complètent le registre : un filet carmin d'un pixel en tête de `Card`, un
carré plein de 6 px devant chaque élément de liste au lieu d'une puce ronde, et des
libellés en capitales espacées. Aucune n'est décorative au sens strict : elles servent à
séparer des blocs sans ajouter de bordure lourde, et à rendre les métriques denses
scannables.
## Consommation
```css
@import "tailwindcss";
@import "@cohaise/ui/styles";
```
L'application conserve la main sur la directive `tailwindcss` et sur sa configuration ;
ce paquet ne fournit que les jetons. Le build Vite résout l'entrée via le champ
`exports` du `package.json`.
## Contraintes
- Aucune valeur de couleur littérale n'est autorisée dans les composants : uniquement
des utilitaires derivés des jetons sémantiques, sinon la thématisation casse.
- `@theme inline` est obligatoire plutôt que `@theme`, car les utilitaires doivent
référencer la variable pour résoudre la valeur au changement de mode.
- Aucune durée ne doit être écrite en dur dans un composant (`duration-150` est
interdit) : passer par `duration-fast`, `duration-base` ou `duration-slow`.
-38
View File
@@ -1,38 +0,0 @@
{
"name": "@cohaise/ui",
"version": "0.0.0",
"private": true,
"type": "module",
"sideEffects": ["**/*.css"],
"style": "./src/styles/index.css",
"exports": {
".": {
"types": "./dist/index.d.ts",
"default": "./dist/index.js"
},
"./styles": "./src/styles/index.css",
"./styles/tokens": "./src/styles/tokens.css",
"./styles/theme": "./src/styles/theme.css"
},
"files": ["dist", "src/styles"],
"scripts": {
"build": "tsc --build",
"clean": "node --eval \"import('node:fs').then(fs => { fs.rmSync('dist', { recursive: true, force: true }); fs.rmSync('tsconfig.tsbuildinfo', { force: true }); })\"",
"typecheck": "tsc --noEmit"
},
"peerDependencies": {
"react": "^19.0.0",
"react-dom": "^19.0.0"
},
"devDependencies": {
"@types/react": "^19.3.0",
"@types/react-dom": "^19.3.0",
"react": "^19.3.0",
"react-dom": "^19.3.0",
"typescript": "^7.0.2"
},
"dependencies": {
"clsx": "^2.1.1",
"tailwind-merge": "^3.7.0"
}
}
-15
View File
@@ -1,15 +0,0 @@
{
"$schema": "https://json.schemastore.org/tsconfig",
"extends": "../../tsconfig.base.json",
"compilerOptions": {
"lib": ["ES2022", "DOM", "DOM.Iterable"],
"jsx": "react-jsx",
"rootDir": "src",
"outDir": "dist",
"composite": true,
"declaration": true,
"declarationMap": true,
"sourceMap": true
},
"include": ["src/**/*.ts", "src/**/*.tsx"]
}
@@ -1,5 +1,5 @@
import { Navigate, Outlet, Route, Routes } from "react-router-dom";
import { Spinner } from "@cohaise/ui";
import { Spinner } from "./ui/index.js";
import { useSession } from "./lib/session.js";
import { AppShell } from "./components/AppShell.js";
import { Login } from "./pages/Login.js";
@@ -1,6 +1,6 @@
import { useState } from "react";
import { NavLink, Outlet } from "react-router-dom";
import { Button, cn } from "@cohaise/ui";
import { Button, cn } from "../ui/index.js";
import { useSession } from "../lib/session.js";
import {
ActivityIcon,
@@ -58,6 +58,11 @@ export const AppShell = () => {
const brand = (
<NavLink to="/files" className="flex items-center gap-2" onClick={() => setMenuOpen(false)}>
<img
src="/icon.png"
alt=""
className="h-7 w-7 shrink-0 rounded-md ring-1 ring-black/5"
/>
<span className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</span>
@@ -1,5 +1,5 @@
import type { ReactNode } from "react";
import { Spinner, cn } from "@cohaise/ui";
import { Spinner, cn } from "../ui/index.js";
export const IconAction = ({
label,
+85
View File
@@ -0,0 +1,85 @@
import {
createContext,
useCallback,
useContext,
useState,
type ReactNode,
} from "react";
import { Button } from "../ui/index.js";
import { Modal } from "./feedback.js";
export interface ConfirmOptions {
/** Titre de la modale. */
title?: string;
/** Corps du message ; accepte du balisage pour mettre un nom en valeur. */
message: ReactNode;
confirmLabel?: string;
cancelLabel?: string;
/** `danger` reserve l'action a une operation destructive. */
tone?: "default" | "danger";
}
type ConfirmFn = (options: ConfirmOptions) => Promise<boolean>;
interface PendingConfirm {
options: ConfirmOptions;
resolve: (value: boolean) => void;
}
const ConfirmContext = createContext<ConfirmFn | null>(null);
/**
* Remplace `window.confirm` par une modale maison aux couleurs de l'app.
* `useConfirm()` renvoie une promesse resolue a `true` (confirme) ou `false`.
*/
export const ConfirmProvider = ({ children }: { children: ReactNode }) => {
const [pending, setPending] = useState<PendingConfirm | null>(null);
const confirm = useCallback<ConfirmFn>(
(options) => new Promise<boolean>((resolve) => setPending({ options, resolve })),
[],
);
const answer = (value: boolean) => {
if (pending) pending.resolve(value);
setPending(null);
};
const tone = pending?.options.tone ?? "default";
return (
<ConfirmContext.Provider value={confirm}>
{children}
<Modal
open={pending !== null}
title={pending?.options.title ?? "Confirmation"}
onClose={() => answer(false)}
>
<div className="flex flex-col gap-5">
<p className="text-sm leading-relaxed text-muted-foreground">
{pending?.options.message}
</p>
<div className="flex justify-end gap-2">
<Button variant="ghost" size="md" onClick={() => answer(false)}>
{pending?.options.cancelLabel ?? "Annuler"}
</Button>
<Button
variant={tone === "danger" ? "destructive" : "primary"}
size="md"
autoFocus
onClick={() => answer(true)}
>
{pending?.options.confirmLabel ?? "Confirmer"}
</Button>
</div>
</div>
</Modal>
</ConfirmContext.Provider>
);
};
export const useConfirm = (): ConfirmFn => {
const context = useContext(ConfirmContext);
if (!context) throw new Error("useConfirm doit etre utilise sous ConfirmProvider");
return context;
};
@@ -1,5 +1,5 @@
import { useEffect, useState, type FormEvent } from "react";
import { Button, Input, cn } from "@cohaise/ui";
import { Button, Input, cn } from "../ui/index.js";
import {
ApiError,
api,
@@ -1,5 +1,5 @@
import type { ReactNode } from "react";
import { cn } from "@cohaise/ui";
import { useEffect, type ReactNode } from "react";
import { cn } from "../ui/index.js";
import { CloseIcon } from "./icons.js";
export const Modal = ({
@@ -11,13 +11,27 @@ export const Modal = ({
open: boolean;
title: string;
onClose: () => void;
children: React.ReactNode;
children: ReactNode;
}) => {
useEffect(() => {
if (!open) return;
const onKeyDown = (event: KeyboardEvent) => {
if (event.key === "Escape") onClose();
};
window.addEventListener("keydown", onKeyDown);
const previousOverflow = document.body.style.overflow;
document.body.style.overflow = "hidden";
return () => {
window.removeEventListener("keydown", onKeyDown);
document.body.style.overflow = previousOverflow;
};
}, [open, onClose]);
if (!open) return null;
return (
<div className="fixed inset-0 z-50 flex items-center justify-center p-4">
<div
className="absolute inset-0 bg-black/40"
className="animate-overlay-in absolute inset-0 bg-black/40 backdrop-blur-[2px]"
onClick={onClose}
aria-hidden="true"
/>
@@ -25,7 +39,7 @@ export const Modal = ({
role="dialog"
aria-modal="true"
aria-label={title}
className="relative w-full max-w-md rounded-lg border border-border bg-surface p-4 shadow-lg"
className="animate-panel-in relative w-full max-w-md rounded-lg border border-border bg-surface p-4 shadow-lg"
>
<div className="mb-4 flex items-center justify-between gap-4">
<h2 className="font-display text-xs font-semibold uppercase tracking-label text-foreground">
@@ -35,7 +49,7 @@ export const Modal = ({
type="button"
onClick={onClose}
aria-label="Fermer"
className="text-muted-foreground transition-colors hover:text-foreground"
className="rounded-sm text-muted-foreground transition-colors hover:text-foreground focus-visible:ring-ring focus-visible:ring-2 focus-visible:outline-none"
>
<CloseIcon className="h-5 w-5" />
</button>
@@ -145,6 +145,12 @@ export const CloseIcon = (props: IconProps) => (
</svg>
);
export const ArrowLeftIcon = (props: IconProps) => (
<svg {...base(props)}>
<path d="M19 12H5M11 18l-6-6 6-6" />
</svg>
);
export const PenIcon = (props: IconProps) => (
<svg {...base(props)}>
<path d="M4 20h4L18.5 9.5a2.1 2.1 0 0 0-3-3L5 17v3Z" />
@@ -3,6 +3,7 @@ import { createRoot } from "react-dom/client";
import { BrowserRouter } from "react-router-dom";
import { App } from "./App.js";
import { SessionProvider } from "./lib/session.js";
import { ConfirmProvider } from "./components/confirm.js";
import "./styles/index.css";
const container = document.getElementById("root");
@@ -15,7 +16,9 @@ createRoot(container).render(
<StrictMode>
<BrowserRouter>
<SessionProvider>
<App />
<ConfirmProvider>
<App />
</ConfirmProvider>
</SessionProvider>
</BrowserRouter>
</StrictMode>,
@@ -1,5 +1,5 @@
import { useEffect, useRef, useState, type FormEvent } from "react";
import { Button, Input, Spinner } from "@cohaise/ui";
import { Button, Input, Spinner } from "../ui/index.js";
import {
ApiError,
api,
@@ -10,6 +10,7 @@ import {
type StorageLocation,
} from "../lib/api.js";
import { Alert, Badge, EmptyState, Modal, PageHeader } from "../components/feedback.js";
import { useConfirm } from "../components/confirm.js";
import { IconAction } from "../components/IconAction.js";
import {
ActivityIcon,
@@ -38,6 +39,7 @@ const StatCard = ({ label, value }: { label: string; value: string }) => (
);
export const AdminUsers = () => {
const confirm = useConfirm();
const [users, setUsers] = useState<AdminUser[] | null>(null);
const [stats, setStats] = useState<AdminStats | null>(null);
const [q, setQ] = useState("");
@@ -95,7 +97,18 @@ export const AdminUsers = () => {
};
const removeUser = async (user: AdminUser) => {
if (!window.confirm(`Supprimer définitivement ${user.email} ?`)) return;
const ok = await confirm({
title: "Supprimer le membre",
message: (
<>
Supprimer définitivement <span className="font-semibold text-foreground">{user.email}</span>{" "}
ainsi que ses fichiers ? Cette action est irréversible.
</>
),
confirmLabel: "Supprimer",
tone: "danger",
});
if (!ok) return;
setBusy(user.id);
setError(null);
try {
@@ -1,5 +1,5 @@
import { useCallback, useEffect, useRef, useState } from "react";
import { Button, Card, Spinner } from "@cohaise/ui";
import { Button, Card, Spinner } from "../ui/index.js";
import {
ApiError,
api,
@@ -9,6 +9,7 @@ import {
} from "../lib/api.js";
import { useSession } from "../lib/session.js";
import { Alert, Badge, EmptyState, PageHeader } from "../components/feedback.js";
import { useConfirm } from "../components/confirm.js";
import { IconAction } from "../components/IconAction.js";
import {
CreateFolderDialog,
@@ -17,6 +18,7 @@ import {
ShareDialog,
} from "../components/dialogs.js";
import {
ArrowLeftIcon,
DownloadIcon,
FileIcon,
FolderIcon,
@@ -48,6 +50,7 @@ const isImage = (file: UploadedFile): boolean =>
export const Browser = () => {
const { user, refresh } = useSession();
const confirm = useConfirm();
const [path, setPath] = useState<Crumb[]>([{ id: null, name: "Racine" }]);
const [folders, setFolders] = useState<Folder[]>([]);
const [files, setFiles] = useState<UploadedFile[]>([]);
@@ -111,7 +114,18 @@ export const Browser = () => {
const removeTarget = async (target: Target) => {
const label = target.type === "folder" ? "ce dossier" : "ce fichier";
if (!window.confirm(`Placer ${label} dans la corbeille ?`)) return;
const ok = await confirm({
title: "Mettre à la corbeille",
message: (
<>
Placer <span className="font-semibold text-foreground">{target.name}</span> ({label}) dans la
corbeille ?
</>
),
confirmLabel: "Corbeille",
tone: "danger",
});
if (!ok) return;
setRemoving(target.id);
setError(null);
try {
@@ -153,32 +167,45 @@ export const Browser = () => {
description="Vos dossiers et fichiers. Envoyez un fichier ou créez un dossier."
/>
<nav aria-label="Fil d'Ariane">
<ol className="flex flex-wrap items-center gap-1.5 text-xs">
{path.map((crumb, index) => (
<li key={`${crumb.id ?? "root"}-${index}`} className="flex items-center gap-1.5">
{index > 0 ? (
<span className="text-border" aria-hidden="true">
/
</span>
) : null}
{index === path.length - 1 ? (
<span className="font-medium text-foreground" aria-current="page">
{crumb.name}
</span>
) : (
<button
type="button"
onClick={() => goTo(index)}
className="text-muted-foreground underline-offset-2 transition-colors hover:text-foreground hover:underline"
>
{crumb.name}
</button>
)}
</li>
))}
</ol>
</nav>
<div className="flex flex-wrap items-center gap-3">
{path.length > 1 ? (
<button
type="button"
onClick={() => goTo(path.length - 2)}
className="inline-flex items-center gap-1.5 rounded-sm border border-border-control bg-surface px-2.5 py-1.5 font-display text-[0.6875rem] font-semibold uppercase tracking-label text-foreground transition-colors duration-fast hover:bg-surface-hover focus-visible:ring-ring focus-visible:ring-2 focus-visible:outline-none"
>
<ArrowLeftIcon className="h-3.5 w-3.5" />
Retour
</button>
) : null}
<nav aria-label="Fil d'Ariane" className="min-w-0">
<ol className="flex flex-wrap items-center gap-1.5 text-xs">
{path.map((crumb, index) => (
<li key={`${crumb.id ?? "root"}-${index}`} className="flex items-center gap-1.5">
{index > 0 ? (
<span className="text-border" aria-hidden="true">
/
</span>
) : null}
{index === path.length - 1 ? (
<span className="font-medium text-foreground" aria-current="page">
{crumb.name}
</span>
) : (
<button
type="button"
onClick={() => goTo(index)}
className="text-muted-foreground underline-offset-2 transition-colors hover:text-foreground hover:underline"
>
{crumb.name}
</button>
)}
</li>
))}
</ol>
</nav>
</div>
<Card>
<div className="flex flex-col gap-3 p-4 sm:flex-row sm:items-center sm:justify-between">
@@ -1,6 +1,6 @@
import { useState, type FormEvent } from "react";
import { useNavigate } from "react-router-dom";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "@cohaise/ui";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "../ui/index.js";
import { Alert } from "../components/feedback.js";
import { ApiError, api } from "../lib/api.js";
import { useSession } from "../lib/session.js";
@@ -37,12 +37,21 @@ export const ChangePassword = () => {
<main className="flex min-h-dvh items-center justify-center bg-background px-4 py-10">
<div className="w-full max-w-sm">
<header className="mb-6 text-center">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display mt-2 text-lg font-semibold uppercase tracking-label text-foreground">
Nouveau mot de passe
</h1>
<div className="flex items-center justify-center gap-3">
<img
src="/icon.png"
alt=""
className="h-12 w-12 rounded-xl ring-1 ring-black/5"
/>
<div className="text-left">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display text-lg font-semibold uppercase tracking-label text-foreground">
Nouveau mot de passe
</h1>
</div>
</div>
<p className="mt-2 text-sm leading-relaxed text-muted-foreground">
Bienvenue {user?.first_name ?? ""}. Ce mot de passe a été défini par un
administrateur : choisissez le vôtre.
@@ -1,6 +1,6 @@
import { useEffect, useRef, useState } from "react";
import { Link, useSearchParams } from "react-router-dom";
import { Button, Card, CardContent, CardHeader, CardTitle, Spinner } from "@cohaise/ui";
import { Button, Card, CardContent, CardHeader, CardTitle, Spinner } from "../ui/index.js";
import { Alert } from "../components/feedback.js";
import { ApiError, api } from "../lib/api.js";
import { useSession } from "../lib/session.js";
@@ -37,12 +37,21 @@ export const ConfirmEmail = () => {
<main className="flex min-h-dvh items-center justify-center bg-background px-4 py-10">
<div className="w-full max-w-sm">
<header className="mb-6 text-center">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display mt-2 text-lg font-semibold uppercase tracking-label text-foreground">
Changement d'adresse
</h1>
<div className="flex items-center justify-center gap-3">
<img
src="/icon.png"
alt=""
className="h-12 w-12 rounded-xl ring-1 ring-black/5"
/>
<div className="text-left">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display text-lg font-semibold uppercase tracking-label text-foreground">
Changement d'adresse
</h1>
</div>
</div>
</header>
<Card>
@@ -1,6 +1,6 @@
import { useState, type FormEvent } from "react";
import { Link } from "react-router-dom";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "@cohaise/ui";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "../ui/index.js";
import { Alert } from "../components/feedback.js";
import { ApiError, api } from "../lib/api.js";
@@ -28,12 +28,21 @@ export const ForgotPassword = () => {
<main className="flex min-h-dvh items-center justify-center bg-background px-4 py-10">
<div className="w-full max-w-sm">
<header className="mb-6 text-center">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display mt-2 text-lg font-semibold uppercase tracking-label text-foreground">
Mot de passe oublié
</h1>
<div className="flex items-center justify-center gap-3">
<img
src="/icon.png"
alt=""
className="h-12 w-12 rounded-xl ring-1 ring-black/5"
/>
<div className="text-left">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display text-lg font-semibold uppercase tracking-label text-foreground">
Mot de passe oublié
</h1>
</div>
</div>
</header>
<Card>
@@ -1,5 +1,5 @@
import { useCallback, useEffect, useState } from "react";
import { Button, Spinner, cn } from "@cohaise/ui";
import { Button, Spinner, cn } from "../ui/index.js";
import { ApiError, api, formatBytes, type MediaItem } from "../lib/api.js";
import { Alert, EmptyState, PageHeader } from "../components/feedback.js";
import { FileIcon, ImageIcon } from "../components/icons.js";
@@ -1,6 +1,6 @@
import { useState, type FormEvent } from "react";
import { Link, Navigate, useNavigate } from "react-router-dom";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "@cohaise/ui";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "../ui/index.js";
import { ApiError, api } from "../lib/api.js";
import { useSession } from "../lib/session.js";
@@ -33,12 +33,21 @@ export const Login = () => {
<main className="flex min-h-dvh items-center justify-center bg-background px-4 py-10">
<div className="w-full max-w-sm">
<header className="mb-6 text-center">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display mt-2 text-lg font-semibold uppercase tracking-label text-foreground">
Cloud
</h1>
<div className="flex items-center justify-center gap-3">
<img
src="/icon.png"
alt=""
className="h-12 w-12 rounded-xl ring-1 ring-black/5"
/>
<div className="text-left">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display text-lg font-semibold uppercase tracking-label text-foreground">
Cloud
</h1>
</div>
</div>
<p className="mt-2 text-sm leading-relaxed text-muted-foreground">
Connectez-vous pour accéder à vos fichiers.
</p>
@@ -1,12 +1,14 @@
import { useEffect, useRef, useState, type FormEvent } from "react";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input, Spinner } from "@cohaise/ui";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input, Spinner } from "../ui/index.js";
import { ApiError, api, formatDate, type SessionInfo } from "../lib/api.js";
import { useSession } from "../lib/session.js";
import { Alert, Badge, PageHeader } from "../components/feedback.js";
import { useConfirm } from "../components/confirm.js";
import { TrashIcon } from "../components/icons.js";
export const Profile = () => {
const { user, refresh } = useSession();
const confirm = useConfirm();
const [firstName, setFirstName] = useState(user?.first_name ?? "");
const [lastName, setLastName] = useState(user?.last_name ?? "");
@@ -107,7 +109,14 @@ export const Profile = () => {
};
const revokeSession = async (session: SessionInfo) => {
if (session.current && !window.confirm("Fermer la session en cours ?")) return;
if (session.current) {
const ok = await confirm({
title: "Fermer la session",
message: "Fermer la session en cours vous déconnectera immédiatement.",
confirmLabel: "Fermer",
});
if (!ok) return;
}
setRevoking(session.id);
setSessionsError(null);
try {
@@ -1,6 +1,6 @@
import { useState, type FormEvent } from "react";
import { Link, useSearchParams } from "react-router-dom";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "@cohaise/ui";
import { Button, Card, CardContent, CardDescription, CardHeader, CardTitle, Input } from "../ui/index.js";
import { Alert } from "../components/feedback.js";
import { ApiError, api } from "../lib/api.js";
@@ -35,12 +35,21 @@ export const ResetPassword = () => {
<main className="flex min-h-dvh items-center justify-center bg-background px-4 py-10">
<div className="w-full max-w-sm">
<header className="mb-6 text-center">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display mt-2 text-lg font-semibold uppercase tracking-label text-foreground">
Nouveau mot de passe
</h1>
<div className="flex items-center justify-center gap-3">
<img
src="/icon.png"
alt=""
className="h-12 w-12 rounded-xl ring-1 ring-black/5"
/>
<div className="text-left">
<p className="font-display text-xs font-semibold uppercase tracking-logo text-accent">
CoHaiSe
</p>
<h1 className="font-display text-lg font-semibold uppercase tracking-label text-foreground">
Nouveau mot de passe
</h1>
</div>
</div>
</header>
<Card>
@@ -1,5 +1,5 @@
import { useState, type FormEvent } from "react";
import { Button, Input, Spinner } from "@cohaise/ui";
import { Button, Input, Spinner } from "../ui/index.js";
import { ApiError, api, formatBytes, type Folder, type UploadedFile } from "../lib/api.js";
import { Alert, EmptyState, PageHeader } from "../components/feedback.js";
import { DownloadIcon, FileIcon, FolderIcon, SearchIcon } from "../components/icons.js";
@@ -1,5 +1,5 @@
import { useCallback, useEffect, useState } from "react";
import { Button, Spinner } from "@cohaise/ui";
import { Button, Spinner } from "../ui/index.js";
import {
ApiError,
api,
@@ -9,6 +9,7 @@ import {
type TrashFolder,
} from "../lib/api.js";
import { Alert, EmptyState, PageHeader } from "../components/feedback.js";
import { useConfirm } from "../components/confirm.js";
import { IconAction } from "../components/IconAction.js";
import { FileIcon, FolderIcon, RestoreIcon, TrashIcon } from "../components/icons.js";
@@ -19,6 +20,7 @@ interface TrashData {
}
export const Trash = () => {
const confirm = useConfirm();
const [data, setData] = useState<TrashData | null>(null);
const [loading, setLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
@@ -54,11 +56,33 @@ export const Trash = () => {
}
};
const emptyTrash = () => {
if (!window.confirm("Vider définitivement la corbeille ?")) return;
const emptyTrash = async () => {
const ok = await confirm({
title: "Vider la corbeille",
message: "Tous les éléments seront définitivement supprimés. Cette action est irréversible.",
confirmLabel: "Vider",
tone: "danger",
});
if (!ok) return;
void run("empty", () => api.emptyTrash());
};
const purge = async (key: string, name: string, action: () => Promise<unknown>) => {
const ok = await confirm({
title: "Supprimer définitivement",
message: (
<>
Supprimer définitivement <span className="font-semibold text-foreground">{name}</span> ?
Cette action est irréversible.
</>
),
confirmLabel: "Supprimer",
tone: "danger",
});
if (!ok) return;
void run(key, action);
};
const empty = data !== null && data.folders.length === 0 && data.files.length === 0;
return (
@@ -125,11 +149,11 @@ export const Trash = () => {
icon={<TrashIcon className="h-4 w-4" />}
tone="danger"
isLoading={busy === `purge-${folder.id}`}
onClick={() => {
if (window.confirm(`Supprimer définitivement « ${folder.name} » ?`)) {
void run(`purge-${folder.id}`, () => api.purgeFolder(folder.id));
}
}}
onClick={() =>
void purge(`purge-${folder.id}`, folder.name, () =>
api.purgeFolder(folder.id),
)
}
/>
</li>
))}
@@ -170,7 +194,7 @@ export const Trash = () => {
isLoading={busy === `purge-${file.id}`}
tone="danger"
onClick={() =>
void run(`purge-${file.id}`, () => api.purgeFile(file.id))
void purge(`purge-${file.id}`, file.name, () => api.purgeFile(file.id))
}
/>
</li>
@@ -10,7 +10,7 @@
font-style: normal;
font-weight: 400;
font-display: swap;
src: url("../../fonts/poppins-400.woff2") format("woff2");
src: url("../fonts/poppins-400.woff2") format("woff2");
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193,
U+2212, U+2215, U+FEFF, U+FFFD;
@@ -21,7 +21,7 @@
font-style: normal;
font-weight: 600;
font-display: swap;
src: url("../../fonts/poppins-600.woff2") format("woff2");
src: url("../fonts/poppins-600.woff2") format("woff2");
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193,
U+2212, U+2215, U+FEFF, U+FFFD;
@@ -32,7 +32,7 @@
font-style: normal;
font-weight: 400 700;
font-display: swap;
src: url("../../fonts/jetbrains-mono-latin.woff2") format("woff2");
src: url("../fonts/jetbrains-mono-latin.woff2") format("woff2");
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193,
U+2212, U+2215, U+FEFF, U+FFFD;
@@ -43,7 +43,7 @@
font-style: normal;
font-weight: 400 900;
font-display: swap;
src: url("../../fonts/orbitron-latin.woff2") format("woff2");
src: url("../fonts/orbitron-latin.woff2") format("woff2");
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193,
U+2212, U+2215, U+FEFF, U+FFFD;
@@ -54,7 +54,7 @@
font-style: normal;
font-weight: 400 900;
font-display: swap;
src: url("../../fonts/cinzel-latin.woff2") format("woff2");
src: url("../fonts/cinzel-latin.woff2") format("woff2");
unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA,
U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193,
U+2212, U+2215, U+FEFF, U+FFFD;
@@ -1,3 +1,4 @@
@import "tailwindcss";
@import "./fonts.css";
@import "./tokens.css";
@import "./theme.css";
@@ -103,3 +103,42 @@
@utility duration-slow {
transition-duration: var(--cohaise-duration-slow);
}
/* Entree des surfaces modales (overlay + panneau). */
@keyframes cohaise-overlay-in {
from {
opacity: 0;
}
to {
opacity: 1;
}
}
@keyframes cohaise-panel-in {
from {
opacity: 0;
transform: translateY(0.5rem) scale(0.98);
}
to {
opacity: 1;
transform: translateY(0) scale(1);
}
}
@utility animate-overlay-in {
animation: cohaise-overlay-in var(--cohaise-duration-base) var(--cohaise-ease-out-soft) both;
}
@utility animate-panel-in {
animation: cohaise-panel-in var(--cohaise-duration-base) var(--cohaise-ease-out-soft) both;
}
@media (prefers-reduced-motion: reduce) {
*,
*::before,
*::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
}
}

Some files were not shown because too many files have changed in this diff Show More