diff --git a/.env.example b/.env.example index e6055d4..f42691b 100644 --- a/.env.example +++ b/.env.example @@ -47,6 +47,9 @@ SMTP_PASSWORD= SMTP_FROM= # true si le serveur SMTP exige TLS des la connexion (port 465). SMTP_SECURE=false +# Logo des courriels. Par defaut 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. diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml index 260e7fe..d8d7d6a 100644 --- a/.github/workflows/deploy.yml +++ b/.github/workflows/deploy.yml @@ -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 diff --git a/Makefile b/Makefile index f47e47c..76f9a89 100644 --- a/Makefile +++ b/Makefile @@ -1,6 +1,6 @@ COMPOSE=docker compose -.PHONY: help up down build logs ps front front-build db migrate admin backup dev typecheck check +.PHONY: help up down build logs ps front front-build db migrate admin backup purge-logs reset dev typecheck check help: @echo "CoHaiSe Cloud" @@ -20,6 +20,8 @@ help: @echo " make migrate Appliquer les migrations SQL" @echo " make backup Sauvegarder la base dans ./backups" @echo " make admin ARGS=... Creer ou reinitialiser un compte" + @echo " make purge-logs Vider le journal d'audit" + @echo " make reset Cloud vierge, hors administrateurs" @echo "" @echo "Developpement, sans Docker" @echo " make dev Vite sur 5174, API sur 3101" @@ -75,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 diff --git a/README.md b/README.md index 91acdf4..fe5e6e7 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/backend/cloud/README.md b/backend/README.md similarity index 100% rename from backend/cloud/README.md rename to backend/README.md diff --git a/backend/cloud/tsconfig.json b/backend/cloud/tsconfig.json deleted file mode 100644 index ab1723a..0000000 --- a/backend/cloud/tsconfig.json +++ /dev/null @@ -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" }] -} diff --git a/backend/cloud/migrations/000_schema_migrations.sql b/backend/migrations/000_schema_migrations.sql similarity index 100% rename from backend/cloud/migrations/000_schema_migrations.sql rename to backend/migrations/000_schema_migrations.sql diff --git a/backend/cloud/migrations/001_initial_schema.sql b/backend/migrations/001_initial_schema.sql similarity index 100% rename from backend/cloud/migrations/001_initial_schema.sql rename to backend/migrations/001_initial_schema.sql diff --git a/backend/cloud/migrations/002_reference_data.sql b/backend/migrations/002_reference_data.sql similarity index 100% rename from backend/cloud/migrations/002_reference_data.sql rename to backend/migrations/002_reference_data.sql diff --git a/backend/cloud/migrations/003_integrity_backstop.sql b/backend/migrations/003_integrity_backstop.sql similarity index 100% rename from backend/cloud/migrations/003_integrity_backstop.sql rename to backend/migrations/003_integrity_backstop.sql diff --git a/backend/cloud/migrations/004_cloud_requirements.sql b/backend/migrations/004_cloud_requirements.sql similarity index 100% rename from backend/cloud/migrations/004_cloud_requirements.sql rename to backend/migrations/004_cloud_requirements.sql diff --git a/backend/cloud/migrations/005_storage_location_realign.sql b/backend/migrations/005_storage_location_realign.sql similarity index 100% rename from backend/cloud/migrations/005_storage_location_realign.sql rename to backend/migrations/005_storage_location_realign.sql diff --git a/backend/cloud/migrations/006_public_folder.sql b/backend/migrations/006_public_folder.sql similarity index 100% rename from backend/cloud/migrations/006_public_folder.sql rename to backend/migrations/006_public_folder.sql diff --git a/backend/cloud/package.json b/backend/package.json similarity index 79% rename from backend/cloud/package.json rename to backend/package.json index 7fb2470..55cce33 100644 --- a/backend/cloud/package.json +++ b/backend/package.json @@ -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" } } diff --git a/backend/shared/package.json b/backend/shared/package.json deleted file mode 100644 index 204681c..0000000 --- a/backend/shared/package.json +++ /dev/null @@ -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" - } -} diff --git a/backend/cloud/src/access.ts b/backend/src/access.ts similarity index 99% rename from backend/cloud/src/access.ts rename to backend/src/access.ts index 7d8d1fb..18cd6bf 100644 --- a/backend/cloud/src/access.ts +++ b/backend/src/access.ts @@ -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 diff --git a/backend/cloud/src/admin.ts b/backend/src/admin.ts similarity index 98% rename from backend/cloud/src/admin.ts rename to backend/src/admin.ts index ace2c61..6ddc6fd 100644 --- a/backend/cloud/src/admin.ts +++ b/backend/src/admin.ts @@ -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 => { throw error; } - const { Db } = await import("@cohaise/server"); + const { Db } = await import("./lib/index.js"); const db = new Db(config); try { diff --git a/backend/src/assets/logo.png b/backend/src/assets/logo.png new file mode 100644 index 0000000..f34c330 Binary files /dev/null and b/backend/src/assets/logo.png differ diff --git a/backend/cloud/src/index.ts b/backend/src/index.ts similarity index 95% rename from backend/cloud/src/index.ts rename to backend/src/index.ts index 8bfa78e..2f6c234 100644 --- a/backend/cloud/src/index.ts +++ b/backend/src/index.ts @@ -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"; diff --git a/backend/shared/src/auth.ts b/backend/src/lib/auth.ts similarity index 100% rename from backend/shared/src/auth.ts rename to backend/src/lib/auth.ts diff --git a/backend/shared/src/cli.ts b/backend/src/lib/cli.ts similarity index 100% rename from backend/shared/src/cli.ts rename to backend/src/lib/cli.ts diff --git a/backend/shared/src/config.ts b/backend/src/lib/config.ts similarity index 93% rename from backend/shared/src/config.ts rename to backend/src/lib/config.ts index a7d99bb..1d76415 100644 --- a/backend/shared/src/config.ts +++ b/backend/src/lib/config.ts @@ -59,6 +59,14 @@ const schema = z.object({ SMTP_PASSWORD: z.string().optional().transform((v) => (v ? v : null)), SMTP_FROM: z.string().min(3), SMTP_SECURE: bool(false), + /** + * Logo des courriels. Par defaut 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), diff --git a/backend/shared/src/db.ts b/backend/src/lib/db.ts similarity index 100% rename from backend/shared/src/db.ts rename to backend/src/lib/db.ts diff --git a/backend/shared/src/errors.ts b/backend/src/lib/errors.ts similarity index 95% rename from backend/shared/src/errors.ts rename to backend/src/lib/errors.ts index 5e6d87a..3c81928 100644 --- a/backend/shared/src/errors.ts +++ b/backend/src/lib/errors.ts @@ -41,6 +41,9 @@ export class AppError extends Error { static serviceUnavailable(message = "Service momentanement indisponible.") { return new AppError(503, "UNAVAILABLE", message); } + static insufficientStorage(message = "Espace de stockage insuffisant sur le serveur.") { + return new AppError(507, "INSUFFICIENT_STORAGE", message); + } } export interface SafeError { diff --git a/backend/shared/src/http.ts b/backend/src/lib/http.ts similarity index 100% rename from backend/shared/src/http.ts rename to backend/src/lib/http.ts diff --git a/backend/shared/src/index.ts b/backend/src/lib/index.ts similarity index 89% rename from backend/shared/src/index.ts rename to backend/src/lib/index.ts index ca4ba65..c8f191e 100644 --- a/backend/shared/src/index.ts +++ b/backend/src/lib/index.ts @@ -41,6 +41,13 @@ export { type MigrationResult, } from "./migrate.js"; export { createMailer, link, type Mailer, type MailMessage } from "./mail.js"; +export { + branding, + renderMail, + type Branding, + type MailContent, + type RenderedMail, +} from "./mail-template.js"; export { createRateLimiter, rateLimitKey, type RateLimiter } from "./ratelimit.js"; export { prepareService, diff --git a/backend/src/lib/mail-template.ts b/backend/src/lib/mail-template.ts new file mode 100644 index 0000000..ccbf2a5 --- /dev/null +++ b/backend/src/lib/mail-template.ts @@ -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, "&") + .replace(//g, ">") + .replace(/"/g, """) + .replace(/'/g, "'"); + +const FONT = "-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif"; + +export const renderMail = (brand: Branding, content: MailContent): RenderedMail => { + const paragraphs = (content.paragraphs ?? []) + .map( + (paragraph) => + `

