690618:1444 237 #02

2026-06-18 14:44:46 +07:00
parent 037fbb65f5
commit 09e304de84
52 changed files with 4471 additions and 1038 deletions
@@ -17,3 +17,44 @@ description: Execute the implementation planning workflow using the plan templat

 4. **On Error**:
   - If `spec.md` is missing: Run `/speckit.specify` first to create the feature specification
+
+## OCR-Specific Planning Considerations
+
+When planning OCR & AI Extraction prompt management features (ADR-037), include:
+
+### Infrastructure Planning
+
+- **OCR Sidecar**: Verify Desk-5439 sidecar availability (port 8765)
+- **Endpoints**: Plan for `/ocr-upload`, `/embed`, and `/normalize` endpoints
+- **Environment Variables**: Document required env vars (OCR_SIDECAR_API_KEY, OCR_API_URL)
+- **Network**: Verify VLAN 10 connectivity between backend and Desk-5439
+
+### Database Planning
+
+- **Schema Changes**: Use SQL deltas per ADR-009 (no TypeORM migrations)
+- **Version Column**: Verify `ai_prompts` table has `version` column
+- **Entity Mapping**: Ensure `@VersionColumn()` in `ai-prompts.entity.ts`
+- **Seed Data**: Plan for default OCR system prompt seed
+
+### Service Architecture
+
+- **Validation Service**: Extend existing `ai-prompts.service.ts` for prompt validation
+- **Optimistic Locking**: Plan version conflict handling (409 Conflict responses)
+- **Prompt Resolution**: Design `resolveActive()` for template placeholder substitution
+- **BullMQ Integration**: Plan queue jobs for OCR, extraction, and RAG prep
+
+### 3-Step Pipeline Design
+
+- **Sequential Execution**: Design OCR → AI Extract → RAG Prep flow
+- **State Tracking**: Plan Redis-based pipeline status tracking
+- **Input/Output Contract**: Define data flow between pipeline steps
+- **Error Recovery**: Design rollback and retry mechanisms
+
+### Frontend Planning
+
+- **Tab Structure**: Plan separate tabs for OCR, AI Extraction, and Sandbox
+- **Version History**: Design version list display and activation UI
+- **Validation UI**: Plan inline validation error display
+- **Vector Preview**: Design chunk list and vector dimension display (5 dims)
+
+For specialized OCR workflows, use `/speckit.ocr-prompt-management` instead.