Arborescence & métadonnées

• Binaires dans storage/docs/<doc_id>.bin.
• Métadonnées JSON dans storage/meta/<doc_id>.json avec : sha256, size, enc (false pour l’instant), tags, timestamps.

{
  "doc_id": "DOC-0001",
  "name": "circular_mayors.pdf",
  "sha256": "abc123...",
  "size": 123456,
  "enc": false,
  "tags": ["p1", "mayor", "doc"],
  "created_at": "2025-12-10T14:00:00Z",
  "updated_at": "2025-12-10T14:00:00Z"
}

Endpoints CRUD documents (Fake crypto)

POST /api/v1/docs

curl -X POST http://localhost:8000/api/v1/docs \
  -H "Content-Type: application/json" \
  -d '{
    "doc_id": "DOC-0001",
    "name": "circular_mayors.pdf",
    "content_b64": "...",
    "tags": ["p1","mayor"]
  }'

GET /api/v1/docs/{doc_id}

curl http://localhost:8000/api/v1/docs/DOC-0001

DELETE /api/v1/docs/{doc_id}

curl -X DELETE http://localhost:8000/api/v1/docs/DOC-0001

ESP32 (base64 → SPIFFS)

Réception du content_b64, décodage vers SPIFFS ou SD (mode test). Exemple minimal :

#include <Base64.h>
// Pseudocode : write decoded bytes to SPIFFS
// fs::File f = SPIFFS.open("/doc.bin", "w");
// f.write(decoded, decodedLen);

À retenir / Suites

• Chiffrement réel repoussé en phase 6 (libsodium, nonce, MAC).
• Garder le format meta stable (sha256/size/enc/tags/timestamps) pour les futures migrations.
• Prévoir nettoyage/purge des fichiers et ré-index si doc supprimé.
• Penser quotas/TTL côté devices quand les docs grossissent.