VNOS / TECHNICAL ARCHITECTURE / HLDMermaid Sources ↗
HLD v0.3.0 · TARGET ARCHITECTURE

گراف معماری کلان VNOS

نمای کلان سیستم‌عامل شبکه‌های ارزش، مستقل از صنعت و رابط کاربری. این سه نمودار، ساختار هدف و قراردادهای بین لایه‌ها را نشان می‌دهند؛ هنوز ادعایی درباره پیاده‌سازی عملیاتی همه ماژول‌ها ندارند.

قانون معماری P0: Headless · API-First · Metadata-Driven · Configuration-First · Modular · Source-Agnostic. God Admin یک پنل است و Control Plane، مجموعه سرویس‌های کنترل و انتشار تنظیمات در پشت آن.
HIGH-LEVEL DESIGN / PLATFORM CONTEXT & CONTAINERS

۱. گراف معماری کلان

مسیریابی مستقل پنل‌ها و مصرف‌کنندگان بیرونی به API، جداسازی Control Plane از Runtime و زیرساخت رویدادها.

flowchart TB
    Actor["کاربران سازمانی و مدیران شبکه"]
    External["سامانه‌های بیرونی<br/>ERP / WMS / MES / POS / Customs"]
    Apps["Experience Clients<br/>God Admin Panel / Partner Portal / Mobile"]
    Auth["Identity + Scoped Authorization"]
    APIs["Versioned Headless APIs<br/>OpenAPI / Idempotency / Validation"]
    CP["Control Plane Services<br/>Metadata / Schema Governance / Workflow Rules / Policy / Integration Config"]
    Publish["Versioned Configuration Publishing<br/>Impact Analysis / Approval / Safe Migrations"]
    Runtime["Application Runtime<br/>Commands / Queries / Workflow Execution"]
    Domain["Modular Domain Engines<br/>Network / Contract / Demand / Order / Lot / Production / Inventory / Logistics / Sales / Ledger"]
    Ingest["Integration Runtime<br/>Mapping / Provenance / Validation / Reconciliation"]
    Data[("SQL Server<br/>Relational Domain + Configuration + Audit")]
    Outbox["Transactional Outbox"]
    Bus["Event Transport<br/>RabbitMQ / Worker Consumers"]
    Proof["Optional Proof Adapter<br/>Blockchain / External Ledger"]
    Finance["External Financial Partners<br/>Bank / Insurance / Financing"]

    Actor --> Apps --> Auth --> APIs
    External --> Ingest --> APIs
    APIs --> CP
    APIs --> Runtime
    CP --> Publish --> Runtime
    Runtime --> Domain
    Runtime --> Data
    CP --> Data
    Ingest --> Data
    Domain --> Data
    Domain --> Outbox --> Bus
    Bus --> Ingest
    Bus -.-> Proof
    Bus -.-> Finance

    classDef primary fill:#12345d,color:#fff,stroke:#c4a463,stroke-width:2px
    classDef plane fill:#e7eef6,color:#173650,stroke:#789db9
    classDef ext fill:#fff4dc,color:#594526,stroke:#c4a463
    class APIs,CP,Runtime,Domain primary
    class Apps,Auth,Publish,Data,Outbox,Bus,Ingest plane
    class Actor,External,Proof,Finance ext
HIGH-LEVEL DESIGN / VALUE NETWORK DOMAIN INTERACTIONS

۲. گراف ارتباط موتورهای دامنه

نمایش شبکه‌ای و غیرخطی سفارش، تولید، انبار، تحویل، شواهد فروش و تعهدات مالی؛ بر مبنای رخدادها و قواعد قراردادی.

