---
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"
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."
---

# FREEEXILE: CỔNG ĐIỀU HƯỚNG TRUNG TÂM & CHỈ MỤC TÀI LIỆU TOÀN CỤC

> **Dự án**: `FreeExile` — ARPG 2.5D Cổ Võ Hoang Dã & Hắc Ám Lưu Đày (PoE2 Spirit).  
> **Kiến trúc tài liệu**: [DOCUMENTATION_SYSTEM_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/DOCUMENTATION_SYSTEM_ARCHITECTURE.md) (Chuẩn Diátaxis 2.0 & AI-Native Metadata).  
> **Chỉ mục máy tính đọc (Machine-Readable JSON)**: [documentation_index.json](file:///c:/Projects/FreeExile/docs/documentation_index.json).

```mermaid
flowchart LR
    Root["docs/"] --> Arch["architecture/<br/>(10 Tài liệu)"]
    Root --> GDD["game_design/<br/>(12 Tài liệu)"]
    Root --> Cli["client/<br/>(4 Tài liệu)"]
    Root --> Sec["security/<br/>(2 Hiến chương)"]
    Root --> Ops["operations/<br/>(3 Tài liệu)"]
    Root --> Std["standards/<br/>(3 Quy chuẩn)"]
    Root --> ADR["adr/<br/>(4 Bản ghi)"]
    Root --> DRQ["design_requests/<br/>(Quy trình DRQ)"]
```

---

## 1. PHÂN HỆ KIẾN TRÚC KỸ THUẬT PHÂN TÁN (`docs/architecture/`)
*Chủ trì: `server_systems_architect` | Trọng tâm: 1M+ CCU, p99 < 25ms, Actor Model, 2PC Sổ cái*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt Kỹ Thuật | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-ARCH-001` | [ARCHITECTURE_MILLION_CCU.md](file:///c:/Projects/FreeExile/docs/architecture/ARCHITECTURE_MILLION_CCU.md) | Explanation | Tổng quan kiến trúc phân tán 1M CCU, phân vùng Spatial Grid, Gateway QUIC. | [spatial_grid.py](file:///c:/Projects/FreeExile/server/world/spatial_grid.py) |
| `DOC-ARCH-002` | [DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/DISTRIBUTED_ENGINE_1M_CCU_ARCHITECTURE.md) | Explanation | Triển khai Actor Model, xử lý concurrency, SQLite (WAL mode) và Kafka Event Sourcing. | [spatial_grid.py](file:///c:/Projects/FreeExile/server/world/spatial_grid.py) |
| `DOC-ARCH-003` | [GAME_ENGINE_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/GAME_ENGINE_ARCHITECTURE.md) | Explanation | Vòng lặp 30Hz máy chủ đơn phương xác thực, reconciliation, chống lệch tọa độ. | [movement_authority.py](file:///c:/Projects/FreeExile/server/world/movement_authority.py) |
| `DOC-ARCH-004` | [SERVER_DATABASE_AND_PERSISTENCE_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/SERVER_DATABASE_AND_PERSISTENCE_ARCHITECTURE.md) | Explanation | Thiết kế sổ cái tài chính phân tán 2PC, CockroachDB/PostgreSQL kết hợp Redis. | [database.py](file:///c:/Projects/FreeExile/server/auth/database.py) |
| `DOC-ARCH-005` | [ACCOUNT_AUTH_OAUTH_CAPTCHA_SYSTEM.md](file:///c:/Projects/FreeExile/docs/architecture/ACCOUNT_AUTH_OAUTH_CAPTCHA_SYSTEM.md) | Explanation | Định danh người chơi, Argon2id, Remember Token đa tầng và AI Captcha chống brute-force. | [auth_service.py](file:///c:/Projects/FreeExile/server/auth/auth_service.py) |
| `DOC-ARCH-006` | [CHAT_AND_SOCIAL_ARCHITECTURE_2026.md](file:///c:/Projects/FreeExile/docs/architecture/CHAT_AND_SOCIAL_ARCHITECTURE_2026.md) | Explanation | Kênh Chat Bang Hội, Chat Thế Giới WebSocket/QUIC kết hợp kiểm duyệt thời gian thực. | [chat_pb2.py](file:///c:/Projects/FreeExile/server/proto/chat_pb2.py) |
| `DOC-ARCH-007` | [ENDGAME_WORLD_MAP_AND_MAP_CONTENT_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/ENDGAME_WORLD_MAP_AND_MAP_CONTENT_ARCHITECTURE.md) | Explanation | Phân vùng instance bản đồ thế giới mở, hệ thống Tinh Đồ Vô Hạn (Endgame Atlas). | [endgame_atlas_engine.py](file:///c:/Projects/FreeExile/server/world/endgame_atlas_engine.py) |
| `DOC-ARCH-008` | [MAP_DATA_PROCGEN_WARFOG_ANTIBOT_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/MAP_DATA_PROCGEN_WARFOG_ANTIBOT_ARCHITECTURE.md) | Explanation | ProcGen địa hình ngẫu nhiên, sương mù Server War-Fog triệt tiêu hoàn toàn bot maphack. | [war_fog_engine.py](file:///c:/Projects/FreeExile/server/world/war_fog_engine.py) |
| `DOC-ARCH-009` | [MAP_DUNGEON_AND_SECRET_CHAMBER_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/MAP_DUNGEON_AND_SECRET_CHAMBER_ARCHITECTURE.md) | Explanation | Hầm ngục leo tầng vô tận, cơ chế bí thất kỳ ngộ sinh tử và đấu trường Hardcore. | [zone_engine.py](file:///c:/Projects/FreeExile/server/world/zone_engine.py) |
| `DOC-ARCH-010` | [PLAYER_HIDEOUT_AND_PORTAL_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/architecture/PLAYER_HIDEOUT_AND_PORTAL_ARCHITECTURE.md) | Explanation | Mật Thất Lưu Đày cá nhân, máy kích hoạt Cổng Vạn Giới và quản lý instance. | [hideout_engine.py](file:///c:/Projects/FreeExile/server/world/hideout_engine.py) |

---

## 2. PHÂN HỆ THIẾT KẾ TRÒ CHƠI & GDD POE2 (`docs/game_design/`)
*Chủ trì: `poe2_game_designer` & `content_economy_researcher` | Trọng tâm: Cổ Võ Hoang Dã, Huyết Cốt Ma Đồ, Barter Economy*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt Nghiệp Vụ | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-GDD-001` | [FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md](file:///c:/Projects/FreeExile/docs/game_design/FREEEXILE_ORIGINAL_IP_AND_SYSTEMS.md) | Explanation | Cốt lõi vũ trụ Cổ Võ Hoang Dã, danh pháp độc quyền, bảo hộ pháp lý quốc tế. | [martial_types.py](file:///c:/Projects/FreeExile/server/world/martial_types.py) |
| `DOC-GDD-002` | [POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md](file:///c:/Projects/FreeExile/docs/game_design/POE2_INSPIRED_SKILL_TAGS_AND_BUILD_SYSTEM.md) | Reference | Ma trận 32 tags kỹ năng 6 tiers chuẩn PoE2, hỗ trợ build archetypes đa dạng. | [skill_tag_catalog.py](file:///c:/Projects/FreeExile/server/world/skill_tag_catalog.py) |
| `DOC-GDD-003` | [MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md](file:///c:/Projects/FreeExile/docs/game_design/MARTIAL_SKILLS_AND_AUGMENT_SIGILS_SYSTEM.md) | Reference | Cắm phiến xương Ma Võ Tàn Cốt vào Khung Cốt Võ Đồ, Dị Biến Tà Ấn, Song Binh. | [martial_matrix.py](file:///c:/Projects/FreeExile/server/world/martial_matrix.py) |
| `DOC-GDD-004` | [ITEM_CRAFTING_AND_AFFIX_GUIDE.md](file:///c:/Projects/FreeExile/docs/game_design/ITEM_CRAFTING_AND_AFFIX_GUIDE.md) | How-To | Cẩm nang chế tác đập đá huyết, bảng Affix T0-T5, tỷ lệ vỡ nát 25% van xả lạm phát. | [item_crafting_engine.py](file:///c:/Projects/FreeExile/server/world/item_crafting_engine.py) |
| `DOC-GDD-005` | [ORIGINAL_SYSTEMS_AND_ECONOMY.md](file:///c:/Projects/FreeExile/docs/game_design/ORIGINAL_SYSTEMS_AND_ECONOMY.md) | Explanation | Kinh tế Barter Cổ Cốt & Huyết Thạch tự hủy, mạng lưới 1.500 mắt xích Ma Đồ. | [currency_exchange.py](file:///c:/Projects/FreeExile/server/shop/currency_exchange.py) |
| `DOC-GDD-006` | [ANTI_INFLATION_SAVAGE_ECONOMY_2026.md](file:///c:/Projects/FreeExile/docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md) | Explanation | 4 mỏ vàng thu nhập dân cày, ma trận van xả tiêu hủy vĩnh viễn (thuế 5%, vỡ đồ 25%). | [economic_simulation_engine.py](file:///c:/Projects/FreeExile/server/world/economic_simulation_engine.py) |
| `DOC-GDD-007` | [RESEARCH_TRENDS_AND_ANTI_INFLATION_BLUEPRINT.md](file:///c:/Projects/FreeExile/docs/game_design/RESEARCH_TRENDS_AND_ANTI_INFLATION_BLUEPRINT.md) | Reference | Nghiên cứu thị trường ARPG 2026, mô hình toán học cân bằng faucets-sinks. | [combat_monte_carlo.py](file:///c:/Projects/FreeExile/tools/analytics/combat_monte_carlo.py) |
| `DOC-GDD-008` | [SEASONAL_LEAGUE_RESET_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/game_design/SEASONAL_LEAGUE_RESET_ARCHITECTURE.md) | Explanation | Mùa Giải Đại Nạn Hoang Vực (Clean Slate), hợp nhất rương Remove-Only an toàn. | [season_league_manager.py](file:///c:/Projects/FreeExile/server/world/season_league_manager.py) |
| `DOC-GDD-009` | [GUILD_SYSTEM_AND_SHARED_STASH.md](file:///c:/Projects/FreeExile/docs/game_design/GUILD_SYSTEM_AND_SHARED_STASH.md) | Reference | Bang hội tinh gọn (Guild Chat + Rương chia sẻ phân quyền 2PC), không công thành. | [two_phase_commit.py](file:///c:/Projects/FreeExile/server/trade/two_phase_commit.py) |
| `DOC-GDD-010` | [QUEST_SYSTEM_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/game_design/QUEST_SYSTEM_ARCHITECTURE.md) | Explanation | Hệ thống nhiệm vụ hoang dã, mốc thành tựu sinh tồn, trả thưởng Cổ Cốt Thạch. | [quest_engine.py](file:///c:/Projects/FreeExile/server/world/quest_engine.py) |
| `DOC-GDD-011` | [NPC_SYSTEM_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/game_design/NPC_SYSTEM_ARCHITECTURE.md) | Explanation | State machine quản lý NPC, cây thoại phân nhánh, trao đổi Barter không dùng vàng. | [npc_engine.py](file:///c:/Projects/FreeExile/server/world/npc_engine.py) |
| `DOC-GDD-012` | [COMBAT_DAMAGE_AND_DEFENSE_MATHEMATICS_2026.md](file:///c:/Projects/FreeExile/docs/game_design/COMBAT_DAMAGE_AND_DEFENSE_MATHEMATICS_2026.md) | Reference | Toán học chiến đấu PoE2: Sát thương đa tầng, bể entropy né tránh, giáp phi tuyến, Boss Stagger. | [damage_calculator.py](file:///c:/Projects/FreeExile/server/combat/damage_calculator.py) |

---

## 3. PHÂN HỆ ĐỒ HỌA & CLIENT ENGINE (`docs/client/`)
*Chủ trì: `ios_client_engineer`, `art_ui_director`, `web_client_engineer` | Trọng tâm: Metal API, 120Hz, 2.5D Isometric*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt Công Nghệ | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-CLI-001` | [IOS_METAL_AND_CLIENT_ENGINE.md](file:///c:/Projects/FreeExile/docs/client/IOS_METAL_AND_CLIENT_ENGINE.md) | Explanation | Client iOS Metal API, ProMotion 120Hz, Zero Garbage Object Pooling. | [world_renderer.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/world_renderer.js) |
| `DOC-CLI-002` | [ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md](file:///c:/Projects/FreeExile/docs/client/ISOMETRIC_COLLISION_BOUNDARIES_AND_PROP_SYSTEM.md) | Reference | Toán học Isometric 2:1, lưới va chạm tĩnh/động và giải thuật Y-sorting. | [iso_math.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/iso_math.js) |
| `DOC-CLI-003` | [SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md](file:///c:/Projects/FreeExile/docs/client/SAVAGE_PRIMAL_ART_AND_VFX_BIBLE.md) | Reference | Quy chuẩn Dark Fantasy, bảng màu hoang tàn, phong cách PBR và GPU Shaders. | [savage_vfx_factory.py](file:///c:/Projects/FreeExile/tools/asset_pipeline/savage_vfx_factory.py) |
| `DOC-CLI-004` | [MOBILE_WEBAPP_TESTING_GUIDE.md](file:///c:/Projects/FreeExile/docs/client/MOBILE_WEBAPP_TESTING_GUIDE.md) | How-To | Hướng dẫn test WebApp PWA qua Wi-Fi cục bộ không cần tài khoản Apple Developer. | [serve_webapp.py](file:///c:/Projects/FreeExile/tools/serve_webapp.py) |

---

## 4. PHÂN HỆ BẢO MẬT & PHÒNG THỦ KHỐI SEC-OPS (`docs/security/`)
*Chủ trì: `ciso_agent` & `blue_team_guardian` | Trọng tâm: Quyền VETO Release, Zero-Trust, Anti-Dupe 2PC*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt An Ninh | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-SEC-001` | [INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md](file:///c:/Projects/FreeExile/docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md) | Explanation | Hiến chương Khối Bảo Mật Độc Lập, Quyền Phủ Quyết Release (Veto Power). | [run_independent_security_audit.py](file:///c:/Projects/FreeExile/tools/security/run_independent_security_audit.py) |
| `DOC-SEC-002` | [SECURITY_ANTI_CHEAT_BOT.md](file:///c:/Projects/FreeExile/docs/security/SECURITY_ANTI_CHEAT_BOT.md) | Explanation | Phòng thủ đa tầng: Apple App Attest, ChaCha20, AI Touch Biometrics. | [touch_biometrics.py](file:///c:/Projects/FreeExile/server/security/touch_biometrics.py) |

---

## 5. PHÂN HỆ VẬN HÀNH & THƯƠNG MẠI HÓA (`docs/operations/`)
*Chủ trì: `studio_producer`, `lead_documentation_architect` | Trọng tâm: 8 tuần roadmap, StoreKit 2, Feedback telemetry*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt Vận Hành | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-OPS-001` | [ROADMAP_2_MONTHS.md](file:///c:/Projects/FreeExile/docs/operations/ROADMAP_2_MONTHS.md) | Reference | Kế hoạch tác chiến 8 tuần, 5 sprints bàn giao từ Alpha đến Release 1M CCU. | Kế hoạch điều phối Studio |
| `DOC-OPS-002` | [PAYMENT_AND_MEGASHOP_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/operations/PAYMENT_AND_MEGASHOP_ARCHITECTURE.md) | Explanation | Cổng Apple StoreKit 2, Web3 Crypto Gateway, cam kết 100% Non-Pay-to-Win. | [shop_service.py](file:///c:/Projects/FreeExile/server/shop/shop_service.py) |
| `DOC-OPS-003` | [FEEDBACK_AND_SUGGESTIONS_SYSTEM.md](file:///c:/Projects/FreeExile/docs/operations/FEEDBACK_AND_SUGGESTIONS_SYSTEM.md) | Explanation | Kênh thu thập ý kiến người chơi và telemetry lỗi trên SQLite biệt lập. | [feedback_service.py](file:///c:/Projects/FreeExile/server/feedback/feedback_service.py) |

---

## 6. PHÂN HỆ QUY CHUẨN KỸ THUẬT & LIÊN PHÒNG BAN (`docs/standards/`)
*Chủ trì: `lead_documentation_architect`, `localization_lead` | Trọng tâm: File Hygiene, Asset Pipeline, i18n*

| Doc ID | Tên Tài Liệu & Liên Kết | Diátaxis | Tóm Tắt Quy Chuẩn | Mã Nguồn Liên Quan |
| :--- | :--- | :--- | :--- | :--- |
| `DOC-STD-001` | [ENGINEERING_STANDARDS_2026.md](file:///c:/Projects/FreeExile/docs/standards/ENGINEERING_STANDARDS_2026.md) | Reference | Quy chuẩn kỹ thuật Python/TypeScript/Metal, giới hạn dòng file/hàm, Docs-as-Code. | [check_code_and_doc_hygiene.py](file:///c:/Projects/FreeExile/tools/lint/check_code_and_doc_hygiene.py) |
| `DOC-STD-002` | [DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md](file:///c:/Projects/FreeExile/docs/standards/DESIGN_PIPELINE_AND_CROSS_DEPT_WORKFLOW.md) | How-To | Quy trình phối hợp 4 bước liên phòng ban và công cụ tự động hóa Asset Pipeline. | [design_pipeline_manager.py](file:///c:/Projects/FreeExile/tools/asset_pipeline/design_pipeline_manager.py) |
| `DOC-STD-003` | [GLOBAL_LOCALIZATION_DICTIONARY.md](file:///c:/Projects/FreeExile/docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md) | Reference | Từ điển thuật ngữ chuẩn hóa 9 ngôn ngữ (EN, VI, ZH, JA, KO, RU, ES, PT, DE). | [test_localization.py](file:///c:/Projects/FreeExile/tests/unit/test_localization.py) |

---

## 7. QUYẾT ĐỊNH KIẾN TRÚC (`docs/adr/`)
*Chủ trì: `server_systems_architect` | Trọng tâm: Trade-offs & Thiết kế bất biến*

- [ADR-0001: WebAssembly Thay Thế Lua Scripting](file:///c:/Projects/FreeExile/docs/adr/0001_modern_game_scripting_wasm_vs_lua.md)
- [ADR-0002: Khóa Hai Pha (2PC) Cho Sổ Cái Tài Chính & Giao Dịch Chống Dupe](file:///c:/Projects/FreeExile/docs/adr/0002_two_phase_commit_distributed_ledger.md)
- [ADR-0003: Bang Hội Tinh Gọn (Lightweight Guild) Thay Cho Công Thành Chiến](file:///c:/Projects/FreeExile/docs/adr/0003_lightweight_guild_vs_faction_territory_wars.md)
- [ADR-0004: Uỷ Thác Bản Năng: Lõi Phản Xạ 30Hz Cục Bộ Kết Hợp Multi-LLM](file:///c:/Projects/FreeExile/docs/adr/0004_savage_war_soul_totem_multi_llm_delegation.md)

---

## 8. HƯỚNG DẪN TRA CỨU DÀNH CHO AUTONOMOUS AI AGENTS

1. **Truy vấn theo Phân Loại Diátaxis**:
   - Cần học cách làm: Tra cứu các tài liệu `diataxis_type: "how-to"`.
   - Cần tra cứu bảng số / thông số: Tra cứu `diataxis_type: "reference"`.
   - Cần hiểu lý do thiết kế: Tra cứu `diataxis_type: "explanation"`.
2. **Nạp Ngữ Cảnh Tối Ưu (Token Conservation)**:
   - Thay vì đọc toàn bộ tài liệu, hãy sử dụng `docs/documentation_index.json` để lấy `doc_id`, `summary`, và `related_code`.
   - Chỉ mở tệp tài liệu khi thực sự cần tham chiếu công thức toán học hoặc bảng thuộc tính chi tiết.
3. **Kiểm Thử Tài Liệu**:
   - Luôn chạy `python tools/lint/check_documentation_system.py` sau khi thêm hoặc sửa bất kỳ tài liệu Markdown nào.