docs(spec): X14 — object-storage (MinIO/S3) migration plan #145

chaim · 2026-06-08T06:30:32Z

chaim commented

2026-06-08 06:30:32 +00:00

מה זה

מסמך-ספ חדש docs/spec/X14-storage-minio.md — תוכנית-תחום מלאה להגירת אחסון-הקבצים הבינאריים מ-data/ המקומי ל-MinIO (שירות Coolify minio, כבר פרוס ובריא).

ממצאי-הסקירה שתועדו

מלאי-דיסק (cases 1.2G, digests 251M, training 157M, precedent-library 105M, internal-decisions 45M)
מיפוי I/O מפוזר על ~8 שירותים — אין שכבת-אחסון מרכזית (כשל-השורש)
עמודות-DB המאחסנות נתיבים; bind-mounts של הקונטיינר; מצב-MinIO (SNSD, רשת נפרדת)
Paperclip = צרכן-API בלבד (הגירה שקופה)
מקורות-MinIO רשמיים (docs.min.io, AWS S3 spec, minio-py)

הכרעות-יו"ר (2026-06-08)

git=טקסט, MinIO=בינאריים (INV-STG7)
WORM (Object-Lock COMPLIANCE) על סופי בלבד (INV-STG4)
רשת-Docker פנימית legal-ai↔MinIO

Invariants

מקיים G2 — שכבת-אחסון יחידה (storage.py) מחליפה את ה-I/O המפוזר
חדשים: INV-STG1..7 (שכבה-יחידה · מפתח-אטומי · דליות-לפי-ממשל · WORM-סופי · pgvector=מקור-אמת · presigned · git=טקסט)

סוג

ספ-בלבד — אין שינוי קוד/התנהגות. תוכנית-הביצוע (7 שלבים) תהפוך למשימות TaskMaster בנפרד.

🤖 Generated with Claude Code

## מה זה מסמך-ספ חדש `docs/spec/X14-storage-minio.md` — תוכנית-תחום מלאה להגירת אחסון-הקבצים הבינאריים מ-`data/` המקומי ל-**MinIO** (שירות Coolify `minio`, כבר פרוס ובריא). ## ממצאי-הסקירה שתועדו - מלאי-דיסק (cases 1.2G, digests 251M, training 157M, precedent-library 105M, internal-decisions 45M) - מיפוי I/O **מפוזר** על ~8 שירותים — **אין שכבת-אחסון מרכזית** (כשל-השורש) - עמודות-DB המאחסנות נתיבים; bind-mounts של הקונטיינר; מצב-MinIO (SNSD, רשת נפרדת) - Paperclip = צרכן-API בלבד (הגירה שקופה) - מקורות-MinIO רשמיים (docs.min.io, AWS S3 spec, minio-py) ## הכרעות-יו"ר (2026-06-08) 1. **git=טקסט, MinIO=בינאריים** (INV-STG7) 2. **WORM (Object-Lock COMPLIANCE) על סופי בלבד** (INV-STG4) 3. **רשת-Docker פנימית** legal-ai↔MinIO ## Invariants - מקיים **G2** — שכבת-אחסון יחידה (`storage.py`) מחליפה את ה-I/O המפוזר - חדשים: **INV-STG1..7** (שכבה-יחידה · מפתח-אטומי · דליות-לפי-ממשל · WORM-סופי · pgvector=מקור-אמת · presigned · git=טקסט) ## סוג ספ-בלבד — **אין שינוי קוד/התנהגות**. תוכנית-הביצוע (7 שלבים) תהפוך למשימות TaskMaster בנפרד. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

chaim added 1 commit 2026-06-08 06:30:32 +00:00

docs(spec): X14 — object-storage (MinIO/S3) migration plan 16470f6279

Adds docs/spec/X14-storage-minio.md — the domain spec + phased plan for
migrating binary document storage from the local data/ tree to the
already-deployed MinIO service (Coolify svc `minio`).

Captures: disk inventory, scattered file-I/O map (~8 services, no central
layer), DB path columns, MinIO deploy state, Paperclip = API-consumer only.
Defines 7 domain invariants (INV-STG1..7) and a 7-phase execution plan.

Chair decisions (2026-06-08): git-per-case keeps text/metadata + MinIO holds
binaries (INV-STG7); WORM Object-Lock on FINAL decisions only (INV-STG4);
internal Docker network for legal-ai↔MinIO.

Invariants: keeps G2 (single storage path replaces scattered I/O);
INV-STG1..7 new. Spec-only PR — no code/behavior change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

chaim merged commit 36319a8d75 into main

2026-06-08 06:30:37 +00:00

chaim deleted branch worktree-storage-minio-plan

2026-06-08 06:30:37 +00:00

chaim referenced this issue from a commit

2026-06-08 06:30:38 +00:00

Merge pull request 'docs(spec): X14 — object-storage (MinIO/S3) migration plan' (#145) from worktree-storage-minio-plan into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: ezer-mishpati/legal-ai#145