Spécification

Comment ça marche, en langage simpleCopier le lien

Une application Next.js 16 s'exécute sur Google Cloud Run à https://wovain.com. Elle sert le site web, une API et un serveur MCP auquel ChatGPT se connecte. Le site web et ChatGPT appellent les mêmes procédures d'API : ils font donc toujours la même chose. Une base PostgreSQL sur Cloud SQL mémorise les utilisateurs, connexions, exécutions, idées, designs, produits et campagnes.

Quand le vendeur demande des idées, l'API demande à Qloo quels thèmes aiment les fans de la graine et demande à Tavily ce qui est dans l'actualité et sur les places de marché dans ces thèmes. Nemotron, hébergé sur Nebius Token Factory, rédige le brief de design et la fiche produit ; fal dessine l'illustration ; Nemotron l'évalue et le code revérifie la taille d'impression. À l'approbation, l'API crée un produit Fourthwall puis, plus tard, une campagne Meta, toujours en pause. La documentation vit séparément sur https://docs.wovain.com.

Pourquoi pas quelque chose de plus élaboré : une application et un seul jeu de procédures gardent la preuve de concept petite et les deux surfaces identiques.

Le parcours principal à travers le systèmeCopier le lien

Réf. PRD : prd.md > The Core Journey.

1. Le vendeur se connecte → Better Auth (/api/auth) crée une session dans PostgreSQL. ChatGPT se connecte plutôt via le serveur OAuth de Better Auth et appelle POST /api/mcp avec un jeton d'accès.
2. Le vendeur saisit une graine → la page ou l'outil MCP research_trends appelle ideas.research → researchIdeas dans packages/api/src/flow/ideas.ts utilise Qloo et Tavily depuis packages/core → les idées classées sont enregistrées.
3. Le vendeur choisit une idée → designs.generate (generateDesign) → brief Nemotron (draftBrief), illustration fal (createArtist), prix (priceFor), juge Nemotron (judgeDesign) → le design est enregistré en pending_approval.
4. Le vendeur approuve → designs.approve (decideDesign).
5. products.create (createDesignProduct) appelle Fourthwall via la connexion scellée du vendeur ; products.publish le rend public.
6. campaigns.create (createProductCampaign) → texte publicitaire Nemotron (writeAdCopy) → stagePausedCampaign crée la campagne, l'ensemble de publicités et les publicités en pause sur Meta.
7. runs.start (startRun) enchaîne ces étapes ; avec autopilot: true, Nemotron choisit l'idée (pickIdea) et relit le design (reviewDesign).

Pile techniqueCopier le lien

Où cela s'exécute et comment l'essayerCopier le lien

• Production : Cloud Run sur https://wovain.com ; docs sur https://docs.wovain.com.
• ChatGPT : ajoutez un connecteur avec l'URL https://mcp.wovain.com/api/mcp. La découverte OAuth est servie sur /.well-known/oauth-protected-resource et /.well-known/oauth-authorization-server ; le vendeur se connecte et accorde l'accès sur la page de consentement.
• En local : Node.js (voir .nvmrc), pnpm et Docker pour PostgreSQL.

pnpm install
docker compose up -d
pnpm run dev

Les clés vont dans les valeurs de apps/web/.env.schema : BETTER_AUTH_SECRET, BETTER_AUTH_URL, DATABASE_URL, TOKEN_ENCRYPTION_KEY, NEBIUS_API_KEY, QLOO_API_KEY, TAVILY_API_KEY, FAL_KEY, META_APP_ID, META_APP_SECRET. Ne commitez jamais de vraies valeurs.

La soumission exige une courte vidéo de démo et le dépôt public ; le déploiement s'y ajoute. URL de la vidéo : à ajouter. URL du dépôt : à ajouter.

Style et ambianceCopier le lien

Chaleureux, simple, chiffres d'abord ; voix de coach. Thèmes clair et sombre issus des tokens shadcn ; une action principale par carte. Fonctionne en largeur de téléphone.

ComposantsCopier le lien

Application web (apps/web)Copier le lien

Pages (login, dashboard, consent), /api/rpc, /api/auth, /api/mcp, /api/connections/[provider]/start et callback, et les routes OAuth .well-known. src/services.ts construit db, auth et core. Réf. PRD : prd.md > Screens and Layout.

API (packages/api)Copier le lien

