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

# CHỈ THỊ ĐIỀU HÀNH TỔNG GIÁM ĐỐC (CEO EXECUTIVE DIRECTIVE)
# QUY CHUẨN PHÂN VÙNG BẢN ĐỒ & THIẾT KẾ ĐỘT PHÁ GAMEPLAY CHUẨN MỰC POE2

> **Cấp độ**: Tuyệt mật & Bắt buộc thi hành toàn Studio (Mandatory Studio-Wide Standard)  
> **Người ban hành**: Studio Executive Producer / CEO  
> **Đối tượng áp dụng**: Tất cả các phòng ban (Systems, Server, Client Web/iOS, QA, Art/VFX, Security/Economy)  
> **Phiên bản**: 2026.POE2.1 — Triệt tiêu lỗi sơ đẳng, nâng tầm trải nghiệm ARPG hoang dã

---

## 1. NGUYÊN TẮC CỐT LÕI: KHÔNG GIAN BẤT KHẢ XÂM PHẠM & VÙNG CHIẾN TRƯỜNG TỬ THẦN

Trong triết lý thiết kế của **Path of Exile 2 (PoE2)** và game ARPG kinh điển:
1. **Sào Huyệt Cá Nhân (Hideout / Tiên Phủ Động Thiên) & Doanh Trại (Sanctuary Hub)**: Là không gian an toàn tuyệt đối (100% Peaceful Sanctuary). Đây là nơi lưu đày giả nghỉ chân, quản lý Rương Đồ (Stash Vault), rèn trang bị, khảm nạp võ học, nghiên cứu Tinh Đồ Nghi và thử nghiệm sát thương trên **Mộc Nhân Bất Hoại (Target Dummy)**. **TUYỆT ĐỐI NGHIÊM CẤM** việc sản sinh quái vật hoang dã, chó săn hay bộ xương đi tuần trong Sào Huyệt và Hub!
2. **Chiến Trường Hoang Dã (Wildlands / Outer Maps / Dungeons / Secret Chambers / Endgame Maps)**: Là nơi quái vật ngự trị theo bầy đàn chiến thuật, có thủ lĩnh tinh anh, buff thuộc tính ngẫu nhiên, tầm cảnh giới săn mồi và đòn đánh có chỉ báo (Telegraph) rõ ràng.

```mermaid
flowchart LR
    subgraph SafeZone ["KHÔNG GIAN AN TOÀN (100% Peaceful Safe Haven)"]
        H["Tiên Phủ Động Thiên (Hideout)"]
        T["Bến Lưu Đày Hub (Sanctuary)"]
        Dummy["Mộc Nhân Bất Hoại (Dummy Only - DPS & Combo Test)"]
        H --- Dummy
        T --- Dummy
    end

    subgraph Waygates ["CỔNG DỊCH CHUYỂN CHỦ ĐỘNG"]
        MD["Bàn Tàn Đồ 6 Cổng (Map Device)"]
        WG["Vạn Giới Giới Môn (World Gate)"]
        QG["Thiên Mệnh Bí Cảnh Môn (Quest Gate)"]
    end

    subgraph HostileZones ["VÙNG ĐẤT CHẾT (Hostile PoE2 Combat Encounters)"]
        M1["Bờ Đá Tàn Xương (Bone Strand)"]
        M2["Đầm Lầy Thối Rữa (Rotten Swamp)"]
        M3["Bí Cảnh Tàn Đồ T1-T16 (Astral Maps)"]
        M4["Mật Thất Cổ Quan (Secret Chambers)"]
    end

    SafeZone -->|Khai Mở & Bước Qua Cổng| Waygates
    Waygates -->|Tải Bản Đồ Mới & Kích Hoạt Quái| HostileZones
```

---

## 2. CHỈ ĐẠO CỤ THỂ CHO TỪNG PHÒNG BAN STUDIO

