Bienvenue sur la Documentation Nekristo

Nekristo est une plateforme conçue pour simplifier et standardiser le cycle de vie complet de vos applications, du développement local jusqu'au déploiement en production.

La Philosophie : Le Manifeste comme Source de Vérité

Au cœur de Nekristo se trouve un principe simple : tout ce qui concerne une application doit être déclaré en un seul endroit. Cet endroit est le fichier nekristo.yml, appelé le manifeste.

Ce fichier agit comme un contrat qui décrit :

• L'architecture de votre application (backend, frontend, services tiers).
• Comment la construire (build steps, variables d'environnement).
• Ses dépendances en infrastructure (bases de données, services de messagerie).
• Comment la déployer (nom de l'image Docker, configuration de production).

L'outil en ligne de commande nekristo-cli utilise ce manifeste comme unique source de vérité pour orchestrer toutes les tâches, garantissant ainsi la cohérence et la reproductibilité à chaque étape. Il gère automatiquement la création des bases de données, la configuration des proxys et la centralisation des logs (via Loki), vous permettant de vous concentrer sur le code.

À qui s'adresse cette documentation ?

Cette documentation est destinée aux développeurs qui souhaitent :

• Intégrer une application existante à la plateforme Nekristo.
• Créer une nouvelle application en suivant les conventions de la plateforme.
• Comprendre le fonctionnement de l'écosystème pour le maintenir ou l'étendre.

Comment Naviguer

• Guides : Suivez des tutoriels pas à pas pour prendre en main la plateforme.
• Référence : Explorez la syntaxe complète du manifeste nekristo.yml et des commandes CLI.
• Exemples : Découvrez des cas d'usage réels et des workflows complets.

Démarrage Rapide

Prêt à commencer ? Suivez notre Guide de Démarrage Rapide pour créer votre première application avec Nekristo en quelques minutes.

Fonctionnalités Clés

🚀 Développement Simplifié

• Hot-reloading automatique pour tous vos services
• Création automatique des bases de données en développement et production
• Configuration unifiée via le manifeste nekristo.yml

🔒 Sécurité Intégrée

• Provisionnement automatisé de VPS avec configuration sécurisée
• Gestion des secrets chiffrée avec GPG
• Scan de vulnérabilités automatique des images Docker avec Trivy

📊 Observabilité

• Centralisation des logs avec Loki et Grafana
• Monitoring des services en temps réel
• Health checks configurables pour chaque composant

🌐 Déploiement Sans Interruption

• Stratégie Blue-Green pour les mises à jour sans downtime
• Migrations automatiques de bases de données
• Configuration SSL automatique avec Let's Encrypt

Support et Contribution

Pour toute question ou suggestion, n'hésitez pas à consulter les guides ou à contribuer à l'amélioration de cette plateforme.