appRouter dans src/routers/index.ts liste ideas, designs, products, campaigns, runs et connections ; la logique de chaque étape est dans src/flow/*. publicProcedure ajoute la journalisation evlog ; protectedProcedure exige une session ou un utilisateur MCP. Réf. PRD : prd.md > Features and Behavior.

Serveur MCP (packages/api/src/mcp.ts)Copier le lien

createMcpServer enregistre list_connections, research_trends, generate_design, approve_design, reject_design, create_product, publish_product, create_campaign, start_run et get_run, chacun appelant le même routeur. Réf. PRD : prd.md > Screens and Layout.

Core (packages/core)Copier le lien

createCore assemble Qloo (qloo.ts), Tavily (trends.ts), Nemotron (nemotron.ts), fal (fal.ts), le prix (pricing.ts), le juge (design.ts), l'autopilot (autopilot.ts), les publicités (ads.ts), Fourthwall (fourthwall.ts), le client OAuth amont (upstream.ts) et le scellement des jetons (sealing.ts). Réf. PRD : prd.md > Features and Behavior.

Authentification (packages/auth)Copier le lien

createAuth construit Better Auth sur la base Drizzle ; mcpResource est l'URL à laquelle les jetons d'accès sont liés. Réf. PRD : prd.md > States and Boundaries.

Base de données (packages/db)Copier le lien

Tables Better Auth dans src/schema/auth.ts ; tables du vendeur dans src/schema/seller.ts. Réf. PRD : prd.md > States and Boundaries.

Flows DuoCopier le lien

Flows d'auto-réparation, d'éclaireur et de développeur autour du dépôt ; définitions dans docs/flows.md. Réf. PRD : prd.md > Features and Behavior (After deploy).

Modèle de donnéesCopier le lien

Les migrations sont générées avec pnpm run db:generate.

Structure des fichiersCopier le lien

wovain/
├── apps/
│   ├── web/              # Next.js 16: pages, /api/rpc, /api/auth, /api/mcp
│   └── fumadocs/         # docs site, content/docs in en, fr, es
├── packages/
│   ├── api/              # oRPC routers, flow steps, MCP server
│   ├── auth/             # Better Auth configuration
│   ├── core/             # providers, pricing, judge, autopilot
│   ├── db/               # Drizzle schema, relations, client, migrations
│   ├── ui/               # shared shadcn/ui components
│   └── config/           # shared tsconfig
├── docs/                 # scope, PRD, spec, app map, flows
├── infra/                # deployment
└── AGENTS.md

Services externes et dépendancesCopier le lien

Modes de défaillance importantsCopier le lien

• Une clé de fournisseur manque → l'étape échoue avec NOT_CONFIGURED nommant la variable ; les autres étapes fonctionnent toujours.
• Le vendeur n'a pas connecté Fourthwall ou Meta → l'outil MCP renvoie l'erreur, la raison, la solution et le lien de connexion.
• Une étape échoue dans une exécution → l'exécution est failed avec son étape et son erreur.

Ce qui a été simplifié et pourquoiCopier le lien

• Une seule application plutôt que des services API et MCP séparés — un seul jeu de procédures garde les surfaces cohérentes.
• Des résultats d'outils en JSON plutôt que des widgets ChatGPT — moins de code ; les widgets pourront venir plus tard.
• Des campagnes en pause plutôt que des lancements en direct — supprime le risque de dépense involontaire.
• T-shirt uniquement — un seul produit suffit à prouver la boucle.
• Pas d'optimiseur — il faut d'abord de vraies données de dépenses.

Décisions et points ouvertsCopier le lien

• Le code garde-fou et Nemotron décide à l'intérieur — choisi pour qu'une erreur du modèle ne puisse pas publier un design non vérifié ni dépenser de l'argent ; le compromis est de corriger parfois une bonne réponse du modèle.
• Qloo avant Tavily — le goût restreint la recherche d'actualité ; le compromis est la dépendance à la couverture de Qloo pour la graine.
• Résolu : ChatGPT se connecte à https://mcp.wovain.com/api/mcp ; le plugin MCP de Better Auth est le serveur OAuth et requireMcpAuth vérifie chaque jeton.
• Ouvert : périmètre de la revue d'application Meta pour la création de campagnes côté serveur.
• Concept peu familier abordé : la différence entre un modèle qui suggère une valeur et un code qui la garantit. Clarifié par la règle selon laquelle les contrôles tranchés par le code (taille d'impression, prix plancher, fourchette de budget) ne sont pas une sortie du modèle, démontrée par les tests de packages/core/src/design.test.ts.