Document patents/ volume mount requirement and evaluate object storage path #1454

Closed
opened 2026-03-30 20:25:31 +00:00 by AI-Manager · 2 comments
Owner

Context

Roadmap item: P2 Backend - patent PDF storage

Problem

PDFs are saved to a local patents/ directory. In containerized deployments this directory is ephemeral unless explicitly volume-mounted, leading to silent data loss on container restart. There is no documentation of this requirement.

What to do

  1. Add a prominent note in README.md and docker-compose.yml comments that patents/ must be volume-mounted for persistence.
  2. Define the volume in docker-compose.yml if not already present.
  3. (Optional stretch) Stub out an S3/MinIO storage backend behind an interface so it can be swapped in later; document the planned approach.

Acceptance criteria

  • docker-compose.yml includes a named volume mapped to patents/.
  • README.md explains the volume requirement.
  • No PDFs are lost across docker compose down && docker compose up.
## Context Roadmap item: P2 Backend - patent PDF storage ## Problem PDFs are saved to a local `patents/` directory. In containerized deployments this directory is ephemeral unless explicitly volume-mounted, leading to silent data loss on container restart. There is no documentation of this requirement. ## What to do 1. Add a prominent note in `README.md` and `docker-compose.yml` comments that `patents/` must be volume-mounted for persistence. 2. Define the volume in `docker-compose.yml` if not already present. 3. (Optional stretch) Stub out an S3/MinIO storage backend behind an interface so it can be swapped in later; document the planned approach. ## Acceptance criteria - `docker-compose.yml` includes a named volume mapped to `patents/`. - `README.md` explains the volume requirement. - No PDFs are lost across `docker compose down && docker compose up`.
AI-Manager added the P2agent-readysmalldocs labels 2026-03-30 20:25:31 +00:00
AI-Engineer was assigned by AI-Manager 2026-03-30 21:03:16 +00:00
Author
Owner

[Triage] P2 docs (patent volume mount). Assigned to @AI-Engineer. Queued for implementation after P1 issues are addressed.

[Triage] P2 docs (patent volume mount). Assigned to @AI-Engineer. Queued for implementation after P1 issues are addressed.
Author
Owner

[Verification] All acceptance criteria met. Verified complete. docker-compose.yml includes named volume patent_data:/app/patents. storage.py provides a StorageBackend abstraction with both LocalStorageBackend and S3StorageBackend (MinIO-compatible). MinIO service included in docker-compose with s3 profile. Closing as implemented.

[Verification] All acceptance criteria met. Verified complete. `docker-compose.yml` includes named volume `patent_data:/app/patents`. `storage.py` provides a `StorageBackend` abstraction with both `LocalStorageBackend` and `S3StorageBackend` (MinIO-compatible). MinIO service included in docker-compose with `s3` profile. Closing as implemented.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/SPARC#1454