Aller plus loin
Documentation développeur.
La couche avancée. Tout ce que cette documentation résume se trouve ici, écrit pour des développeurs — dans le dépôt, versionné avec le code.
Les documents de référence
Guide
Construire un Project Kreiz (ouvre GitHub dans un nouvel onglet)
Le guide de référence : template, application, schéma et migrations, types de contenu, formulaires, déploiement — sans lire le code du Core.
Architecture
Architecture du Core (ouvre GitHub dans un nouvel onglet)
Les couches (domain, services, ports, adapters, data, http, admin), l'intégration Astro et le modèle Save/Publish/Snapshot/Build.
API
API publique de @kreiz/core (ouvre GitHub dans un nouvel onglet)
La surface réellement supportée, sous-chemin par sous-chemin : contexte d'exécution, symboles, stabilité. La carte exports est la frontière.
Référence
Configuration (ouvre GitHub dans un nouvel onglet)
Chaque section de kreiz({...}) et chaque variable KREIZ_* : obligations, défauts, groupes tout-ou-rien, dev vs production.
Exploitation
Opérer un Project (ouvre GitHub dans un nouvel onglet)
Migrations, sauvegardes attendues, table de recovery, rétentions, cron de maintenance, monitoring.
Reprise
Handoff développeur (ouvre GitHub dans un nouvel onglet)
Commandes, environnement, baseline de performance, état des tests — pour reprendre le dépôt sans reconstituer l'histoire.
Honnêteté
Registre de dette technique (ouvre GitHub dans un nouvel onglet)
Les dettes et limitations V1 assumées, avec leur impact et leur plan.
État
Production readiness (ouvre GitHub dans un nouvel onglet)
Prêt / conditionnel / pas encore : l'état réel du projet pour la production.
Sécurité
Revue de sécurité finale (ouvre GitHub dans un nouvel onglet)
La revue adversariale du Core complet, la revue senior indépendante et les conditions restantes.
Vie privée
Cartographie des données (ouvre GitHub dans un nouvel onglet)
Le contenu de chaque table, pour une revue RGPD sans reverse-engineering du schéma.
Ces fichiers vivent dans docs/ du dépôt. En cas de divergence, le code fait foi — et chaque document s'engage à être corrigé plutôt qu'à décrire un passé idéalisé.
Deux conventions à connaître
- La frontière est mécanique — la carte
exportsdu paquet est la seule surface publique ; un import profond dans le Core casse le typecheck, pas seulement la convention. - Le schéma appartient à l'app — le Core ne possède aucune migration : le Project compose ses tables via
defineCoreTables()et possède sa chaîne Drizzle.
Pour construire un Project de bout en bout, commencez par leguide « Construire un Project Kreiz » (ouvre GitHub dans un nouvel onglet).