Auteur·rice

Lorein Du Perron

Date de publication

6 avril 2026

1 🚀 EDPI-Docs : Infrastructure de Rédaction & Diffusion Résiliente

L’ingénierie du savoir accessible partout, pour tous.

Build & Deploy Lint Quality Control License: MIT SDLC Standard

1.1 📌 Vision & Objectifs Stratégiques

EDPI-Docs est un écosystème Docs-as-Code né d’une nécessité de terrain : produire du contenu technique de qualité industrielle malgré l’instabilité des infrastructures (énergie, matériel, réseau) tout en optimisant le temps et la productivité.

Le projet repose sur trois piliers correctifs : 1. Continuité Opérationnelle (Offline-First) : Rédaction locale complète sans dépendance à Internet, avec tests de rendu cohérents avant synchronisation. Solution agnostique supportant Android, iOS, Windows, Linux et macOS. 2. Accessibilité Sociale & Gratuite : Structure prête à l’emploi permettant à tout expert de publier ses connaissances gratuitement, sans barrière technique complexe. 3. Flexibilité Mobile/Desktop :

    * **Sur PC** : Gestion granulaire et chirurgicale (édition fluide, débogage profond).
    * **Sur Mobile** : Souplesse d'édition pour capturer le savoir en déplacement et synchronisation parfaite via Git.

1.2 🏗️ Architecture & Flux de Qualité (CI/CD)

Le flux de travail garantit le respect des standards de l’ingénierie logicielle.

%%| label: fig-workflow-edpi
%%| fig-cap: Flux de production Docs-as-Code (Résilience & Qualité)
graph TD
    A[Édition Offline : PC/Mobile] -->|Rendu Local| B(Validation Visuelle)
    B -->|Git Push| C{VCS : GitHub}
    C -->|Trigger CI/CD| D[GitHub Actions]
    
    subgraph "Pipeline de Qualité"
    D --> E{Linter : Markdownlint}
    E -->|Succès| F[Engine : Quarto/Typst]
    E -->|Échec| H[Notification Erreur]
    end

    F -->|Publication Auto| G[Edge Host : Cloudflare]
    
    style E fill:#f9f,stroke:#333,stroke-width:2px
    style H fill:#ff9999,stroke:#333

1.2.1 La Garantie Qualité : Markdownlint

Le projet intègre un Linter Markdown qui analyse la structure des fichiers à chaque soumission pour détecter :

* Les erreurs de syntaxe et les liens morts.
* Le non-respect de la hiérarchie des titres.
* Les incohérences de formatage.
* *Note : Toute erreur bloque le déploiement jusqu'à sa résolution.*

1.3 🚀 Écosystème Technique (Stack Modulaire)

Composant Solution Actuelle Rôle & Avantage
Édition Obsidian / VS Code Rendu local offline et gestion des liens bidirectionnels.
Validation Markdownlint Standardisation rigoureuse du contenu technique.
Versionnement Git (GitHub) Historisation et synchronisation multi-support.
Moteur Cloud Quarto + Typst Transformation du Markdown en formats HTML et PDF.
Diffusion Cloudflare Pages Hébergement gratuit, rapide et résilient (Edge Computing).

1.4 📊 Gouvernance & Cycle de Vie (SDLC)

Conformément à la norme ISO/IEC 12207, le projet assure une traçabilité totale des livrables techniques.

Phase Document de Référence Objectif
01. Cadrage EDPI-CHARTE Vision stratégique et analyse de résilience.
02. Spécifications EDPI-STB Spécifications Techniques de Besoin.
03. Conception EDPI-DAL Architecture modulaire IaaS.
04. Qualité EDPI-PVA Plan de Validation et Assurance Qualité.
05. Exploitation EDPI-DEX Dossier d’Exploitation et monitoring.

1.5 🤝 Contribuer au Savoir Commun

1.  Consultez le guide **[CONTRIBUTING.md](./CONTRIBUTING.md)**.
2.  Utilisez le **[Template de Pull Request](.github/PULL_REQUEST_TEMPLATE.md)**.
3.  Respectez les **Conventional Commits** pour l'historique.

1.6 ⚖️ Mentions Légales & Contact

* **Licence** : [MIT](./LICENSE) (Libre et ouvert).
* **Promoteur** : **Lorein Du Perron** (Junior Software Engineer).
* **Contact** : [LinkedIn](https://linkedin.com/in/lorein-duperron) | [GitHub](https://github.com/edpi-org)