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 here, then continue from Step 1 to Step 5 in order.

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.