{
  "title": "Pool Service",
  "slug": "team/backend/services/pool-service",
  "url": "/docs/team/backend/services/pool-service",
  "frontmatter": {
    "layout": "doc",
    "title": "Pool Service",
    "description": "سرویس مدیریت داده‌های مرجع — Reference Data، مواد اولیه تولید Username، آواتارها و داده‌های ارز",
    "version": "0.1.0",
    "status": "BLUEPRINT",
    "author": "Backend Team",
    "owner": "Backend Team",
    "created_at": "2026-07-24",
    "updated_at": "2026-07-24",
    "tags": ""
  },
  "sections": [
    {
      "level": 1,
      "heading": "Pool Service",
      "content": "**Pool Service — Reference Data & Asset Management**\n\n> وضعیت: Blueprint (پیش‌نویس برای بازبینی تیم)"
    },
    {
      "level": 2,
      "heading": "۱. تعریف",
      "content": "Pool Service یک سرویس دامنه مستقل است که **مالک داده‌های مرجع (Reference Data)** و **مواد اولیه تولید** (کلمات ساخت Username، آواتارهای curated، لیست نام‌های رزرو شده) می‌باشد. سایر سرویس‌ها (user-service، currency-service، storage-service) این داده‌ها را از طریق Read API مصرف می‌کنند."
    },
    {
      "level": 2,
      "heading": "۲. Scope",
      "content": ""
    },
    {
      "level": 3,
      "heading": "Pool Service مسئول است برای:",
      "content": "- **Username Materials:** لیست adjectives و nouns برای تولید تصادفی Username\n- **Reserved Usernames:** نام‌های رزرو شده (ادمین، برند، کلمات ممنوعه)\n- **Username Registry:** ثبت و بررسی یکتایی نام‌های تولیدشده (Reserve API اتمیک)\n- **Avatar Pool:** آواتارهای curated با متادیتا (skin tone, category, tags)\n- **Currency Reference:** داده‌های مرجع ارز (ISO 4217, نام، نماد، precision, country mapping)"
    },
    {
      "level": 3,
      "heading": "Pool Service مسئول نیست برای:",
      "content": "- تولید واقعی Username (در user-service)\n- نرخ زنده ارز (در currency-service)\n- احراز هویت کاربران (در auth-service / IAM)\n- فایل‌های فیزیکی آواتار (در MVP موقتاً در Pool؛ مهاجرت به Storage Service بعدی)"
    },
    {
      "level": 2,
      "heading": "۳. تکنولوژی",
      "content": "- **زبان:** Go (net/http + pgx)\n- **دیتابیس:** PostgreSQL مستقل\n- **API:** REST/JSON\n- **رویداد:** در این نسخه رویدادی منتشر نمی‌شود"
    },
    {
      "level": 2,
      "heading": "۴. مسیرهای API (برنامه‌ریزی شده)",
      "content": "| Method | Path | توضیح |\n|--------|------|-------|\n| `GET` | `/v1/pool/username-materials` | لیست adjectives/nouns |\n| `GET` | `/v1/pool/usernames/reserved` | نام‌های رزرو شده |\n| `POST` | `/v1/pool/usernames/reserve` | رزرو اتمیک نام |\n| `GET` | `/v1/pool/avatars` | لیست آواتارها با فیلتر |\n| `GET` | `/v1/pool/currencies` | داده‌های مرجع ارز |"
    },
    {
      "level": 2,
      "heading": "۵. مستندات مرتبط",
      "content": "- [Blueprint اصلی (nons-api)](https://github.com/nons/nons-api/blob/main/services/pool-service/blueprint.md)"
    }
  ]
}