{
  "version": "2026.1",
  "generated_at": "2026-09-29T20:00:00Z",
  "total_documents": 55,
  "documents": [
    {
      "doc_id": "DOC-ADR-001",
      "title": "ADR 0001: Đoạn Tuyệt Với Lua — Ứng Dụng WebAssembly Trong Game Scripting",
      "rel_path": "docs/adr/0001_modern_game_scripting_wasm_vs_lua.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/adr/0001_modern_game_scripting_wasm_vs_lua.md",
      "category": "adr",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "adr",
        "wasm",
        "lua",
        "game-scripting",
        "sandboxing"
      ],
      "related_code": [
        "server/engine/scripting_engine.py"
      ],
      "related_docs": [
        "docs/architecture/GAME_ENGINE_ARCHITECTURE.md"
      ],
      "summary": "Quyết định thay thế Lua VM bằng WebAssembly (Wasm) để đạt hiệu năng native AOT, bộ nhớ sandbox cô lập tuyệt đối.",
      "line_count": 146
    },
    {
      "doc_id": "DOC-ADR-002",
      "title": "ADR 0002: Khóa Hai Pha (2PC) Cho Sổ Cái Tài Chính & Giao Dịch Chống Dupe",
      "rel_path": "docs/adr/0002_two_phase_commit_distributed_ledger.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/adr/0002_two_phase_commit_distributed_ledger.md",
      "category": "adr",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "anti_dupe_economic_auditor",
      "last_updated": "2026-09-29",
      "tags": [
        "adr",
        "2pc",
        "distributed-transactions",
        "anti-dupe",
        "ledger"
      ],
      "related_code": [
        "server/trade/guild_stash_service.py",
        "server/trade/two_phase_commit.py",
        "server/trade/consignment_vault.py",
        "tests/unit/test_trade_2pc.py"
      ],
      "related_docs": [
        "docs/architecture/SERVER_DATABASE_AND_PERSISTENCE_ARCHITECTURE.md",
        "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md"
      ],
      "summary": "Quyết định ứng dụng thuật toán Khóa Hai Pha (2PC) kết hợp Redlock trên Redis Cluster để triệt tiêu hoàn toàn dupe đồ và race conditions.",
      "line_count": 75
    },
    {
      "doc_id": "DOC-ADR-003",
      "title": "ADR 0003: Bang Hội Tinh Gọn (Lightweight Guild) Thay Cho Công Thành Chiến",
      "rel_path": "docs/adr/0003_lightweight_guild_vs_faction_territory_wars.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/adr/0003_lightweight_guild_vs_faction_territory_wars.md",
      "category": "adr",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "adr",
        "guild-system",
        "individual-centric",
        "arpg-spirit",
        "anti-inflation"
      ],
      "related_code": [
        "server/trade/guild_stash_service.py",
        "server/trade/two_phase_commit.py",
        "tests/unit/test_guild_stash_2pc.py"
      ],
      "related_docs": [
        "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md",
        "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md"
      ],
      "summary": "Quyết định loại bỏ cơ chế công thành chiến bang hội kiểu VLTK/MMO để giữ trọn vẹn tinh thần ARPG cá nhân cày cuốc sâu sắc (PoE2 Spirit).",
      "line_count": 67
    },
    {
      "doc_id": "DOC-ADR-004",
      "title": "ADR 0004: Uỷ Thác Bản Năng: Lõi Phản Xạ 30Hz Cục Bộ Kết Hợp Multi-LLM",
      "rel_path": "docs/adr/0004_savage_war_soul_totem_multi_llm_delegation.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/adr/0004_savage_war_soul_totem_multi_llm_delegation.md",
      "category": "adr",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "ai_agent_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "adr",
        "ai-delegation",
        "war-soul-totem",
        "multi-llm",
        "offline-farming"
      ],
      "related_code": [
        "server/agent/agent_decision_core.py",
        "server/agent/llm_provider_client.py",
        "tests/unit/test_agent_decision_core.py"
      ],
      "related_docs": [
        "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
        "docs/architecture/GAME_ENGINE_ARCHITECTURE.md"
      ],
      "summary": "Quyết định kết hợp mô hình AI phân tầng: phản xạ thú tính cục bộ 30Hz (0ms) cho chiến đấu vi mô và Multi-LLM router không đồng bộ cho chiến thuật vĩ mô.",
      "line_count": 72
    },
    {
      "doc_id": "DOC-ADR-INDEX",
      "title": "Chỉ Mục Các Bản Ghi Quyết Định Kiến Trúc (Architecture Decision Records)",
      "rel_path": "docs/adr/README.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/adr/README.md",
      "category": "adr",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "adr",
        "architecture",
        "decisions",
        "index"
      ],
      "related_code": [
        "server/engine/",
        "server/trade/",
        "server/guild/",
        "server/agent/"
      ],
      "related_docs": [
        "docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Tổng hợp danh sách các quyết định kỹ thuật và kiến trúc cốt lõi định hình hệ thống FreeExile.",
      "line_count": 41
    },
    {
      "doc_id": "DOC-ARCH-001",
      "title": "Kiến Trúc Phân Tán Triệu CCU & Spatial Grid",
      "rel_path": "docs/architecture/ARCHITECTURE_MILLION_CCU.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/ARCHITECTURE_MILLION_CCU.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "distributed",
        "1m-ccu",
        "actor-model",
        "spatial-grid",
        "quic"
      ],
      "related_code": [
        "server/world/spatial_grid.py",
        "server/network/gateway.py"
      ],
      "related_docs": [
        "docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md"
      ],
      "summary": "Kiến trúc tổng quan phân tán Actor Model, phân vùng Spatial Grid và Gateway QUIC/TCP chịu tải 1M+ CCU.",
      "line_count": 111
    },
    {
      "doc_id": "DOC-ARCH-002",
      "title": "Lõi Động Cơ Phân Tán 1M CCU & Event Sourcing",
      "rel_path": "docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "distributed-engine",
        "actor-model",
        "p99-latency",
        "redis-cluster",
        "kafka"
      ],
      "related_code": [
        "server/engine/actor_system.py",
        "server/engine/event_store.py"
      ],
      "related_docs": [
        "docs/architecture/ARCHITECTURE_MILLION_CCU.md"
      ],
      "summary": "Chi tiết triển khai Actor Model, xử lý concurrency p99 < 25ms, Redis Cluster và Kafka Event Sourcing.",
      "line_count": 164
    },
    {
      "doc_id": "DOC-ARCH-003",
      "title": "Kiến Trúc Vòng Lặp Game Engine 30Hz Server-Client",
      "rel_path": "docs/architecture/GAME_ENGINE_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/GAME_ENGINE_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "game-engine",
        "tick-30hz",
        "server-authoritative",
        "spatial-grid"
      ],
      "related_code": [
        "server/engine/game_loop.py",
        "server/world/movement_authority.py"
      ],
      "related_docs": [
        "docs/architecture/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md"
      ],
      "summary": "Vòng lặp máy chủ 30Hz đơn phương xác thực, cơ chế reconciliation phía client và khử trôi tọa độ.",
      "line_count": 292
    },
    {
      "doc_id": "DOC-ARCH-004",
      "title": "Kiến Trúc Cơ Sở Dữ Liệu & Lưu Trữ Bất Biến 2PC",
      "rel_path": "docs/architecture/SERVER_DATABASE_AND_PERSISTENCE_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/SERVER_DATABASE_AND_PERSISTENCE_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "database",
        "persistence",
        "cockroachdb",
        "redis",
        "2pc",
        "event-sourcing"
      ],
      "related_code": [
        "server/auth/database.py",
        "server/trade/consignment_vault.py"
      ],
      "related_docs": [
        "docs/adr/0002_two_phase_commit_distributed_ledger.md"
      ],
      "summary": "Thiết kế sổ cái tài chính phân tán 2PC, kiến trúc CockroachDB/PostgreSQL kết hợp Redis Cache chống dupe.",
      "line_count": 320
    },
    {
      "doc_id": "DOC-ARCH-005",
      "title": "Hệ Thống Định Danh, OAuth2 & AI Captcha",
      "rel_path": "docs/architecture/ACCOUNT_AUTH_OAUTH_CAPTCHA_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/ACCOUNT_AUTH_OAUTH_CAPTCHA_SYSTEM.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "auth",
        "oauth2",
        "captcha",
        "security",
        "token-vault"
      ],
      "related_code": [
        "server/auth/auth_service.py",
        "server/auth/bank_security.py"
      ],
      "related_docs": [
        "docs/security/SECURITY_ANTI_CHEAT_BOT.md"
      ],
      "summary": "Kiến trúc xác thực tài khoản, lưu trữ mật khẩu Argon2id, Remember Token đa tầng và AI Captcha phòng chống brute-force.",
      "line_count": 247
    },
    {
      "doc_id": "DOC-ARCH-006",
      "title": "Kiến Trúc Kênh Chat & Tương Tác Xã Hội Tốc Độ Cao",
      "rel_path": "docs/architecture/CHAT_AND_SOCIAL_ARCHITECTURE_2026.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/CHAT_AND_SOCIAL_ARCHITECTURE_2026.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "chat",
        "social",
        "guild-chat",
        "moderation",
        "websocket"
      ],
      "related_code": [
        "server/chat/chat_service.py",
        "server/chat/moderation.py"
      ],
      "related_docs": [
        "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md"
      ],
      "summary": "Hệ thống kênh Chat Bang Hội, Chat Thế Giới qua WebSocket/QUIC kết hợp bộ lọc kiểm duyệt từ khóa độc hại thời gian thực.",
      "line_count": 164
    },
    {
      "doc_id": "DOC-ARCH-007",
      "title": "Kiến Trúc Bản Đồ Thế Giới Vô Hạn & Endgame Atlas",
      "rel_path": "docs/architecture/ENDGAME_WORLD_MAP_AND_MAP_CONTENT_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/ENDGAME_WORLD_MAP_AND_MAP_CONTENT_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "endgame-atlas",
        "world-map",
        "map-instances",
        "dungeons"
      ],
      "related_code": [
        "server/world/endgame_atlas_engine.py",
        "server/world/map_instance_system.py"
      ],
      "related_docs": [
        "docs/architecture/MAP_DUNGEON_AND_SECRET_CHAMBER_ARCHITECTURE.md"
      ],
      "summary": "Kiến trúc phân vùng instance bản đồ thế giới mở, hệ thống Tinh Đồ Vô Hạn (Endgame Atlas) và định tuyến phụ bản.",
      "line_count": 175
    },
    {
      "doc_id": "DOC-ARCH-008",
      "title": "Dữ Liệu Bản Đồ, Sương Mù Chiến Trận & Thuật Toán Chống Bot",
      "rel_path": "docs/architecture/MAP_DATA_PROCGEN_WARFOG_ANTIBOT_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/MAP_DATA_PROCGEN_WARFOG_ANTIBOT_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "map-data",
        "procgen",
        "war-fog",
        "anti-bot",
        "server-authoritative"
      ],
      "related_code": [
        "server/world/procedural_map.py",
        "server/world/war_fog.py"
      ],
      "related_docs": [
        "docs/security/SECURITY_ANTI_CHEAT_BOT.md"
      ],
      "summary": "Thuật toán ProcGen địa hình ngẫu nhiên, sương mù Server-Authoritative War-Fog triệt tiêu hoàn toàn bot maphack.",
      "line_count": 179
    },
    {
      "doc_id": "DOC-ARCH-009",
      "title": "Kiến Trúc Phó Bản & Tứ Đại Bí Thất Man Tộc",
      "rel_path": "docs/architecture/MAP_DUNGEON_AND_SECRET_CHAMBER_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/MAP_DUNGEON_AND_SECRET_CHAMBER_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "dungeons",
        "secret-chambers",
        "instancing",
        "procedural"
      ],
      "related_code": [
        "server/world/map_instance_system.py",
        "server/world/zone_engine.py"
      ],
      "related_docs": [
        "docs/game_design/ITEM_CRAFTING_AND_AFFIX_GUIDE.md"
      ],
      "summary": "Đặc tả các hầm ngục leo tầng vô tận, cơ chế bí thất kỳ ngộ sinh tử và phòng đấu Hardcore 1 mạng sống.",
      "line_count": 209
    },
    {
      "doc_id": "DOC-ARCH-010",
      "title": "Mật Thất Cá Nhân & Thiết Bị Cổng Vạn Giới",
      "rel_path": "docs/architecture/PLAYER_HIDEOUT_AND_PORTAL_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/PLAYER_HIDEOUT_AND_PORTAL_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "hideout",
        "astral-portals",
        "instance-lifecycle",
        "map-device"
      ],
      "related_code": [
        "server/world/hideout_engine.py",
        "server/world/portal_device.py"
      ],
      "related_docs": [
        "docs/architecture/ENDGAME_WORLD_MAP_AND_MAP_CONTENT_ARCHITECTURE.md"
      ],
      "summary": "Kiến trúc Mật Thất Lưu Đày (Hideout) cá nhân, máy kích hoạt Cổng Vạn Giới (Astral Portals) và vòng đời instance.",
      "line_count": 170
    },
    {
      "doc_id": "DOC-ARCH-014",
      "title": "Kiến Trúc Dịch Chuyển An Toàn & Cổng Sào Huyệt Chuẩn PoE2",
      "rel_path": "docs/architecture/TELEPORT_AND_TOWN_PORTAL_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/architecture/TELEPORT_AND_TOWN_PORTAL_ARCHITECTURE.md",
      "category": "architecture",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_engineer",
      "last_updated": "2026-10-02",
      "tags": [
        "teleportation",
        "town-portal",
        "quarantine-engine",
        "poe2-map-device",
        "anti-exploit"
      ],
      "related_code": [
        "server/world/game_design_matrix_schema.py",
        "server/world/game_design_matrix_service.py",
        "proto/portal.proto",
        "server/world/hideout_engine.py"
      ],
      "related_docs": [
        "docs/game_design/PARTY_AND_SOCIAL_SYSTEM_SPECS.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Kiến trúc kỹ thuật chuẩn Diátaxis Explanation cho hệ thống Dịch Chuyển An Toàn 3.5s, Cổng Sào Huyệt 2 chiều PoE2 và Cổng Kiểm Duyệt Cách Ly chống exploit phòng Boss/Mật Thất.",
      "line_count": 175
    },
    {
      "doc_id": "DOC-CLI-001",
      "title": "Công Nghệ Client 2.5D Isometric & Tối Ưu Hóa Apple Metal 120Hz",
      "rel_path": "docs/client/IOS_METAL_AND_CLIENT_ENGINE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/client/IOS_METAL_AND_CLIENT_ENGINE.md",
      "category": "client",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "ios_client_engineer",
      "last_updated": "2026-09-29",
      "tags": [
        "ios",
        "metal",
        "120hz",
        "promotion",
        "zero-garbage",
        "performance"
      ],
      "related_code": [
        "client/webapp/js/engine/world_renderer.js",
        "client/webapp/js/engine/iso_math.js"
      ],
      "related_docs": [
        "docs/client/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md"
      ],
      "summary": "Kiến trúc render Metal API trên iOS, hỗ trợ màn hình ProMotion 120Hz, Zero Garbage Object Pooling trong Hot Path.",
      "line_count": 94
    },
    {
      "doc_id": "DOC-CLI-002",
      "title": "Hệ Thống Tọa Độ Isometric, Lưới Va Chạm & Chân Đế Đạo Cụ 2.5D",
      "rel_path": "docs/client/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/client/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md",
      "category": "client",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "ios_client_engineer",
      "last_updated": "2026-09-29",
      "tags": [
        "isometric-2.5d",
        "collision-grid",
        "prop-footprint",
        "depth-sorting"
      ],
      "related_code": [
        "client/webapp/js/engine/iso_math.js",
        "server/world/spatial_grid.py"
      ],
      "related_docs": [
        "docs/client/IOS_METAL_AND_CLIENT_ENGINE.md"
      ],
      "summary": "Đặc tả toán học chuyển đổi hệ tọa độ Descartes sang Isometric 2:1, lưới va chạm tĩnh/động và thuật toán sắp xếp chiều sâu Y-sorting.",
      "line_count": 343
    },
    {
      "doc_id": "DOC-CLI-003",
      "title": "Kinh Thánh Mỹ Thuật & VFX Hoang Dã (Savage Primal Art Bible)",
      "rel_path": "docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md",
      "category": "client",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "art_ui_director",
      "last_updated": "2026-09-29",
      "tags": [
        "art-bible",
        "vfx",
        "dark-fantasy",
        "pbr-shaders",
        "color-palette"
      ],
      "related_code": [
        "tools/asset_pipeline/savage_vfx_factory.py",
        "tools/asset_pipeline/pbr_texture_synthesizer.py"
      ],
      "related_docs": [
        "docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md"
      ],
      "summary": "Bảng quy chuẩn mỹ thuật Dark Fantasy Cổ Võ Hoang Dã, bảng màu hoang tàn, phong cách đổ bóng PBR và hiệu ứng GPU Shaders.",
      "line_count": 102
    },
    {
      "doc_id": "DOC-CLI-004",
      "title": "Cẩm Nang Kiểm Thử Di Động Qua WebApp PWA Simulator",
      "rel_path": "docs/client/MOBILE_WEBAPP_TESTING_GUIDE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/client/MOBILE_WEBAPP_TESTING_GUIDE.md",
      "category": "client",
      "diataxis_type": "how-to",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "web_client_engineer",
      "last_updated": "2026-09-29",
      "tags": [
        "webapp-pwa",
        "mobile-simulator",
        "testing-guide",
        "chrome-devtools"
      ],
      "related_code": [
        "tools/serve_webapp.py",
        "client/webapp/index.html"
      ],
      "related_docs": [
        "docs/client/IOS_METAL_AND_CLIENT_ENGINE.md"
      ],
      "summary": "Quy trình thiết lập và kiểm thử game trên iPhone/Android thật qua mạng Wi-Fi cục bộ không cần tài khoản Apple Developer.",
      "line_count": 110
    },
    {
      "doc_id": "DOC-GDD-001",
      "title": "Bản Quyền Độc Bản: Vũ Trụ, Lore & Danh Pháp Hoang Dã",
      "rel_path": "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "original-ip",
        "lore",
        "dark-fantasy",
        "savage-primal",
        "poe2-spirit"
      ],
      "related_code": [
        "server/world/martial_types.py"
      ],
      "related_docs": [
        "docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md"
      ],
      "summary": "Cương lĩnh thiết lập vũ trụ Cổ Võ Hoang Dã & Hắc Ám Lưu Đày, bảng đối soát thuật ngữ độc quyền, bảo hộ pháp lý.",
      "line_count": 77
    },
    {
      "doc_id": "DOC-GDD-002",
      "title": "Ma Trận Tag Chiêu Thức Chuẩn PoE2 & Hướng Build",
      "rel_path": "docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "skill-tags",
        "gem-system",
        "theorycrafting",
        "build-archetypes"
      ],
      "related_code": [
        "server/world/skill_tag_catalog.py",
        "server/world/skill_database_service.py"
      ],
      "related_docs": [
        "docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md"
      ],
      "summary": "Hệ thống 32 Tags kỹ năng phân cấp 6 tiers chuẩn PoE2, ma trận tương thích Gem Hỗ Trợ và 6 Archetypes kinh điển.",
      "line_count": 246
    },
    {
      "doc_id": "DOC-GDD-003",
      "title": "Hệ Thống Ma Võ Tàn Cốt & Dị Biến Tà Ấn",
      "rel_path": "docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "martial-skills",
        "bone-relics",
        "mutator-glyphs",
        "bone-matrix"
      ],
      "related_code": [
        "server/world/martial_matrix.py",
        "server/world/martial_catalog.py"
      ],
      "related_docs": [
        "docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md"
      ],
      "summary": "Hệ thống cắm phiến xương võ học vào Khung Cốt Võ Đồ, bổ trợ Dị Biến Tà Ấn và combo Song Binh Hoán Chuyển.",
      "line_count": 212
    },
    {
      "doc_id": "DOC-GDD-004",
      "title": "Cẩm Nang Chế Tác Trang Bị & Ma Trận Thuộc Tính (Affix Matrix)",
      "rel_path": "docs/game_design/ITEM_CRAFTING_AND_AFFIX_GUIDE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/ITEM_CRAFTING_AND_AFFIX_GUIDE.md",
      "category": "game_design",
      "diataxis_type": "how-to",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "crafting",
        "affix-matrix",
        "primal-stones",
        "corruption-sink"
      ],
      "related_code": [
        "server/world/item_crafting_engine.py",
        "server/world/affix_catalog.py"
      ],
      "related_docs": [
        "docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md"
      ],
      "summary": "Bảng tra cứu Affix Tiers T0-T5, quy trình đập đá huyết chế tác tà binh và cơ chế van xả vỡ nát 25% chống lạm phát.",
      "line_count": 253
    },
    {
      "doc_id": "DOC-GDD-005",
      "title": "Kinh Tế Barter Cổ Cốt & Huyết Cốt Ma Đồ",
      "rel_path": "docs/game_design/ORIGINAL_SYSTEMS_AND_ECONOMY.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/ORIGINAL_SYSTEMS_AND_ECONOMY.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "barter-economy",
        "bloodstones",
        "bone-matrix",
        "poe2-spirit"
      ],
      "related_code": [
        "server/world/currency_exchange.py",
        "server/world/martial_matrix.py"
      ],
      "related_docs": [
        "docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md"
      ],
      "summary": "Hệ thống kinh tế hàng-đổi-hàng bản vị Huyết Thạch & Cổ Cốt tự tiêu hủy, mạng lưới 1.500 mắt xích Huyết Cốt Ma Đồ.",
      "line_count": 75
    },
    {
      "doc_id": "DOC-GDD-006",
      "title": "Thiết Kế Cân Bằng Kinh Tế & Ma Trận Tiêu Hủy Lạm Phát",
      "rel_path": "docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "content_economy_researcher",
      "last_updated": "2026-09-29",
      "tags": [
        "economy",
        "anti-inflation",
        "barter",
        "faucets-sinks",
        "ddre"
      ],
      "related_code": [
        "server/world/economy_salvage.py",
        "server/trade/consignment_vault.py"
      ],
      "related_docs": [
        "docs/game_design/RESEARCH_TRENDS_AND_ANTI_INFLATION_BLUEPRINT.md"
      ],
      "summary": "4 mỏ thu nhập bền vững, ma trận van xả tiêu hủy vĩnh viễn (thuế 5%, vỡ đồ 25%) và thuật toán co giãn DDRE.",
      "line_count": 158
    },
    {
      "doc_id": "DOC-GDD-007",
      "title": "Báo Cáo Nghiên Cứu ARPG 2026 & Bản Vẽ Chống Siêu Lạm Phát",
      "rel_path": "docs/game_design/RESEARCH_TRENDS_AND_ANTI_INFLATION_BLUEPRINT.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/RESEARCH_TRENDS_AND_ANTI_INFLATION_BLUEPRINT.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "content_economy_researcher",
      "last_updated": "2026-09-29",
      "tags": [
        "market-research",
        "economy-blueprint",
        "poe2-benchmarks",
        "faucets-sinks"
      ],
      "related_code": [
        "tools/analytics/combat_monte_carlo.py"
      ],
      "related_docs": [
        "docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md"
      ],
      "summary": "Nghiên cứu so sánh cơ chế PoE2/Diablo4/Last Epoch, mô hình toán học cân bằng faucets-sinks trong 8 tuần.",
      "line_count": 128
    },
    {
      "doc_id": "DOC-GDD-008",
      "title": "Kiến Trúc Mùa Giải & Rương Chỉ Rút (Remove-Only Stash)",
      "rel_path": "docs/game_design/SEASONAL_LEAGUE_RESET_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/SEASONAL_LEAGUE_RESET_ARCHITECTURE.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "seasonal-reset",
        "leagues",
        "remove-only-stash",
        "economy-reset"
      ],
      "related_code": [
        "server/world/season_league_system.py",
        "server/world/season_migration.py"
      ],
      "related_docs": [
        "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md"
      ],
      "summary": "Chu trình reset Mùa Giải Đại Nạn Hoang Vực (Clean Slate), hợp nhất rương về Cõi Bị Lãng Quên dạng Remove-Only an toàn.",
      "line_count": 175
    },
    {
      "doc_id": "DOC-GDD-009",
      "title": "Đặc Tả Hệ Thống Bang Hội Gọn Nhẹ & Rương Chung 2PC",
      "rel_path": "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "guild-system",
        "shared-stash",
        "anti-dupe",
        "2pc",
        "lightweight-guild"
      ],
      "related_code": [
        "server/guild/guild_service.py",
        "server/guild/guild_stash_2pc.py"
      ],
      "related_docs": [
        "docs/adr/0003_lightweight_guild_vs_faction_territory_wars.md"
      ],
      "summary": "Thiết kế Bang hội tinh gọn (Guild Chat + Rương chia sẻ phân quyền), khóa 2PC chống dupe, không công thành chiếm đất.",
      "line_count": 109
    },
    {
      "doc_id": "DOC-GDD-010",
      "title": "Kiến Trúc Hệ Thống Nhiệm Vụ & Mốc Phần Thưởng Server-Authoritative",
      "rel_path": "docs/game_design/QUEST_SYSTEM_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/QUEST_SYSTEM_ARCHITECTURE.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "quest-system",
        "milestones",
        "lore-progression",
        "rewards"
      ],
      "related_code": [
        "server/world/quest_engine.py",
        "server/world/quest_catalog.py"
      ],
      "related_docs": [
        "docs/game_design/NPC_SYSTEM_ARCHITECTURE.md"
      ],
      "summary": "Cây nhiệm vụ chính tuyến và kỳ ngộ hoang dã, thẩm định điều kiện máy chủ, trả thưởng Cổ Cốt và điểm Huyết Cốt Ma Đồ.",
      "line_count": 194
    },
    {
      "doc_id": "DOC-GDD-011",
      "title": "Hệ Thống NPC Hoang Dã, Cây Thoại & Trao Đổi Barter",
      "rel_path": "docs/game_design/NPC_SYSTEM_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/NPC_SYSTEM_ARCHITECTURE.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "npc-system",
        "dialogue-trees",
        "barter-exchange",
        "quest-binding"
      ],
      "related_code": [
        "server/world/npc_engine.py",
        "server/world/npc_catalog.py"
      ],
      "related_docs": [
        "docs/game_design/QUEST_SYSTEM_ARCHITECTURE.md"
      ],
      "summary": "State machine quản lý NPC, cây thoại phân nhánh theo tiến độ sinh tồn, tích hợp đổi chác Cổ Cốt không dùng vàng.",
      "line_count": 240
    },
    {
      "doc_id": "DOC-GDD-012",
      "title": "Toán Học Chiến Đấu: Sát Thương, Giáp Phi Tuyến & Boss Stagger",
      "rel_path": "docs/game_design/COMBAT_DAMAGE_AND_DEFENSE_MATHEMATICS_2026.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/COMBAT_DAMAGE_AND_DEFENSE_MATHEMATICS_2026.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "combat",
        "mathematics",
        "damage",
        "defense",
        "armour",
        "stagger",
        "evasion-entropy"
      ],
      "related_code": [
        "server/combat/damage_calculator.py",
        "tests/unit/test_damage_and_defense_calculator.py"
      ],
      "related_docs": [
        "docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Đặc tả toán học tính toán sát thương đa tầng, bể entropy né tránh, giáp phi tuyến và thanh gãy thế Boss Stagger theo tinh thần PoE2.",
      "line_count": 131
    },
    {
      "doc_id": "DOC-GDD-012",
      "title": "Hệ Thống Tổ Đội 6 Người, Phân Bổ Vật Phẩm & Mạng Xã Hội Thời Gian Thực",
      "rel_path": "docs/game_design/PARTY_AND_SOCIAL_SYSTEM_SPECS.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/PARTY_AND_SOCIAL_SYSTEM_SPECS.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-10-02",
      "tags": [
        "party-system",
        "social-engine",
        "loot-allocation",
        "scaling-matrix",
        "poe2"
      ],
      "related_code": [
        "server/world/game_design_matrix_schema.py",
        "server/world/game_design_matrix_service.py",
        "proto/party.proto",
        "proto/social.proto"
      ],
      "related_docs": [
        "docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Đặc tả kỹ thuật chuẩn Diátaxis Reference cho hệ thống Tổ Đội 6 người, công thức khuếch đại thưởng EXP/Loot, 3 chế độ phân bổ vật phẩm, và quản lý Bạn Bè/Bang Hội thời gian thực.",
      "line_count": 174
    },
    {
      "doc_id": "DOC-GDD-012",
      "title": "Hệ Thống Thăng Hoa & Huyết Cốt Tiến Hóa Độc Bản",
      "rel_path": "docs/game_design/SAVAGE_ASCENDANCY_AND_EVOLUTION_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/SAVAGE_ASCENDANCY_AND_EVOLUTION_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "ascendancy",
        "evolution",
        "keystone",
        "paradigm-shifter",
        "savage-primal",
        "poe2-spirit"
      ],
      "related_code": [
        "server/world/ascendancy_types.py",
        "server/world/ascendancy_catalog.py",
        "server/world/ascendancy_engine.py",
        "tests/unit/test_ascendancy_system.py"
      ],
      "related_docs": [
        "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
        "docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md"
      ],
      "summary": "Quy chuẩn thiết kế Hệ Thống Thăng Hoa 10 Thí Luyện Cực Hạn, cấp phát 30 điểm Thăng Hoa và các Keystones biến đổi Item, Skill và Chỉ số cơ bản.",
      "line_count": 170
    },
    {
      "doc_id": "DOC-GDD-012",
      "title": "Hệ Thống Quái Vật Hoang Dã & Trí Tuệ Thú Tính (Savage Monster & Feral AI System)",
      "rel_path": "docs/game_design/SAVAGE_MONSTER_AND_FERAL_AI_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/SAVAGE_MONSTER_AND_FERAL_AI_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "monsters",
        "procedural-generation",
        "feral-ai",
        "10k-variants",
        "shader-palettes"
      ],
      "related_code": [
        "server/world/monster_types.py",
        "server/world/monster_archetype_catalog.py",
        "server/world/monster_procedural_engine.py",
        "server/world/monster_ai_engine.py"
      ],
      "related_docs": [
        "docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md",
        "docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md"
      ],
      "summary": "Đặc tả 10.000 biến thể quái vật qua 100 level, kiến trúc ghép mảnh thủ tục & GPU Shader Palette chống quá tải phần cứng mobile, công thức phân bổ kích thước và độ hung dữ.",
      "line_count": 152
    },
    {
      "doc_id": "DOC-GDD-012",
      "title": "Kiến Trúc Hệ Thống Cốt Truyện Kẻ Hành Khất & Biên Niên Sử Lưu Đày",
      "rel_path": "docs/game_design/STORYLINE_AND_BEGGAR_CHRONICLE_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/STORYLINE_AND_BEGGAR_CHRONICLE_ARCHITECTURE.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "storyline",
        "quest-system",
        "beggar-chronicle",
        "narrative-acts",
        "grimdark-arpg"
      ],
      "related_code": [
        "server/world/storyline_types.py",
        "server/world/storyline_catalog.py",
        "server/world/storyline_engine.py",
        "server/world/quest_engine.py",
        "server/world/quest_catalog.py",
        "client/webapp/js/ui/story_quest_board.js"
      ],
      "related_docs": [
        "docs/game_design/QUEST_SYSTEM_ARCHITECTURE.md",
        "docs/game_design/NPC_SYSTEM_ARCHITECTURE.md"
      ],
      "summary": "Kiến trúc hệ thống cốt truyện 5 Hồi kể về hành trình một kẻ hành khất vượt qua đói rét, bùn lầy, bão cát và quái thú để vươn tới ngôi vị Bá Chủ Tối Cao cõi lưu đày.",
      "line_count": 97
    },
    {
      "doc_id": "DOC-GDD-013",
      "title": "Hệ Thống Vũ Khí Cổ Võ Hoang Dã & Ma Trận Môn Phái - Tộc Hệ",
      "rel_path": "docs/game_design/SAVAGE_WEAPONS_AND_MARTIAL_SECTS_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/SAVAGE_WEAPONS_AND_MARTIAL_SECTS_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-29",
      "tags": [
        "weapons",
        "martial-sects",
        "primal-clans",
        "dual-wield",
        "two-handed",
        "auto-swap",
        "poe2-spirit"
      ],
      "related_code": [
        "server/world/weapon_types.py",
        "server/world/weapon_catalog.py",
        "server/world/weapon_engine.py",
        "tests/unit/test_weapon_system.py"
      ],
      "related_docs": [
        "docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md",
        "docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md",
        "docs/game_design/SAVAGE_ASCENDANCY_AND_EVOLUTION_SYSTEM.md"
      ],
      "summary": "Quy chuẩn thiết kế Hệ Thống Vũ Khí Hoang Dã phân cấp theo 5 Tông Môn Cổ Võ & 5 Cổ Tộc Man Hoang, cơ chế Song Binh Hoán Chuyển 0ms và Implicit Affixes chuẩn PoE2.",
      "line_count": 155
    },
    {
      "doc_id": "DOC-GDD-014",
      "title": "Đặc Tả Hệ Thống Túi Đồ, Kho Cá Nhân & Rương Bán Hàng Premium",
      "rel_path": "docs/game_design/INVENTORY_STASH_AND_PREMIUM_MERCHANT_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/INVENTORY_STASH_AND_PREMIUM_MERCHANT_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-30",
      "tags": [
        "inventory",
        "personal-stash",
        "merchant-stash",
        "megashop-gating",
        "2pc",
        "anti-dupe"
      ],
      "related_code": [
        "server/inventory/inventory_service.py",
        "server/inventory/inventory_types.py",
        "server/shop/shop_catalog.py"
      ],
      "related_docs": [
        "docs/game_design/EQUIPMENT_SLOT_AND_SPATIAL_GRID_SYSTEM.md",
        "docs/adr/0002_two_phase_commit_distributed_ledger.md"
      ],
      "summary": "Kiến trúc 3 tầng lưu trữ: Túi đồ sinh tồn, Kho cá nhân phân tab và Rương bán hàng Premium khóa Coin MegaShop, bảo vệ bằng 2PC chống dupe đồ.",
      "line_count": 143
    },
    {
      "doc_id": "DOC-GDD-015",
      "title": "Thiết Kế Hệ Thống Ô Lưới Không Gian 2D Cho Trang Bị & Rương",
      "rel_path": "docs/game_design/EQUIPMENT_SLOT_AND_SPATIAL_GRID_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/game_design/EQUIPMENT_SLOT_AND_SPATIAL_GRID_SYSTEM.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "poe2_game_designer",
      "last_updated": "2026-09-30",
      "tags": [
        "spatial-grid",
        "equipment-slots",
        "inventory-tetris",
        "aabb-collision",
        "auto-compact"
      ],
      "related_code": [
        "server/inventory/spatial_inventory_grid.py",
        "server/inventory/spatial_grid_types.py",
        "tests/unit/test_spatial_inventory_grid.py"
      ],
      "related_docs": [
        "docs/game_design/INVENTORY_STASH_AND_PREMIUM_MERCHANT_SYSTEM.md"
      ],
      "summary": "Quy chuẩn ma trận ô lưới không gian 2D WxH cho từng dòng trang bị, thuật toán AABB va chạm, First-Fit và 2D Bin-Packing Defragmentation.",
      "line_count": 206
    },
    {
      "doc_id": "DOC-RESEARCH-001",
      "title": "Khảo Sát Thị Trường Game AI Agent 2026 & Đối Soát Kiến Trúc FreeExile",
      "rel_path": "docs/research/2026_AI_AGENT_GAMES_MARKET_RESEARCH.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/research/2026_AI_AGENT_GAMES_MARKET_RESEARCH.md",
      "category": "game_design",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "studio_producer",
      "last_updated": "",
      "tags": [
        "research",
        "market-survey-2026",
        "ai-agents",
        "dual-brain",
        "feral-totem"
      ],
      "related_code": [
        "server/world/agent_orb_service.py",
        "server/agent/agent_decision_core.py",
        "server/agent/llm_provider_client.py"
      ],
      "related_docs": [
        "docs/roadmap/ROADMAP_2026_2027.md",
        "docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md"
      ],
      "summary": "Tổng hợp nghiên cứu 6 tựa game 2026 tích hợp AI Agent, phân tích mô hình System 1 / System 2 và đối soát kiến trúc Não Kép FreeExile.",
      "line_count": 112
    },
    {
      "doc_id": "DOC-RESEARCH-002",
      "title": "Bản Đồng Thuận Chiến Lược CEO & Đặc Tả Đột Phá Chiến Hồn Tế Cốt",
      "rel_path": "docs/research/CEO_ALIGNMENT_AND_FERAL_TOTEM_SPEC.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/research/CEO_ALIGNMENT_AND_FERAL_TOTEM_SPEC.md",
      "category": "game_design",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "studio_producer",
      "last_updated": "",
      "tags": [
        "ceo-alignment",
        "feral-totem",
        "ai-agents",
        "dual-brain",
        "anti-inflation",
        "poe2-spirit"
      ],
      "related_code": [
        "server/world/agent_orb_service.py",
        "server/agent/agent_decision_core.py",
        "server/agent/llm_provider_client.py"
      ],
      "related_docs": [
        "docs/roadmap/ROADMAP_2026_2027.md",
        "docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md",
        "docs/research/2026_AI_AGENT_GAMES_MARKET_RESEARCH.md"
      ],
      "summary": "Đồng thuận chiến lược với CEO: 4 trụ cột bản sắc FreeExile và đặc tả chi tiết 3 cơ chế đột phá cho hệ thống Chiến Hồn Tế Cốt (Feral Totem).",
      "line_count": 121
    },
    {
      "doc_id": "DOC-OPS-001",
      "title": "Lộ Trình Tác Chiến 8 Tuần & 5 Sprints Độc Bản",
      "rel_path": "docs/operations/ROADMAP_2_MONTHS.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/operations/ROADMAP_2_MONTHS.md",
      "category": "operations",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "studio_producer",
      "last_updated": "2026-09-29",
      "tags": [
        "roadmap",
        "8-weeks",
        "5-sprints",
        "milestones",
        "release-plan"
      ],
      "related_code": [
        "N/A"
      ],
      "related_docs": [
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Kế hoạch phân bổ tài nguyên, mốc nghiệm thu kỹ thuật và lộ trình ra mắt thương mại hóa từ Alpha đến Release 1M CCU.",
      "line_count": 94
    },
    {
      "doc_id": "DOC-OPS-002",
      "title": "Kiến Trúc Thanh Toán Đa Nền Tảng & Hắc Thị Hoang Vực (MegaShop)",
      "rel_path": "docs/operations/PAYMENT_AND_MEGASHOP_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/operations/PAYMENT_AND_MEGASHOP_ARCHITECTURE.md",
      "category": "operations",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "server_systems_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "payment",
        "megashop",
        "apple-storekit2",
        "web3-crypto",
        "anti-p2w"
      ],
      "related_code": [
        "server/shop/shop_service.py",
        "server/shop/payment_gateways.py"
      ],
      "related_docs": [
        "docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md"
      ],
      "summary": "Tích hợp Apple StoreKit 2, Web3 Crypto Gateway (USDT/SOL/TON), chính sách 100% Non-Pay-to-Win (chỉ bán cosmetic & tiện ích rương).",
      "line_count": 207
    },
    {
      "doc_id": "DOC-OPS-003",
      "title": "Hệ Thống Góp Ý & Báo Lỗi Biệt Lập (Isolated Feedback Store)",
      "rel_path": "docs/operations/FEEDBACK_AND_SUGGESTIONS_SYSTEM.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/operations/FEEDBACK_AND_SUGGESTIONS_SYSTEM.md",
      "category": "operations",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "lead_documentation_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "feedback-system",
        "bug-report",
        "sqlite-isolated",
        "telemetry"
      ],
      "related_code": [
        "server/feedback/feedback_service.py",
        "server/feedback/feedback_api.py"
      ],
      "related_docs": [
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Kiến trúc ghi nhận góp ý và telemetry lỗi của người chơi trên CSDL SQLite biệt lập tách rời hoàn toàn khỏi vòng lặp game 30Hz.",
      "line_count": 202
    },
    {
      "doc_id": "DOC-ROADMAP-001",
      "title": "Lộ Trình Phát Triển Chiến Lược FreeExile (Roadmap 2026 - 2027)",
      "rel_path": "docs/roadmap/ROADMAP_2026_2027.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/roadmap/ROADMAP_2026_2027.md",
      "category": "operations",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "studio_producer",
      "last_updated": "",
      "tags": [
        "roadmap",
        "strategic-vision",
        "seasonal-cadence",
        "dual-realm",
        "feral-totem",
        "poe2-style"
      ],
      "related_code": [
        "server/world/agent_orb_service.py",
        "server/world/server_engine_loop.py",
        "server/world/season_league_manager.py"
      ],
      "related_docs": [
        "docs/README.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md",
        "docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md"
      ],
      "summary": "Lộ trình chiến lược, kiến trúc mùa giải song thực cảnh 3 tháng và 5 phân kỳ phát triển của FreeExile giai đoạn 2026 - 2027.",
      "line_count": 142
    },
    {
      "doc_id": "DOC-ROADMAP-002",
      "title": "Kế Hoạch Phát Triển Phiên Bản Kế Tiếp (v2026.2 Development Plan)",
      "rel_path": "docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md",
      "category": "operations",
      "diataxis_type": "how-to",
      "status": "canonical",
      "version": "2026.2",
      "owner_role": "server_systems_architect",
      "last_updated": "",
      "tags": [
        "development-plan",
        "version-2026-2",
        "dual-brain",
        "metal-120fps",
        "2pc-ledger",
        "sprint-plan"
      ],
      "related_code": [
        "server/world/agent_orb_service.py",
        "server/agent/agent_decision_core.py",
        "server/agent/llm_provider_client.py"
      ],
      "related_docs": [
        "docs/roadmap/ROADMAP_2026_2027.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md",
        "docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md"
      ],
      "summary": "Kế hoạch kỹ thuật chi tiết phiên bản v2026.2: Kiến trúc Não Kép AI Agent, tối ưu Apple Metal 120 FPS, sổ cái 2PC chống dupe và lộ trình 4 sprints.",
      "line_count": 175
    },
    {
      "doc_id": "DOC-SEC-001",
      "title": "Hiến Chương Khối Bảo Mật Độc Lập & Quyền Phủ Quyết Release",
      "rel_path": "docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md",
      "category": "security",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "ciso_agent",
      "last_updated": "2026-09-29",
      "tags": [
        "security-charter",
        "ciso",
        "veto-power",
        "red-team",
        "blue-team"
      ],
      "related_code": [
        "tools/security/run_independent_security_audit.py",
        "server/security/independent_security_auditor.py"
      ],
      "related_docs": [
        "docs/security/SECURITY_ANTI_CHEAT_BOT.md"
      ],
      "summary": "Tổ chức Khối Bảo Mật 5 vai trò độc lập, cơ chế VETO phủ quyết release với lỗi Critical/High, quy chuẩn kiểm toán định kỳ.",
      "line_count": 148
    },
    {
      "doc_id": "DOC-SEC-002",
      "title": "Kiến Trúc Phòng Thủ Zero-Trust, Anti-Bot & Touch Biometrics",
      "rel_path": "docs/security/SECURITY_ANTI_CHEAT_BOT.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/security/SECURITY_ANTI_CHEAT_BOT.md",
      "category": "security",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "blue_team_guardian",
      "last_updated": "2026-09-29",
      "tags": [
        "anti-cheat",
        "anti-bot",
        "touch-biometrics",
        "zero-trust",
        "apple-app-attest"
      ],
      "related_code": [
        "server/security/touch_biometrics.py",
        "server/security/network_integrity.py"
      ],
      "related_docs": [
        "docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md"
      ],
      "summary": "Phòng ngự đa tầng: Apple App Attest, ChaCha20-Poly1305, phân tích sinh trắc học cử chỉ ngón tay AI Touch Biometrics.",
      "line_count": 116
    },
    {
      "doc_id": "DOC-INDEX-001",
      "title": "Cổng Điều Hướng Trung Tâm & Chỉ Mục Tài Liệu Hệ Thống FreeExile",
      "rel_path": "docs/README.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/README.md",
      "category": "standards",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "lead_documentation_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "master-index",
        "navigation",
        "catalog",
        "docs-portal",
        "diataxis"
      ],
      "related_code": [
        "tools/lint/check_documentation_system.py"
      ],
      "related_docs": [
        "docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Cổng điều hướng trung tâm và bảng danh bạ tài liệu toàn diện của dự án FreeExile phục vụ kỹ sư và AI Agents.",
      "line_count": 141
    },
    {
      "doc_id": "DOC-META-001",
      "title": "Kiến Trúc Hệ Thống Tài Liệu Chuẩn Diátaxis & AI-Native (Doc-as-Code 2026)",
      "rel_path": "docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md",
      "category": "standards",
      "diataxis_type": "explanation",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "lead_documentation_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "doc-architecture",
        "diataxis",
        "ai-friendly",
        "yaml-frontmatter",
        "docs-as-code"
      ],
      "related_code": [
        "tools/lint/check_documentation_system.py",
        "tools/lint/check_code_and_doc_hygiene.py"
      ],
      "related_docs": [
        "docs/README.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Quy chuẩn thiết kế, phân chia module, cấu trúc metadata YAML frontmatter và kiểm thử tự động hệ thống tài liệu FreeExile.",
      "line_count": 138
    },
    {
      "doc_id": "DOC-STD-001",
      "title": "Tôn Chỉ Kỹ Thuật & Quy Tắc Phát Triển Chuẩn Công Nghiệp 2026",
      "rel_path": "docs/standards/ENGINEERING_STANDARDS_2026.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/standards/ENGINEERING_STANDARDS_2026.md",
      "category": "standards",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "lead_documentation_architect",
      "last_updated": "2026-10-02",
      "tags": [
        "engineering-standards",
        "clean-code",
        "tdd",
        "diataxis",
        "file-hygiene",
        "reactive-i18n"
      ],
      "related_code": [
        "tools/lint/check_code_and_doc_hygiene.py",
        "tools/lint/check_i18n_hygiene.py",
        "client/webapp/js/data/i18n.js"
      ],
      "related_docs": [
        "docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md",
        "docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md"
      ],
      "summary": "Quy chuẩn mã nguồn Python/TypeScript/Metal, giới hạn độ dài file/hàm, kiến trúc reactive i18n không reload trang, chu trình TDD khép kín, văn hóa Docs-as-Code.",
      "line_count": 389
    },
    {
      "doc_id": "DOC-STD-002",
      "title": "Quy Trình Phối Hợp Liên Phòng Ban & Asset Pipeline Tự Hành",
      "rel_path": "docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md",
      "category": "standards",
      "diataxis_type": "how-to",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "lead_documentation_architect",
      "last_updated": "2026-09-29",
      "tags": [
        "design-pipeline",
        "cross-dept",
        "asset-pipeline",
        "drq-workflow"
      ],
      "related_code": [
        "tools/asset_pipeline/design_pipeline_manager.py"
      ],
      "related_docs": [
        "docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md"
      ],
      "summary": "Quy trình chuyển đổi yêu cầu từ tài liệu sang Asset Design Request (DRQ), cơ chế thẩm định 2 cấp và đồng bộ asset vào client.",
      "line_count": 246
    },
    {
      "doc_id": "DOC-STD-003",
      "title": "Bảng Từ Điển Thuật Ngữ Chuẩn Đa Ngôn Ngữ (9 Ngôn Ngữ)",
      "rel_path": "docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md",
      "category": "standards",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "localization_lead",
      "last_updated": "2026-10-02",
      "tags": [
        "localization",
        "i18n",
        "dictionary",
        "9-languages",
        "terminology",
        "chat-i18n"
      ],
      "related_code": [
        "server/localization/localization_engine.py",
        "client/webapp/js/data/chat_i18n_catalog.js",
        "client/webapp/js/data/i18n_catalog.js",
        "client/webapp/js/data/i18n.js",
        "tools/lint/check_i18n_hygiene.py"
      ],
      "related_docs": [
        "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Bảng đối soát thuật ngữ game chuẩn hóa cho 9 ngôn ngữ toàn cầu (VI, EN, ZH, JA, KO, TH, DE, RU, ES), đồng bộ 77 thuật ngữ chat, kênh, phân quyền và tooltip vật phẩm.",
      "line_count": 298
    },
    {
      "doc_id": "DOC-STD-004",
      "title": "Quy Chuẩn Phân Vùng Bản Đồ & Thiết Kế Đột Phá Gameplay Chuẩn Mực PoE2",
      "rel_path": "docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md",
      "category": "standards",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.POE2.1",
      "owner_role": "studio_executive_producer",
      "last_updated": "2026-09-30",
      "tags": [
        "poe2",
        "zone-architecture",
        "safe-haven",
        "encounters",
        "hideout"
      ],
      "related_code": [
        "server/world/zone_engine.py",
        "client/webapp/js/engine/monster_system.js"
      ],
      "related_docs": [
        "docs/standards/ENGINEERING_STANDARDS_2026.md"
      ],
      "summary": "Quy chuẩn phân vùng bản đồ, Safe Haven 100% không quái thù địch (chỉ Dummy), chiến trường quái vật có telegraph và né tránh theo chuẩn PoE2.",
      "line_count": 134
    },
    {
      "doc_id": "DOC-STD-016",
      "title": "Quy Chuẩn Thẩm Định & Phương Thức Bảo Vệ Bản Quyền Sở Hữu Trí Tuệ (IP Defense Protocol)",
      "rel_path": "docs/standards/INTELLECTUAL_PROPERTY_AND_COPYRIGHT_DEFENSE_PROTOCOL.md",
      "abs_path": "file:///C:/Projects/FreeExile/docs/standards/INTELLECTUAL_PROPERTY_AND_COPYRIGHT_DEFENSE_PROTOCOL.md",
      "category": "standards",
      "diataxis_type": "reference",
      "status": "canonical",
      "version": "2026.1",
      "owner_role": "ciso_agent",
      "last_updated": "2026-10-03",
      "tags": [
        "ip-compliance",
        "copyright-defense",
        "generative-ai",
        "legal-safeguards",
        "poe2-spirit"
      ],
      "related_code": [
        "server/security/independent_security_auditor.py",
        "client/webapp/js/data/i18n.js"
      ],
      "related_docs": [
        "docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md",
        "docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md"
      ],
      "summary": "Quy chuẩn đánh giá rủi ro vi phạm bản quyền đối với asset đồ họa AI, cơ chế gameplay, lore, mã nguồn và quy trình 4 cấp bảo vệ khi phát sinh tranh chấp sở hữu trí tuệ.",
      "line_count": 113
    }
  ]
}