41 lines
2.6 KiB
Markdown
41 lines
2.6 KiB
Markdown
<!-- file: README.md -->
|
|
<!-- version: 1 -->
|
|
|
|
# SaseDev Knowledge
|
|
|
|
SaseDev Knowledge est la plateforme applicative destinée à publier et administrer plusieurs familles de connaissance SaseDev sans transformer PGR en encyclopédie technique.
|
|
|
|
Le dépôt applicatif retenu est `sasedev-knowledge`. Le nom court du produit et le préfixe de crates sont `knowledge`.
|
|
|
|
## Statut
|
|
|
|
La version courante est définie par [`VERSION`](VERSION).
|
|
|
|
`0.0.1` est une release de fondation. Elle établit la gouvernance, les frontières d'architecture, le workspace minimal, les premiers contrats et les validations nécessaires avant toute implémentation fonctionnelle importante.
|
|
|
|
## Invariants de fondation
|
|
|
|
- Git est la source autoritaire du contenu versionné.
|
|
- Une forge est une intégration optionnelle et ne constitue pas une dépendance du domaine.
|
|
- PostgreSQL conserve l'état applicatif ; il ne remplace pas Git comme vérité du contenu publié.
|
|
- La lecture publique doit pouvoir fonctionner depuis des copies Git locales et un index/cache applicatif sans appel à une forge pour chaque requête.
|
|
- PGR, HOWTOs, snippets et décisions `project-local` conservent des forces et responsabilités documentaires distinctes.
|
|
- Une proposition externe ne publie jamais directement du contenu et conserve la révision Git de base utilisée pour sa création.
|
|
|
|
## Entrées principales
|
|
|
|
- [`RULES.md`](RULES.md) — point d'entrée normatif local ;
|
|
- [`ROADMAP.md`](ROADMAP.md) — trajectoire macro engagée ;
|
|
- [`CHANGELOG.md`](CHANGELOG.md) — changements utiles par release ;
|
|
- [`docs/000-README.md`](docs/000-README.md) — index documentaire ;
|
|
- [`docs/objectives/001-PROJECT_OBJECTIVES.md`](docs/objectives/001-PROJECT_OBJECTIVES.md) — objectifs et non-objectifs ;
|
|
- [`docs/architecture/001-PROJECT_PROFILE.md`](docs/architecture/001-PROJECT_PROFILE.md) — baseline PGR, profils/skeletons et matrice de décisions ;
|
|
- [`docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md`](docs/architecture/002-KNOWLEDGE_ARCHITECTURE.md) — architecture de fondation Git/forge/PostgreSQL et frontières de contenu ;
|
|
- [`docs/plans/001-V0_0_1_FOUNDATION_PLAN.md`](docs/plans/001-V0_0_1_FOUNDATION_PLAN.md) — plan vivant de `0.0.1` ;
|
|
- [`docs/validation/001-VALIDATION_MATRIX.md`](docs/validation/001-VALIDATION_MATRIX.md) — matrice de validation ;
|
|
- [`prompts/001-V0_0_1_START_PROMPT.md`](prompts/001-V0_0_1_START_PROMPT.md) — prompt de démarrage autoritaire de la release.
|
|
|
|
## Langue et nomenclature
|
|
|
|
Les noms de fichiers, crates, identifiants et code sont en anglais. La documentation normative et explicative principale est en français.
|