{
  "title": "پلتفرم",
  "slug": "team/platform/index",
  "url": "/docs/team/platform/index",
  "frontmatter": {
    "layout": "doc",
    "title": "پلتفرم",
    "description": "معماری سیستم، استانداردهای مهندسی، دیاگرام‌ها و قراردادهای سطح پلتفرم",
    "version": "1.0.0",
    "status": "PRIVATE",
    "author": "xoxxel",
    "owner": "xoxxel",
    "created_at": "2026-06-09",
    "updated_at": "2026-06-09",
    "tags": "",
    "reviewers": ""
  },
  "sections": [
    {
      "level": 1,
      "heading": "پلتفرم",
      "content": "**Platform Documentation**\n\nاین بخش شامل معماری کلان سیستم، استانداردهای مهندسی، دیاگرام‌های معماری و قراردادهای سطح پلتفرم است. مستندات اینجا متعلق به یک تیم خاص نیست — مرجع رسمی تصمیمات و قواعد فراتیمی هستند.\n\n---"
    },
    {
      "level": 2,
      "heading": "معماری سیستم",
      "content": "| سند | توضیح |\n| --- | --- |\n| [معماری پروژه](./Architecture) | معماری Monorepo، لایه‌ها، سرویس‌ها و اصول معماری |"
    },
    {
      "level": 2,
      "heading": "استانداردهای مهندسی",
      "content": ""
    },
    {
      "level": 3,
      "heading": "عمومی",
      "content": "| سند | توضیح |\n| --- | --- |\n| [استایل گاید](./standards/index) | نمای کلی تمام استانداردها — راهنمای یکپارچه |\n| [خط مشی زبان](./standards/language-policy) | زبان رسمی کد، موارد مجاز فارسی، ممنوعیت‌ها |\n| [قراردادهای نام‌گذاری](./standards/naming-conventions) | فایل‌ها، دیتابیس، env vars، Docker، NATS، API |\n| [ساختار مخزن](./standards/repository-structure) | ساختار استاندارد سرویس، monorepo |\n| [نسخه‌بندی](./standards/versioning-policy) | Semantic Versioning، پیش‌انتشار، تگ‌گذاری |\n| [امنیت](./standards/security-policy) | رازها، parameterized queries، JWT، cookies |"
    },
    {
      "level": 3,
      "heading": "مستندات و ارتباطات",
      "content": "| سند | توضیح |\n| --- | --- |\n| [مستندات سرویس](./standards/docs-policy) | فایل‌های اجباری docs/، قوانین به‌روزرسانی |\n| [الگوی README](./standards/readme-template) | ساختار اجباری README.md |\n| [تغییرات (CHANGELOG)](./standards/changelog-policy) | ساختار Keep a Changelog |"
    },
    {
      "level": 3,
      "heading": "قراردادهای API و رویداد",
      "content": "| سند | توضیح |\n| --- | --- |\n| [استاندارد رویداد](./standards/event-standard) | استاندارد رسمی طراحی و انتشار رویدادها در NATS |\n| [قرارداد رویداد](./standards/event-contract) | پوسته استاندارد NATS، فیلدها، versioning payload |"
    },
    {
      "level": 3,
      "heading": "توسعه و کیفیت",
      "content": "| سند | توضیح |\n| --- | --- |\n| [تست](./standards/testing-policy) | واحد و یکپارچه، CI، پوشش، قوانین |\n| [استاندارد لاگ‌نویسی](./standards/logging-standard) | JSON ساختاریافته، سطوح، قوانین PII |\n| [تعریف انجام شده (DoD)](./standards/definition-of-done) | چک‌لیست کامل پذیرش Feature/PR |"
    },
    {
      "level": 3,
      "heading": "چرخه عمر سرویس",
      "content": "| سند | توضیح |\n| --- | --- |\n| [بلوپرینت](./standards/blueprint-policy) | الزامات پیش از توسعه، تأیید تیمی |\n| [دمو (پیش‌نمایش)](./standards/demo-policy) | HTML/CSS ساده، قوانین فنی |\n| [گیت](./standards/git-policy) | فرمت کامیت، برنچ، workflow، PR |"
    },
    {
      "level": 2,
      "heading": "دیاگرام‌های معماری",
      "content": "| سند | توضیح |\n| --- | --- |\n| [جریان کلی](./diagrams/container_diagram) | معماری سطح بالا — ارتباط کانتینرها و لایه‌ها |\n| [جریان رویدادها](./diagrams/event_driven_architecture) | معماری رویدادمحور با NATS JetStream |"
    },
    {
      "level": 2,
      "heading": "سرویس‌های جدید",
      "content": "| سند | توضیح |\n| --- | --- |\n| [درگاه ورودی (gateway)](./gateway/index) | درگاه API Gateway واحد، مسیریابی و امنیت لبه پلتفرم |\n| [سرویس ارز (currency-service)](../backend/services/currency-service) | تنها مرجع نرخ ارز و تبدیل مبلغ در پلتفرم |\n| [سرویس تسویه (settlement-service)](../backend/services/settlement-service) | کمیسیون، تسویه فروشنده و مدیریت refund |\n\n---"
    },
    {
      "level": 2,
      "heading": "مخاطبان این مستندات",
      "content": "- معماران سیستم (System Architects)\n- توسعه‌دهندگان تمام تیم‌ها\n- مهندسان پلتفرم (Platform Engineers)\n- رهبران فنی (Technical Leads)"
    }
  ]
}