Modèles

Les modèles sont des packages de démarrage clonables. Chacun est une véritable application structurée que vous pouvez installer depuis le marketplace en un clic, ou cloner avec la CLI pour obtenir une base de code TypeScript à étendre.

Les modèles existent pour deux raisons :

1. Montrer plutôt que décrire — une application multi-objets fonctionnelle se lit plus vite que la documentation.
2. Donner aux équipes d'ingénierie un point de départ — lorsque vous voulez du code sous contrôle de version, et pas seulement des métadonnées générées par l'IA dans votre base de données.

Ce que contient le catalogue par défaut

Source : github.com/objectstack-ai/templates. Apache-2.0. Clonez sans demander.

Installer en 30 secondes (sans code)

Dans Console :

1. Ouvrez Marketplace → recherchez le modèle.
2. Cliquez sur Install.
3. Actualisez — la nouvelle application apparaît dans votre navigation.

C'est fait. Enregistrements, vues, flows, permissions — tout est en ligne.

Cloner comme base de code (pour les ingénieurs)

pnpm dlx @objectstack/cli create my-app --template todo
cd my-app
pnpm install
pnpm dev          # http://localhost:4002

Le clone est un package pnpm autonome — des fichiers *.object.ts, *.view.ts, *.flow.ts que vous pouvez éditer, analyser, tester, committer. Lorsque vous êtes satisfait :

pnpm build
os package publish   # → votre marketplace

Les clients qui installent votre fork obtiennent votre marque et vos modifications.

Charte du modèle (le contrat social)

Chaque modèle est livré avec un fichier CHARTER.md qui déclare sa portée et ses limites strictes — généralement : ≤ 6 objets métier, ≤ 2 500 lignes de code sous src/, une application, une locale par défaut. La charte existe pour que les modèles restent des modèles, et non des produits à moitié finis. Si un fork dépasse ces limites, publiez-le comme un nouveau modèle, ne surchargez pas un modèle existant.

Consultez le TEMPLATE_GUIDE.md en amont pour le protocole des suffixes de fichiers (*.object.ts, *.state.ts, *.hook.ts, …), la séquence d'écriture (objects → state → hooks → views → flows → …), et les services de plateforme polymorphes (sys_comment, sys_attachment, sys_audit_log) que vous devriez réutiliser plutôt que de réinventer.

Choisir un point de départ

AI Builder + modèles ensemble

Vous pouvez cloner un modèle et continuer à utiliser l'AI Builder par-dessus. Installez helpdesk, puis dites :

« Ajoute un champ entier csat_score à hd_ticket, plage 1–5, demande-le à la clôture. »

L'IA étend le package installé sur place. Renvoyez la modification vers le dépôt source avec os package export.

Pour aller plus loin

• AI Builder — étendez n'importe quel modèle par chat
• Packages — ce qu'est réellement un modèle
• Marketplace — distribuez votre fork
• Quickstart — le parcours développeur complet de bout en bout