Step 0: Documentation Overview

Documentation for the production automation in Amir2000 Image Automation. This page is the navigation hub for the core path and supporting references.
Start at:Amir2000 Image Automation | Case Study first.
Then continue from Step 1 to Step 5 in order.

Current Production Additions

• Classifier-first subject suggestion in main_set.py with Ollama fallback.
• Nature-classifier prompt hints in caption_review_local.py for caption/alt/keyword generation (when enabled).
• Stage 6 stability guards: idle/hard timeout watchdog plus row quarantine on repeated native prefill crashes.
• Review-editor Generate action for row-level metadata retry with pending-row duplicate protection.
• Publish completion UX uses one final dialog and closes review window on OK.
• Startup Ollama runtime visibility line (processor=GPU/CPU context=... vram=...) for immediate mode verification.
• Optional run-end Ollama process close via OLLAMA_CLOSE_ON_RUN_END.

Core Reading Order (Step 1 to Step 5)

Use this sequence first. It covers the project end-to-end with minimal page switching.

1. Step 1: Purpose and scope - business context, boundaries, and expected outcomes.
2. Step 2: Workflow - exact 8-stage runtime behavior.
3. Step 3: Runbook - daily operation plus recovery procedure.
4. Step 4: Database model - operational truth and publish-side model.
5. Step 5: Developer guide - how to extend without breaking reliability.

Supporting References

Use this order when you need deeper details after the core path.

1. Reference 1: Install and setup - environment bootstrap and first-run readiness.
2. Reference 2: User guide - operator workflow from run to publish.
3. Reference 3: Troubleshooting - targeted diagnosis and fix paths.
4. Reference 4: Logging and failure handling - where to read failures first.
5. Reference 5: Data contracts - config, JSON, and schema contract surfaces.
6. Reference 6: File reference - ownership lookup for scripts and data.
7. Reference 7: Design principles - architecture rationale and guardrails.
8. Reference 8: Diagrams - visual flow and system boundaries.