flowchart LR
    Network["Organization / Network<br/>Membership / Facilities / Policies"]
    Contract["Contract / Commercial Terms<br/>Versioned Rules"]
    Demand["Demand / Supply Offer<br/>Order / Commitment"]
    Source["Sourcing / Receipt<br/>Customs / Quality Evidence"]
    Transform["Transformation / Production<br/>Actual Input + BOM Version"]
    Inv["Inventory / Custody<br/>Reservation + Movements"]
    Delivery["Fulfillment / Transport<br/>Dispatch + Acceptance"]
    Retail["Retail Events<br/>POS / Returns / Evidence"]
    Lineage["Lot & Provenance Graph<br/>Exact / Inferred / Unknown"]
    Financial["Financial Eligibility / Calculation<br/>Rules + Approvals"]
    Ledger["Balanced Double-Entry Ledger<br/>Receivable / Payable"]
    Reconcile["Settlement Reconciliation<br/>External Payment Evidence"]
    SourceHub["Unified Ingestion<br/>Manual / File / API"]
    Rules["Published Rule / Workflow Versions"]

    Network -.-> Contract
    Network -.-> Demand
    Contract -.-> Demand
    Contract -.-> Financial
    SourceHub --> Source
    SourceHub --> Retail
    SourceHub --> Delivery
    Demand <--> Source
    Demand <--> Transform
    Source --> Inv
    Inv <--> Transform
    Transform --> Delivery
    Delivery --> Inv
    Delivery --> Retail
    Source --> Lineage
    Transform --> Lineage
    Delivery --> Lineage
    Retail -.->|"evidence-dependent"| Lineage
    Delivery -.->|"eligible events"| Financial
    Retail -.->|"eligible events"| Financial
    Financial --> Ledger --> Reconcile
    Rules -.-> Demand
    Rules -.-> Transform
    Rules -.-> Financial

    classDef domain fill:#12345d,color:#fff,stroke:#c2a261,stroke-width:1.5px
    classDef cross fill:#e9eff5,color:#16374f,stroke:#87a0b3
    classDef fn fill:#fff0d7,color:#644b21,stroke:#c2a261
    class Demand,Source,Transform,Inv,Delivery,Retail domain
    class Network,Contract,Lineage,SourceHub,Rules cross
    class Financial,Ledger,Reconcile fn
HIGH-LEVEL DESIGN / CONFIGURATION LIFECYCLE

۳. چرخه پیکربندی و انتشار

مسیر داینامیک تعریف فیلد و مدل تا ارزیابی اثر، مهاجرت کنترل‌شده SQL، نسخه فعال و اجرای مستقل از UI.

flowchart TD
    Admin["God Admin Panel or Management API"]
    Draft["Draft Metadata<br/>Entity / Field / Relationship / Policy / Workflow"]
    Validate["Validation + Security / Compatibility Checks"]
    Preview["Schema Diff / Migration Preview<br/>Impact and Data Safety"]
    Approve{"Authorized publish approval?"}
    Migrate["Governed Schema Engine<br/>Controlled SQL Migration"]
    Version["Atomic Activation<br/>Published Configuration Version"]
    API["Headless Runtime<br/>Stable APIs + Metadata-Aware Validation"]
    UI["Metadata-Driven UI Renderer"]
    Audit["Immutable Audit / Change History"]
    Reject["Return to Draft<br/>Reasons + Fixes"]

    Admin --> Draft --> Validate --> Preview --> Approve
    Approve -->|"No"| Reject --> Draft
    Approve -->|"Yes"| Migrate
    Migrate -->|"Failure"| Reject
    Migrate -->|"Success"| Version
    Version --> API
    Version --> UI
    Draft -.-> Audit
    Approve -.-> Audit
    Migrate -.-> Audit
    Version -.-> Audit

    classDef primary fill:#12345d,color:#fff,stroke:#c4a463
    classDef light fill:#e9eff5,color:#12345d,stroke:#95adbf
    classDef warning fill:#fff1d8,color:#594422,stroke:#c4a463
    class API,Version,Migrate primary
    class Admin,Draft,Validate,Preview,UI,Audit light
    class Approve,Reject warning
DESIGN REVIEW

اصلاحات نسبت به گراف‌های اولیه

  1. پشتیبانی از مشتریان مستقل API: هیچ سرویس دامنه‌ای به پنل وب وابسته نیست؛ ورودی سازمان و اتصال بیرونی از مسیر APIهای مجاز است.
  2. انتشار امن Metadata: تغییر فیلد و جدول به تأیید نسخه، بررسی مغایرت و Schema Engine کنترل‌شده نیاز دارد.
  3. جریان کسب‌وکار غیرخطی: هر زنجیره الزاماً با سفارش خرده‌فروش شروع نمی‌شود و شناسایی طلب الزاماً منتظر فروش POS نیست.
  4. مرزبندی دامنه‌ها: موجودی فیزیکی، نگهداری کالا، مالکیت قانونی، تعهدات قرارداد و پول واقعی، مفاهیم مستقل هستند.
  5. کیفیت شواهد: GTIN / SKU به‌تنهایی معرف بچ محصول فروخته‌شده نیست؛ ارتباط دقیق یا استنباطی با confidence جدا می‌شود.
  6. تطبیق مالی: ثبت سند دوبل به معنی انجام انتقال وجه نیست. مدرک پرداخت برون‌سامانه باید مستقل راستی‌آزمایی شود.
  7. یکپارچگی رخدادها: Outbox در تراکنش دامنه ثبت می‌شود؛ پیام‌های ناهمگام idempotent پردازش و قابل رصد می‌شوند.
  8. بلاکچین اختیاری: اثبات دیجیتال افزونه است؛ بدون آن جریان‌های اصلی باید کار کنند.

جزئیات فنی، ملاحظات امنیتی، تصمیم‌های باز و مفروضات در HLD Markdown نگهداری می‌شوند.