heros_web/docs/roadmap.md

삼국지: 세 형제의 맹세 Roadmap

Initial Goal

Build a small complete tactical RPG loop that can grow into a longer Romance of the Three Kingdoms campaign:

1. Title screen
2. Prologue story
3. First battle briefing
4. First battle
5. Battle result and save point
6. Repeatable story -> camp -> battle expansion path

Current Slice

• Vite, TypeScript, and Phaser project foundation
• Cinematic title scene with an original Taoyuan Oath background, subtle motion, menu UI, and first-input audio
• Cinematic prologue pages with high-resolution story backgrounds, character portraits, non-black scene transitions, and scenario data
• File-based original soft stereo orchestral BGM loops for title, prologue, oath, militia, and battle-prep scenes
• First battle scene with a high-resolution battlefield background, large 12x12 tactical grid, high-detail pixel-style unit sprites, class and terrain affinity rules, ally/enemy roster tabs, unit detail stat panels, weapon/armor/accessory equipment growth, terrain-cost movement range preview, click-to-move unit movement, cursor-adjacent post-move command popup, right-click move cancel, right-click tactical menu, turn ending/reset, resonance bond tracking, and grayscale acted-unit feedback
• Second battle expansion with a larger scrollable map, mixed enemy AI behaviors, minimap navigation, camp progression, and save persistence
• Third battle expansion path toward Guangzong with a new battlefield, story bridge, campaign step persistence, and title continue support
• Fourth battle Guangzong main camp confrontation with Zhang Jue, expanded enemy formation, campaign persistence, and anti-Dong Zhuo setup
• Fifth battle Sishui Gate vanguard path starting the anti-Dong Zhuo chapter, with campaign persistence and title continue support
• Battle-specific camp conversations with selectable bond-growth choices from the first camp through the Xu Province camp
• Sixth battle Jieqiao relief route under Gongsun Zan, with a story bridge toward Tao Qian and Xu Province
• Seventh battle Xu Province rescue route against Cao Cao's vanguard, with Tao Qian entrusting Xu Province as the next endpoint
• Sortie preparation selection in camp so Liu Bei is required and optional allied officers can be deployed or benched before battle
• Xu Province camp recruitment for Jian Yong and Mi Zhu, including new strategist/quartermaster roles, bond dialogue, and selectable sortie participation
• Eighth battle Xiaopei supply-road defense, where the expanded Xu Province roster can be selected into battle and Lu Bu's refuge arc is foreshadowed
• Ninth battle Xuzhou gate night raid, opening Lu Bu's refuge and the internal instability that leads toward the loss of Xu Province
• Tenth battle Xuzhou breakout, covering Zhang Fei's mistake, the loss of Xu Province to Lu Bu, and the retreat toward Cao Cao's shadow
• Eleventh battle Xudu refuge road, opening Liu Bei's uneasy service under Cao Cao through a Yuan Shu remnant test battle
• Tactical sortie preparation panel with class role, named equipment, core stats, bond partner, and next-map terrain suitability for each deployable officer
• Flow verification script from title through the eleventh battle victory, recruit sortie selection, and camp save state

Next Steps

1. Continue into Liu Bei's tense service under Cao Cao, then build toward the break from Cao Cao
2. Add a chapter/progress view so long campaign arcs are easier to read between battles
3. Apply treasure equipment effects to damage, defense, recovery, and command rules
4. Add more recruitable officers as the campaign moves toward Cao Cao, Yuan Shao, Liu Biao, and Zhuge Liang
5. Keep expanding scenarios through the long campaign instead of treating the current slice as an ending

Content Direction

• Use original names, portraits, maps, and dialogue inspired by historical tactical RPGs.
• Keep copyrighted scripts, sprites, portraits, music, and maps out of the repository.
• Prefer data-driven scenarios so new chapters and battlefields can be added without rewriting scene code.
• Follow Liu Bei's long-form campaign arc: Yellow Turban suppression -> anti-Dong Zhuo era -> service under Gongsun Zan -> inheritance of Xu Province from Tao Qian -> loss of Xu Province to Lu Bu -> service under Cao Cao -> break from Cao Cao -> service under Yuan Shao -> refuge under Liu Biao -> recruitment of Zhuge Liang -> Red Cliffs -> securing Jing and Yi Provinces -> founding of Shu Han.