${escapeHtml(paragraph)}

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

Vos identifiants

+

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

+

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

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

${escapeHtml(content.note)}

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

${escapeHtml(content.heading)}

+

${escapeHtml(content.intro)}

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

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

+

${escapeHtml(brand.footer)}

+
+ +
+
+
+ +`; + + const lines = [content.intro, ...(content.paragraphs ?? [])]; + if (content.credentials) { + lines.push(`Adresse : ${content.credentials.email}`, `Mot de passe temporaire : ${content.credentials.password}`); + } + if (content.cta) lines.push(`${content.cta.label} : ${content.cta.url}`); + if (content.note) lines.push(content.note); + lines.push("", "Message automatique : merci de ne pas repondre a cet e-mail.", brand.footer); + + return { html, text: lines.join("\n") }; +}; \ No newline at end of file diff --git a/backend/shared/src/mail.ts b/backend/src/lib/mail.ts similarity index 57% rename from backend/shared/src/mail.ts rename to backend/src/lib/mail.ts index 9512130..48938a7 100644 --- a/backend/shared/src/mail.ts +++ b/backend/src/lib/mail.ts @@ -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 }] } + : {}), }); }, }; diff --git a/backend/shared/src/migrate.ts b/backend/src/lib/migrate.ts similarity index 100% rename from backend/shared/src/migrate.ts rename to backend/src/lib/migrate.ts diff --git a/backend/shared/src/ratelimit.ts b/backend/src/lib/ratelimit.ts similarity index 100% rename from backend/shared/src/ratelimit.ts rename to backend/src/lib/ratelimit.ts diff --git a/backend/shared/src/service.ts b/backend/src/lib/service.ts similarity index 100% rename from backend/shared/src/service.ts rename to backend/src/lib/service.ts diff --git a/backend/cloud/src/media.ts b/backend/src/media.ts similarity index 98% rename from backend/cloud/src/media.ts rename to backend/src/media.ts index dd0eedc..ca0799e 100644 --- a/backend/cloud/src/media.ts +++ b/backend/src/media.ts @@ -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"; /** diff --git a/backend/cloud/src/routes/account.ts b/backend/src/routes/account.ts similarity index 90% rename from backend/cloud/src/routes/account.ts rename to backend/src/routes/account.ts index e3b9202..38b4890 100644 --- a/backend/cloud/src/routes/account.ts +++ b/backend/src/routes/account.ts @@ -7,6 +7,7 @@ import sharp from "sharp"; import { AppError, attachUser, + branding, clientIp, createMailer, createRateLimiter, @@ -14,6 +15,7 @@ import { hashPassword, link, rateLimitKey, + renderMail, requireAuth, sha256, verifyPassword, @@ -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[0], extra: string): void => { @@ -167,6 +170,11 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => ); if (!location) throw AppError.serviceUnavailable("Aucun emplacement de stockage disponible."); + const disk = await diskUsage(config.VARIANT_DIR); + if (disk !== null && processed.byteLength > disk.available_bytes) { + throw AppError.insufficientStorage("Espace disque insuffisant sur le serveur."); + } + const relative = avatarRelativePath(user.id); const destination = absolutePath(config.VARIANT_DIR, relative); await mkdir(path.dirname(destination), { recursive: true }); @@ -257,11 +265,19 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => [randomUUID(), user.id, sha256(token), new Date(Date.now() + HOUR_MS)], ); const url = link(config, `/reset-password?token=${encodeURIComponent(token)}`); + const mail = renderMail(brand, { + preview: "Reinitialisez le mot de passe de votre compte.", + heading: "Reinitialisation du mot de passe", + intro: + "Une reinitialisation de mot de passe a ete demandee pour votre compte CoHaiSe Cloud. Choisissez un nouveau mot de passe en suivant le lien ci-dessous.", + cta: { label: "Choisir un mot de passe", url }, + note: "Ce lien expire dans une heure. Si vous n'etes pas a l'origine de cette demande, ignorez ce message : votre mot de passe reste inchange.", + }); await mailer .send({ to: user.email, subject: "CoHaiSe Cloud — reinitialisation du mot de passe", - text: `Une reinitialisation de mot de passe a ete demandee pour ce compte.\n\n${url}\n\nCe lien expire dans une heure. Si vous n'etes pas a l'origine de cette demande, ignorez ce message.`, + ...mail, }) .catch(() => undefined); } @@ -344,11 +360,20 @@ export const registerAccountRoutes = (app: App, db: Db, config: Config): void => ); const url = link(config, `/confirm-email?token=${encodeURIComponent(token)}`); + const mail = renderMail(brand, { + preview: "Confirmez votre nouvelle adresse e-mail.", + heading: "Confirmez votre nouvelle adresse", + intro: + "Une demande de changement d'adresse a ete faite pour votre compte CoHaiSe Cloud. Confirmez la nouvelle adresse en suivant le lien ci-dessous.", + cta: { label: "Confirmer l'adresse", url }, + note: "Ce lien expire dans une heure. Sans confirmation, l'adresse reste inchangee.", + }); await mailer .send({ to: data.new_email, subject: "CoHaiSe Cloud — confirmez votre nouvelle adresse", - text: `Une demande de changement d'adresse a ete faite pour votre compte CoHaiSe Cloud.\n\n${url}\n\nCe lien expire dans une heure. Sans confirmation, l'adresse reste inchangee.`, + text: mail.text, + html: mail.html, }) .catch(() => undefined); diff --git a/backend/cloud/src/routes/admin.ts b/backend/src/routes/admin.ts similarity index 84% rename from backend/cloud/src/routes/admin.ts rename to backend/src/routes/admin.ts index 65b81db..8dc9113 100644 --- a/backend/cloud/src/routes/admin.ts +++ b/backend/src/routes/admin.ts @@ -3,14 +3,18 @@ import { z } from "zod"; import { AppError, attachUser, + branding, createMailer, currentUser, hashPassword, + link, + renderMail, requireAuth, type App, type Config, type Db, -} from "@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[0]): void => { if (currentUser(context).role_slug !== "admin") throw AppError.forbidden(); }; + /** + * Un quota ne peut depasser la capacite reelle du disque qui porte les + * medias : au-dela, la limite est un chiffre mort que le support ne pourra + * jamais honorer. Le controle est ignore si le support n'est pas lisible + * (chemin absent dans le conteneur), pour ne pas bloquer la configuration. + */ + const assertQuotaFits = async (quota: number): Promise => { + const disk = await diskUsage(config.MEDIA_DIR); + if (disk !== null && quota > disk.total_bytes) { + throw AppError.badRequest( + `Le quota depasse la capacite du disque (${humanBytes(disk.total_bytes)}).`, + ); + } + }; + app.get("/api/cloud/admin/stats", requireAuth, async (context) => { requireAdmin(context); const [users] = await db.query<{ count: number }>( @@ -145,6 +178,7 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { usedBytes: Number(files?.bytes ?? 0), trashFiles: trash?.count ?? 0, locations, + disk: await diskUsage(config.MEDIA_DIR), }); }); @@ -191,6 +225,24 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { ); const created = await db.required(`${SELECT_USER} WHERE u.id = ?`, [id]); + + const mail = renderMail(brand, { + preview: "Votre acces CoHaiSe Cloud est pret.", + heading: "Votre compte a ete cree", + intro: `Un compte CoHaiSe Cloud vient d'etre ouvert pour ${data.first_name}. Connectez-vous avec les identifiants ci-dessous.`, + credentials: { email: data.email, password }, + cta: { label: "Se connecter", url: link(config, "/login") }, + note: "Ce mot de passe est temporaire : il vous sera demande de le changer des la premiere connexion.", + }); + await mailer + .send({ + to: data.email, + subject: "CoHaiSe Cloud — votre compte est pret", + text: mail.text, + html: mail.html, + }) + .catch(() => undefined); + return context.json({ user: publicUser(created), password }, 201); }); @@ -293,11 +345,20 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { // Le mot de passe est rendu une seule fois et envoye au compte. Un echec // d'envoi n'invalide pas la reinitialisation. + const mail = renderMail(brand, { + preview: "Un nouveau mot de passe a ete genere pour votre compte.", + heading: "Mot de passe reinitialise", + intro: "Un administrateur a reinitialise le mot de passe de votre compte CoHaiSe Cloud.", + credentials: { email: user.email, password }, + cta: { label: "Se connecter", url: link(config, "/login") }, + note: "Ce mot de passe est temporaire : il vous sera demande de le changer des la premiere connexion.", + }); await mailer .send({ to: user.email, subject: "CoHaiSe Cloud — mot de passe reinitialise", - text: `Un administrateur a reinitialise le mot de passe de votre compte.\n\nMot de passe provisoire : ${password}\n\nIl vous sera demande de le changer a la prochaine connexion.`, + text: mail.text, + html: mail.html, }) .catch(() => undefined); @@ -310,12 +371,15 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { `SELECT id, name, slug, mount_path, quota_bytes, used_bytes, is_active, created_at FROM storage_locations WHERE deleted_at IS NULL ORDER BY id`, ); - return context.json({ locations: rows }); + return context.json({ locations: rows, disk: await diskUsage(config.MEDIA_DIR) }); }); app.post("/api/cloud/admin/storage-locations", requireAuth, async (context) => { requireAdmin(context); const data = parse(createLocationSchema, await context.req.json().catch(() => null)); + if (data.quota_bytes !== undefined && data.quota_bytes !== null) { + await assertQuotaFits(data.quota_bytes); + } try { await db.exec( `INSERT INTO storage_locations (name, slug, mount_path, quota_bytes) @@ -345,6 +409,9 @@ export const registerAdminRoutes = (app: App, db: Db, config: Config): void => { if (data.quota_bytes !== undefined && data.quota_bytes !== null && data.quota_bytes < row.used_bytes) { throw AppError.badRequest("Le quota est inferieur a l'espace deja utilise."); } + if (data.quota_bytes !== undefined && data.quota_bytes !== null) { + await assertQuotaFits(data.quota_bytes); + } const fields: string[] = []; const values: unknown[] = []; diff --git a/backend/cloud/src/routes/auth.ts b/backend/src/routes/auth.ts similarity index 99% rename from backend/cloud/src/routes/auth.ts rename to backend/src/routes/auth.ts index 1327a04..f94b5fa 100644 --- a/backend/cloud/src/routes/auth.ts +++ b/backend/src/routes/auth.ts @@ -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), diff --git a/backend/cloud/src/routes/files.ts b/backend/src/routes/files.ts similarity index 97% rename from backend/cloud/src/routes/files.ts rename to backend/src/routes/files.ts index 21869ea..d5e73a1 100644 --- a/backend/cloud/src/routes/files.ts +++ b/backend/src/routes/files.ts @@ -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); diff --git a/backend/cloud/src/routes/folders.ts b/backend/src/routes/folders.ts similarity index 99% rename from backend/cloud/src/routes/folders.ts rename to backend/src/routes/folders.ts index 54ab944..7f8d7b2 100644 --- a/backend/cloud/src/routes/folders.ts +++ b/backend/src/routes/folders.ts @@ -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 diff --git a/backend/cloud/src/routes/media.ts b/backend/src/routes/media.ts similarity index 99% rename from backend/cloud/src/routes/media.ts rename to backend/src/routes/media.ts index dddf7d2..2e66aa0 100644 --- a/backend/cloud/src/routes/media.ts +++ b/backend/src/routes/media.ts @@ -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, diff --git a/backend/cloud/src/routes/search.ts b/backend/src/routes/search.ts similarity index 99% rename from backend/cloud/src/routes/search.ts rename to backend/src/routes/search.ts index 8bbe2cb..dd18329 100644 --- a/backend/cloud/src/routes/search.ts +++ b/backend/src/routes/search.ts @@ -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 diff --git a/backend/cloud/src/routes/trash.ts b/backend/src/routes/trash.ts similarity index 99% rename from backend/cloud/src/routes/trash.ts rename to backend/src/routes/trash.ts index 2b38d26..fd0dc4b 100644 --- a/backend/cloud/src/routes/trash.ts +++ b/backend/src/routes/trash.ts @@ -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"; diff --git a/backend/cloud/src/storage.ts b/backend/src/storage.ts similarity index 82% rename from backend/cloud/src/storage.ts rename to backend/src/storage.ts index 8d2f81e..43366ed 100644 --- a/backend/cloud/src/storage.ts +++ b/backend/src/storage.ts @@ -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 => { }; export const openForDownload = (absolute: string) => createReadStream(absolute); + +/** + * Occupation reelle du support qui porte `target`. Sert a refuser un quota + * plus grand que le disque et a prevenir un eclatement d'ENOSPC : l'espace + * logique (used_bytes) peut etre disponible alors que le disque est plein. + */ +export interface DiskUsage { + total_bytes: number; + /** Blocs libres, blocs reserves du systeme de fichiers inclus. */ + free_bytes: number; + /** Blocs utilisables par le processus (hors reserve root). */ + available_bytes: number; +} + +export const diskUsage = async (target: string): Promise => { + try { + const info = await statfs(target, { bigint: true }); + return { + total_bytes: Number(info.blocks * info.bsize), + free_bytes: Number(info.bfree * info.bsize), + available_bytes: Number(info.bavail * info.bsize), + }; + } catch { + // Support absent ou non monté : l'appelant decide du repli. + return null; + } +}; diff --git a/backend/shared/tsconfig.json b/backend/tsconfig.json similarity index 83% rename from backend/shared/tsconfig.json rename to backend/tsconfig.json index c62df5b..804eaca 100644 --- a/backend/shared/tsconfig.json +++ b/backend/tsconfig.json @@ -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"] diff --git a/docker-compose.yml b/docker-compose.yml index 1cf1926..e7bedc1 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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} diff --git a/docker/Dockerfile.api b/docker/Dockerfile.api index 8508dac..1c09322 100644 --- a/docker/Dockerfile.api +++ b/docker/Dockerfile.api @@ -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} diff --git a/docker/Dockerfile.app b/docker/Dockerfile.app index 624f7e4..8c0cd98 100644 --- a/docker/Dockerfile.app +++ b/docker/Dockerfile.app @@ -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 diff --git a/docker/README.md b/docker/README.md index 6dcfc86..e73b2c6 100644 --- a/docker/README.md +++ b/docker/README.md @@ -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 diff --git a/docker/reset-cloud.sql b/docker/reset-cloud.sql new file mode 100644 index 0000000..ebbf195 --- /dev/null +++ b/docker/reset-cloud.sql @@ -0,0 +1,21 @@ +-- Remise a zero du cloud en conservant les comptes administrateurs. +-- Execute par `make reset`. Les tables enfants partent avant les parents pour +-- rester compatible avec les contraintes de cle etrangere. + +DELETE FROM file_variants; +DELETE FROM media_metadata; +DELETE FROM share_links; +DELETE FROM files; +DELETE FROM folder_permissions; +DELETE FROM folders; +DELETE FROM user_avatars; +DELETE FROM password_reset_tokens; +DELETE FROM email_change_requests; +DELETE FROM user_sessions; +DELETE FROM audit_logs; + +-- Les comptes utilisateurs disparaissent, les administrateurs restent. +DELETE FROM users WHERE role_id NOT IN (SELECT id FROM roles WHERE slug = 'admin'); + +-- Le compteur logique des supports repart de zero en meme temps que le disque. +UPDATE storage_locations SET used_bytes = 0; diff --git a/docs/agents.md b/docs/agents.md index 5a3b82d..28fdce9 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -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. diff --git a/docs/api.md b/docs/api.md index ac17bb4..3b31abc 100644 --- a/docs/api.md +++ b/docs/api.md @@ -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 : diff --git a/docs/architecture.md b/docs/architecture.md index af534a5..88641cd 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -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`, diff --git a/docs/deployment.md b/docs/deployment.md index 4f8ddaa..fedae44 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -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-.sql.gz make admin ARGS=... # créer / réinitialiser un compte +make purge-logs # vider le journal d'audit +make reset # cloud vierge, administrateurs conservés (confirmation) make dev # Vite 5174, proxy /api → 3101 make check # typecheck + build make down # arrêt, volumes conservés ``` -`make backup` lit le mot de passe **dans le conteneur** : il ne passe ni par la -commande, ni par le dépôt. +`make backup`, `make purge-logs` et `make reset` lisent le mot de passe **dans +le conteneur** : il ne passe ni par la commande, ni par le dépôt. + +## Maintenance + +### Vider les journaux + +`make purge-logs` supprime le contenu de `audit_logs` (table +`docker/reset-cloud.sql` mise à part). Les comptes, fichiers et dossiers sont +intacts. + +### Remettre le cloud à zéro + +`make reset` repart d'une instance vierge **en conservant les comptes +administrateurs** : + +- supprime fichiers, dossiers, partages, permissions, avatars, sessions, jetons + (réinitialisation, changement d'adresse) et journaux d'audit ; +- supprime tous les comptes **sauf** ceux dont le rôle est `admin` ; +- remet `storage_locations.used_bytes` à zéro ; +- efface les médias sur disque (`$CLOUD_MEDIA_DIR`), originaux, vignettes et + avatars compris. + +La commande demande une confirmation (`o`/`y`). Enchaîner `make backup` avant +si l'état doit être conservé. ## Migrations diff --git a/docs/security.md b/docs/security.md index 86efbe7..332563e 100644 --- a/docs/security.md +++ b/docs/security.md @@ -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. diff --git a/docs/standards.md b/docs/standards.md index 45f2233..8c4d84b 100644 --- a/docs/standards.md +++ b/docs/standards.md @@ -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) | diff --git a/docs/workflow.md b/docs/workflow.md index ab382f7..9442810 100644 --- a/docs/workflow.md +++ b/docs/workflow.md @@ -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/.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/.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`. diff --git a/frontend/cloud/src/styles/index.css b/frontend/cloud/src/styles/index.css deleted file mode 100644 index 07ea97d..0000000 --- a/frontend/cloud/src/styles/index.css +++ /dev/null @@ -1,4 +0,0 @@ -@import "tailwindcss"; -@import "@cohaise/ui/styles"; - -@source "../../../../frontend/shared/src"; diff --git a/frontend/cloud/index.html b/frontend/index.html similarity index 64% rename from frontend/cloud/index.html rename to frontend/index.html index ef7166d..a0ab49b 100644 --- a/frontend/cloud/index.html +++ b/frontend/index.html @@ -4,7 +4,11 @@ + CoHaiSe Cloud + + + diff --git a/frontend/cloud/package.json b/frontend/package.json similarity index 86% rename from frontend/cloud/package.json rename to frontend/package.json index b554d8a..0ed7098 100644 --- a/frontend/cloud/package.json +++ b/frontend/package.json @@ -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", diff --git a/frontend/public/favicon.ico b/frontend/public/favicon.ico new file mode 100644 index 0000000..cf90136 Binary files /dev/null and b/frontend/public/favicon.ico differ diff --git a/frontend/public/icon.png b/frontend/public/icon.png new file mode 100644 index 0000000..f34c330 Binary files /dev/null and b/frontend/public/icon.png differ diff --git a/frontend/cloud/public/theme.js b/frontend/public/theme.js similarity index 100% rename from frontend/cloud/public/theme.js rename to frontend/public/theme.js diff --git a/frontend/shared/README.md b/frontend/shared/README.md deleted file mode 100644 index 3fd8f1b..0000000 --- a/frontend/shared/README.md +++ /dev/null @@ -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
--cohaise-gray-*, --cohaise-crimson-*"] --> B["tokens.css
--cohaise-background, --cohaise-border, ..."] - B --> C["theme.css
@theme inline"] - C --> D["Tailwind CSS
compile les utilitaires"] - D --> E["frontend/cloud"] - - F["Classe .dark sur <html>"] -.->|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 ``. `: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
#f7f5f4"] - LB["--cohaise-foreground
#1a1a1a"] - LC["--cohaise-primary
#b71c1c"] - end - subgraph Dark["`.dark` — mode sombre"] - DA["--cohaise-background
#050000"] - DB["--cohaise-foreground
#f4f4f2"] - DC["--cohaise-primary
#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`. diff --git a/frontend/shared/package.json b/frontend/shared/package.json deleted file mode 100644 index de83787..0000000 --- a/frontend/shared/package.json +++ /dev/null @@ -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" - } -} diff --git a/frontend/shared/tsconfig.json b/frontend/shared/tsconfig.json deleted file mode 100644 index c7c09d1..0000000 --- a/frontend/shared/tsconfig.json +++ /dev/null @@ -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"] -} diff --git a/frontend/cloud/src/App.tsx b/frontend/src/App.tsx similarity index 98% rename from frontend/cloud/src/App.tsx rename to frontend/src/App.tsx index f690051..e0673bc 100644 --- a/frontend/cloud/src/App.tsx +++ b/frontend/src/App.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"; diff --git a/frontend/cloud/src/components/AppShell.tsx b/frontend/src/components/AppShell.tsx similarity index 96% rename from frontend/cloud/src/components/AppShell.tsx rename to frontend/src/components/AppShell.tsx index cc6aadc..80932f9 100644 --- a/frontend/cloud/src/components/AppShell.tsx +++ b/frontend/src/components/AppShell.tsx @@ -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 = ( setMenuOpen(false)}> + CoHaiSe diff --git a/frontend/cloud/src/components/IconAction.tsx b/frontend/src/components/IconAction.tsx similarity index 94% rename from frontend/cloud/src/components/IconAction.tsx rename to frontend/src/components/IconAction.tsx index d3389db..3045a2e 100644 --- a/frontend/cloud/src/components/IconAction.tsx +++ b/frontend/src/components/IconAction.tsx @@ -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, diff --git a/frontend/src/components/confirm.tsx b/frontend/src/components/confirm.tsx new file mode 100644 index 0000000..b888262 --- /dev/null +++ b/frontend/src/components/confirm.tsx @@ -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; + +interface PendingConfirm { + options: ConfirmOptions; + resolve: (value: boolean) => void; +} + +const ConfirmContext = createContext(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(null); + + const confirm = useCallback( + (options) => new Promise((resolve) => setPending({ options, resolve })), + [], + ); + + const answer = (value: boolean) => { + if (pending) pending.resolve(value); + setPending(null); + }; + + const tone = pending?.options.tone ?? "default"; + + return ( + + {children} + answer(false)} + > +
+

+ {pending?.options.message} +

+
+ + +
+
+
+
+ ); +}; + +export const useConfirm = (): ConfirmFn => { + const context = useContext(ConfirmContext); + if (!context) throw new Error("useConfirm doit etre utilise sous ConfirmProvider"); + return context; +}; diff --git a/frontend/cloud/src/components/dialogs.tsx b/frontend/src/components/dialogs.tsx similarity index 99% rename from frontend/cloud/src/components/dialogs.tsx rename to frontend/src/components/dialogs.tsx index 65b1308..13bcca2 100644 --- a/frontend/cloud/src/components/dialogs.tsx +++ b/frontend/src/components/dialogs.tsx @@ -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, diff --git a/frontend/cloud/src/components/feedback.tsx b/frontend/src/components/feedback.tsx similarity index 78% rename from frontend/cloud/src/components/feedback.tsx rename to frontend/src/components/feedback.tsx index 2398a9c..d16fe25 100644 --- a/frontend/cloud/src/components/feedback.tsx +++ b/frontend/src/components/feedback.tsx @@ -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 (