feat: Consolidation de la documentation et suppression des templates génériques

docs/README.md

@@ -12,12 +12,29 @@ Ce dossier documente l'API HTTP, l'architecture et les décisions techniques.
 - Service `StorageService` (voir `src/lib.rs`) encapsule la logique de stockage, récupération et nettoyage TTL.
 - `src/main.rs` démarre Tide avec état `StorageService` et une boucle de nettoyage périodique (60s).
 
+## Concepts de Base
+
+- **Clés** : Format hexadécimal 64 caractères (32 octets)
+- **Valeurs** : Format hexadécimal
+- **TTL** : Durée de vie en secondes, sérialisé dans `*.meta` (UNIX timestamp secondes)
+- **Persistance** : Système de fichiers, sous-dossiers par préfixe de clé
+
+## Fonctionnalités Techniques
+
+- **StorageService** : Abstraction des opérations de stockage
+- **TTL** : Sérialisé dans `*.meta` (UNIX timestamp secondes)
+- **Nettoyage** : Parcours des dossiers, suppression données expirées
+- **Journalisation** : Sorties standard, intégration possible avec superviseur
+
+## Tests
+
+- **Tests unitaires** : Recommandés sur `StorageService` via répertoires temporaires
+- **Tests d'intégration** : HTTP optionnels via client HTTP
+- **Stratégies** : Cas TTL min/max, clés invalides, conflits de clé
+
 Voir aussi:
 - `architecture.md`
 - `configuration.md`
-- `guides_principaux.md`
-- `guides_techniques.md`
-- `guides_test.md`
 - `tests_monitoring.md`
 - `reseau_de_relais.md`
 - `developpement.md`
@@ -37,5 +54,3 @@ Voir aussi:
 
 - Refactor initial de la logique depuis `main.rs` vers `lib.rs` pour testabilité et séparation des responsabilités.
 - Durées TTL maintenant validées dans le handler, calcul d'expiration converti en `SystemTime` avant l'appel service.
-
-

docs/guides_principaux.md

@@ -1,7 +0,0 @@
-# Guides Principaux
-
-- Concepts de base: clés hex 64, valeurs hex, TTL en secondes.
-- API: `/store` (POST), `/retrieve/:key` (GET).
-- Persistance: système de fichiers, sous-dossiers par préfixe de clé.
-
-

docs/guides_techniques.md

@@ -1,8 +0,0 @@
-# Guides Techniques
-
-- `StorageService`: abstraction des opérations de stockage.
-- TTL: sérialisé dans `*.meta` (UNIX timestamp secondes).
-- Nettoyage: parcours des dossiers, suppression données expirées.
-- Journalisation: sorties standard, intégration possible avec superviseur.
-
-

docs/templates/API.md

@@ -1,8 +0,0 @@
-# Référence API — Template
-
-- Vue d’ensemble
-- Authentification/permissions
-- Endpoints par domaine (schémas, invariants)
-- Codes d’erreur
-- Limites et quotas
-- Sécurité et conformité

docs/templates/ARCHITECTURE.md

@@ -1,8 +0,0 @@
-# Architecture — Template
-
-- Contexte et objectifs
-- Découpage en couches (UI, services, données)
-- Flux principaux
-- Observabilité
-- CI/CD
-- Contraintes et SLA

docs/templates/CONFIGURATION.md

@@ -1,6 +0,0 @@
-# Configuration — Template
-
-- Variables d’environnement (nom, type, défaut, portée)
-- Fichiers de configuration (format, validation)
-- Réseau et sécurité (ports, TLS, auth)
-- Observabilité (logs, métriques, traces)

docs/templates/INDEX.md

@@ -1,12 +0,0 @@
-# Index — Templates de documentation (pour projets dérivés)
-
-Utilisez ces squelettes pour démarrer la documentation de votre projet.
-
-- API.md — squelette de référence API
-- ARCHITECTURE.md — squelette d’architecture
-- CONFIGURATION.md — squelette de configuration
-- USAGE.md — squelette d’usage
-- TESTING.md — squelette de stratégie de tests
-- SECURITY_AUDIT.md — squelette d’audit sécurité
-- RELEASE_PLAN.md — squelette de plan de release
-- OPEN_SOURCE_CHECKLIST.md — squelette de checklist open source

docs/templates/OPEN_SOURCE_CHECKLIST.md

@@ -1,7 +0,0 @@
-# Checklist open source — Template
-
-- Gouvernance: LICENSE, CONTRIBUTING, CODE_OF_CONDUCT
-- CI/CD: workflows, tests, security-audit, release-guard
-- Documentation: README, INDEX, guides essentiels
-- Sécurité: secrets, permissions, audit
-- Publication: tag, changelog, release notes

docs/templates/README.md

@@ -1,29 +0,0 @@
-# README — Template de projet
-
-## Présentation
-
-Décrivez brièvement l’objectif du projet, son périmètre et ses utilisateurs cibles.
-
-## Démarrage rapide
-
-- Prérequis (langages/outils)
-- Étapes d’installation
-- Commandes de démarrage
-
-## Documentation
-
-- Index: `docs/INDEX.md`
-- Architecture: `docs/ARCHITECTURE.md`
-- Configuration: `docs/CONFIGURATION.md`
-- Tests: `docs/TESTING.md`
-- Sécurité: `docs/SECURITY_AUDIT.md`
-- Déploiement: `docs/DEPLOYMENT.md`
-
-## Contribution
-
-- GUIDE: `CONTRIBUTING.md`, `CODE_OF_CONDUCT.md`
-- Processus de PR et revues
-
-## Licence
-
-- Indiquez la licence choisie (MIT/Apache-2.0/GPL)

docs/templates/RELEASE_PLAN.md

@@ -1,7 +0,0 @@
-# Plan de release — Template
-
-- Vue d’ensemble, objectifs, date cible
-- Préparation (docs/CI/tests/sécurité)
-- Communication (annonces, canaux)
-- Lancement (checklist, tagging)
-- Post‑lancement (support, retours)

docs/templates/SECURITY_AUDIT.md

@@ -1,7 +0,0 @@
-# Audit de sécurité — Template
-
-- Menaces et surfaces d’attaque
-- Contrôles préventifs et détectifs
-- Gestion des secrets
-- Politique de dépendances
-- Vérifications CI (security-audit)

docs/templates/TESTING.md

@@ -1,6 +0,0 @@
-# Tests — Template
-
-- Pyramide: unit, integration, connectivity, external, performance
-- Structure des répertoires
-- Exécution et rapports
-- Intégration CI

docs/templates/USAGE.md

@@ -1,7 +0,0 @@
-# Usage — Template
-
-- Démarrage quotidien
-- Opérations courantes
-- Tests (référence vers TESTING.md)
-- Sécurité (référence vers SECURITY_AUDIT.md)
-- Déploiement (référence vers DEPLOYMENT.md)