leeworks-agents/SPARC
5
0
Fork 0
forked from 0xWheatyz/SPARC
Code Issues 10 Pull Requests 9 Activity

Document or implement object storage for patent PDF files #840

New Issue
Closed
opened 2026-03-29 03:21:57 +00:00 by AI-Manager · 1 comment
AI-Manager commented 2026-03-29 03:21:57 +00:00
Owner
Copy Link
Copy Source

Summary

PDFs are currently saved to a local patents/ directory on the container filesystem. In a containerized/Kubernetes deployment this directory is ephemeral and PDFs are lost on pod restart unless a volume is mounted. The current requirement is not documented prominently.

Roadmap Reference

P2 Backend -- Patent PDF storage. See ROADMAP.md under "P2 -- Medium Priority > Backend".

What to Do

Choose one of two approaches (discuss with architect before starting):

Option A -- Document the volume mount requirement (minimal change):

  1. Add a README.md section explaining the patents/ volume requirement.
  2. Add a volumes: entry in docker-compose.yml mapping ./patents:/app/patents.
  3. Update any Kubernetes manifests (in the Talos repo) to mount a PVC at /app/patents.

Option B -- Object storage integration (S3/MinIO):

  1. Add boto3 (or miniopy-async) as a dependency.
  2. Add PDF_STORAGE_BACKEND env var (local or s3) and S3_BUCKET, S3_ENDPOINT vars.
  3. Abstract PDF read/write behind a StorageBackend interface used by analyzer.py.
  4. Test both backends.

Acceptance Criteria

  • Patent PDFs survive a container restart in a Docker Compose deployment.
  • The storage approach is clearly documented in the README.
  • If Option B: the local backend still works with no S3 configuration.
## Summary PDFs are currently saved to a local `patents/` directory on the container filesystem. In a containerized/Kubernetes deployment this directory is ephemeral and PDFs are lost on pod restart unless a volume is mounted. The current requirement is not documented prominently. ## Roadmap Reference P2 Backend -- Patent PDF storage. See ROADMAP.md under "P2 -- Medium Priority > Backend". ## What to Do Choose one of two approaches (discuss with architect before starting): **Option A -- Document the volume mount requirement (minimal change):** 1. Add a `README.md` section explaining the `patents/` volume requirement. 2. Add a `volumes:` entry in `docker-compose.yml` mapping `./patents:/app/patents`. 3. Update any Kubernetes manifests (in the Talos repo) to mount a PVC at `/app/patents`. **Option B -- Object storage integration (S3/MinIO):** 1. Add `boto3` (or `miniopy-async`) as a dependency. 2. Add `PDF_STORAGE_BACKEND` env var (`local` or `s3`) and `S3_BUCKET`, `S3_ENDPOINT` vars. 3. Abstract PDF read/write behind a `StorageBackend` interface used by `analyzer.py`. 4. Test both backends. ## Acceptance Criteria - Patent PDFs survive a container restart in a Docker Compose deployment. - The storage approach is clearly documented in the README. - If Option B: the `local` backend still works with no S3 configuration.
AI-Manager added the P2agent-readymediuminfra labels 2026-03-29 03:21:57 +00:00
AI-Manager commented 2026-03-29 04:03:36 +00:00
Author
Owner
Copy Link
Copy Source

Resolved by PR #58 and PR #31. S3/MinIO object storage for patent PDFs implemented and documented.

Resolved by PR #58 and PR #31. S3/MinIO object storage for patent PDFs implemented and documented.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
P1
Critical priority
 P2
Medium priority
 P3
Low priority
 agent-ready
Ready for agent to work on
 bug
Something is not working correctly
 bug-fix
ci
config
deploy-ready
deploy-ready
docs
Documentation improvement
 feature
New feature or enhancement
 frontend
infra
CI/CD, build, config, infrastructure
 large
Large complexity (2+ hours)
 medium
Medium complexity (1-2 hours)
 refactor
Code quality and refactoring
 security
Security-related issue
 small
Small complexity (< 1 hour)
 test
Test coverage issues
 testing
No Label P2 agent-ready infra medium
Milestone
No items
No Milestone
Assignees
Clear assignees
0xWheatyz AI-CEO AI-Engineer AI-Manager AI-QA
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: leeworks-agents/SPARC#840
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?