Nicolas
cd8ce42df7
Socle backend, entièrement testable en CI, pour le tutoriel guidé. Le moteur front (driver.js), l'instrumentation `data-tour-*` et le CRUD admin viendront ensuite. Schéma (`schema.prisma` + migration `20260906120000_tour_scenarios`) — les 4 modèles de #44, qui révisent le registre statique prévu par #42 : - `TourTarget` (`key` PK + `description`) : catalogue des cibles de surlignage valides, seedé, comme `TechStep`/`Unit`. - `TourScenario` (`key` stable, `name`, `enabled`) : un scénario rejouable. - `TourScenarioStep` (`order`, `route?`, `targetKey`, `title`, `content`) : `title`/`content` sont du **texte libre**, pas des clés i18n (#44 : contenu administrable → texte, comme le nom d'une recette). - `TourProgress` (`userProfileId` + `scenarioId`, PK composite) : présence d'une ligne = scénario vu (terminé *ou* passé). Seed (`reference-seed-data.ts`) : les 9 `TourTarget` correspondant aux `data-tour-*` à poser côté front, + les 2 scénarios de #42 (`general`, `techStepMetadata`) **créés seulement s'ils sont absents** (un admin en devient propriétaire ensuite). `techStepMetadata` reste court pour l'instant — #36 (popover qui se ferme en pleine sélection) est ouvert, v1 ne couvre que les gestes qui marchent déjà. API : - `GET /reference/tours` (public) → scénarios **activés** + étapes ordonnées, forme consommée directement par le futur `useTour()`. - `GET /profile/tours` → `{ completedTourKeys: string[] }`. - `POST /profile/tours/:tourKey/complete` → upsert idempotent ; corps vide = terminé, `{ skipped: true }` = passé. Émet `analytics.recordEvent` `tour.completed` / `tour.skipped` (le dashboard admin agrège déjà tout type d'`AnalyticsEvent` génériquement — analytics de #44 quasi gratuites). 404 `TOUR_NOT_FOUND` (nouveau code 4053) sur une clé inconnue/désactivée. `reset-db.ts` truncate les 4 nouvelles tables (reseedées juste après). Tests Mocha : `GET /reference/tours` (scénarios + étapes ordonnées, exclusion d'un scénario désactivé) ; `/profile/tours` GET+POST (upsert idempotent, `skipped`, 404 clé inconnue, 404 tour désactivé, isolation par profil). Pas de base Postgres locale → exécutés en CI. Refs #42, #44 Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
34 lines
1.4 KiB
TypeScript
34 lines
1.4 KiB
TypeScript
// Public entry point of the code shared between apps/api and apps/web.
|
|
// Anything exported here is part of the cross-app contract — keep it
|
|
// intentional (types, validation schemas, error codes), not an implementation
|
|
// detail specific to one side.
|
|
|
|
export * from "./data/catalog-labels-en.js";
|
|
export * from "./data/catalog-labels-fr.js";
|
|
export * from "./errors/error-codes.js";
|
|
export * from "./logic/planning-portions.js";
|
|
export * from "./schemas/account.js";
|
|
export * from "./schemas/admin.js";
|
|
export * from "./schemas/auth.js";
|
|
export * from "./schemas/cooking-session.js";
|
|
export * from "./schemas/household.js";
|
|
export * from "./schemas/planning.js";
|
|
export * from "./schemas/preferences.js";
|
|
export * from "./schemas/profile.js";
|
|
export * from "./schemas/recipe.js";
|
|
export * from "./schemas/shopping-list.js";
|
|
export * from "./schemas/sources.js";
|
|
export * from "./schemas/tech-step-worker.js";
|
|
export * from "./tools/assert-is-never.js";
|
|
export * from "./types/admin.js";
|
|
export * from "./types/cooking-session.js";
|
|
export * from "./types/household.js";
|
|
export * from "./types/planning.js";
|
|
export * from "./types/preferences.js";
|
|
export * from "./types/recipe.js";
|
|
export * from "./types/reference.js";
|
|
export * from "./types/shopping-list.js";
|
|
export * from "./types/sources.js";
|
|
export * from "./types/tech-step-worker.js";
|
|
export * from "./types/tour.js";
|
|
export * from "./types/user-profile.js";
|