Initiative Koesion · Spécification ouverte
Microservice.MD
La spécification ouverte pour concevoir, documenter et valider les microservices. Un document de conception structuré et prêt pour l’IA, pour les systèmes de microservices.
Microservice.MD est créée, détenue et maintenue par Koesion — née des patrons que nous appliquons dans nos mandats de consultation, et ouverte à toutes les équipes.
Ce qu’est MICROSERVICE.md
MICROSERVICE.md est une spécification ouverte pour la documentation de conception des microservices. Chaque service d’un système porte un document structuré qui décrit ce qu’est le service, où se trouvent ses frontières et comment il se comporte — dans un format consommable autant par les humains que par les outils d’IA.
Elle s’appuie sur les concepts du canevas de microservice et évolue vers un outil de conception plus complet pour les systèmes de microservices : de la première esquisse jusqu’à la validation, la gouvernance et l’évolution.
Parce que le format est structuré et cohérent, il devient un socle pour de meilleures conversations de conception, une communication plus claire entre équipes, une gouvernance d’architecture praticable et un développement assisté par IA réellement efficace.
Ce qu’un document MICROSERVICE.md capture
Un document par service, couvrant les décisions qui comptent :
- Raison d’être et responsabilités du service
- Frontières et contexte délimité
- Responsables et imputabilité d’équipe
- API — REST, gRPC, GraphQL
- Événements publiés et consommés
- Dépendances, en amont et en aval
- Propriété des données et stockage
- Observabilité : métriques, journaux, traces, SLO
- Posture de sécurité et contrôle d’accès
- Stratégie de déploiement et environnement d’exécution
- Contexte prêt pour l’IA, pour l’ingénierie assistée
Un dépôt GitHub public — github.com/koesion/microservice-md — hébergera bientôt la spécification et son outillage.
Vous cherchez le savoir de conception derrière la spécification? Microservice.Guru est la plateforme d’apprentissage de Koesion en architecture de microservices.
Découvrir Microservice.Guru