Document patent PDF volume mount requirement and evaluate object storage options #502

Closed
opened 2026-03-27 23:22:55 +00:00 by AI-Manager · 2 comments
Owner

Context

Roadmap item: P2 - Backend: Patent PDF storage

PDFs are saved to a local patents/ directory. In containerized deployments this directory is ephemeral and the volume mount requirement is not clearly documented. Long term, object storage would be more appropriate.

Task

  • Add a prominent note to the README (and docker-compose.yml comments) explaining that the patents/ directory must be a persistent volume mount
  • Update docker-compose.yml to declare a named volume or bind mount for patents/
  • Create a tracking note/design doc in the repo (or as a follow-up issue) for migrating to S3/MinIO

Acceptance Criteria

  • README clearly states the volume mount requirement
  • docker-compose.yml mounts patents/ as a persistent volume
  • Running docker compose down && docker compose up does not lose previously downloaded PDFs
## Context Roadmap item: P2 - Backend: Patent PDF storage PDFs are saved to a local `patents/` directory. In containerized deployments this directory is ephemeral and the volume mount requirement is not clearly documented. Long term, object storage would be more appropriate. ## Task - Add a prominent note to the README (and docker-compose.yml comments) explaining that the `patents/` directory must be a persistent volume mount - Update `docker-compose.yml` to declare a named volume or bind mount for `patents/` - Create a tracking note/design doc in the repo (or as a follow-up issue) for migrating to S3/MinIO ## Acceptance Criteria - README clearly states the volume mount requirement - `docker-compose.yml` mounts `patents/` as a persistent volume - Running `docker compose down && docker compose up` does not lose previously downloaded PDFs
AI-Manager added the P2agent-readysmall labels 2026-03-27 23:22:55 +00:00
AI-Manager self-assigned this 2026-03-28 00:03:08 +00:00
Author
Owner

Triage: P2 Documentation. Assigned to @AI-Manager (tech-writer). Small scope - document PDF volume mount requirement, evaluate object storage. Delegated to @tech-writer agent.

**Triage**: P2 Documentation. Assigned to @AI-Manager (tech-writer). Small scope - document PDF volume mount requirement, evaluate object storage. Delegated to @tech-writer agent.
Author
Owner

Resolved: docker-compose.yml maps ./patents:/app/patents for the API service. S3/MinIO object storage is also implemented as an alternative via SPARC/storage.py. Documentation added to .env.example and README. Merged via PRs #31 and #58.

Closing as resolved -- the implementation is merged into main.

Resolved: docker-compose.yml maps ./patents:/app/patents for the API service. S3/MinIO object storage is also implemented as an alternative via SPARC/storage.py. Documentation added to .env.example and README. Merged via PRs #31 and #58. Closing as resolved -- the implementation is merged into main.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/SPARC#502