Tree & metadata

• Binaries in storage/docs/<doc_id>.bin.
• Metadata JSON in storage/meta/<doc_id>.json with sha256, size, enc (false for now), 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"
}

CRUD endpoints (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)

Receive content_b64, decode to SPIFFS or SD (test mode). Minimal snippet:

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

Takeaways / Next

• Real crypto deferred to phase 6 (libsodium, nonce, MAC).
• Keep meta format stable (sha256/size/enc/tags/timestamps) for future migrations.
• Plan cleanup/purge and re-index when a doc is deleted.
• Consider quotas/TTL on devices as docs grow.