sdk_storage/docs

Documentation du projet sdk_storage

Ce dossier documente l'API HTTP, l'architecture et les décisions techniques.

API

• POST /store : stocke une valeur hex pour une clé hex 64 chars, ttl optionnel (secondes). Quand --permanent est passé au binaire, l'absence de ttl rend la donnée permanente.
• GET /retrieve/:key : retourne { key, value } où value est encodée en hex.

Architecture

• 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
• tests_monitoring.md
• reseau_de_relais.md
• developpement.md
• depannage.md
• performance.md
• api_json_spec.md
• api_contrats.md
• release_guide.md
• ci_docker_registry.md

REX technique

• Docker

  • Build local: docker build -t sdk_storage:local .
  • Run: docker run --rm -p 8081:8081 -v $PWD/storage:/app/storage sdk_storage:local
  • Par défaut --permanent est activé via CMD, override possible: docker run ... sdk_storage -- --permanent

• 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.