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
• Twelfth battle Xiapi outer siege, putting Liu Bei under Cao Cao's command against Lu Bu while preserving Liu Bei's independent motive and camp tension
• Thirteenth battle Xiapi final clash, ending Lu Bu's arc and opening the tension that will lead toward Liu Bei breaking from Cao Cao
• Fourteenth battle Cao Cao break route, adding Sun Qian as a recruitable strategist and making expanded sortie selection matter before Liu Bei heads toward Yuan Shao
• Fifteenth battle Yuan Shao refuge road, pushing Liu Bei through Cao Cao's pursuit into Yuan Shao's camp while preserving the six-officer sortie roster
• Sixteenth battle Liu Biao refuge road, adding Zhao Yun as a recruitable cavalry officer and forcing a seven-officer roster into a six-officer sortie choice
• Liu Biao camp visit events with one-time local choices, persisted completion, bond/gold/item rewards, and Wolong clue preparation before Zhuge Liang's recruitment arc
• Seventeenth battle Wolong visit road, gated by Wolong clue visits, opening the Longzhong approach and recruiting Zhuge Liang into the roster after victory
• Post-Wolong camp dialogue and visit events, including Zhuge Liang bond choices and Red Cliffs preparation clues
• Eighteenth battle Bowang ambush as the first Red Cliffs preparation battle, with a new large battlefield, Xiahou Dun's vanguard, mixed enemy AI, Zhuge Liang sortie recommendation, and post-battle camp events
• Nineteenth battle Changban refuge route, extending Red Cliffs preparation with a larger refugee-road battlefield, Cao Chun's cavalry pursuit, Zhao Yun survival pressure, and a sortie choice that highlights growing roster tradeoffs
• Twentieth battle Jiangdong envoy route, shifting sortie choice toward protecting Zhuge Liang and Sun Qian while opening the diplomatic path to Sun Quan and Zhou Yu
• Camp progress timeline tab that summarizes Liu Bei's long campaign arc, completed battles, current chapter, latest battle, and next major chapter
• Tactical sortie preparation panel with battle-specific sortie limits, recommended officers with reasons, class role, named equipment, core stats, bond partner, next-map terrain suitability, deployment preview, formation roles, active bond count, recruited-officer count, reserve roster summary, and readiness advice for each deployable officer
• Officer collection support in camp, including full roster status, selected/reserve/recommended markers, and post-battle reserve training growth for benched officers
• Treasure equipment effects wired into battle previews and resolution, including named weapon damage bonuses, defensive treasure mitigation, support recovery bonuses, turn-start charm recovery, and equipment-specific growth bonuses
• Flow verification script from title through the twentieth battle victory, recruit sortie selection, Liu Biao visit rewards, Zhuge Liang recruitment, Bowang/Changban/Jiangdong camp states, campaign timeline state, and camp save state

Next Steps

1. Continue the Red Cliffs preparation chapter into the Sun Quan/Zhou Yu parley and the first Red Cliffs confrontation
2. Add more recruitable officers as the campaign moves toward Red Cliffs, Jing Province, Yi Province, and Shu Han
3. Expand reserve training into explicit drill choices, class practice, and bond-focused camp assignments
4. Add a dedicated treasure/equipment management view so players can compare special effects and growth
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.