docs: enrich Doc/ with deep-dive technical contracts, traps, and handoff
This commit is contained in:
1 parent
3411e5b058
commit
fc262f8331
9 files changed
+502
-8
No files matched your search
+27
-8
@@ -21,14 +21,33 @@
|
||||
|
||||
## 📑 สารบัญเอกสารในโฟลเดอร์นี้
|
||||
|
||||
1. [**ARCHITECTURE.md**](./ARCHITECTURE.md)
|
||||
* สถาปัตยกรรมโครงสร้างโปรเจกต์ Wails v3, Frontend React 19, และ Backend Services ทั้ง 5 ตัว
|
||||
2. [**DEVELOPMENT_RULES.md**](./DEVELOPMENT_RULES.md)
|
||||
* กฎ 6 ข้อในการพัฒนา และบทเรียนจาก Horoyoi-san & โปรเจกต์เดิม (Ananta / GaC-hkrpg-go)
|
||||
3. [**UPDATER_SYSTEM.md**](./UPDATER_SYSTEM.md)
|
||||
* กลไกและวงจรชีวิตของระบบ Auto-Updater และ Local Build (Temp Isolation, Rollback, Cleanup)
|
||||
4. [**HISTORY_AND_LOGS.md**](./HISTORY_AND_LOGS.md)
|
||||
* ไทม์ไลน์และประวัติการพัฒนาตั้งแต่เริ่มรวม 2 Repos จนถึงฟีเจอร์ปัจจุบัน
|
||||
### 📌 เอกสารส่งต่อสถานะหลักและสัญญาทางเทคนิค (Core Handoff & Technical Contracts)
|
||||
1. [**G-LAUNCHER-HANDOFF.md**](./G-LAUNCHER-HANDOFF.md)
|
||||
* 🌟 **เอกสารหลักที่ต้องอ่านเป็นไฟล์แรกหลัง Compact:** สรุปสถานะงานแบบแยกชั้น (โค้ด/บิลด์/ดีพลอย/ยืนยันผล), กับดัก 5 ข้อที่ห้ามพลาด, และ Checklist ก่อน Commit
|
||||
2. [**updater-temp-lifecycle.md**](./updater-temp-lifecycle.md)
|
||||
* สัญญาทางเทคนิคของระบบอัปเดต 4 ขั้นตอน: การจัดการ Temp Workspace, การเลี่ยง Windows Process Lock, และระบบ Atomic Rollback
|
||||
3. [**wails3-ipc-bindings-contract.md**](./wails3-ipc-bindings-contract.md)
|
||||
* สัญญาการสื่อสาร Wails v3 IPC, ระบบ Type-Safe Bindings, และเหตุผลทางสถาปัตยกรรมที่ต้องทำ Go Backend ก่อน Frontend UI
|
||||
4. [**diff-patching-engine.md**](./diff-patching-engine.md)
|
||||
* กลไกการแพตช์ไฟล์ตัวเกมด้วย HPatchz (`.hdiff`), Zift (`.ziff`), การสกัดเครื่องมือจาก Embed Assets, และระบบ Safe Backup
|
||||
5. [**git-runtime-mingit.md**](./git-runtime-mingit.md)
|
||||
* สถาปัตยกรรม Portable MinGit: การตรวจจับและดาวน์โหลดอัตโนมัติโดยไม่ต้องใช้สิทธิ์ Administrator และการป้องกัน Terminal Hang
|
||||
6. [**game-selection-persistence.md**](./game-selection-persistence.md)
|
||||
* ระบบบันทึกพาธตัวเกมแบบทนทานต่อ Crash ด้วย Windows API `MoveFileEx` เพื่อป้องกันปัญหาไฟล์ JSON กลายเป็น 0 ไบต์
|
||||
7. [**thai-localization-mod.md**](./thai-localization-mod.md)
|
||||
* ระบบแปลภาษาไทย 2 ระดับ: Launcher UI (i18next) และ Game Modding (การแพตช์ไบต์ใน ExcelData พร้อมระบบกู้คืน)
|
||||
8. [**upstream-merge-audit.md**](./upstream-merge-audit.md)
|
||||
* ตารางแจกแจงที่มาของโค้ด (File Attribution Matrix) จากทั้ง Firefly Launcher และ Horoyoi-san
|
||||
|
||||
### 🏛️ เอกสารสถาปัตยกรรมและกฎการพัฒนาทั่วไป
|
||||
9. [**ARCHITECTURE.md**](./ARCHITECTURE.md)
|
||||
* สถาปัตยกรรมโครงสร้างโปรเจกต์ระดับสูง Wails v3, Frontend React 19, และ Backend Services ทั้ง 5 ตัว
|
||||
10. [**DEVELOPMENT_RULES.md**](./DEVELOPMENT_RULES.md)
|
||||
* กฎ 6 ข้อในการพัฒนา และบทเรียนจาก Horoyoi-san & โปรเจกต์เดิม (Ananta / GaC-hkrpg-go)
|
||||
11. [**UPDATER_SYSTEM.md**](./UPDATER_SYSTEM.md)
|
||||
* ภาพรวมและ Sequence Diagram ของระบบ Auto-Updater และ Local Build
|
||||
12. [**HISTORY_AND_LOGS.md**](./HISTORY_AND_LOGS.md)
|
||||
* ไทม์ไลน์และประวัติการพัฒนาตั้งแต่เริ่มรวม 2 Repos จนถึงปัจจุบัน
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in new issue
Block a user