### 2.1. Phòng Thiết Kế Hệ Thống (Lead Systems Designer - `poe2_game_designer`)
- **Phân Bổ Quái Theo Hệ Sinh Thái (Ecosystem Matrix)**: Mỗi bản đồ ngoại vực phải có danh mục quái vật đặc thù từ 10 chủng tộc hoang dã ([monster_archetype_catalog.py](file:///c:/Projects/FreeExile/server/world/monster_archetype_catalog.py)).
- **Cơ Chế Bầy Đàn Chiến Thuật (Tactical Pack Sizes)**:
  - Quái thường (Common): Đi theo bầy 3–6 con, tấn công phối hợp áp sát.
  - Quái Tinh Anh (Magic/Rare): Sở hữu 1–3 từ ấn đặc thù (Huyết Lôi, Cuồng Nộ, Băng Giáp), buff hào quang cho đàn em.
  - Trùm Khu Vực (Unique Boss): Sở hữu thanh Poise lớn, chuỗi đòn đánh theo giai đoạn (Phase 1, Phase 2) và đòn đánh AoE tử thần buộc người chơi dùng Huyễn Ảnh Bộ né tránh.
- **Tiêu Chuẩn Target Dummy**: Mộc Nhân trong Hideout phải ghi nhận telemetry: DPS hiện tại, Sát thương cực đại (Max Hit), Số hit combo, Phá vỡ tư thế (Poise Broken) để người chơi tự do tinh chỉnh build.

### 2.2. Phòng Kiến Trúc Server (Lead Server Architect - `server_systems_architect`)
- **Cổng Kiểm Duyệt Sinh Quái Authoritative ([ZoneEngine](file:///c:/Projects/FreeExile/server/world/zone_engine.py))**:
  - Triển khai `can_spawn_hostile_monsters(zone_id)` và `validate_monster_spawn(zone_id, is_dummy)`.
  - Bất kỳ gói tin hay logic nào cố gắng spawn quái vật có thuộc tính sát thương/thù địch vào zone loại `SANCTUARY` hoặc `zone_player_hideout` đều bị Server reject lập tức.
- **Đồng Bộ Hóa Ranh Giới (Zone Transition Synchronization)**:
  - Khi người chơi rời Hideout qua Cổng Vạn Giới hoặc Bàn Tàn Đồ, Server khởi tạo session không gian độc lập, nạp đúng Spatial Grid và seed quái ngẫu nhiên.
  - Triệt tiêu hoàn toàn tình trạng quái dí theo người chơi qua cổng dịch chuyển.

### 2.3. Phòng Phát Triển Client (Lead Client Architect - `ios_client_engineer` & `web_client_engineer`)
- **Bộ Quản Lý Thực Thể Quái ([monster_system.js](file:///c:/Projects/FreeExile/client/webapp/js/engine/monster_system.js))**:
  - `initZoneMonsters(zoneId)` làm sạch mảng `activeMonsters` mỗi khi chuyển map.
  - Hideout chỉ nạp duy nhất `dummy_primal_shrine` (`isDummy: true`, `isNeutral: true`).
  - Tích hợp gọi `initZoneMonsters` tự động bên trong `teleportToZone(zoneId)` tại [worldmap_dungeons.js](file:///c:/Projects/FreeExile/client/webapp/js/ui/worldmap_dungeons.js).
- **Trải Nghiệm Thao Tác Chiến Đấu PoE2**:
  - Huyễn Ảnh Bộ (Evasion Roll): 0.25s i-frame chủ động hủy hoạt ảnh thừa (Animation Cancel) khi né đòn quái vật.
  - Chỉ báo HUD an toàn: Khi đứng trong Hideout/Sanctuary, biểu tượng Safe Zone hiển thị xanh dịu, tắt radar cảnh báo thù địch.

### 2.4. Khối Nghệ Thuật & Đồ Họa (Art & UI/UX Director - `art_ui_director`, `vfx_tech_artist`)
- **Visual Distinction (Tương Phản Giữa Bình Yên & Tàn Khốc)**:
  - Hideout: Ánh sáng êm dịu, khói sương bảng lảng, tàn tích trúc uyển/đỉnh phong thanh tịnh, không khí tôn nghiêm.
  - Ngoại Vực: Bùn lầy tăm tối, máu khô rỉ sét, sấm sét dị biến, hiệu ứng quái bò lên từ lòng đất hoặc xé toạc hư không khi người chơi tiến vào phạm vi kích hoạt.
- **Chỉ Báo Đòn Đánh (Telegraph FX)**: Vệt đỏ/cam cảnh báo hình nón hoặc hình tròn trước các đòn chém trọng kích của Trùm để người chơi phán đoán thời điểm né đòn.

### 2.5. Phòng Kiểm Thử & Đảm Bảo Chất Lượng (Head of QA - `qa_stress_tester`)
- **Bộ Test Khép Kín TDD ([test_zone_monster_spawning_rules.py](file:///c:/Projects/FreeExile/tests/unit/test_zone_monster_spawning_rules.py))**:
  - Kiểm tra tự động 100% kịch bản: Kiểm tra zone type, hàm chặn sinh quái, kiểm tra mã nguồn JavaScript client không chứa quái vật thù địch trong Safe Haven.
  - Đưa vào CI/CD pre-commit gate: Mọi vi phạm làm xuất hiện quái trong Hideout đều lập tức đánh trượt build.

### 2.6. Khối Bảo Mật & Sổ Cái Độc Lập (`ciso_agent`, `anti_dupe_economic_auditor`)
- **Bảo Vệ Tính Toàn Vẹn Không Gian An Toàn**:
  - Khóa chặt các lỗ hổng khai thác lỗi: Cấm người chơi lợi dụng ranh giới cổng an toàn để "bắn tỉa" quái vật ngoài map (Safe Spotting).
  - Đảm bảo rương đồ, giao dịch và chế tác trong Hideout diễn ra trong trạng thái tĩnh (Zero Threat State), không bị gián đoạn hay mất mát do bất kỳ sự kiện ngoại cảnh nào.

---

## 3. LỘ TRÌNH TRIỂN KHAI & ĐỐI SOÁT CHẤT LƯỢNG

| Giai Đoạn | Nhiệm Vụ Trọng Tâm | Đơn Vị Phụ Trách | Trạng Thái |
| :--- | :--- | :--- | :--- |
| **Pha 1** | Vá triệt để lỗi quái mọc trong Hideout/Sanctuary trên cả Client và Server | Server + Client Web/iOS | **HOÀN THÀNH** |
| **Pha 2** | Thiết lập TDD regression suite kiểm soát không gian an toàn | Autonomous QA | **HOÀN THÀNH** |
| **Pha 3** | Nâng cấp cơ chế bầy đàn, telegraph và i-frame chiến đấu ngoại vực | Systems Design + VFX Tech | **HOÀN THÀNH** |
| **Pha 4** | Hoàn thiện Bàn Tàn Đồ 6 Cổng Endgame & cơ chế Leash AI / Poise Break | Systems + Server + Client | **HOÀN THÀNH** |

---

## 4. BỘ CHỈ SỐ KIỂM CHỨNG TỰ ĐỘNG (VERIFICATION METRICS)
- **114/114 Automated Unit & E2E Tests PASS** (0 failures, 0 xfails):
  - [test_zone_monster_spawning_rules.py](file:///c:/Projects/FreeExile/tests/unit/test_zone_monster_spawning_rules.py): 14/14 PASS (Zone purity & authoritative spawner).
  - [test_target_dummy_and_telemetry.py](file:///c:/Projects/FreeExile/tests/unit/test_target_dummy_and_telemetry.py): 10/10 PASS (Dummy DPS rolling window, zero loot drops).
  - [test_monster_pack_and_affixes.py](file:///c:/Projects/FreeExile/tests/unit/test_monster_pack_and_affixes.py): 4/4 PASS (15-tier affix hierarchy & pack leader auras).
  - [test_telegraph_renderer.py](file:///c:/Projects/FreeExile/tests/unit/test_telegraph_renderer.py): 10/10 PASS (Attack cones, rings, lines, windup delays).
  - [test_dodge_and_evasion_iframe.py](file:///c:/Projects/FreeExile/tests/unit/test_dodge_and_evasion_iframe.py): 16/16 PASS (Huyễn Ảnh Bộ 0.25s i-frame invulnerability).
  - [test_monster_poise_and_leash.py](file:///c:/Projects/FreeExile/tests/unit/test_monster_poise_and_leash.py): 10/10 PASS (Poise stagger recovery & leash threshold tethering).
  - [test_poe2_zone_and_encounter_e2e.py](file:///c:/Projects/FreeExile/tests/e2e/test_poe2_zone_and_encounter_e2e.py): 50/50 PASS (Full-loop zone gating, portal transitions, combat feel).
- **Audit Vệ Sinh & Ma Trận Thiết Kế (Hygiene & Matrix Audit)**:
  - `check_code_and_doc_hygiene.py --strict`: **0 Hard Cap Violations** across 520 files.
  - `verify_game_design_matrix.py`: **100% IN SYNC** across DB, Code & Wiki Specs.

---
*Văn bản chỉ thị có hiệu lực tức thì từ ngày 01/10/2026 trên toàn bộ hệ thống phát triển FreeExile.*