diff --git a/.github/workflows/auto-create-pr.yml b/.github/workflows/auto-create-pr.yml new file mode 100644 index 0000000..e78ab2a --- /dev/null +++ b/.github/workflows/auto-create-pr.yml @@ -0,0 +1,52 @@ +name: PR — Ouverture automatique + +on: + push: + branches-ignore: [main] + workflow_dispatch: + +jobs: + create-pr: + runs-on: cohaise + permissions: + contents: write + pull-requests: write + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - name: Ouvrir (ou vérifier) la pull request + env: + GITEA_TOKEN: ${{ secrets.GITHUB_TOKEN }} + API: ${{ github.server_url }}/api/v1 + REPO: ${{ github.repository }} + BRANCH: ${{ github.ref_name }} + run: | + set -eu + if [ "$BRANCH" = "main" ]; then + echo "main est la base : aucune PR à ouvrir." + exit 0 + fi + title=$(git log -1 --pretty=%s) + body=$(git log -1 --pretty=%b) + [ -n "$body" ] || body="PR automatique de $BRANCH vers main." + + open=$(curl -fsS -H "Authorization: token $GITEA_TOKEN" \ + "$API/repos/$REPO/pulls?state=open&limit=50" \ + | python3 -c 'import json,os,sys; b=os.environ["BRANCH"]; print(sum(1 for p in json.load(sys.stdin) if p.get("head", {}).get("ref") == b))') + if [ "$open" -gt 0 ]; then + echo "Une PR est déjà ouverte pour $BRANCH." + exit 0 + fi + + python3 - "$BRANCH" "$title" "$body" <<'PY' | curl -fsS -X POST \ + -H "Authorization: token $GITEA_TOKEN" \ + -H "Content-Type: application/json" \ + --data-binary @- \ + "$API/repos/$REPO/pulls" + import json, sys + branch, title, body = sys.argv[1], sys.argv[2], sys.argv[3] + print(json.dumps({"base": "main", "head": branch, "title": title, "body": body})) + PY + echo "PR créée." diff --git a/.gitignore b/.gitignore index 2e31670..1f3bdbf 100644 --- a/.gitignore +++ b/.gitignore @@ -3,6 +3,8 @@ dist/ build/ coverage/ .vite/ +.next/ +out/ *.tsbuildinfo # Sauvegardes de base : contiennent les donnees, jamais versionnees. diff --git a/Makefile b/Makefile index 52a7cff..a9917d9 100644 --- a/Makefile +++ b/Makefile @@ -16,14 +16,15 @@ help: @echo " make up Demarrer la vitrine" @echo " make down Arreter la vitrine" @echo " make web Reconstruire et publier la vitrine" + @echo " make build Construire les images (ne publie rien)" @echo " make deploy Build + demarrage" - @echo " make dev Vite vitrine (5173)" + @echo " make dev Next.js vitrine (3000)" @echo "" @echo "CRM (crm.cohaise.dev, port 8082)" @echo " make crm-up Demarrer le CRM" @echo " make crm-down Arreter le CRM" @echo " make crm-front Reconstruire et publier le front CRM" - @echo " make crm-migrate Appliquer les migrations" + @echo " make crm-migrate Migrer la base et recharger l'API" @echo " make crm-backup Sauvegarder la base" @echo " make crm-admin ARGS=... Creer ou reinitialiser un compte" @echo " make crm-dev Vite CRM (5175)" @@ -90,8 +91,9 @@ crm-db: $(CRM) restart db crm-migrate: - $(CRM) build migrate + $(CRM) build api migrate $(CRM) run --rm migrate + $(CRM) up -d --no-deps api crm-backup: @mkdir -p backups diff --git a/README.md b/README.md index 926102d..08a3c8a 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ mais se déploient dans **deux stacks Docker indépendantes**. | Application | Sous-domaine | Stack | Port par défaut | Compose | | --- | --- | --- | --- | --- | -| Vitrine | `cohaise.dev` | statique (nginx) | 8080 | `docker-compose.yml` | +| Vitrine | `cohaise.dev` | Next.js (export statique) + nginx | 8080 | `docker-compose.yml` | | CRM | `crm.cohaise.dev` | nginx + API + MariaDB | 8082 | `docker-compose.crm.yml` | Le dépôt `CoHaiSe-CLOUD` (`cloud.cohaise.dev`) reste séparé. @@ -16,14 +16,14 @@ Le dépôt `CoHaiSe-CLOUD` (`cloud.cohaise.dev`) reste séparé. ``` frontend/ shared/ @cohaise/ui — design system, jetons et composants partagés - web/ @cohaise/web — la vitrine (statique, bilingue FR/EN) + web/ @cohaise/web — la vitrine (Next.js, bilingue FR/EN) crm/ @cohaise/crm-web — le front du CRM (React + Vite) backend/ shared/ @cohaise/server — couche serveur : config, base, auth, http, migrations crm/ @cohaise/crm — l'API du CRM (auth, organisations, contacts, leads) docker/ Dockerfile image nginx (paramétrée par NGINX_CONF) - Dockerfile.app build Vite puis export atomique dans le volume + Dockerfile.app build Next/Vite puis export atomique dans le volume Dockerfile.api image de l'API nginx/web.conf serveur de la vitrine nginx/crm.conf serveur du CRM (proxy /api/ vers l'API) @@ -32,10 +32,13 @@ docker/ ## Vitrine -La vitrine est une application statique React + Vite, sans base ni session. -Sections : Hero, Services (accordéon coulissant), Démos (mockups neutres), Stack, -À propos, Contact. Elle est bilingue (FR par défaut, EN) et porte le thème -« liquid glass » carmin du design system. +La vitrine est un site Next.js en export statique, sans base ni session. Routes +dédiées : `/`, `/services`, `/demos`, `/stack`, `/about`, `/contact`. Les +métadonnées, le sitemap, `robots.txt` et l'image Open Graph sont générés par +Next. Elle est bilingue (FR par défaut, EN) via un toggle client, et porte le +thème « liquid glass » carmin du design system. Les animations d'entrée +(fade-in-up au threshold) et le smooth scroll par section respectent +`prefers-reduced-motion`. Le formulaire de contact POSTe vers `POST /api/crm/leads` du CRM (cross-origin) ; le lead est posé dans `contacts` avec `external_source = 'cohaise-web'`. @@ -44,7 +47,7 @@ le lead est posé dans `contacts` avec `external_source = 'cohaise-web'`. cp .env.example .env # COHAISE_HTTP_PORT=8080 make up # build + démarrage sur 8080 make web # reconstruire et publier la vitrine -make dev # serveur Vite local, port 5173 +make dev # serveur Next local, port 3000 ``` ## CRM diff --git a/backend/crm/src/config/app.ts b/backend/crm/src/config/app.ts new file mode 100644 index 0000000..1462e9d --- /dev/null +++ b/backend/crm/src/config/app.ts @@ -0,0 +1,20 @@ +/** + * Réglages applicatifs du CRM. Les secrets et paramètres d'environnement + * restent dans `@cohaise/server` (voir `config.ts`) : ce fichier ne contient + * que des constantes métier, sans dépendance à l'environnement. + */ + +/** Taille de page par défaut des listes paginées. */ +export const DEFAULT_PAGE_SIZE = 25; + +/** Plafond de page pour éviter les requêtes trop larges. */ +export const MAX_PAGE_SIZE = 100; + +/** Source externe des prospects créés par le formulaire de la vitrine. */ +export const PUBLIC_LEAD_SOURCE = "cohaise-web"; + +/** Anti-abus du formulaire public : 5 envois par IP et par quart d'heure. */ +export const PUBLIC_LEAD_RATE_LIMIT = { + windowMs: 15 * 60 * 1000, + max: 5, +} as const; diff --git a/backend/crm/src/index.ts b/backend/crm/src/index.ts index f296277..5156009 100644 --- a/backend/crm/src/index.ts +++ b/backend/crm/src/index.ts @@ -1,11 +1,11 @@ import { dirname, join } from "node:path"; import { fileURLToPath } from "node:url"; import { purgeExpiredSessions, startService } from "@cohaise/server"; -import { registerAuthRoutes } from "./routes/auth.js"; -import { registerCountryRoutes } from "./routes/countries.js"; -import { registerOrganizationRoutes } from "./routes/organizations.js"; -import { registerContactRoutes } from "./routes/contacts.js"; -import { registerLeadRoutes } from "./routes/leads.js"; +import { registerAuthRoutes } from "./routes/authRoutes.js"; +import { registerCountryRoutes } from "./routes/countryRoutes.js"; +import { registerOrganizationRoutes } from "./routes/organizationRoutes.js"; +import { registerContactRoutes } from "./routes/contactRoutes.js"; +import { registerLeadRoutes } from "./routes/leadRoutes.js"; const migrationsDir = join(dirname(fileURLToPath(import.meta.url)), "../migrations"); @@ -18,8 +18,8 @@ void startService({ registerOrganizationRoutes(app, db); registerContactRoutes(app, db); registerLeadRoutes(app, db); - // Les jetons expires n'ont rien a faire en base : purge au demarrage - // plutot qu'un EVENT, qui dependrait du planificateur MariaDB. + // Les jetons expirés n'ont rien à faire en base : purge au démarrage + // plutôt qu'un EVENT, qui dépendrait du planificateur MariaDB. void purgeExpiredSessions(db); }, }); diff --git a/backend/crm/src/middleware/auth.ts b/backend/crm/src/middleware/auth.ts new file mode 100644 index 0000000..9e80e26 --- /dev/null +++ b/backend/crm/src/middleware/auth.ts @@ -0,0 +1,13 @@ +/** + * Porte d'authentification appliquée à une ressource protégée. + * + * `attachUser` est monté sur le chemin exact et sur ses sous-chemins : Hono + * n'hérite pas automatiquement du middleware d'un préfixe. Le contrôle fin + * (`requireAuth`) reste déclaré au niveau de chaque route, comme avant. + */ +import { attachUser, type App, type Db } from "@cohaise/server"; + +export const mountSession = (app: App, db: Db, basePath: string): void => { + app.use(`${basePath}/*`, attachUser(db)); + app.use(basePath, attachUser(db)); +}; diff --git a/backend/crm/src/models/types.ts b/backend/crm/src/models/types.ts new file mode 100644 index 0000000..1a4c530 --- /dev/null +++ b/backend/crm/src/models/types.ts @@ -0,0 +1,88 @@ +/** + * Lignes de base de données et formes exposées par l'API. + * + * Les colonnes gardent leur nom SQL (`first_name`, `phone_code`, …) : les + * services les convertissent au plus près du SELECT, jamais dans les routes. + */ + +export interface UserRow { + id: string; + email: string; + password_hash: string; + first_name: string; + last_name: string; + is_active: number; + must_change_password: number; +} + +/** Utilisateur renvoyé au client : jamais de hash ni de drapeau interne. */ +export interface AuthUser { + id: string; + email: string; + first_name: string; + last_name: string; + must_change_password: boolean; +} + +export interface CountryRow { + id: number; + code: string; + name: string; + phone_code: string | null; +} + +export interface OrganizationRow { + id: string; + name: string; + slug: string; + website: string | null; + industry: string | null; + phone: string | null; + email: string | null; + address_line1: string | null; + address_line2: string | null; + postal_code: string | null; + city: string | null; + country_id: number | null; + country_name: string | null; + country_code: string | null; + description: string | null; + owner_id: string | null; + owner_name: string | null; + created_at: string; + updated_at: string; +} + +export interface ContactRow { + id: string; + first_name: string; + last_name: string; + organization_id: string | null; + organization_name: string | null; + email: string | null; + phone: string | null; + mobile: string | null; + job_title: string | null; + country_id: number | null; + country_name: string | null; + country_code: string | null; + external_source: string | null; + external_id: string | null; + description: string | null; + owner_id: string | null; + owner_name: string | null; + created_at: string; + updated_at: string; +} + +/** Corps du formulaire public de la vitrine. */ +export interface LeadInput { + firstName: string; + lastName: string; + email: string; + organization?: string | null | undefined; + phone?: string | null | undefined; + message?: string | null | undefined; + /** Honeypot : rempli uniquement par les robots. */ + website?: string | null | undefined; +} diff --git a/backend/crm/src/routes/auth.ts b/backend/crm/src/routes/auth.ts deleted file mode 100644 index 2005927..0000000 --- a/backend/crm/src/routes/auth.ts +++ /dev/null @@ -1,151 +0,0 @@ -import { z } from "zod"; -import { - AppError, - attachUser, - clearSessionCookie, - createSession, - currentUser, - hashPassword, - isHttpsRequest, - requireAuth, - revokeSession, - setSessionCookie, - sha256, - verifyPassword, - type App, - type Config, - type Db, -} from "@cohaise/server"; - -const credentials = z.object({ - email: z.string().trim().toLowerCase().email().max(255), - password: z.string().min(1).max(1024), -}); - -const changePassword = z.object({ - current: z.string().min(1).max(1024), - next: z.string().min(8).max(1024), -}); - -interface UserRow { - id: string; - email: string; - password_hash: string; - first_name: string; - last_name: string; - is_active: number; - must_change_password: number; -} - -const SELECT_USER = ` - SELECT u.id, u.email, u.password_hash, u.first_name, u.last_name, - u.is_active, u.must_change_password - FROM users u`; - -/** - * Empreinte de repli, calculee pour n'importe quelle chaine : une adresse - * inconnue doit prendre exactement le meme temps qu'une adresse connue avec - * un mauvais mot de passe, sinon l'API devient un annuaire. - */ -const DUMMY_HASH_PROMISE = hashPassword("placeholder-for-anti-enumeration").catch(() => null); -void DUMMY_HASH_PROMISE; - -const publicUser = (row: UserRow) => ({ - id: row.id, - email: row.email, - first_name: row.first_name, - last_name: row.last_name, - must_change_password: row.must_change_password === 1, -}); - -export const registerAuthRoutes = (app: App, db: Db, config: Config): void => { - app.use("/api/crm/auth/*", attachUser(db)); - - app.post("/api/crm/auth/login", async (context) => { - const parsed = credentials.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - throw AppError.badRequest("Identifiants invalides."); - } - - const row = await db.one( - `${SELECT_USER} WHERE u.email = ? AND u.deleted_at IS NULL`, - [parsed.data.email], - ); - - const stored = row?.password_hash ?? (await DUMMY_HASH_PROMISE) ?? ""; - const valid = stored ? await verifyPassword(parsed.data.password, stored) : false; - if (!row || !valid) throw AppError.unauthorized("Identifiants invalides."); - if (row.is_active !== 1) throw AppError.unauthorized("Compte desactive."); - - const { token, expiresAt } = await createSession( - db, - row.id, - { - ipAddress: context.req.header("x-forwarded-for")?.split(",")[0]?.trim() ?? null, - userAgent: context.req.header("user-agent") ?? null, - }, - config.SESSION_TTL_HOURS, - ); - await db.exec("UPDATE users SET last_login_at = UTC_TIMESTAMP(3) WHERE id = ?", [row.id]); - - // Le schema reel de la requete, pas PUBLIC_ORIGIN : voir isHttpsRequest. - const secure = isHttpsRequest(context, config.TRUST_PROXY); - setSessionCookie(context, token, expiresAt, secure); - - return context.json({ user: publicUser(row) }); - }); - - app.post("/api/crm/auth/logout", requireAuth, async (context) => { - const token = context.get("token") as string | undefined; - if (token) await revokeSession(db, token); - clearSessionCookie(context); - return context.json({ ok: true }); - }); - - app.get("/api/crm/auth/me", requireAuth, async (context) => { - const session = currentUser(context); - const row = await db.one(`${SELECT_USER} WHERE u.id = ? AND u.deleted_at IS NULL`, [ - session.id, - ]); - if (!row) throw AppError.unauthorized(); - return context.json({ user: publicUser(row) }); - }); - - app.post("/api/crm/auth/change-password", requireAuth, async (context) => { - const session = currentUser(context); - const parsed = changePassword.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - throw AppError.badRequest("Le nouveau mot de passe doit contenir au moins 8 caracteres."); - } - - const row = await db.one<{ password_hash: string }>( - "SELECT password_hash FROM users WHERE id = ? AND deleted_at IS NULL", - [session.id], - ); - if (!row) throw AppError.unauthorized(); - - if (!(await verifyPassword(parsed.data.current, row.password_hash))) { - throw AppError.unauthorized("Mot de passe actuel incorrect."); - } - if (parsed.data.current === parsed.data.next) { - throw AppError.badRequest("Le nouveau mot de passe doit differer de l'actuel."); - } - - const hash = await hashPassword(parsed.data.next); - // Pas de password_changed_at ici : cette colonne appartient au modele du - // Cloud. Le CRM n'a pas de notion de confirmation d'identite a celebrer. - await db.exec("UPDATE users SET password_hash = ?, must_change_password = 0 WHERE id = ?", [ - hash, - session.id, - ]); - // La session courante est conservee, toutes les autres sont revoquees. - await db.exec( - `UPDATE user_sessions - SET revoked_at = UTC_TIMESTAMP() - WHERE user_id = ? AND revoked_at IS NULL AND token_hash <> ?`, - [session.id, sha256(context.get("token") ?? "")], - ); - - return context.json({ ok: true }); - }); -}; diff --git a/backend/crm/src/routes/authRoutes.ts b/backend/crm/src/routes/authRoutes.ts new file mode 100644 index 0000000..6d907a5 --- /dev/null +++ b/backend/crm/src/routes/authRoutes.ts @@ -0,0 +1,83 @@ +import { z } from "zod"; +import { + AppError, + clearSessionCookie, + currentUser, + isHttpsRequest, + requireAuth, + setSessionCookie, + type App, + type Config, + type Db, +} from "@cohaise/server"; +import { mountSession } from "../middleware/auth.js"; +import { + changePassword, + getSessionUser, + login, + logout, +} from "../services/authService.js"; + +const credentials = z.object({ + email: z.string().trim().toLowerCase().email().max(255), + password: z.string().min(1).max(1024), +}); + +const newPassword = z.object({ + current: z.string().min(1).max(1024), + next: z.string().min(8).max(1024), +}); + +export const registerAuthRoutes = (app: App, db: Db, config: Config): void => { + mountSession(app, db, "/api/crm/auth"); + + app.post("/api/crm/auth/login", async (context) => { + const parsed = credentials.safeParse(await context.req.json().catch(() => null)); + if (!parsed.success) throw AppError.badRequest("Identifiants invalides."); + + const result = await login(db, config, { + email: parsed.data.email, + password: parsed.data.password, + ipAddress: context.req.header("x-forwarded-for")?.split(",")[0]?.trim() ?? null, + userAgent: context.req.header("user-agent") ?? null, + }); + + // Le schéma réel de la requête, pas PUBLIC_ORIGIN : voir isHttpsRequest. + const secure = isHttpsRequest(context, config.TRUST_PROXY); + setSessionCookie(context, result.token, result.expiresAt, secure); + + return context.json({ user: result.user }); + }); + + app.post("/api/crm/auth/logout", requireAuth, async (context) => { + await logout(db, context.get("token")); + clearSessionCookie(context); + return context.json({ ok: true }); + }); + + app.get("/api/crm/auth/me", requireAuth, async (context) => { + const session = currentUser(context); + const user = await getSessionUser(db, session.id); + return context.json({ user }); + }); + + app.post("/api/crm/auth/change-password", requireAuth, async (context) => { + const session = currentUser(context); + const parsed = newPassword.safeParse(await context.req.json().catch(() => null)); + if (!parsed.success) { + throw AppError.badRequest( + "Le nouveau mot de passe doit contenir au moins 8 caracteres.", + ); + } + + await changePassword( + db, + session.id, + context.get("token"), + parsed.data.current, + parsed.data.next, + ); + + return context.json({ ok: true }); + }); +}; diff --git a/backend/crm/src/routes/contactRoutes.ts b/backend/crm/src/routes/contactRoutes.ts new file mode 100644 index 0000000..f44a2d0 --- /dev/null +++ b/backend/crm/src/routes/contactRoutes.ts @@ -0,0 +1,106 @@ +import { z } from "zod"; +import { + AppError, + currentUser, + requireAuth, + type App, + type Db, +} from "@cohaise/server"; +import { mountSession } from "../middleware/auth.js"; +import { + createContact, + deleteContact, + getContact, + listContacts, + toPublicContact, + updateContact, +} from "../services/contactService.js"; +import { parsePagination } from "../utils/pagination.js"; +import { invalidBody, uuidSchema } from "../utils/validation.js"; + +const createContactBody = z.object({ + firstName: z.string().trim().min(1).max(100), + lastName: z.string().trim().min(1).max(100), + organizationId: uuidSchema.nullish(), + email: z.string().trim().max(255).nullish(), + phone: z.string().trim().max(50).nullish(), + mobile: z.string().trim().max(50).nullish(), + jobTitle: z.string().trim().max(150).nullish(), + countryId: z.coerce.number().int().positive().nullish(), + externalSource: z.string().trim().max(50).nullish(), + externalId: z.string().trim().max(100).nullish(), + description: z.string().trim().max(4000).nullish(), +}); + +const updateContactBody = createContactBody.partial(); + +export const registerContactRoutes = (app: App, db: Db): void => { + mountSession(app, db, "/api/crm/contacts"); + + app.get("/api/crm/contacts", requireAuth, async (context) => { + const pagination = parsePagination( + context.req.query("page"), + context.req.query("limit"), + ); + const { total, contacts } = await listContacts( + db, + { + search: context.req.query("q")?.trim() ?? "", + organizationId: context.req.query("organizationId")?.trim() ?? "", + }, + pagination, + ); + + return context.json({ + total, + page: pagination.page, + limit: pagination.limit, + contacts: contacts.map(toPublicContact), + }); + }); + + app.get("/api/crm/contacts/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Prospect introuvable."); + } + const contact = await getContact(db, id); + return context.json({ contact: toPublicContact(contact) }); + }); + + app.post("/api/crm/contacts", requireAuth, async (context) => { + const user = currentUser(context); + const parsed = createContactBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const contact = await createContact(db, user.id, parsed.data); + return context.json({ contact: toPublicContact(contact) }, 201); + }); + + app.patch("/api/crm/contacts/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Prospect introuvable."); + } + + const parsed = updateContactBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const contact = await updateContact(db, id, parsed.data); + return context.json({ contact: toPublicContact(contact) }); + }); + + app.delete("/api/crm/contacts/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Prospect introuvable."); + } + + await deleteContact(db, id); + return context.json({ ok: true }); + }); +}; diff --git a/backend/crm/src/routes/contacts.ts b/backend/crm/src/routes/contacts.ts deleted file mode 100644 index 02aab58..0000000 --- a/backend/crm/src/routes/contacts.ts +++ /dev/null @@ -1,274 +0,0 @@ -import { randomUUID } from "node:crypto"; -import { z } from "zod"; -import { - AppError, - attachUser, - currentUser, - requireAuth, - type App, - type Db, -} from "@cohaise/server"; - -const uuid = z - .string() - .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "Identifiant invalide."); - -const createContact = z.object({ - firstName: z.string().trim().min(1).max(100), - lastName: z.string().trim().min(1).max(100), - organizationId: z.string().regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i).nullish(), - email: z.string().trim().max(255).nullish(), - phone: z.string().trim().max(50).nullish(), - mobile: z.string().trim().max(50).nullish(), - jobTitle: z.string().trim().max(150).nullish(), - countryId: z.coerce.number().int().positive().nullish(), - externalSource: z.string().trim().max(50).nullish(), - externalId: z.string().trim().max(100).nullish(), - description: z.string().trim().max(4000).nullish(), -}); - -const updateContact = createContact.partial(); - -interface ContactRow { - id: string; - first_name: string; - last_name: string; - organization_id: string | null; - organization_name: string | null; - email: string | null; - phone: string | null; - mobile: string | null; - job_title: string | null; - country_id: number | null; - country_name: string | null; - country_code: string | null; - external_source: string | null; - external_id: string | null; - description: string | null; - owner_id: string | null; - owner_name: string | null; - created_at: string; - updated_at: string; -} - -const SELECT_CONTACT = ` - SELECT ct.id, ct.first_name, ct.last_name, ct.organization_id, - o.name AS organization_name, ct.email, ct.phone, ct.mobile, ct.job_title, - ct.country_id, c.name AS country_name, c.code AS country_code, - ct.external_source, ct.external_id, ct.description, ct.owner_id, - CONCAT(u.first_name, ' ', u.last_name) AS owner_name, - ct.created_at, ct.updated_at - FROM contacts ct - LEFT JOIN organizations o ON o.id = ct.organization_id AND o.deleted_at IS NULL - LEFT JOIN countries c ON c.id = ct.country_id - LEFT JOIN users u ON u.id = ct.owner_id`; - -const publicContact = (row: ContactRow) => ({ - id: row.id, - first_name: row.first_name, - last_name: row.last_name, - organization_id: row.organization_id, - organization_name: row.organization_name, - email: row.email, - phone: row.phone, - mobile: row.mobile, - job_title: row.job_title, - country_id: row.country_id, - country_name: row.country_name, - country_code: row.country_code, - external_source: row.external_source, - external_id: row.external_id, - description: row.description, - owner_id: row.owner_id, - owner_name: row.owner_name, - created_at: row.created_at, - updated_at: row.updated_at, -}); - -/** Un e-mail absent ne doit pas heurter l'index actif : NULL passe partout. */ -const emailOrNull = (value: string | null | undefined): string | null => - value ? value.toLowerCase() : null; - -export const registerContactRoutes = (app: App, db: Db): void => { - app.use("/api/crm/contacts/*", attachUser(db)); - app.use("/api/crm/contacts", attachUser(db)); - - app.get("/api/crm/contacts", requireAuth, async (context) => { - const search = context.req.query("q")?.trim() ?? ""; - const organizationId = context.req.query("organizationId")?.trim() ?? ""; - const page = Math.max(1, Number(context.req.query("page") ?? 1) || 1); - const limit = Math.min(100, Math.max(1, Number(context.req.query("limit") ?? 25) || 25)); - const offset = (page - 1) * limit; - - const clauses = ["ct.deleted_at IS NULL"]; - const params: unknown[] = []; - if (search) { - clauses.push( - "(ct.first_name LIKE ? OR ct.last_name LIKE ? OR ct.email LIKE ? OR o.name LIKE ?)", - ); - const term = `%${search}%`; - params.push(term, term, term, term); - } - if (uuid.safeParse(organizationId).success) { - clauses.push("ct.organization_id = ?"); - params.push(organizationId); - } - const where = `WHERE ${clauses.join(" AND ")}`; - - const totalRows = await db.query<{ total: number }>( - `SELECT COUNT(*) AS total - FROM contacts ct - LEFT JOIN organizations o ON o.id = ct.organization_id AND o.deleted_at IS NULL - ${where}`, - params, - ); - const total = Number(totalRows[0]?.total ?? 0); - - const rows = await db.query( - `${SELECT_CONTACT} ${where} ORDER BY ct.last_name, ct.first_name LIMIT ${limit} OFFSET ${offset}`, - params, - ); - - return context.json({ - total, - page, - limit, - contacts: rows.map(publicContact), - }); - }); - - app.get("/api/crm/contacts/:id", requireAuth, async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Prospect introuvable."); - const row = await db.one( - `${SELECT_CONTACT} WHERE ct.id = ? AND ct.deleted_at IS NULL`, - [id], - ); - if (!row) throw AppError.notFound("Prospect introuvable."); - return context.json({ contact: publicContact(row) }); - }); - - app.post( - "/api/crm/contacts", - requireAuth, - async (context) => { - const user = currentUser(context); - const parsed = createContact.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - const issue = parsed.error.issues[0]; - throw AppError.badRequest(issue ? `${issue.path.join(".") || "corps"} : ${issue.message}` : "Corps invalide."); - } - const data = parsed.data; - - const id = randomUUID(); - try { - await db.exec( - `INSERT INTO contacts - (id, first_name, last_name, organization_id, email, phone, mobile, job_title, - country_id, external_source, external_id, description, owner_id, created_by) - VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, - [ - id, - data.firstName, - data.lastName, - data.organizationId ?? null, - emailOrNull(data.email), - data.phone ?? null, - data.mobile ?? null, - data.jobTitle ?? null, - data.countryId ?? null, - data.externalSource ?? null, - data.externalId ?? null, - data.description ?? null, - user.id, - user.id, - ], - ); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Un prospect actif porte deja cette adresse."); - } - if ((error as { errno?: number }).errno === 1452) { - throw AppError.badRequest("L'entreprise ou le pays reference n'existe pas."); - } - throw error; - } - - const created = await db.required(`${SELECT_CONTACT} WHERE ct.id = ?`, [id]); - return context.json({ contact: publicContact(created) }, 201); - }, - ); - - app.patch( - "/api/crm/contacts/:id", - requireAuth, - async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Prospect introuvable."); - - const parsed = updateContact.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) throw AppError.badRequest("Corps invalide."); - - const existing = await db.one<{ id: string }>( - "SELECT id FROM contacts WHERE id = ? AND deleted_at IS NULL", - [id], - ); - if (!existing) throw AppError.notFound("Prospect introuvable."); - - const columns: Record = { - first_name: parsed.data.firstName, - last_name: parsed.data.lastName, - organization_id: parsed.data.organizationId, - email: parsed.data.email === undefined ? undefined : emailOrNull(parsed.data.email), - phone: parsed.data.phone, - mobile: parsed.data.mobile, - job_title: parsed.data.jobTitle, - country_id: parsed.data.countryId, - external_source: parsed.data.externalSource, - external_id: parsed.data.externalId, - description: parsed.data.description, - }; - - const assignments = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => `${key} = ?`); - if (assignments.length === 0) throw AppError.badRequest("Aucune modification fournie."); - const values = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => columns[key]); - - try { - await db.exec( - `UPDATE contacts SET ${assignments.join(", ")} WHERE id = ? AND deleted_at IS NULL`, - [...values, id], - ); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Un prospect actif porte deja cette adresse."); - } - if ((error as { errno?: number }).errno === 1452) { - throw AppError.badRequest("L'entreprise ou le pays reference n'existe pas."); - } - throw error; - } - - const updated = await db.required(`${SELECT_CONTACT} WHERE ct.id = ?`, [id]); - return context.json({ contact: publicContact(updated) }); - }, - ); - - app.delete( - "/api/crm/contacts/:id", - requireAuth, - async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Prospect introuvable."); - const result = await db.exec( - "UPDATE contacts SET deleted_at = UTC_TIMESTAMP() WHERE id = ? AND deleted_at IS NULL", - [id], - ); - if (result.affectedRows === 0) throw AppError.notFound("Prospect introuvable."); - return context.json({ ok: true }); - }, - ); -}; diff --git a/backend/crm/src/routes/countries.ts b/backend/crm/src/routes/countries.ts deleted file mode 100644 index 09ff1a6..0000000 --- a/backend/crm/src/routes/countries.ts +++ /dev/null @@ -1,150 +0,0 @@ -import { z } from "zod"; -import { - AppError, - attachUser, - requireAuth, - type App, - type Db, -} from "@cohaise/server"; - -const createCountry = z.object({ - code: z - .string() - .trim() - .toUpperCase() - .regex(/^[A-Z]{2}$/, "Code ISO 3166-1 alpha-2 attendu, deux lettres."), - name: z.string().trim().min(1).max(100), - phoneCode: z - .string() - .trim() - .regex(/^\+?[0-9]{1,7}$/, "Indicatif telephonique attendu.") - .nullish(), -}); - -const updateCountry = createCountry.partial(); - -interface CountryRow { - id: number; - code: string; - name: string; - phone_code: string | null; -} - -const publicCountry = (row: CountryRow) => ({ - id: row.id, - code: row.code, - name: row.name, - phone_code: row.phone_code, -}); - -export const registerCountryRoutes = (app: App, db: Db): void => { - app.use("/api/crm/countries/*", attachUser(db)); - app.use("/api/crm/countries", attachUser(db)); - - // Referentiel : lecture ouverte a tout le monde authentifie, ecriture - // reservee. Le tri est collationnel, donc sans accent ni casse douteuse. - app.get("/api/crm/countries", requireAuth, async (context) => { - const search = context.req.query("q")?.trim() ?? ""; - const where = search ? "WHERE name LIKE ? OR code = ?" : ""; - const params = search ? [`%${search}%`, search.toUpperCase()] : []; - const rows = await db.query( - `SELECT id, code, name, phone_code FROM countries ${where} ORDER BY name`, - params, - ); - return context.json({ countries: rows.map(publicCountry) }); - }); - - app.post( - "/api/crm/countries", - requireAuth, - async (context) => { - const parsed = createCountry.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - const issue = parsed.error.issues[0]; - throw AppError.badRequest(issue?.message ?? "Corps invalide."); - } - - try { - await db.exec("INSERT INTO countries (code, name, phone_code) VALUES (?, ?, ?)", [ - parsed.data.code, - parsed.data.name, - parsed.data.phoneCode ?? null, - ]); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Ce pays existe deja."); - } - throw error; - } - - const created = await db.required( - "SELECT id, code, name, phone_code FROM countries WHERE code = ?", - [parsed.data.code], - ); - return context.json({ country: publicCountry(created) }, 201); - }, - ); - - app.patch( - "/api/crm/countries/:id", - requireAuth, - async (context) => { - const id = Number(context.req.param("id")); - if (!Number.isInteger(id) || id <= 0) throw AppError.notFound("Pays introuvable."); - - const parsed = updateCountry.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) throw AppError.badRequest("Corps invalide."); - - const columns: Record = { - code: parsed.data.code, - name: parsed.data.name, - phone_code: parsed.data.phoneCode, - }; - const assignments = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => `${key} = ?`); - if (assignments.length === 0) throw AppError.badRequest("Aucune modification fournie."); - const values = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => columns[key]); - - try { - const result = await db.exec( - `UPDATE countries SET ${assignments.join(", ")} WHERE id = ?`, - [...values, id], - ); - if (result.affectedRows === 0) throw AppError.notFound("Pays introuvable."); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Ce code de pays existe deja."); - } - throw error; - } - - const updated = await db.required( - "SELECT id, code, name, phone_code FROM countries WHERE id = ?", - [id], - ); - return context.json({ country: publicCountry(updated) }); - }, - ); - - app.delete( - "/api/crm/countries/:id", - requireAuth, - async (context) => { - const id = Number(context.req.param("id")); - if (!Number.isInteger(id) || id <= 0) throw AppError.notFound("Pays introuvable."); - try { - const result = await db.exec("DELETE FROM countries WHERE id = ?", [id]); - if (result.affectedRows === 0) throw AppError.notFound("Pays introuvable."); - } catch (error) { - if ((error as { errno?: number }).errno === 1451) { - throw AppError.conflict("Des entreprises ou contacts referencent ce pays."); - } - throw error; - } - return context.json({ ok: true }); - }, - ); -}; diff --git a/backend/crm/src/routes/countryRoutes.ts b/backend/crm/src/routes/countryRoutes.ts new file mode 100644 index 0000000..d4e00f6 --- /dev/null +++ b/backend/crm/src/routes/countryRoutes.ts @@ -0,0 +1,69 @@ +import { z } from "zod"; +import { AppError, requireAuth, type App, type Db } from "@cohaise/server"; +import { mountSession } from "../middleware/auth.js"; +import { + createCountry, + deleteCountry, + listCountries, + toPublicCountry, + updateCountry, +} from "../services/countryService.js"; +import { invalidBody } from "../utils/validation.js"; + +const createCountryBody = z.object({ + code: z + .string() + .trim() + .toUpperCase() + .regex(/^[A-Z]{2}$/, "Code ISO 3166-1 alpha-2 attendu, deux lettres."), + name: z.string().trim().min(1).max(100), + phoneCode: z + .string() + .trim() + .regex(/^\+?[0-9]{1,7}$/, "Indicatif telephonique attendu.") + .nullish(), +}); + +const updateCountryBody = createCountryBody.partial(); + +export const registerCountryRoutes = (app: App, db: Db): void => { + mountSession(app, db, "/api/crm/countries"); + + // Référentiel : lecture ouverte à tout le monde authentifié, écriture + // réservée. + app.get("/api/crm/countries", requireAuth, async (context) => { + const rows = await listCountries(db, context.req.query("q") ?? ""); + return context.json({ countries: rows.map(toPublicCountry) }); + }); + + app.post("/api/crm/countries", requireAuth, async (context) => { + const parsed = createCountryBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const country = await createCountry(db, parsed.data); + return context.json({ country: toPublicCountry(country) }, 201); + }); + + app.patch("/api/crm/countries/:id", requireAuth, async (context) => { + const id = Number(context.req.param("id")); + if (!Number.isInteger(id) || id <= 0) throw AppError.notFound("Pays introuvable."); + + const parsed = updateCountryBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const country = await updateCountry(db, id, parsed.data); + return context.json({ country: toPublicCountry(country) }); + }); + + app.delete("/api/crm/countries/:id", requireAuth, async (context) => { + const id = Number(context.req.param("id")); + if (!Number.isInteger(id) || id <= 0) throw AppError.notFound("Pays introuvable."); + + await deleteCountry(db, id); + return context.json({ ok: true }); + }); +}; diff --git a/backend/crm/src/routes/leadRoutes.ts b/backend/crm/src/routes/leadRoutes.ts new file mode 100644 index 0000000..71683c4 --- /dev/null +++ b/backend/crm/src/routes/leadRoutes.ts @@ -0,0 +1,51 @@ +import { z } from "zod"; +import { AppError, type App, type Db } from "@cohaise/server"; +import { PUBLIC_LEAD_RATE_LIMIT } from "../config/app.js"; +import { createLead } from "../services/leadService.js"; +import { createRateLimiter } from "../utils/rateLimit.js"; + +/** + * Point d'entrée public du formulaire de contact de la vitrine. + * + * Route volontairement sans `requireAuth` : n'importe quel visiteur de + * cohaise.dev peut créer un prospect. Le honeypot et le rate-limit sont + * décrits dans `services/leadService.ts`. + */ + +const leadBody = z.object({ + firstName: z.string().trim().min(1).max(100), + lastName: z.string().trim().min(1).max(100), + email: z.string().trim().min(1).max(255), + organization: z.string().trim().min(1).max(255).nullish(), + phone: z.string().trim().max(50).nullish(), + message: z.string().trim().max(4000).nullish(), + // Honeypot : vide chez un humain, rempli par un robot. + website: z.string().max(255).nullish(), +}); + +// Une instance unique par processus : suffisant pour un CRM à un seul nœud. +const limiter = createRateLimiter(PUBLIC_LEAD_RATE_LIMIT); + +export const registerLeadRoutes = (app: App, db: Db): void => { + app.post("/api/crm/leads", async (context) => { + const forwarded = context.req.header("x-forwarded-for"); + const ip = + forwarded?.split(",")[0]?.trim() ?? + context.req.header("x-real-ip") ?? + "unknown"; + if (!limiter.isAllowed(ip)) throw AppError.tooManyRequests(); + + const parsed = leadBody.safeParse(await context.req.json().catch(() => null)); + if (!parsed.success) { + const issue = parsed.error.issues[0]; + throw AppError.badRequest( + issue + ? `${issue.path.join(".") || "corps"} : ${issue.message}` + : "Corps invalide.", + ); + } + + const result = await createLead(db, parsed.data); + return context.json(result, 201); + }); +}; diff --git a/backend/crm/src/routes/leads.ts b/backend/crm/src/routes/leads.ts deleted file mode 100644 index 6ffc9ea..0000000 --- a/backend/crm/src/routes/leads.ts +++ /dev/null @@ -1,146 +0,0 @@ -import { randomUUID } from "node:crypto"; -import { z } from "zod"; -import { AppError, type App, type Db } from "@cohaise/server"; - -/** - * Point d'entrée public du formulaire de contact de la vitrine. - * - * Route volontairement sans `requireAuth` : n'importe quel visiteur de - * cohaise.dev peut creer un prospect. Protection anti-abus a deux etages : - * - un honeypot (champ invisible que seuls les robots remplissent) ; - * - un rate-limit simple en memoire, par IP (Cloudflare reste la 1re ligne). - * Le lead est pose dans `contacts` avec `external_source = 'cohaise-web'`, - * non assigne, pour apparaitre dans la liste des prospects du CRM. - */ - -const leadSchema = z.object({ - firstName: z.string().trim().min(1).max(100), - lastName: z.string().trim().min(1).max(100), - email: z.string().trim().min(1).max(255), - organization: z.string().trim().min(1).max(255).nullish(), - phone: z.string().trim().max(50).nullish(), - message: z.string().trim().max(4000).nullish(), - // Honeypot : vide chez un humain, rempli par un robot. - website: z.string().max(255).nullish(), -}); - -const slugify = (value: string): string => - value - .normalize("NFD") - .replace(/[\u0300-\u036f]/g, "") - .toLowerCase() - .replace(/[^a-z0-9]+/g, "-") - .replace(/^-+|-+$/g, "") - .slice(0, 255); - -/** Un e-mail absent ne doit pas heurter l'index unique : NULL passe partout. */ -const emailOrNull = (value: string): string | null => value.toLowerCase(); - -/** Retrouve l'entreprise par son nom, ou la cree (nom unique en base). */ -const findOrCreateOrganization = async (db: Db, name: string): Promise => { - const existing = await db.one<{ id: string }>( - "SELECT id FROM organizations WHERE name = ? AND deleted_at IS NULL", - [name], - ); - if (existing) return existing.id; - - const id = randomUUID(); - try { - await db.exec("INSERT INTO organizations (id, name, slug) VALUES (?, ?, ?)", [ - id, - name, - slugify(name), - ]); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - // Course : une autre requete vient de creer le meme nom. On la rejoint. - const raced = await db.one<{ id: string }>( - "SELECT id FROM organizations WHERE name = ? AND deleted_at IS NULL", - [name], - ); - if (raced) return raced.id; - } - throw error; - } - return id; -}; - -// Rate-limit en memoire : suffisant pour une instance CRM unique. Derriere -// nginx/Cloudflare, l'IP vient de x-forwarded-for. -const RATE_WINDOW_MS = 15 * 60 * 1000; -const RATE_MAX = 5; -const attempts = new Map(); - -const isAllowed = (ip: string): boolean => { - const now = Date.now(); - const recent = (attempts.get(ip) ?? []).filter((t) => now - t < RATE_WINDOW_MS); - if (recent.length >= RATE_MAX) { - attempts.set(ip, recent); - return false; - } - recent.push(now); - attempts.set(ip, recent); - return true; -}; - -export const registerLeadRoutes = (app: App, db: Db): void => { - app.post("/api/crm/leads", async (context) => { - const forwarded = context.req.header("x-forwarded-for"); - const ip = - forwarded?.split(",")[0]?.trim() ?? context.req.header("x-real-ip") ?? "unknown"; - if (!isAllowed(ip)) throw AppError.tooManyRequests(); - - const parsed = leadSchema.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - const issue = parsed.error.issues[0]; - throw AppError.badRequest( - issue ? `${issue.path.join(".") || "corps"} : ${issue.message}` : "Corps invalide.", - ); - } - const data = parsed.data; - - // Honeypot rempli : robot. On feint la reussite pour ne pas se trahir. - if (data.website) { - return context.json({ ok: true, id: randomUUID() }, 201); - } - - const organizationId = data.organization - ? await findOrCreateOrganization(db, data.organization) - : null; - - const id = randomUUID(); - try { - await db.exec( - `INSERT INTO contacts - (id, first_name, last_name, organization_id, email, phone, job_title, - country_id, external_source, external_id, description, owner_id, created_by) - VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, - [ - id, - data.firstName, - data.lastName, - organizationId, - emailOrNull(data.email), - data.phone ?? null, - null, - null, - "cohaise-web", - null, - data.message ?? null, - null, - null, - ], - ); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Cette adresse a deja ete enregistree."); - } - if ((error as { errno?: number }).errno === 1452) { - throw AppError.badRequest("L'entreprise referencee n'existe pas."); - } - throw error; - } - - return context.json({ ok: true, id }, 201); - }); -}; diff --git a/backend/crm/src/routes/organizationRoutes.ts b/backend/crm/src/routes/organizationRoutes.ts new file mode 100644 index 0000000..c492edc --- /dev/null +++ b/backend/crm/src/routes/organizationRoutes.ts @@ -0,0 +1,110 @@ +import { z } from "zod"; +import { + AppError, + currentUser, + requireAuth, + type App, + type Db, +} from "@cohaise/server"; +import { mountSession } from "../middleware/auth.js"; +import { + createOrganization, + deleteOrganization, + getOrganization, + listOrganizations, + toPublicOrganization, + updateOrganization, +} from "../services/organizationService.js"; +import { parsePagination } from "../utils/pagination.js"; +import { invalidBody, uuidSchema } from "../utils/validation.js"; + +const writable = z.string().trim().min(1).max(255); +const optionalText = z.string().trim().max(255).nullish(); +const optionalLong = z.string().trim().max(4000).nullish(); + +const createOrganizationBody = z.object({ + name: writable, + website: optionalText, + industry: z.string().trim().max(100).nullish(), + phone: z.string().trim().max(50).nullish(), + email: z.string().trim().max(255).nullish(), + addressLine1: optionalText, + addressLine2: optionalText, + postalCode: z.string().trim().max(20).nullish(), + city: z.string().trim().max(100).nullish(), + countryId: z.coerce.number().int().positive().nullish(), + description: optionalLong, +}); + +const updateOrganizationBody = createOrganizationBody.partial(); + +export const registerOrganizationRoutes = (app: App, db: Db): void => { + mountSession(app, db, "/api/crm/organizations"); + + app.get("/api/crm/organizations", requireAuth, async (context) => { + const pagination = parsePagination( + context.req.query("page"), + context.req.query("limit"), + ); + const { total, organizations } = await listOrganizations( + db, + context.req.query("q")?.trim() ?? "", + pagination, + ); + + return context.json({ + total, + page: pagination.page, + limit: pagination.limit, + organizations: organizations.map(toPublicOrganization), + }); + }); + + app.get("/api/crm/organizations/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Entreprise introuvable."); + } + const organization = await getOrganization(db, id); + return context.json({ organization: toPublicOrganization(organization) }); + }); + + app.post("/api/crm/organizations", requireAuth, async (context) => { + const user = currentUser(context); + const parsed = createOrganizationBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const organization = await createOrganization(db, user.id, parsed.data); + return context.json( + { organization: toPublicOrganization(organization) }, + 201, + ); + }); + + app.patch("/api/crm/organizations/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Entreprise introuvable."); + } + + const parsed = updateOrganizationBody.safeParse( + await context.req.json().catch(() => null), + ); + if (!parsed.success) throw invalidBody(parsed.error); + + const organization = await updateOrganization(db, id, parsed.data); + return context.json({ organization: toPublicOrganization(organization) }); + }); + + app.delete("/api/crm/organizations/:id", requireAuth, async (context) => { + const id = context.req.param("id"); + if (!id || !uuidSchema.safeParse(id).success) { + throw AppError.notFound("Entreprise introuvable."); + } + + await deleteOrganization(db, id); + return context.json({ ok: true }); + }); +}; diff --git a/backend/crm/src/routes/organizations.ts b/backend/crm/src/routes/organizations.ts deleted file mode 100644 index 711ee9a..0000000 --- a/backend/crm/src/routes/organizations.ts +++ /dev/null @@ -1,277 +0,0 @@ -import { randomUUID } from "node:crypto"; -import { z } from "zod"; -import { - AppError, - attachUser, - currentUser, - requireAuth, - type App, - type Db, -} from "@cohaise/server"; - -const uuid = z - .string() - .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, "Identifiant invalide."); - -const writable = z.string().trim().min(1).max(255); -const optionalText = z.string().trim().max(255).nullish(); -const optionalLong = z.string().trim().max(4000).nullish(); - -const createOrganization = z.object({ - name: writable, - website: optionalText, - industry: z.string().trim().max(100).nullish(), - phone: z.string().trim().max(50).nullish(), - email: z.string().trim().max(255).nullish(), - addressLine1: optionalText, - addressLine2: optionalText, - postalCode: z.string().trim().max(20).nullish(), - city: z.string().trim().max(100).nullish(), - countryId: z.coerce.number().int().positive().nullish(), - description: optionalLong, -}); - -const updateOrganization = createOrganization.partial(); - -interface OrganizationRow { - id: string; - name: string; - slug: string; - website: string | null; - industry: string | null; - phone: string | null; - email: string | null; - address_line1: string | null; - address_line2: string | null; - postal_code: string | null; - city: string | null; - country_id: number | null; - country_name: string | null; - country_code: string | null; - description: string | null; - owner_id: string | null; - owner_name: string | null; - created_at: string; - updated_at: string; -} - -const SELECT_ORGANIZATION = ` - SELECT o.id, o.name, o.slug, o.website, o.industry, o.phone, o.email, - o.address_line1, o.address_line2, o.postal_code, o.city, o.country_id, - c.name AS country_name, c.code AS country_code, - o.description, o.owner_id, - CONCAT(u.first_name, ' ', u.last_name) AS owner_name, - o.created_at, o.updated_at - FROM organizations o - LEFT JOIN countries c ON c.id = o.country_id - LEFT JOIN users u ON u.id = o.owner_id`; - -const publicOrganization = (row: OrganizationRow) => ({ - id: row.id, - name: row.name, - slug: row.slug, - website: row.website, - industry: row.industry, - phone: row.phone, - email: row.email, - address_line1: row.address_line1, - address_line2: row.address_line2, - postal_code: row.postal_code, - city: row.city, - country_id: row.country_id, - country_name: row.country_name, - country_code: row.country_code, - description: row.description, - owner_id: row.owner_id, - owner_name: row.owner_name, - created_at: row.created_at, - updated_at: row.updated_at, -}); - -/** Normalise un nom en slug lisible, sans accent ni punctuation. */ -const slugify = (value: string): string => - value - .normalize("NFD") - .replace(/[\u0300-\u036f]/g, "") - .toLowerCase() - .replace(/[^a-z0-9]+/g, "-") - .replace(/^-+|-+$/g, "") - .slice(0, 255); - -export const registerOrganizationRoutes = (app: App, db: Db): void => { - app.use("/api/crm/organizations/*", attachUser(db)); - app.use("/api/crm/organizations", attachUser(db)); - - app.get("/api/crm/organizations", requireAuth, async (context) => { - const search = context.req.query("q")?.trim() ?? ""; - const page = Math.max(1, Number(context.req.query("page") ?? 1) || 1); - const limit = Math.min(100, Math.max(1, Number(context.req.query("limit") ?? 25) || 25)); - const offset = (page - 1) * limit; - - const where = search - ? "WHERE o.deleted_at IS NULL AND (o.name LIKE ? OR o.city LIKE ? OR o.industry LIKE ?)" - : "WHERE o.deleted_at IS NULL"; - const term = `%${search}%`; - const params = search ? [term, term, term] : []; - - const [{ total }, rows] = await Promise.all([ - db - .query<{ total: number }>(`SELECT COUNT(*) AS total FROM organizations o ${where}`, params) - .then((result) => ({ total: Number(result[0]?.total ?? 0) })), - db.query( - `${SELECT_ORGANIZATION} ${where} ORDER BY o.name LIMIT ${limit} OFFSET ${offset}`, - params, - ), - ]); - - return context.json({ - total, - page, - limit, - organizations: rows.map(publicOrganization), - }); - }); - - app.get("/api/crm/organizations/:id", requireAuth, async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Entreprise introuvable."); - const row = await db.one( - `${SELECT_ORGANIZATION} WHERE o.id = ? AND o.deleted_at IS NULL`, - [id], - ); - if (!row) throw AppError.notFound("Entreprise introuvable."); - return context.json({ organization: publicOrganization(row) }); - }); - - app.post( - "/api/crm/organizations", - requireAuth, - async (context) => { - const user = currentUser(context); - const parsed = createOrganization.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) { - const issue = parsed.error.issues[0]; - throw AppError.badRequest( - issue ? `${issue.path.join(".") || "corps"} : ${issue.message}` : "Corps invalide.", - ); - } - const data = parsed.data; - - const id = randomUUID(); - try { - await db.exec( - `INSERT INTO organizations - (id, name, slug, website, industry, phone, email, address_line1, address_line2, - postal_code, city, country_id, description, owner_id, created_by) - VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, - [ - id, - data.name, - slugify(data.name), - data.website ?? null, - data.industry ?? null, - data.phone ?? null, - data.email ?? null, - data.addressLine1 ?? null, - data.addressLine2 ?? null, - data.postalCode ?? null, - data.city ?? null, - data.countryId ?? null, - data.description ?? null, - user.id, - user.id, - ], - ); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Une entreprise porte deja ce nom."); - } - throw error; - } - - const created = await db.required( - `${SELECT_ORGANIZATION} WHERE o.id = ?`, - [id], - ); - return context.json({ organization: publicOrganization(created) }, 201); - }, - ); - - app.patch( - "/api/crm/organizations/:id", - requireAuth, - async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Entreprise introuvable."); - - const parsed = updateOrganization.safeParse(await context.req.json().catch(() => null)); - if (!parsed.success) throw AppError.badRequest("Corps invalide."); - - const existing = await db.one<{ id: string }>( - "SELECT id FROM organizations WHERE id = ? AND deleted_at IS NULL", - [id], - ); - if (!existing) throw AppError.notFound("Entreprise introuvable."); - - const columns: Record = { - website: parsed.data.website, - industry: parsed.data.industry, - phone: parsed.data.phone, - email: parsed.data.email, - address_line1: parsed.data.addressLine1, - address_line2: parsed.data.addressLine2, - postal_code: parsed.data.postalCode, - city: parsed.data.city, - country_id: parsed.data.countryId, - description: parsed.data.description, - }; - if (parsed.data.name !== undefined) { - columns.name = parsed.data.name; - columns.slug = slugify(parsed.data.name); - } - - const assignments = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => `${key} = ?`); - if (assignments.length === 0) throw AppError.badRequest("Aucune modification fournie."); - - const values = Object.keys(columns) - .filter((key) => columns[key] !== undefined) - .map((key) => columns[key]); - - try { - await db.exec( - `UPDATE organizations SET ${assignments.join(", ")} WHERE id = ? AND deleted_at IS NULL`, - [...values, id], - ); - } catch (error) { - if ((error as { errno?: number }).errno === 1062) { - throw AppError.conflict("Une entreprise porte deja ce nom."); - } - throw error; - } - - const updated = await db.required( - `${SELECT_ORGANIZATION} WHERE o.id = ?`, - [id], - ); - return context.json({ organization: publicOrganization(updated) }); - }, - ); - - app.delete( - "/api/crm/organizations/:id", - requireAuth, - async (context) => { - const id = context.req.param("id"); - if (!uuid.safeParse(id).success) throw AppError.notFound("Entreprise introuvable."); - - const result = await db.exec( - "UPDATE organizations SET deleted_at = UTC_TIMESTAMP() WHERE id = ? AND deleted_at IS NULL", - [id], - ); - if (result.affectedRows === 0) throw AppError.notFound("Entreprise introuvable."); - return context.json({ ok: true }); - }, - ); -}; diff --git a/backend/crm/src/services/authService.ts b/backend/crm/src/services/authService.ts new file mode 100644 index 0000000..924197c --- /dev/null +++ b/backend/crm/src/services/authService.ts @@ -0,0 +1,124 @@ +import { + AppError, + createSession, + hashPassword, + revokeSession, + sha256, + verifyPassword, + type Config, + type Db, +} from "@cohaise/server"; +import type { AuthUser, UserRow } from "../models/types.js"; + +const SELECT_USER = ` + SELECT u.id, u.email, u.password_hash, u.first_name, u.last_name, + u.is_active, u.must_change_password + FROM users u`; + +/** + * Empreinte de repli, calculée pour n'importe quelle chaîne : une adresse + * inconnue doit prendre exactement le même temps qu'une adresse connue avec + * un mauvais mot de passe, sinon l'API devient un annuaire. + */ +const DUMMY_HASH_PROMISE = hashPassword("placeholder-for-anti-enumeration").catch( + () => null, +); +void DUMMY_HASH_PROMISE; + +export const toPublicUser = (row: UserRow): AuthUser => ({ + id: row.id, + email: row.email, + first_name: row.first_name, + last_name: row.last_name, + must_change_password: row.must_change_password === 1, +}); + +export interface LoginInput { + email: string; + password: string; + ipAddress: string | null; + userAgent: string | null; +} + +export interface LoginResult { + user: AuthUser; + token: string; + expiresAt: Date; +} + +export const login = async ( + db: Db, + config: Config, + input: LoginInput, +): Promise => { + const row = await db.one( + `${SELECT_USER} WHERE u.email = ? AND u.deleted_at IS NULL`, + [input.email], + ); + + const stored = row?.password_hash ?? (await DUMMY_HASH_PROMISE) ?? ""; + const valid = stored ? await verifyPassword(input.password, stored) : false; + if (!row || !valid) throw AppError.unauthorized("Identifiants invalides."); + if (row.is_active !== 1) throw AppError.unauthorized("Compte desactive."); + + const { token, expiresAt } = await createSession( + db, + row.id, + { ipAddress: input.ipAddress, userAgent: input.userAgent }, + config.SESSION_TTL_HOURS, + ); + await db.exec("UPDATE users SET last_login_at = UTC_TIMESTAMP(3) WHERE id = ?", [ + row.id, + ]); + + return { user: toPublicUser(row), token, expiresAt }; +}; + +export const logout = async (db: Db, token: string | undefined): Promise => { + if (token) await revokeSession(db, token); +}; + +export const getSessionUser = async (db: Db, userId: string): Promise => { + const row = await db.one( + `${SELECT_USER} WHERE u.id = ? AND u.deleted_at IS NULL`, + [userId], + ); + if (!row) throw AppError.unauthorized(); + return toPublicUser(row); +}; + +export const changePassword = async ( + db: Db, + userId: string, + token: string | undefined, + current: string, + next: string, +): Promise => { + const row = await db.one<{ password_hash: string }>( + "SELECT password_hash FROM users WHERE id = ? AND deleted_at IS NULL", + [userId], + ); + if (!row) throw AppError.unauthorized(); + + if (!(await verifyPassword(current, row.password_hash))) { + throw AppError.unauthorized("Mot de passe actuel incorrect."); + } + if (current === next) { + throw AppError.badRequest("Le nouveau mot de passe doit differer de l'actuel."); + } + + const hash = await hashPassword(next); + // Pas de password_changed_at ici : cette colonne appartient au modèle du + // Cloud. Le CRM n'a pas de notion de confirmation d'identité à célébrer. + await db.exec( + "UPDATE users SET password_hash = ?, must_change_password = 0 WHERE id = ?", + [hash, userId], + ); + // La session courante est conservée, toutes les autres sont révoquées. + await db.exec( + `UPDATE user_sessions + SET revoked_at = UTC_TIMESTAMP() + WHERE user_id = ? AND revoked_at IS NULL AND token_hash <> ?`, + [userId, sha256(token ?? "")], + ); +}; diff --git a/backend/crm/src/services/contactService.ts b/backend/crm/src/services/contactService.ts new file mode 100644 index 0000000..a97a429 --- /dev/null +++ b/backend/crm/src/services/contactService.ts @@ -0,0 +1,209 @@ +import { randomUUID } from "node:crypto"; +import { AppError, type Db } from "@cohaise/server"; +import type { ContactRow } from "../models/types.js"; +import { isDuplicateEntry, isForeignKeyViolation } from "../utils/dbErrors.js"; +import { normalizeEmail } from "../utils/normalize.js"; +import { uuidSchema } from "../utils/validation.js"; +import { buildAssignments } from "../utils/sql.js"; +import type { Pagination } from "../utils/pagination.js"; + +const SELECT_CONTACT = ` + SELECT ct.id, ct.first_name, ct.last_name, ct.organization_id, + o.name AS organization_name, ct.email, ct.phone, ct.mobile, ct.job_title, + ct.country_id, c.name AS country_name, c.code AS country_code, + ct.external_source, ct.external_id, ct.description, ct.owner_id, + CONCAT(u.first_name, ' ', u.last_name) AS owner_name, + ct.created_at, ct.updated_at + FROM contacts ct + LEFT JOIN organizations o ON o.id = ct.organization_id AND o.deleted_at IS NULL + LEFT JOIN countries c ON c.id = ct.country_id + LEFT JOIN users u ON u.id = ct.owner_id`; + +export interface ContactCreate { + firstName: string; + lastName: string; + organizationId?: string | null | undefined; + email?: string | null | undefined; + phone?: string | null | undefined; + mobile?: string | null | undefined; + jobTitle?: string | null | undefined; + countryId?: number | null | undefined; + externalSource?: string | null | undefined; + externalId?: string | null | undefined; + description?: string | null | undefined; +} + +export type ContactUpdate = { + [Key in keyof ContactCreate]?: ContactCreate[Key] | undefined; +}; + +export interface ContactList { + total: number; + contacts: ContactRow[]; +} + +export interface ContactFilters { + search: string; + organizationId: string; +} + +export const toPublicContact = (row: ContactRow) => ({ + id: row.id, + first_name: row.first_name, + last_name: row.last_name, + organization_id: row.organization_id, + organization_name: row.organization_name, + email: row.email, + phone: row.phone, + mobile: row.mobile, + job_title: row.job_title, + country_id: row.country_id, + country_name: row.country_name, + country_code: row.country_code, + external_source: row.external_source, + external_id: row.external_id, + description: row.description, + owner_id: row.owner_id, + owner_name: row.owner_name, + created_at: row.created_at, + updated_at: row.updated_at, +}); + +export const listContacts = async ( + db: Db, + filters: ContactFilters, + pagination: Pagination, +): Promise => { + const clauses = ["ct.deleted_at IS NULL"]; + const params: unknown[] = []; + + if (filters.search) { + clauses.push( + "(ct.first_name LIKE ? OR ct.last_name LIKE ? OR ct.email LIKE ? OR o.name LIKE ?)", + ); + const term = `%${filters.search}%`; + params.push(term, term, term, term); + } + if (uuidSchema.safeParse(filters.organizationId).success) { + clauses.push("ct.organization_id = ?"); + params.push(filters.organizationId); + } + const where = `WHERE ${clauses.join(" AND ")}`; + + const totalRows = await db.query<{ total: number }>( + `SELECT COUNT(*) AS total + FROM contacts ct + LEFT JOIN organizations o ON o.id = ct.organization_id AND o.deleted_at IS NULL + ${where}`, + params, + ); + const rows = await db.query( + `${SELECT_CONTACT} ${where} ORDER BY ct.last_name, ct.first_name LIMIT ${pagination.limit} OFFSET ${pagination.offset}`, + params, + ); + + return { total: Number(totalRows[0]?.total ?? 0), contacts: rows }; +}; + +export const getContact = async (db: Db, id: string): Promise => { + const row = await db.one( + `${SELECT_CONTACT} WHERE ct.id = ? AND ct.deleted_at IS NULL`, + [id], + ); + if (!row) throw AppError.notFound("Prospect introuvable."); + return row; +}; + +export const createContact = async ( + db: Db, + ownerId: string, + data: ContactCreate, +): Promise => { + const id = randomUUID(); + try { + await db.exec( + `INSERT INTO contacts + (id, first_name, last_name, organization_id, email, phone, mobile, job_title, + country_id, external_source, external_id, description, owner_id, created_by) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, + [ + id, + data.firstName, + data.lastName, + data.organizationId ?? null, + normalizeEmail(data.email), + data.phone ?? null, + data.mobile ?? null, + data.jobTitle ?? null, + data.countryId ?? null, + data.externalSource ?? null, + data.externalId ?? null, + data.description ?? null, + ownerId, + ownerId, + ], + ); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Un prospect actif porte deja cette adresse."); + } + if (isForeignKeyViolation(error)) { + throw AppError.badRequest("L'entreprise ou le pays reference n'existe pas."); + } + throw error; + } + + return db.required(`${SELECT_CONTACT} WHERE ct.id = ?`, [id]); +}; + +export const updateContact = async ( + db: Db, + id: string, + data: ContactUpdate, +): Promise => { + const existing = await db.one<{ id: string }>( + "SELECT id FROM contacts WHERE id = ? AND deleted_at IS NULL", + [id], + ); + if (!existing) throw AppError.notFound("Prospect introuvable."); + + const assignments = buildAssignments({ + first_name: data.firstName, + last_name: data.lastName, + organization_id: data.organizationId, + email: data.email === undefined ? undefined : normalizeEmail(data.email), + phone: data.phone, + mobile: data.mobile, + job_title: data.jobTitle, + country_id: data.countryId, + external_source: data.externalSource, + external_id: data.externalId, + description: data.description, + }); + if (!assignments) throw AppError.badRequest("Aucune modification fournie."); + + try { + await db.exec( + `UPDATE contacts SET ${assignments.clause} WHERE id = ? AND deleted_at IS NULL`, + [...assignments.values, id], + ); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Un prospect actif porte deja cette adresse."); + } + if (isForeignKeyViolation(error)) { + throw AppError.badRequest("L'entreprise ou le pays reference n'existe pas."); + } + throw error; + } + + return db.required(`${SELECT_CONTACT} WHERE ct.id = ?`, [id]); +}; + +export const deleteContact = async (db: Db, id: string): Promise => { + const result = await db.exec( + "UPDATE contacts SET deleted_at = UTC_TIMESTAMP() WHERE id = ? AND deleted_at IS NULL", + [id], + ); + if (result.affectedRows === 0) throw AppError.notFound("Prospect introuvable."); +}; diff --git a/backend/crm/src/services/countryService.ts b/backend/crm/src/services/countryService.ts new file mode 100644 index 0000000..b728ca3 --- /dev/null +++ b/backend/crm/src/services/countryService.ts @@ -0,0 +1,91 @@ +import { AppError, type Db } from "@cohaise/server"; +import type { CountryRow } from "../models/types.js"; +import { isDuplicateEntry, isReferencedRow } from "../utils/dbErrors.js"; +import { buildAssignments } from "../utils/sql.js"; + +const SELECT_COUNTRY = "SELECT id, code, name, phone_code FROM countries"; + +export interface CountryCreate { + code: string; + name: string; + phoneCode?: string | null | undefined; +} + +export interface CountryUpdate { + code?: string | undefined; + name?: string | undefined; + phoneCode?: string | null | undefined; +} + +export const toPublicCountry = (row: CountryRow) => ({ + id: row.id, + code: row.code, + name: row.name, + phone_code: row.phone_code, +}); + +/** Référentiel : le tri est collationnel, donc sans accent ni casse douteuse. */ +export const listCountries = async (db: Db, search: string): Promise => { + const term = search.trim(); + const where = term ? "WHERE name LIKE ? OR code = ?" : ""; + const params = term ? [`%${term}%`, term.toUpperCase()] : []; + return db.query(`${SELECT_COUNTRY} ${where} ORDER BY name`, params); +}; + +export const createCountry = async ( + db: Db, + data: CountryCreate, +): Promise => { + try { + await db.exec("INSERT INTO countries (code, name, phone_code) VALUES (?, ?, ?)", [ + data.code, + data.name, + data.phoneCode ?? null, + ]); + } catch (error) { + if (isDuplicateEntry(error)) throw AppError.conflict("Ce pays existe deja."); + throw error; + } + + return db.required(`${SELECT_COUNTRY} WHERE code = ?`, [data.code]); +}; + +export const updateCountry = async ( + db: Db, + id: number, + data: CountryUpdate, +): Promise => { + const assignments = buildAssignments({ + code: data.code, + name: data.name, + phone_code: data.phoneCode, + }); + if (!assignments) throw AppError.badRequest("Aucune modification fournie."); + + try { + const result = await db.exec( + `UPDATE countries SET ${assignments.clause} WHERE id = ?`, + [...assignments.values, id], + ); + if (result.affectedRows === 0) throw AppError.notFound("Pays introuvable."); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Ce code de pays existe deja."); + } + throw error; + } + + return db.required(`${SELECT_COUNTRY} WHERE id = ?`, [id]); +}; + +export const deleteCountry = async (db: Db, id: number): Promise => { + try { + const result = await db.exec("DELETE FROM countries WHERE id = ?", [id]); + if (result.affectedRows === 0) throw AppError.notFound("Pays introuvable."); + } catch (error) { + if (isReferencedRow(error)) { + throw AppError.conflict("Des entreprises ou contacts referencent ce pays."); + } + throw error; + } +}; diff --git a/backend/crm/src/services/leadService.ts b/backend/crm/src/services/leadService.ts new file mode 100644 index 0000000..ec82353 --- /dev/null +++ b/backend/crm/src/services/leadService.ts @@ -0,0 +1,65 @@ +import { randomUUID } from "node:crypto"; +import { AppError, type Db } from "@cohaise/server"; +import { PUBLIC_LEAD_SOURCE } from "../config/app.js"; +import type { LeadInput } from "../models/types.js"; +import { isDuplicateEntry, isForeignKeyViolation } from "../utils/dbErrors.js"; +import { normalizeEmail } from "../utils/normalize.js"; +import { findOrCreateOrganization } from "./organizationService.js"; + +export interface LeadResult { + ok: true; + id: string; +} + +/** + * Crée un prospect depuis le formulaire public de la vitrine. + * + * Protection anti-abus à deux étages, appliquée par la route : + * - un honeypot (champ invisible que seuls les robots remplissent) ; + * - un rate-limit simple en mémoire, par IP (Cloudflare reste la 1re ligne). + * Le lead est posé dans `contacts` avec `external_source = 'cohaise-web'`, + * non assigné, pour apparaître dans la liste des prospects du CRM. + */ +export const createLead = async (db: Db, data: LeadInput): Promise => { + // Honeypot rempli : robot. On feint la réussite pour ne pas se trahir. + if (data.website) return { ok: true, id: randomUUID() }; + + const organizationId = data.organization + ? await findOrCreateOrganization(db, data.organization) + : null; + + const id = randomUUID(); + try { + await db.exec( + `INSERT INTO contacts + (id, first_name, last_name, organization_id, email, phone, job_title, + country_id, external_source, external_id, description, owner_id, created_by) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, + [ + id, + data.firstName, + data.lastName, + organizationId, + normalizeEmail(data.email), + data.phone ?? null, + null, + null, + PUBLIC_LEAD_SOURCE, + null, + data.message ?? null, + null, + null, + ], + ); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Cette adresse a deja ete enregistree."); + } + if (isForeignKeyViolation(error)) { + throw AppError.badRequest("L'entreprise referencee n'existe pas."); + } + throw error; + } + + return { ok: true, id }; +}; diff --git a/backend/crm/src/services/organizationService.ts b/backend/crm/src/services/organizationService.ts new file mode 100644 index 0000000..5229ed5 --- /dev/null +++ b/backend/crm/src/services/organizationService.ts @@ -0,0 +1,220 @@ +import { randomUUID } from "node:crypto"; +import { AppError, type Db } from "@cohaise/server"; +import type { OrganizationRow } from "../models/types.js"; +import { isDuplicateEntry } from "../utils/dbErrors.js"; +import { slugify } from "../utils/normalize.js"; +import { buildAssignments } from "../utils/sql.js"; +import type { Pagination } from "../utils/pagination.js"; + +const SELECT_ORGANIZATION = ` + SELECT o.id, o.name, o.slug, o.website, o.industry, o.phone, o.email, + o.address_line1, o.address_line2, o.postal_code, o.city, o.country_id, + c.name AS country_name, c.code AS country_code, + o.description, o.owner_id, + CONCAT(u.first_name, ' ', u.last_name) AS owner_name, + o.created_at, o.updated_at + FROM organizations o + LEFT JOIN countries c ON c.id = o.country_id + LEFT JOIN users u ON u.id = o.owner_id`; + +export interface OrganizationCreate { + name: string; + website?: string | null | undefined; + industry?: string | null | undefined; + phone?: string | null | undefined; + email?: string | null | undefined; + addressLine1?: string | null | undefined; + addressLine2?: string | null | undefined; + postalCode?: string | null | undefined; + city?: string | null | undefined; + countryId?: number | null | undefined; + description?: string | null | undefined; +} + +export type OrganizationUpdate = { + [Key in keyof OrganizationCreate]?: OrganizationCreate[Key] | undefined; +}; + +export interface OrganizationList { + total: number; + organizations: OrganizationRow[]; +} + +export const toPublicOrganization = (row: OrganizationRow) => ({ + id: row.id, + name: row.name, + slug: row.slug, + website: row.website, + industry: row.industry, + phone: row.phone, + email: row.email, + address_line1: row.address_line1, + address_line2: row.address_line2, + postal_code: row.postal_code, + city: row.city, + country_id: row.country_id, + country_name: row.country_name, + country_code: row.country_code, + description: row.description, + owner_id: row.owner_id, + owner_name: row.owner_name, + created_at: row.created_at, + updated_at: row.updated_at, +}); + +export const listOrganizations = async ( + db: Db, + search: string, + pagination: Pagination, +): Promise => { + const where = search + ? "WHERE o.deleted_at IS NULL AND (o.name LIKE ? OR o.city LIKE ? OR o.industry LIKE ?)" + : "WHERE o.deleted_at IS NULL"; + const term = `%${search}%`; + const params = search ? [term, term, term] : []; + + const [counted, rows] = await Promise.all([ + db.query<{ total: number }>( + `SELECT COUNT(*) AS total FROM organizations o ${where}`, + params, + ), + db.query( + `${SELECT_ORGANIZATION} ${where} ORDER BY o.name LIMIT ${pagination.limit} OFFSET ${pagination.offset}`, + params, + ), + ]); + + return { total: Number(counted[0]?.total ?? 0), organizations: rows }; +}; + +export const getOrganization = async (db: Db, id: string): Promise => { + const row = await db.one( + `${SELECT_ORGANIZATION} WHERE o.id = ? AND o.deleted_at IS NULL`, + [id], + ); + if (!row) throw AppError.notFound("Entreprise introuvable."); + return row; +}; + +export const createOrganization = async ( + db: Db, + ownerId: string, + data: OrganizationCreate, +): Promise => { + const id = randomUUID(); + try { + await db.exec( + `INSERT INTO organizations + (id, name, slug, website, industry, phone, email, address_line1, address_line2, + postal_code, city, country_id, description, owner_id, created_by) + VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, + [ + id, + data.name, + slugify(data.name), + data.website ?? null, + data.industry ?? null, + data.phone ?? null, + data.email ?? null, + data.addressLine1 ?? null, + data.addressLine2 ?? null, + data.postalCode ?? null, + data.city ?? null, + data.countryId ?? null, + data.description ?? null, + ownerId, + ownerId, + ], + ); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Une entreprise porte deja ce nom."); + } + throw error; + } + + return db.required(`${SELECT_ORGANIZATION} WHERE o.id = ?`, [id]); +}; + +export const updateOrganization = async ( + db: Db, + id: string, + data: OrganizationUpdate, +): Promise => { + const existing = await db.one<{ id: string }>( + "SELECT id FROM organizations WHERE id = ? AND deleted_at IS NULL", + [id], + ); + if (!existing) throw AppError.notFound("Entreprise introuvable."); + + const assignments = buildAssignments({ + website: data.website, + industry: data.industry, + phone: data.phone, + email: data.email, + address_line1: data.addressLine1, + address_line2: data.addressLine2, + postal_code: data.postalCode, + city: data.city, + country_id: data.countryId, + description: data.description, + ...(data.name === undefined + ? {} + : { name: data.name, slug: slugify(data.name) }), + }); + if (!assignments) throw AppError.badRequest("Aucune modification fournie."); + + try { + await db.exec( + `UPDATE organizations SET ${assignments.clause} WHERE id = ? AND deleted_at IS NULL`, + [...assignments.values, id], + ); + } catch (error) { + if (isDuplicateEntry(error)) { + throw AppError.conflict("Une entreprise porte deja ce nom."); + } + throw error; + } + + return db.required(`${SELECT_ORGANIZATION} WHERE o.id = ?`, [id]); +}; + +export const deleteOrganization = async (db: Db, id: string): Promise => { + const result = await db.exec( + "UPDATE organizations SET deleted_at = UTC_TIMESTAMP() WHERE id = ? AND deleted_at IS NULL", + [id], + ); + if (result.affectedRows === 0) throw AppError.notFound("Entreprise introuvable."); +}; + +/** Retrouve l'entreprise par son nom, ou la crée (nom unique en base). */ +export const findOrCreateOrganization = async ( + db: Db, + name: string, +): Promise => { + const existing = await db.one<{ id: string }>( + "SELECT id FROM organizations WHERE name = ? AND deleted_at IS NULL", + [name], + ); + if (existing) return existing.id; + + const id = randomUUID(); + try { + await db.exec("INSERT INTO organizations (id, name, slug) VALUES (?, ?, ?)", [ + id, + name, + slugify(name), + ]); + } catch (error) { + if (isDuplicateEntry(error)) { + // Course : une autre requête vient de créer le même nom. On la rejoint. + const raced = await db.one<{ id: string }>( + "SELECT id FROM organizations WHERE name = ? AND deleted_at IS NULL", + [name], + ); + if (raced) return raced.id; + } + throw error; + } + return id; +}; diff --git a/backend/crm/src/utils/dbErrors.ts b/backend/crm/src/utils/dbErrors.ts new file mode 100644 index 0000000..163bfc6 --- /dev/null +++ b/backend/crm/src/utils/dbErrors.ts @@ -0,0 +1,15 @@ +/** Erreurs de contrainte MariaDB, reconnues par leur code numérique. */ + +const errnoOf = (error: unknown): number | undefined => + typeof error === "object" && error !== null && "errno" in error + ? ((error as { errno?: number }).errno ?? undefined) + : undefined; + +/** 1062 : violation d'index unique. */ +export const isDuplicateEntry = (error: unknown): boolean => errnoOf(error) === 1062; + +/** 1452 : la ligne référencée par une clé étrangère n'existe pas. */ +export const isForeignKeyViolation = (error: unknown): boolean => errnoOf(error) === 1452; + +/** 1451 : la ligne est encore référencée, suppression impossible. */ +export const isReferencedRow = (error: unknown): boolean => errnoOf(error) === 1451; diff --git a/backend/crm/src/utils/normalize.ts b/backend/crm/src/utils/normalize.ts new file mode 100644 index 0000000..5f196db --- /dev/null +++ b/backend/crm/src/utils/normalize.ts @@ -0,0 +1,15 @@ +/** Normalisations de texte partagées par les services. */ + +/** Slug lisible : sans accent, sans ponctuation, séparé par des tirets. */ +export const slugify = (value: string): string => + value + .normalize("NFD") + .replace(/[\u0300-\u036f]/g, "") + .toLowerCase() + .replace(/[^a-z0-9]+/g, "-") + .replace(/^-+|-+$/g, "") + .slice(0, 255); + +/** Un e-mail absent ne doit pas heurter l'index unique : NULL passe partout. */ +export const normalizeEmail = (value: string | null | undefined): string | null => + value ? value.toLowerCase() : null; diff --git a/backend/crm/src/utils/pagination.ts b/backend/crm/src/utils/pagination.ts new file mode 100644 index 0000000..2829eca --- /dev/null +++ b/backend/crm/src/utils/pagination.ts @@ -0,0 +1,22 @@ +import { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE } from "../config/app.js"; + +export interface Pagination { + page: number; + limit: number; + offset: number; +} + +const positiveInt = (raw: string | undefined, fallback: number): number => { + const value = Number(raw ?? fallback); + return Number.isFinite(value) && value >= 1 ? Math.floor(value) : fallback; +}; + +/** Lit `page`/`limit` depuis la query string et borne les valeurs. */ +export const parsePagination = ( + pageRaw: string | undefined, + limitRaw: string | undefined, +): Pagination => { + const page = Math.max(1, positiveInt(pageRaw, 1)); + const limit = Math.min(MAX_PAGE_SIZE, Math.max(1, positiveInt(limitRaw, DEFAULT_PAGE_SIZE))); + return { page, limit, offset: (page - 1) * limit }; +}; diff --git a/backend/crm/src/utils/rateLimit.ts b/backend/crm/src/utils/rateLimit.ts new file mode 100644 index 0000000..6655f0b --- /dev/null +++ b/backend/crm/src/utils/rateLimit.ts @@ -0,0 +1,33 @@ +export interface RateLimitOptions { + /** Fenêtre glissante, en millisecondes. */ + windowMs: number; + /** Nombre d'essais autorisés dans la fenêtre. */ + max: number; +} + +export interface RateLimiter { + /** Enregistre une tentative et indique si elle est autorisée. */ + isAllowed: (key: string) => boolean; +} + +/** + * Rate-limit en mémoire, suffisant pour une instance CRM unique. Derrière + * nginx/Cloudflare, la clé vient de l'IP transmise par `x-forwarded-for`. + */ +export const createRateLimiter = ({ windowMs, max }: RateLimitOptions): RateLimiter => { + const attempts = new Map(); + + return { + isAllowed: (key) => { + const now = Date.now(); + const recent = (attempts.get(key) ?? []).filter((time) => now - time < windowMs); + if (recent.length >= max) { + attempts.set(key, recent); + return false; + } + recent.push(now); + attempts.set(key, recent); + return true; + }, + }; +}; diff --git a/backend/crm/src/utils/sql.ts b/backend/crm/src/utils/sql.ts new file mode 100644 index 0000000..2ad7d10 --- /dev/null +++ b/backend/crm/src/utils/sql.ts @@ -0,0 +1,22 @@ +/** Construction des `UPDATE` partiels, sans jamais concaténer de valeurs. */ + +export interface Assignments { + clause: string; + values: unknown[]; +} + +/** + * Transforme `{ city: "Lyon", phone: undefined }` en `city = ?`. + * `null` reste une valeur explicite : elle efface la colonne. + * Retourne `null` quand aucune colonne n'est fournie. + */ +export const buildAssignments = ( + columns: Record, +): Assignments | null => { + const keys = Object.keys(columns).filter((key) => columns[key] !== undefined); + if (keys.length === 0) return null; + return { + clause: keys.map((key) => `${key} = ?`).join(", "), + values: keys.map((key) => columns[key]), + }; +}; diff --git a/backend/crm/src/utils/validation.ts b/backend/crm/src/utils/validation.ts new file mode 100644 index 0000000..56d2137 --- /dev/null +++ b/backend/crm/src/utils/validation.ts @@ -0,0 +1,20 @@ +import { z } from "zod"; +import { AppError } from "@cohaise/server"; + +/** Identifiant UUID v4 tel que stocké par les tables du CRM. */ +export const uuidSchema = z + .string() + .regex( + /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, + "Identifiant invalide.", + ); + +/** Erreur 400 homogène pour un corps JSON invalide. */ +export const invalidBody = (error: z.ZodError): AppError => { + const issue = error.issues[0]; + return AppError.badRequest( + issue + ? `${issue.path.join(".") || "corps"} : ${issue.message}` + : "Corps invalide.", + ); +}; diff --git a/docker-compose.yml b/docker-compose.yml index e20053e..ddb6aa7 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -16,6 +16,7 @@ services: target: export args: APP_DIR: frontend/web + OUTPUT_DIR: out command: sh /publish.sh volumes: - app_data:/output diff --git a/docker/Dockerfile.app b/docker/Dockerfile.app index 9d36e98..828b1c9 100644 --- a/docker/Dockerfile.app +++ b/docker/Dockerfile.app @@ -15,5 +15,7 @@ RUN npm run build --workspace=${APP_DIR} FROM alpine:3.21 AS export ARG APP_DIR +# Vite écrit dans `dist/`, Next.js (export statique) dans `out/`. +ARG OUTPUT_DIR=dist -COPY --from=builder /repo/${APP_DIR}/dist /app/dist +COPY --from=builder /repo/${APP_DIR}/${OUTPUT_DIR} /app/dist diff --git a/docker/nginx/web.conf b/docker/nginx/web.conf index 0e685d7..e8602b3 100644 --- a/docker/nginx/web.conf +++ b/docker/nginx/web.conf @@ -3,6 +3,10 @@ server { listen [::]:80 default_server; server_name _; + # Redirections relatives (`/services/`) : derrière un proxy ou un port + # publié, un Location absolu sans port casserait la navigation. + absolute_redirect off; + root /usr/share/nginx/html/current; index index.html; @@ -11,7 +15,7 @@ server { gzip on; gzip_vary on; gzip_min_length 1024; - gzip_types text/plain text/css application/javascript application/json image/svg+xml application/manifest+json; + gzip_types text/plain text/css application/javascript application/json application/xml image/svg+xml image/webp application/manifest+json; location = /healthz { access_log off; @@ -19,6 +23,15 @@ server { return 200 "ok\n"; } + # Assets fingerprintés par Next.js : cache long et immuable. + location /_next/static/ { + include /etc/nginx/snippets/security-headers.conf; + include /etc/nginx/snippets/cache-immutable.conf; + expires 1y; + try_files $uri =404; + } + + # Anciens assets Vite (conservés pour les releases encore servies). location /assets/ { include /etc/nginx/snippets/security-headers.conf; include /etc/nginx/snippets/cache-immutable.conf; @@ -26,13 +39,28 @@ server { try_files $uri =404; } + # Image Open Graph générée par Next.js : fichier sans extension. + location = /opengraph-image { + include /etc/nginx/snippets/security-headers.conf; + include /etc/nginx/snippets/cache-immutable.conf; + default_type image/png; + expires 1y; + try_files $uri =404; + } + + # Page d'erreur générée par l'export statique Next.js. + location = /404.html { + internal; + include /etc/nginx/snippets/security-headers.conf; + include /etc/nginx/snippets/cache-no-cache.conf; + } + location / { include /etc/nginx/snippets/security-headers.conf; include /etc/nginx/snippets/cache-no-cache.conf; - try_files $uri $uri/ @spa; + # Export statique : chaque route est un dossier avec son index.html. + try_files $uri $uri/ =404; } - location @spa { - try_files /index.html =404; - } + error_page 404 /404.html; } diff --git a/docs/agents.md b/docs/agents.md index 04dc1e5..9071dc6 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -8,7 +8,7 @@ de `docs/`. | Action | Commande | | --- | --- | -| Dev hot-reload | `make dev` (Vite 5173) | +| Dev hot-reload | `make dev` (Next.js 3000) | | Vérifier les types | `npm run typecheck` | | Builder | `npm run build` | | Reconstruire + publier | `make web` | @@ -26,18 +26,20 @@ vérifications automatiques. Exécuter les deux avant de déclarer un travail fi 3. **Ne pas lire `.env`** : il contient des secrets d'autres apps. Écrire `SESSION_SECRET` est autorisé, le recopier depuis un autre dépôt aussi, le diffuser non. -4. **Ne pas créer de backend** : ce dépôt est une vitrine statique. Toute - fonctionnalité nécessitant une API appartient à `CoHaiSe-CLOUD` ou - `CoHaiSe-CRM`. +4. **La vitrine n'a pas d'API** : l'export Next est statique ; le formulaire de + contact appelle le CRM séparé (`backend/crm`). Ne pas ajouter de route + dynamique serveur ou de secret dans `frontend/web`. 5. **`.env.example` n'est pas la vérité** : il contient des clés héritées que le compose n'utilise pas. Seul `COHAISE_HTTP_PORT` est lu. ## Conventions de code - TypeScript strict, project references (`tsconfig.json` racine). -- React 19, pas de routeur : la navigation est un état dans `App.tsx`. +- React 19, Next.js app router : les pages et layouts sont des Server + Components ; `"use client"` uniquement quand un hook ou un événement l'exige. - Tailwind 4 via `@import "tailwindcss"` ; **pas de classes arbitraires en dur** : passer par les jetons `--cohaise-*` (`@theme inline`). +- Un élément animé porte `data-reveal` et reste visible sans JavaScript. - Style visuel : `Button`, `Card`, `cn` depuis `@cohaise/ui`. Pas de `
` quand un composant existe. - `.editorconfig` : 2 espaces, LF, UTF-8. @@ -59,8 +61,8 @@ palettes doivent rester synchronisées. - `cohaise.dev` est HSTS-preloadé : `/etc/hosts` ne sert à rien, tester via `localhost:8080`. -- `backend/shared` est construit mais inutilisé : une erreur de types ici ne - casse pas le site. +- `backend/shared` est construit avec le reste et consommé par `backend/crm` : + une erreur de types ici bloque `npm run typecheck` pour tout le monorepo. - `docker/README.md` décrit la build d'image uniquement ; pour le service, `docs/deployment.md`. - Après `make web`, vérifier que le symlink a bien basculé : diff --git a/docs/architecture.md b/docs/architecture.md index e0d7dd9..914848c 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -1,49 +1,70 @@ -# Architecture — CoHaiSe Web +# Architecture — CoHaiSe -Vitrine statique. Il n'y a **ni API, ni base de données, ni session** : un bundle -Vite servi par nginx. Tout le reste (build, publication, en-têtes) tient dans -`docker/`. +Monorepo à deux applications déployées séparément : + +| Application | Sous-domaine | Stack | Compose | +| --- | --- | --- | --- | +| Vitrine | `cohaise.dev` | Next.js 16 (export statique) + nginx | `docker-compose.yml` | +| CRM | `crm.cohaise.dev` | Next/Vite + API Node + MariaDB | `docker-compose.crm.yml` | ## Pile | Élément | Version | Où | | --- | --- | --- | -| React | 19 | `frontend/web` | -| Vite | 8 | `frontend/web/vite.config.ts` | -| Tailwind CSS | 4 (`@tailwindcss/vite`) | `frontend/web/src/styles/index.css` | -| TypeScript | 7 (`typescript` en devDependency racine) | `tsconfig.json` (project references) | +| React | 19 | `frontend/*` | +| Next.js (app router) | 16 | `frontend/web` | +| Vite | 8 | `frontend/crm` | +| Tailwind CSS | 4 (`@tailwindcss/postcss`) | `frontend/web/app/globals.css` | +| TypeScript | 7 | `tsconfig.json` (project references) | +| Hono + mysql2 + Zod | — | `backend/shared`, `backend/crm` | `package.json` racine : `workspaces: ["frontend/*", "backend/*"]`, scripts `build` (`tsc --build` puis build de chaque paquet), `typecheck`, `clean`. +`@cohaise/ui` doit être construit avant la vitrine : `tsc --build` s'en charge. ## Découpage ``` frontend/ - shared/ @cohaise/ui — design system, DUPLOQUÉ dans les 3 dépôts CoHaiSe - web/ @cohaise/web — la vitrine + shared/ @cohaise/ui — design system, dupliqué dans les 3 dépôts CoHaiSe + web/ @cohaise/web — la vitrine Next.js + crm/ @cohaise/crm-web — le front du CRM (React + Vite) backend/ - shared/ @cohaise/server — couche serveur, PRÉSENTE mais INUTILISÉE ici -docker/ Dockerfile, Dockerfile.app, nginx/, publish.sh + shared/ @cohaise/server — config, base, auth, http, migrations + crm/ @cohaise/crm — l'API du CRM +docker/ Dockerfile, Dockerfile.app, Dockerfile.api, nginx/, publish.sh ``` -`backend/shared` est référencé par `tsconfig.json` racine et donc **construit** -par `npm run build`, mais aucun paquet ne l'importe et `docker-compose.yml` ne -construit pas `Dockerfile.api`. C'est un reliquat du monorepo à trois apps : -inoffensif, mais inutile dans ce dépôt. +### Backend CRM -## Chaîne de build +``` +backend/crm/src/ + index.ts composition du service (routes + purge des sessions) + admin.ts création/réinitialisation de comptes hors HTTP + config/app.ts constantes métier (pagination, rate-limit, source lead) + middleware/auth.ts montage de `attachUser` sur une ressource + models/types.ts lignes SQL et formes exposées par l'API + routes/*Routes.ts routes minces : validation Zod, HTTP, statuts + services/*Service.ts requêtes et règles métier + utils/ dbErrors, normalize, pagination, rateLimit, sql, validation +``` + +Le socle (`Db`, `App`, sessions, erreurs) reste dans `@cohaise/server` : la +réorganisation n'a changé ni la stack ni les contrats HTTP. + +## Chaîne de build de la vitrine Deux images, deux rôles : -1. **`docker/Dockerfile.app`** (`target: export`) — stage `builder` `node:22-alpine` : +1. **`docker/Dockerfile.app`** (`target: export`) — stage `builder` `node:22-slim` : `npm ci`, puis `npm run build --workspace=frontend/shared` et - `--workspace=${APP_DIR}` (`APP_DIR: frontend/web` passé par compose). Stage - `export` `alpine:3.21` : recopie `dist/` dans `/app/dist`. -2. **`docker/publish.sh`** — tourne dans le conteneur `app-build` avec le volume - `app_data` monté : copie dans `releases/-`, puis bascule atomique du - lien `current` (`ln -sfn` + `mv -T`). La version précédente reste servie - pendant la copie ; une release plus vieille que 5 minutes est purgée. + `--workspace=${APP_DIR}`. `OUTPUT_DIR` choisit le dossier produit (`out` pour + Next, `dist` pour Vite). Le stage `export` recopie ce dossier dans + `/app/dist`. +2. **`docker/publish.sh`** — tourne dans `app-build` avec le volume `app_data` + monté : copie dans `releases/-`, puis bascule atomique du lien + `current` (`ln -sfn` + `mv -T`). La version précédente reste servie pendant + la copie ; une release plus vieille que 5 minutes est purgée. Publication **atomique** : nginx ne voit jamais un répertoire à moitié écrit. @@ -51,38 +72,100 @@ Publication **atomique** : nginx ne voit jamais un répertoire à moitié écrit `docker/Dockerfile` : `nginx:1.27-alpine` + `docker/nginx/web.conf`. -| Point | Comportement | Référence | -| --- | --- | --- | -| Racine | `/usr/share/nginx/html/current` (symlink) | `nginx/web.conf:6` | -| `/healthz` | `200 ok`, log coupé | `web.conf:16-20` | -| `/assets/` | `expires 1y`, `Cache-Control: public, immutable` | `cache-immutable.conf` | -| Racine applicative | `no-cache`, fallback SPA `try_files → @spa → /index.html` | `web.conf:29-37` | -| gzip | actif, `min_length 1024` | `web.conf:11-14` | -| En-têtes | `snippets/security-headers.conf` au niveau serveur **et** dans chaque `location` | `web.conf:9,23,30` | +| Point | Comportement | +| --- | --- | +| Racine | `/usr/share/nginx/html/current` (symlink) | +| `/healthz` | `200 ok`, log coupé | +| `/_next/static/` | `expires 1y`, `Cache-Control: public, immutable` | +| `/opengraph-image` | fichier sans extension servi en `image/png` | +| `/404.html` | page d'erreur générée par l'export Next | +| Racine applicative | `no-cache`, `try_files $uri $uri/ =404` (pas de fallback SPA) | +| gzip | actif, `min_length 1024` | +| En-têtes | `snippets/security-headers.conf` au niveau serveur **et** dans chaque `location` | + +Chaque route Next est un dossier avec son `index.html` (`trailingSlash: true`). ## Front -- **Pas de routeur** : deux onglets commutés par `useState` (`src/App.tsx:25-29`). -- **Pas de code splitting** : `main.tsx` importe `App` en statique, aucun - `React.lazy`. -- **Thème clair/sombre** : script inline dans `index.html` (anti-FOUC) lit +- **App router** : `app/layout.tsx` porte le shell, les providers, le fond et les + métadonnées par défaut. Une page SEO autonome par section (`/services`, + `/demos`, `/stack`, `/about`, `/contact`), plus `/` qui compose les mêmes + sections. Le menu se comporte comme une barre d'onglets : une pastille + glisse d'une entrée à l'autre et l'URL ne reçoit **aucun `#`**. Sur + l'accueil, le clic fait défiler jusqu'à la région et l'onglet actif suit le + défilement ; depuis une page autonome, la cible est mémorisée dans + `sessionStorage` puis rejointe après le retour à `/`. Ces pages tiennent en + un écran (voir `globals.css`, règle `:only-child`) et ne défilent pas. +- **SEO** : `metadata` par page, canonical, OpenGraph/Twitter, JSON-LD + `Organization`/`WebSite`/`ProfessionalService` sur l'accueil, `sitemap.ts`, + `robots.ts` et `opengraph-image.tsx` généré (1200×630). +- **Bilingue** : toggle client FR/EN (`LanguageContext`). Le HTML prérendu est en + français — c'est la version indexée. La préférence stockée est appliquée après + le montage pour éviter tout mismatch d'hydratation. +- **Thème clair/sombre** : script inline dans `app/layout.tsx` (anti-FOUC) lit `localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`, puis pose la - classe `.dark` sur ``. Le basculeur écrit via `useTheme`. -- **Design system** : `Button`, `Card`, `cn` sont les seuls composants utilisés. - `Input` est un `` brut, `DemoCard` (seul utilisateur de `Skeleton`) n'est - jamais monté. -- **Aucun appel réseau** : pas de `fetch`, `axios`, `WebSocket`, ni - `import.meta.env`. Fonts (woff2) et favicon en local, aucune ressource tierce. + classe `.dark` sur ``. `ThemeContext` lit cet état après le montage. + Le bouton d'en-tête (`ThemeToggle`) est une icône seule : lune en clair, + soleil en sombre, avec étoile et transition rotation/fondu (`.theme-icon-*` + dans `globals.css`). +- **Régions plein écran** : chaque section est un `
` + (`Section`) en `min-h-dvh` ; Stack et About partagent une seule région sur + l'accueil (`StackAbout`). `scroll-snap-type: y mandatory` + + `scroll-snap-stop: always` (voir `globals.css`) empêchent de s'arrêter entre + deux régions ou d'en sauter une. Le footer, hors région, s'aligne sur la fin + du viewport pour rester atteignable. Si une région dépasse la hauteur de + l'écran (téléphone étroit, texte long), `useScrollReveal` pose + `html[data-snap="off"]` et le snap est coupé pour ne pas bloquer le contenu. + Snap aussi désactivé en `prefers-reduced-motion` et sous 620 px de hauteur. +- **Animations** : `useScrollReveal` observe chaque `[data-region]` via une + bande centrale du viewport. Une fois la région stable à l'écran, ses + éléments `[data-reveal]` apparaissent en cascade après 0,25 s (le hero est + réglé à 0,05 s). Quitter la région avant la fin annule le minuteur : elle se + révélera au prochain passage. `data-reveal-delay` décale les voisins et + `prefers-reduced-motion` désactive tout. Pendant une séquence de menu + (`data-scroll-anim`), la région traversée est révélée sans délai. +- **Défilement** : GSAP `ScrollToPlugin` (`scrollToSection`) anime les sauts du + menu **région par région** (une étape par région traversée, courte + respiration entre chaque) ; le snap est suspendu le temps de la séquence + (`html[data-scroll-anim]`) pour que le navigateur ne saute pas directement à + la destination, et un geste de défilement l'interrompt. Pas de + `scroll-behavior: smooth` global, qui entrerait en conflit avec GSAP. Le snap + s'applique aux sections de `main[data-scroll-snap]`. +- **Fond WebGL** : `Topography` est un Client Component chargé via + `next/dynamic` avec `ssr: false`, en position fixed derrière le contenu. +- **Contact** : le formulaire POSTe vers `POST /api/crm/leads` du CRM + (`NEXT_PUBLIC_CRM_API_URL` au build, sinon `https://crm.cohaise.dev`). + +## Front CRM + +- **Shell fixe** : `Crm` occupe `h-dvh` en `overflow-hidden` ; l'en-tête reste + figé et le reste du viewport est **une seule surface** : rail d'onglets à + gauche (15 % à partir de `md`, icônes seules en dessous), vue des données à + droite. La page ne défile jamais ; seules les zones de contenu portent leur + propre défilement (`DataTable`, formulaire du dialogue). +- **Profondeur** : seul l'en-tête porte `.glass` (flou d'arrière-plan). La + surface de travail est un simple voile `bg-surface/40` sans flou ; c'est le + `DataTable` qui porte son propre fond translucide et flouté. +- **DataTable** : `components/DataTable.tsx` affiche la liste triable, la + recherche, les actions de ligne, le squelette, l'état vide et les cartes + mobiles. L'en-tête reste collé et le tableau défile dans son cadre + (`overflow-auto`). Les pages ne réimplémentent plus de ``. +- **Saisie** : `RecordDialog` borne le formulaire à la hauteur de l'écran ; + seul le corps du dialogue défile, y compris sur téléphone. +- **Fond** : `FaultyTerminalBackdrop` est monté sur l'écran connecté, la + connexion, le changement de mot de passe et l'attente de session. ## Jetons `frontend/shared/src/styles/tokens.css` est la source des couleurs ; Tailwind 4 -les reçoit par `@theme inline` (`theme.css`). L'application lit le fichier via : +les reçoit par `@theme inline` (`theme.css`). La vitrine importe le design system +depuis `app/globals.css` : ```css @import "tailwindcss"; @import "@cohaise/ui/styles"; -@source "../../../../frontend/shared/src"; + +@source "../../shared/src"; ``` `--cohaise-destructive` est un rouge (`#d32f2f` clair / `#ef4444` sombre), diff --git a/docs/crm-api.md b/docs/crm-api.md index 3bac224..74eb03d 100644 --- a/docs/crm-api.md +++ b/docs/crm-api.md @@ -1,35 +1,42 @@ # API et modèle de données — CoHaiSe CRM Base : **`/api/crm`**, plus `GET /healthz` (sonde base, `503` si indisponible). -`attachUser` sur les quatre préfixes ; `requireAuth` sur chaque route sauf la -connexion. **Aucune route n'est protégée par un rôle** depuis `007_no_roles.sql`. +`attachUser` sur `auth`, `countries`, `organizations` et `contacts` ; +`requireAuth` sur toutes leurs routes sauf la connexion. `POST /leads` est +public (formulaire de la vitrine). **Aucune route n'est protégée par un rôle** +depuis `007_no_roles.sql`. ## Routes | Méthode | Chemin | Fichier | | --- | --- | --- | -| POST | `/api/crm/auth/login` | `routes/auth.ts:64` | -| POST | `/api/crm/auth/logout` | `routes/auth.ts:98` | -| GET | `/api/crm/auth/me` | `routes/auth.ts:105` | -| POST | `/api/crm/auth/change-password` | `routes/auth.ts:114` | -| GET | `/api/crm/countries?q=` | `routes/countries.ts:46` | -| POST | `/api/crm/countries` | `routes/countries.ts:57` | -| PATCH | `/api/crm/countries/:id` | `routes/countries.ts:88` | -| DELETE | `/api/crm/countries/:id` | `routes/countries.ts:132` | -| GET | `/api/crm/organizations?q&page&limit` | `routes/organizations.ts:105` | -| GET | `/api/crm/organizations/:id` | `routes/organizations.ts:135` | -| POST | `/api/crm/organizations` | `routes/organizations.ts:146` | -| PATCH | `/api/crm/organizations/:id` | `routes/organizations.ts:200` | -| DELETE | `/api/crm/organizations/:id` | `routes/organizations.ts:262` | -| GET | `/api/crm/contacts?q&organizationId&page&limit` | `routes/contacts.ts:96` | -| GET | `/api/crm/contacts/:id` | `routes/contacts.ts:140` | -| POST | `/api/crm/contacts` | `routes/contacts.ts:151` | -| PATCH | `/api/crm/contacts/:id` | `routes/contacts.ts:202` | -| DELETE | `/api/crm/contacts/:id` | `routes/contacts.ts:260` | +| POST | `/api/crm/auth/login` | `routes/authRoutes.ts` | +| POST | `/api/crm/auth/logout` | `routes/authRoutes.ts` | +| GET | `/api/crm/auth/me` | `routes/authRoutes.ts` | +| POST | `/api/crm/auth/change-password` | `routes/authRoutes.ts` | +| GET | `/api/crm/countries?q=` | `routes/countryRoutes.ts` | +| POST | `/api/crm/countries` | `routes/countryRoutes.ts` | +| PATCH | `/api/crm/countries/:id` | `routes/countryRoutes.ts` | +| DELETE | `/api/crm/countries/:id` | `routes/countryRoutes.ts` | +| GET | `/api/crm/organizations?q&page&limit` | `routes/organizationRoutes.ts` | +| GET | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` | +| POST | `/api/crm/organizations` | `routes/organizationRoutes.ts` | +| PATCH | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` | +| DELETE | `/api/crm/organizations/:id` | `routes/organizationRoutes.ts` | +| GET | `/api/crm/contacts?q&organizationId&page&limit` | `routes/contactRoutes.ts` | +| GET | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` | +| POST | `/api/crm/contacts` | `routes/contactRoutes.ts` | +| PATCH | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` | +| DELETE | `/api/crm/contacts/:id` | `routes/contactRoutes.ts` | +| POST | `/api/crm/leads` | `routes/leadRoutes.ts` | + +Chaque route valide son corps puis délègue à `services/*Service.ts` ; aucune +requête SQL n'est écrite dans `routes/`. ### Conventions communes -- Corps validés par Zod (`createX`/`updateX`, `credentials`, `changePassword`). +- Corps validés par Zod dans les routes (`createXBody`, `updateXBody`, + `credentials`, `newPassword`, `leadBody`). - `:id` UUID validé par regex ⇒ **404** sinon (pays : entier `> 0` sinon 404). - Pagination : `limit` borné `1..100`, défaut 25 ; `q` fait une recherche texte. @@ -84,3 +91,8 @@ CLI : `cohaise-migrate --dir [--dry-run] [--check]`, codes `0` / `1` Le DDL MariaDB n'est pas transactionnel : une migration interrompue se corrige par un **nouveau** fichier, jamais en éditant l'ancien. + +`make crm-migrate` applique les migrations **puis reconstruit et redémarre +l'API** : un binaire plus ancien que le schéma (par exemple du code qui lit +encore `roles` après `007`) répondrait `NOT_MIGRATED` alors que la base est à +jour. diff --git a/docs/deployment.md b/docs/deployment.md index b9fafd7..9226747 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -16,7 +16,7 @@ make up # build + démarrage sur 8080 | Service | Image | Port | Rôle | | --- | --- | --- | --- | -| `app-build` | `docker/Dockerfile.app` | — | build Vite, `restart: "no"` | +| `app-build` | `docker/Dockerfile.app` | — | build Next.js (`out/`), `restart: "no"` | | `nginx` | `docker/Dockerfile` | `${COHAISE_HTTP_PORT:-8080}:80` | rendu, `restart: unless-stopped` | Volume unique : `app_data` (`/usr/share/nginx/html`), monté par les deux. Aucun @@ -45,7 +45,7 @@ make reload # nginx -s reload, sans coupure make build # construire les images sans redémarrer make ps # état make logs # journaux suivis -make dev # Vite local sur 5173 (hors Docker) +make dev # Next.js local sur 3000 (hors Docker) make down # arrêt, volumes conservés ``` diff --git a/docs/security.md b/docs/security.md index 2e2ceb8..8c84f99 100644 --- a/docs/security.md +++ b/docs/security.md @@ -1,8 +1,9 @@ # Sécurité — CoHaiSe Web -Surface minimale : une application statique, sans comptes, sans cookies, sans -données. Ce document recense ce qui **est** protégé et ce qui **ne l'est pas**, -pour éviter de partir d'hypothèses fausses. +Surface minimale : un export statique Next.js, sans comptes ni cookies côté +vitrine. Seul appel réseau : le formulaire de contact vers l'API du CRM. Ce +document recense ce qui **est** protégé et ce qui **ne l'est pas**, pour éviter +de partir d'hypothèses fausses. ## Ce qui est en place @@ -16,19 +17,20 @@ X-Frame-Options: DENY Referrer-Policy: strict-origin-when-cross-origin ``` -Le snippet est inclus au niveau `server` **et** dans chaque `location` (fichiers -`assets`, `/`, `/healthz`) : les réponses d'erreur et de santé portent les mêmes -en-têtes que la page. +Le snippet est inclus au niveau `server` **et** dans chaque `location` (assets +Next, image OG, `/`, `/healthz`) : les réponses d'erreur et de santé portent les +mêmes en-têtes que la page. ### Aucune donnée sensible -- Aucun appel réseau côté client (vérifié : pas de `fetch`, `XMLHttpRequest`, - `axios`, `WebSocket`). -- Aucune clé, aucun `import.meta.env` dans `frontend/`. +- Un seul appel réseau côté client : `POST /api/crm/leads` (formulaire de + contact), vers le CRM. +- Aucune clé : seule `NEXT_PUBLIC_CRM_API_URL` est lue au build, et elle est + publique par construction. - `.env` exclu de git (`.gitignore`) et des images (`.dockerignore`). -- Seul stockage navigateur : `localStorage["cohaise-theme"]`. -- Aucun cookie : le design system ne pose pas de cookie, `backend/shared` n'est - pas déployé. +- Stockage navigateur limité à `cohaise-theme` et `cohaise-lang`. +- Aucun cookie posé par la vitrine ; les sessions appartiennent au CRM, sur son + propre domaine. ### Ressources @@ -44,7 +46,7 @@ donc aucun en-tête `Referrer-Policy` à négocier avec un CDN et aucun | HSTS | absent | le `.dev` est HSTS-preloadé par le navigateur, donc le trafic est déjà forcé en HTTPS : l'absence d'en-tête ici ne change rien côté navigateur, mais un autre domaine servirait en clair | | `Permissions-Policy` | absent | caméra/micro/geolocalisation jamais sollicités | | Bind `127.0.0.1` | non | le port `8080` est publié sur toutes les interfaces ; seul le tunnel définit l'accès réel. Pour un hébergement partagé, restreindre à `127.0.0.1:${COHAISE_HTTP_PORT}:80` dans `docker-compose.yml` | -| Rate limiting | non pertinent | aucun endpoint dynamique | +| Rate limiting | côté CRM | l'endpoint public `POST /api/crm/leads` porte honeypot + 5 envois/IP/15 min ; la vitrine n'a aucun endpoint | | TLS | hors du dépôt | nginx n'écoute que le `80`, le terminus HTTPS est le tunnel | ## Chaîne de confiance @@ -60,7 +62,8 @@ tunnel cloudflared → nginx:8080 → /usr/share/nginx/html/current → rele ## À ne pas faire -- Ne pas brancher de clé ou de token dans le front : ce dépôt n'a pas de back. +- Ne pas brancher de clé ou de token dans le front : la vitrine est publique, + tout ce qui est dans le bundle est lisible. Les secrets restent dans le CRM. - Ne pas ajouter de ressource externe (font CDN, script analytics) sans réviser - les en-têtes et `index.html`. + les en-têtes et `frontend/web/app/layout.tsx`. - Ne pas publier `.env` : il contient des clés héritées d'autres apps. diff --git a/docs/standards.md b/docs/standards.md index d208149..1604704 100644 --- a/docs/standards.md +++ b/docs/standards.md @@ -13,8 +13,10 @@ Conventions à respecter pour que ce dépôt reste cohérent avec les deux autre | Indentation | 2 espaces (pas de tabs) | | `trim_trailing_whitespace` | `false` pour `*.md`, vrai ailleurs | -Aucun Prettier/ESLint n'est installé : l'éditeur et l'`.editorconfig` sont la -seule norme mécanique. +Aucun Prettier n'est installé : l'éditeur et l'`.editorconfig` sont la seule +norme mécanique. ESLint a été retiré de `frontend/web` : `typescript-eslint` +ne supporte pas encore TypeScript 7.0. Ne pas le réintroduire tant que ce +support n'existe pas. ## Palette @@ -62,19 +64,89 @@ Chargées en local (`frontend/shared/fonts/*.woff2`), jamais par CDN : ## Thème - Bascule clair/sombre par la classe `.dark` sur ``. -- Script inline dans `index.html` (avant le bundle) : lit +- Script inline dans `frontend/web/app/layout.tsx` (avant le bundle) : lit `localStorage["cohaise-theme"]`, sinon `prefers-color-scheme`. C'est lui qui évite le flash de thème. - `color-scheme: light dark` déclaré pour les contrôles natifs. - Toute règle sombre va dans le bloc `.dark` de `tokens.css`, pas en `@media (prefers-color-scheme: dark)` : la préférence utilisateur prime. +## Next.js (vitrine) + +- Tout fichier qui utilise un hook, un événement ou une API navigateur porte + `"use client"` ; les pages et le layout restent des Server Components. +- Les métadonnées SEO vont dans `export const metadata` (page ou layout), pas + dans un composant client. Une page = une entrée dans `app/lib/site.ts` pour + rester alignée avec le sitemap. +- Les données statiques vivent dans `app/data/`. Un objet contenant des + fonctions ou des icônes React ne doit jamais traverser la frontière + serveur → client : le composant importe la donnée lui-même. +- Une section = une région plein écran : `
` pose `data-region` et + `min-h-dvh`. Ne pas créer de section hors de ce composant, sinon elle + échappe au scroll-snap. +- Les reveals passent par `data-reveal` / `data-reveal-delay` et + `useScrollReveal` (délai par région via `data-region-delay`) ; ne pas + animer un élément sans prévoir son état sans JS. +- `next build` produit `out/` (`output: "export"`). Ne pas ajouter de route + dynamique sans vérifier la compatibilité avec l'export statique. +- Le menu de l'en-tête est une barre d'onglets, pas une liste d'ancres : aucun + `#` n'est écrit dans l'URL. Sur l'accueil, clic → séquence GSAP région par + région et pastille qui glisse vers l'onglet ; ailleurs, la cible passe par + `setPendingSection`/`sessionStorage` puis est rejointe après le retour à `/`. + `scrollToSection` suspend le snap (`data-scroll-anim`) le temps de la + séquence, sinon le navigateur saute directement à la destination ; la durée + renvoyée prolonge le verrou d'onglet. L'onglet actif suit la région visible + (bande centrale) sauf pendant le défilement déclenché par un clic, où il + reste sur l'entrée choisie. Une cible imbriquée (About dans la région Stack) + est ramenée à sa région par `scrollToSection`, car le snap opère par région. +- Les pages SEO autonomes (`/services`, `/about`, …) réutilisent une seule + région sans pied de page et tiennent dans le viewport (règle + `section[data-region]:only-child` dans `globals.css`). Ne pas les laisser + défiler : le menu est justement là pour ramener aux régions de l'accueil. + +## Front CRM + +- La page ne défile **jamais** : le shell est en `h-dvh overflow-hidden`, et les + zones de contenu (`DataTable`, dialogue) portent `min-h-0` + `overflow-auto`. + Ne pas retirer `min-h-0` d'un parent flex, sinon le tableau repousse la page. +- Toute liste passe par `components/DataTable.tsx` : colonnes triables, + recherche, actions de ligne, squelette et cartes sous `md`. Ne pas recréer un + `
` dans une page. +- Les formulaires de création/édition passent par `RecordDialog` ; seul son + corps défile. Les boutons d'action de ligne utilisent `RowActionButton`. +- Les pictogrammes viennent des WebP du dépôt, rendus par `MaskIcon` dans + `components/icons.tsx` : `FolderMaskIcon`/`UsersMaskIcon`/`ActivityMaskIcon` + pour le rail, `PenMaskIcon`, `TrashMaskIcon`, `SearchMaskIcon`, + `CloseMaskIcon`, `LogoutMaskIcon` pour les actions. Le masque CSS + + `background-color: currentColor` permet au survol de les teinter en accent ou + en destructif sans filtre. Ne pas revenir à un `` : les fichiers sont + blancs et disparaîtraient sur fond clair. `components/glyphs.tsx` ne garde que + les flèches (`ChevronDownGlyph`, `ArrowUpGlyph`). +- L'en-tête du CRM porte `.glass` (défini dans `theme.css`, commun à la vitrine + et au CRM) ; la surface de travail reste sans flou et `DataTable` porte son + propre fond translucide (`bg-surface/80 backdrop-blur-xl`), avec un en-tête + sticky à `/90` pour garder le texte lisible quand les lignes passent dessous. +- Les champs (`Input` partagé, selects, recherche) réagissent au survol par un + bord accent ; le bouton de déconnexion est une icône seule + (`LogoutMaskIcon`) avec `aria-label` et `title`, jamais un libellé visible. + +## Backend CRM + +- Une route valide l'entrée (Zod), appelle un service, renvoie le statut HTTP. + Aucune requête SQL directement dans `routes/`. +- Un service reçoit `db` et des données déjà typées ; il lève `AppError` pour + les cas métier (404, 409, 422) et laisse remonter le reste. +- Les noms de colonnes SQL restent dans les services et `models/types.ts` ; + l'API expose ses propres champs. +- Les erreurs de contrainte MariaDB passent par `utils/dbErrors.ts` (1062, + 1451, 1452), jamais par une comparaison de message. + ## Git - Branche `main` unique, remote `origin` sur `git.cohaise.dev`. - Pas de convention de message imposée par l'historique (dépôt neuf). - N'exclure de git que : `.env*` (sauf `.env.example`), `node_modules/`, - `dist/`, `*.log`, `backups/`. + `dist/`, `.next/`, `out/`, `*.log`, `backups/`. - `docs/` est **versionné** (la ligne `docs/` de `.gitignore` a été retirée). ## Interdépôts diff --git a/docs/workflow.md b/docs/workflow.md index 526ec6a..563e569 100644 --- a/docs/workflow.md +++ b/docs/workflow.md @@ -3,11 +3,12 @@ ## Boucle de développement ```sh -make dev # Vite sur http://localhost:5173, hot reload +make dev # Next.js sur http://localhost:3000, hot reload ``` -Le serveur de dev sert `frontend/web` avec `server.host: true`, port `5173` -(`vite.config.ts`). Il n'a pas besoin de Docker ni de `.env`. +Le serveur de dev sert `frontend/web` avec Next.js. Il n'a pas besoin de Docker +ni de `.env`. Pour tester le formulaire de contact, l'API CRM doit tourner sur +`http://localhost:8082` (ou définir `NEXT_PUBLIC_CRM_API_URL`). ## Vérification avant de valider @@ -53,26 +54,32 @@ dépôts CoHaiSe.** Il n'y a pas de version centrale. | --- | --- | | Couleur, rayon, police, ombre | `frontend/shared/src/styles/tokens.css` | | Composant partagé | `frontend/shared/src/components/*.tsx` | -| Page, layout, contenu | `frontend/web/src/**` | -| Routage (onglets) | `frontend/web/src/App.tsx` | -| Cache, en-têtes, fallback SPA | `docker/nginx/web.conf` + `docker/nginx/snippets/` | +| Page, layout, contenu | `frontend/web/app/**` | +| Routes et métadonnées SEO | `frontend/web/app/*/page.tsx`, `frontend/web/app/lib/site.ts` | +| Sitemap / robots / image OG | `frontend/web/app/sitemap.ts`, `robots.ts`, `opengraph-image.tsx` | +| Animations d'entrée | `frontend/web/app/hooks/useScrollReveal.ts` + `globals.css` | +| Cache, en-têtes, 404 | `docker/nginx/web.conf` + `docker/nginx/snippets/` | | Port public | `COHAISE_HTTP_PORT` dans `.env` | -| Thème par défaut | script inline de `frontend/web/index.html` | +| Thème par défaut | script inline de `frontend/web/app/layout.tsx` | ## Git - Branche `main`, remote `origin https://git.cohaise.dev/Esiah/CoHaiSe.git`. - Historique vierge (un commit initial) : aucune convention de message héritée. - Pas de hooks, pas de CI (`.github/`, `.gitlab-ci.yml` absents). -- Ne jamais committer `.env`, `node_modules/`, `dist/` (exclus par `.gitignore`). +- Ne jamais committer `.env`, `node_modules/`, `dist/`, `out/`, `.next/` + (exclus par `.gitignore`). ## Pièges connus 1. **`.dev` en HSTS-preload** : `/etc/hosts` ne fera jamais fonctionner `cohaise.dev` en local. Tester sur `localhost`. -2. **`backend/shared` est construit mais jamais utilisé** : une erreur de types - venant de là n'affecte pas le site, mais bloque `npm run typecheck`. +2. **`backend/shared` est construit avec le reste** : il est consommé par + `backend/crm`, mais une erreur de types ici bloque aussi `npm run typecheck`. 3. **`docker/README.md` historique** : ne sert que les images ; le fonctionnement réel est dans `docs/deployment.md`. -4. **Aucun code splitting** : tout le site tient dans un seul bundle, ce qui est - volontaire pour une vitrine. +4. **Export statique** : `next build` écrit dans `out/`, pas `dist/`. Ne pas + ajouter de route dynamique sans vérifier la compatibilité avec + `output: "export"`. +5. **Pas d'ESLint** : `typescript-eslint` ne supporte pas TypeScript 7.0. Seuls + `typecheck` et `build` vérifient le code. diff --git a/frontend/crm/public/favicon.webp b/frontend/crm/public/favicon.webp index d99b850..4f1c5bb 100644 Binary files a/frontend/crm/public/favicon.webp and b/frontend/crm/public/favicon.webp differ diff --git a/frontend/crm/src/App.tsx b/frontend/crm/src/App.tsx index 10e7876..9345a9e 100644 --- a/frontend/crm/src/App.tsx +++ b/frontend/crm/src/App.tsx @@ -1,6 +1,7 @@ import { useCallback, useEffect, useState } from "react"; import { Spinner } from "@cohaise/ui"; import { ApiError, api, type User } from "./lib/api.js"; +import { FaultyTerminalBackdrop } from "./components/FaultyTerminalBackdrop.js"; import { Login } from "./pages/Login.js"; import { ChangePassword } from "./pages/ChangePassword.js"; import { Crm } from "./pages/Crm.js"; @@ -35,8 +36,11 @@ export const App = () => { if (session.state === "loading") { return ( -
- +
+ +
+ +
); } diff --git a/frontend/crm/src/components/DataTable.tsx b/frontend/crm/src/components/DataTable.tsx new file mode 100644 index 0000000..c8701ad --- /dev/null +++ b/frontend/crm/src/components/DataTable.tsx @@ -0,0 +1,346 @@ +import { useMemo, useState, type ReactNode } from "react"; +import { cn, Skeleton, Spinner } from "@cohaise/ui"; +import { SearchMaskIcon } from "./icons.js"; + +export interface DataTableColumn { + /** Identifiant stable de la colonne, utilisé pour le tri. */ + id: string; + header: string; + cell: (row: T) => ReactNode; + sortable?: boolean; + /** Valeur brute comparée lors du tri. Obligatoire si `sortable`. */ + sortValue?: (row: T) => string | number | null | undefined; + className?: string; + headerClassName?: string; + /** Masque la colonne sur les cartes mobiles (utile pour un champ secondaire). */ + mobileHidden?: boolean; +} + +type SortDirection = "asc" | "desc"; + +interface SortState { + column: string; + direction: SortDirection; +} + +export interface DataTableProps { + data: T[]; + columns: DataTableColumn[]; + keyExtractor: (row: T) => string | number; + loading?: boolean; + error?: string | null; + emptyMessage?: string; + emptyHint?: string; + search?: { + value: string; + onChange: (value: string) => void; + placeholder?: string; + }; + /** Contenu libre à gauche de la barre d'outils, quand il n'y a pas de recherche. */ + toolbarStart?: ReactNode; + /** Bouton(s) à droite de la barre d'outils, par exemple « Nouveau ». */ + actions?: ReactNode; + rowActions?: (row: T) => ReactNode; + footer?: ReactNode; + initialSort?: SortState; +} + +/** + * Tableau de données du CRM. + * + * La page ne défile jamais : ce composant occupe la hauteur restante + * (`min-h-0 flex-1`) et seul le bloc tableau (`overflow-auto`) défile. L'en-tête + * reste collé en haut, les actions sont alignées à droite et chaque ligne + * devient une carte sous `md`. + */ +export function DataTable({ + data, + columns, + keyExtractor, + loading = false, + error = null, + emptyMessage = "Aucun résultat", + emptyHint, + search, + toolbarStart, + actions, + rowActions, + footer, + initialSort, +}: DataTableProps) { + const [sort, setSort] = useState(initialSort ?? null); + + const sorted = useMemo(() => { + if (!sort) return data; + const column = columns.find((item) => item.id === sort.column); + const read = column?.sortValue; + if (!read) return data; + + const direction = sort.direction === "asc" ? 1 : -1; + return [...data].sort((left, right) => { + const a = read(left); + const b = read(right); + const aEmpty = a === null || a === undefined || a === ""; + const bEmpty = b === null || b === undefined || b === ""; + // Les valeurs absentes restent en fin de liste, quel que soit le sens. + if (aEmpty && bEmpty) return 0; + if (aEmpty) return 1; + if (bEmpty) return -1; + if (typeof a === "number" && typeof b === "number") return (a - b) * direction; + return ( + String(a).localeCompare(String(b), "fr", { sensitivity: "base", numeric: true }) * + direction + ); + }); + }, [columns, data, sort]); + + const toggleSort = (column: DataTableColumn) => { + if (!column.sortable || !column.sortValue) return; + setSort((current) => + current?.column === column.id + ? { column: column.id, direction: current.direction === "asc" ? "desc" : "asc" } + : { column: column.id, direction: "asc" }, + ); + }; + + const showSkeleton = loading && data.length === 0; + const hasActions = Boolean(rowActions); + const columnCount = columns.length + (hasActions ? 1 : 0); + const showToolbar = Boolean(search || toolbarStart || actions); + + return ( +
+ {showToolbar ? ( +
+
+ {search ? ( +
+ + search.onChange(event.target.value)} + placeholder={search.placeholder ?? "Rechercher…"} + className="h-9 w-full rounded-sm border border-border-control bg-surface pl-9 pr-3 text-sm text-foreground placeholder:text-subtle-foreground transition-[background-color,border-color,box-shadow] duration-fast ease-out-soft hover:border-accent/60 hover:bg-surface-raised focus-visible:border-border-strong focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background" + /> +
+ ) : null} + {toolbarStart} +
+ {actions ?
{actions}
: null} +
+ ) : null} + + {error ? ( +

+ {error} +

+ ) : null} + +
+ {/* Tableau : au-delà de md. Le conteneur porte seul le défilement. */} +
+
+ + + {columns.map((column) => { + const active = sort?.column === column.id; + return ( + + ); + })} + {hasActions ? ( + + ) : null} + + + + {showSkeleton ? ( + Array.from({ length: 7 }).map((_, rowIndex) => ( + + {Array.from({ length: columnCount }).map((__, cellIndex) => ( + + ))} + + )) + ) : sorted.length === 0 ? ( + + + + ) : ( + sorted.map((row) => { + const key = keyExtractor(row); + return ( + + {columns.map((column) => ( + + ))} + {hasActions ? ( + + ) : null} + + ); + }) + )} + +
+ {column.sortable && column.sortValue ? ( + + ) : ( + column.header + )} + + Actions +
+ +
+
+

+ {emptyMessage} +

+ {emptyHint ? ( +

{emptyHint}

+ ) : null} +
+
+ {column.cell(row)} + + {rowActions?.(row)} +
+
+ + {/* Cartes : en dessous de md. Même zone de défilement, aucun scroll de page. */} +
+ {showSkeleton ? ( + Array.from({ length: 4 }).map((_, index) => ( +
+ + + + +
+ )) + ) : sorted.length === 0 ? ( +
+

+ {emptyMessage} +

+ {emptyHint ? ( +

{emptyHint}

+ ) : null} +
+ ) : ( + sorted.map((row) => { + const key = keyExtractor(row); + return ( +
+
+ {columns + .filter((column) => !column.mobileHidden) + .map((column) => ( +
+
+ {column.header} +
+
{column.cell(row)}
+
+ ))} +
+ {hasActions ? ( +
+ {rowActions?.(row)} +
+ ) : null} +
+ ); + }) + )} +
+ + {footer ? ( +
+ {footer} + {loading && !showSkeleton ? : null} +
+ ) : null} + + + ); +} + +const SortGlyph = ({ direction }: { direction: SortDirection | null }) => ( + +); diff --git a/frontend/crm/src/components/RecordDialog.tsx b/frontend/crm/src/components/RecordDialog.tsx new file mode 100644 index 0000000..656f41f --- /dev/null +++ b/frontend/crm/src/components/RecordDialog.tsx @@ -0,0 +1,63 @@ +import { useEffect, type ReactNode } from "react"; +import { CloseMaskIcon } from "./icons.js"; + +interface RecordDialogProps { + open: boolean; + title: string; + onClose: () => void; + children: ReactNode; +} + +/** + * Panneau de saisie par-dessus la liste. + * + * Le CRM ne défile jamais au niveau de la page : sur grand écran le panneau est + * borné à la hauteur du viewport, et seule sa zone de formulaire défile. Sur + * téléphone il occupe l'écran entier, toujours sans faire grandir la page. + */ +export const RecordDialog = ({ open, title, onClose, children }: RecordDialogProps) => { + useEffect(() => { + if (!open) return; + const onKeyDown = (event: KeyboardEvent) => { + if (event.key === "Escape") onClose(); + }; + window.addEventListener("keydown", onKeyDown); + return () => window.removeEventListener("keydown", onKeyDown); + }, [open, onClose]); + + if (!open) return null; + + return ( +
{ + if (event.target === event.currentTarget) onClose(); + }} + className="fixed inset-0 z-40 flex items-center justify-center bg-black/60 backdrop-blur-sm sm:p-6" + > +
+
+

+ {title} +

+ +
+ +
{children}
+
+
+ ); +}; diff --git a/frontend/crm/src/components/RowActionButton.tsx b/frontend/crm/src/components/RowActionButton.tsx new file mode 100644 index 0000000..7db7e43 --- /dev/null +++ b/frontend/crm/src/components/RowActionButton.tsx @@ -0,0 +1,35 @@ +import type { ReactNode } from "react"; + +interface RowActionButtonProps { + label: string; + onClick: () => void; + tone?: "neutral" | "destructive"; + children: ReactNode; +} + +/** + * Bouton d'action compact d'une ligne de tableau. + * + * Les icônes au trait héritent de `currentColor` : le survol teinte donc le + * pictogramme en accent (modifier) ou en destructif (supprimer). + */ +export const RowActionButton = ({ + label, + onClick, + tone = "neutral", + children, +}: RowActionButtonProps) => ( + +); diff --git a/frontend/crm/src/components/glyphs.tsx b/frontend/crm/src/components/glyphs.tsx new file mode 100644 index 0000000..3456f42 --- /dev/null +++ b/frontend/crm/src/components/glyphs.tsx @@ -0,0 +1,39 @@ +import type { SVGProps } from "react"; +import { cn } from "@cohaise/ui"; + +/** + * Petites icônes au trait, dessinées avec `currentColor`. + * + * Les pictogrammes d'action (recherche, modifier, supprimer, fermer, + * déconnexion) viennent des WebP du dépôt et passent par `MaskIcon` dans + * `icons.tsx`. On ne garde ici que les flèches, qui n'ont pas d'équivalent. + */ +type GlyphProps = SVGProps; + +const Glyph = ({ className, children, ...props }: GlyphProps) => ( + +); + +export const ChevronDownGlyph = (props: GlyphProps) => ( + + + +); + +export const ArrowUpGlyph = (props: GlyphProps) => ( + + + +); diff --git a/frontend/crm/src/components/icons.tsx b/frontend/crm/src/components/icons.tsx index d1f4d26..9d42262 100644 --- a/frontend/crm/src/components/icons.tsx +++ b/frontend/crm/src/components/icons.tsx @@ -1,4 +1,4 @@ -import type { ImgHTMLAttributes } from "react"; +import type { HTMLAttributes, ImgHTMLAttributes } from "react"; type IconProps = Omit, "src" | "alt"> & { filled?: boolean; @@ -18,6 +18,39 @@ const ImgIcon = ({ /> ); +type MaskIconProps = Omit, "children">; + +/** + * Icône WebP du dépôt teintée par `currentColor`. + * + * Les fichiers sont blancs avec un canal alpha : un `` serait invisible + * sur fond clair. Le masque CSS garde la forme et laisse le bouton décider de + * la couleur (accent au survol, destructif pour la poubelle). + */ +const MaskIcon = ({ + src, + className = "", + style, + ...props +}: MaskIconProps & { src: string }) => ( +