📚 Enterprise Technical & Operational Documentation

Welcome to the comprehensive, production-grade technical and operational documentation repository for the Arian Khodro Enterprise Modernization Initiative.

This repository consolidates the architectural decisions, operational protocols, data schemas, and procurement due diligence derived from the foundational discovery and technical evaluation conducted on Day 01 and Day 02 (September 5–6, 2026 / 1405-06-14 to 1405-06-15).

---

🏛️ Documentation Structure & Modules

The documentation is organized into five mission-critical engineering domains:

01. Architecture & Governance

Enterprise system landscape, bounded contexts, cryptographic data sovereignty, single source of truth (SSOT), and high-throughput concurrency.

• 📄 01 — System Landscape & Data Sovereignty
• 📄 02 — Integration Patterns & Asynchronous Workflows

02. Master Data Management (MDM)

Legacy SKU sanitization (27,000 to ~2,900 entities), canonical JSON schemas, 37-layer data hygiene, and inter-vehicle compatibility graphs.

• 📄 01 — Parts Master Data & Catalog Standardization
• 📄 02 — Cross-Referencing & Compatibility Graphs

03. Logistics & Warehouse Management

Subsystem boundaries (WMS/IMS/YMS/TMS/DOM), bin addressing, rugged scanner protocols, wave picking, and reverse-delivery vehicle staging (LIFO).

• 📄 01 — WMS & IMS Subsystem Boundaries
• 📄 02 — Fulfillment Wave Planning & Dispatch Coordination

04. Sales Operations & CRM

Elimination of paper routing, multi-tier cryptographic credit approval, live proforma e-signatures, debt collection handshakes, and digital RMA reverse logistics.

• 📄 01 — Sales Funnel & Credit Approval Workflows
• 📄 02 — Reverse Logistics & Debt Collection Protocols

05. Commercial & Technical Due Diligence

Rigorous audit of external software proposals, vendor lock-in and source code sovereignty dilemma, local commercial rule gaps, and the definitive procurement verdict.

• 📄 01 — WMS Sales Procurement Evaluation & Vendor Lock-In Risk

---

🎯 Executive Principles & Architecture Standards

1. Strict Data & IP Sovereignty: Direct corporate ownership of custom core code, business rules, and customer data assets.
2. Contract-Driven Decoupling: Direct database cross-querying between legacy and modern systems is banned; all interoperability operates through documented Adapter services and asynchronous event streams.
3. Canonical Data Modeling: A single enterprise-wide parts master graph and unified VIN record serve as the foundational truth for sales, logistics, and finance.