Modèles app et remixes
Disponibilité
Le workflow manifeste modèle et enregistrement app est implémenté. Il peut lister manifestes curatés opérateur, créer nouvel enregistrement app depuis l’un, amorcer valeurs environnement non secrètes lorsque magasin environnement configuré, et créer enregistrement remix propre depuis app éligible.
L’instanciation ne déploie pas l’app. Bases, buckets et services auth déclarés ne sont pas provisionnés automatiquement. Certains services déclarés sont eux-mêmes stub-only ; une déclaration manifeste n’est pas preuve qu’une dépendance existe.
Parcourir manifestes
GET /api/apps/templates?category=web&q=next
GET /api/apps/templates/{template_id}La galerie est lecture publique. Un manifeste décrit URL Git source, branche, défauts runtime, schéma variables environnement et services déclarés. Relisez dépôt, révision courante, licence, état maintenance et commandes runtime avant instanciation. Un manifeste est métadonnée opérateur, pas aval sécurité.
Deux manifestes seed intégrés rendent l’API non vide. Leurs dépôts externes peuvent changer ou disparaître, et il n’y a pas encore test fumée automatisé pour chaque seed.
Instancier
POST /api/apps/templates/{template_id}/instantiate
Content-Type: application/json
{
"name": "My app",
"env": {
"NEXT_PUBLIC_APP_NAME": "My app"
}
}L’appel crée enregistrement app privé et renvoie app_id, informations source, type runtime et services déclarés. Seules clés déclarées par manifeste sont acceptées. Champs secret ne sont pas amorcés par cet appel.
Après instanciation :
- inspectez source et paramètres runtime nouvelle app ;
- fournissez secrets via Variables d’environnement app ;
- fournissez dépendances externes réelles vous-même sauf si service est explicitement signalé prêt ;
- appelez endpoint déploiement ; et
- suivez déploiement via build, health check et activation.
Remix
POST /api/apps/{source_app_id}/remix
Content-Type: application/json
{
"name": "My private remix"
}Propriétaires peuvent remixer leur propre app. Un autre utilisateur peut remixer seulement app publique et marquée remixable. Nouvelle app est privée.
Le remix porte URL source, branche, type déploiement, port et lignée. Il ne copie pas valeurs environnement, secrets, références base ou bucket, liaisons auth, checkpoints, état IDE ni données. Il ne fork ni n’épingle dépôt Git distant. Si propriétaire source change ou retire dépôt plus tard, nouveau déploiement peut différer ou échouer.
Pour remix durable, forkez source dans dépôt que vous contrôlez, relisez et épinglez révision, mettez à jour source nouvelle app, puis déployez.
Liste publication pour un modèle
Avant de présenter modèle comme utilisable :
- confirmez dépôt et licence ;
- épinglez ou enregistrez révision testée ;
- validez install, build, run, port et comportement health ;
- testez champs environnement requis sans exposer secrets ;
- vérifiez que chaque service déclaré est réellement disponible ; et
- instanciez, déployez, test fumée et retirez dans environnement propre.