Files
heros_web/docs/asset-backlog.md

272 lines
8.7 KiB
Markdown

# Asset Backlog
This backlog tracks sequential visual asset expansion for story images, portraits,
and unit sheets. Counts are refreshed at the start of each batch, then the batch is
generated, connected, validated, built, flow-tested, committed, and pushed.
## Current Baseline
- Story images: 96 files after Batch 7.
- Portraits: 49 files after Batch 7.
- Unit sheets: 148 files, 74 complete base/action design pairs after Batch 7.
- Target direction:
- Story: about 5 images per major campaign chapter across 65 campaign stages.
- Portraits: one portrait for every important `scenario.ts` speaker.
- Units: 100+ complete unit designs, each with a base 4x4 sheet and an actions 4x4 sheet.
## Batch 1 Priority
Status: complete and ready for build/flow verification.
The first batch targets the most repeated story backgrounds and the highest-frequency
missing portrait speakers.
### Story
- `37-yizhou-luo-road-ambush.png`
- `38-yizhou-luo-road-supply-train.png`
- `39-nanzhong-captures-jungle-net.png`
- `40-nanzhong-captures-river-ford.png`
- `41-wandering-night-camp.png`
- `42-wandering-river-crossing.png`
- `43-northern-qishan-snow-march.png`
- `44-northern-wei-fortress.png`
### Portraits
- `fa-zheng.png`
- `jian-yong.png`
- `pang-tong.png`
- `mi-zhu.png`
- `zhou-yu.png`
- `yi-ji.png`
- `yan-yan.png`
### Units
- `unit-wei-archer-veteran.png` + `unit-wei-archer-veteran-actions.png`
- `unit-wu-cavalry-elite.png` + `unit-wu-cavalry-elite-actions.png`
- `unit-nanman-shaman-ember.png` + `unit-nanman-shaman-ember-actions.png`
## Next Backlog Pool
- Story variants: `story-yizhou`, `story-jingzhou-crisis`,
`story-fan-castle-flood`, `story-jieting-crisis`, `story-chengdu-surrender`,
`story-anti-dong`.
- Portraits: `wu-yi.png`, `li-yan.png`, `ma-chao.png`, `gong-zhi.png`,
`huang-zhong.png`, `cao-cao.png`, `wei-yan.png`, `ma-dai.png`, `meng-huo.png`.
- Units: faction/class variants for Shu, Wei, Wu, Nanman, rebel remnants, and
named-general alternates until the complete design count reaches 100+.
## Batch 2 Priority
Status: complete and ready for build/flow verification.
### Story
- `45-yizhou-council-at-river.png`
- `46-yizhou-mountain-gate.png`
- `47-jingzhou-crisis-watchtower-alarm.png`
- `48-jingzhou-crisis-refugee-court.png`
- `49-fan-castle-flood-rising-water.png`
- `50-fan-castle-flood-siege-engines.png`
- `51-jieting-crisis-supply-line.png`
- `52-jieting-crisis-mountain-camp.png`
- `53-chengdu-surrender-hall.png`
- `54-anti-dong-hulao-pass.png`
### Portraits
- `wu-yi.png`
- `li-yan.png`
- `ma-chao.png`
- `gong-zhi.png`
- `huang-zhong.png`
- `cao-cao.png`
- `wei-yan.png`
- `meng-huo.png`
### Units
- `unit-shu-infantry-guard.png` + `unit-shu-infantry-guard-actions.png`
- `unit-shu-cavalry-white.png` + `unit-shu-cavalry-white-actions.png`
- `unit-wei-cavalry-iron.png` + `unit-wei-cavalry-iron-actions.png`
- `unit-wu-archer-river.png` + `unit-wu-archer-river-actions.png`
## Batch 3 Priority
Status: complete and ready for build/flow verification.
The early-game unit sheets should be remastered because the newer generated units
have a stronger silhouette, cleaner 4x4 framing, and better action readability.
Keep the existing texture keys so code paths and saved scenarios continue to work.
### Unit Remasters
- `unit-liu-bei.png` + `unit-liu-bei-actions.png`
- `unit-guan-yu.png` + `unit-guan-yu-actions.png`
- `unit-zhang-fei.png` + `unit-zhang-fei-actions.png`
- `unit-rebel.png` + `unit-rebel-actions.png`
- `unit-rebel-archer.png` + `unit-rebel-archer-actions.png`
- `unit-rebel-cavalry.png` + `unit-rebel-cavalry-actions.png`
- `unit-rebel-leader.png` + `unit-rebel-leader-actions.png`
### Remaining Portraits
- None. All currently mapped named speakers have portrait coverage after Batch 4.
## Batch 4 Priority
Status: complete. Image dimensions, unit base/action pairs, `pnpm build`, and `pnpm verify:flow` passed.
This batch finishes the named-speaker portrait backlog, adds portrait variants that
are actually selected in story scenes, and continues expanding high-repeat story
backgrounds and class/faction unit variety.
### Story
- `55-yellow-pursuit-ambush.png`
- `56-yellow-pursuit-village-relief.png`
- `57-wolong-straw-boats.png`
- `58-red-cliffs-wind-prayer.png`
- `59-yiling-baidi-mountain-retreat.png`
- `60-maicheng-isolation-snow-road.png`
- `61-yiling-fire-attack-riverbank.png`
- `62-hanzhong-rain-night-watch.png`
- `63-weishui-northbank-cavalry-screen.png`
- `64-nanzhong-forest-council.png`
### Portraits
- `ma-dai.png`
- `liu-bei-campaign.png`
- `guan-yu-campaign.png`
- `zhang-fei-campaign.png`
- `zhuge-liang-campaign.png`
### Units
- `unit-shu-spearman-veteran.png` + `unit-shu-spearman-veteran-actions.png`
- `unit-wei-strategist-blue.png` + `unit-wei-strategist-blue-actions.png`
- `unit-wu-officer-river.png` + `unit-wu-officer-river-actions.png`
- `unit-nanman-officer-warlord.png` + `unit-nanman-officer-warlord-actions.png`
## Batch 5 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed. Code connection uses the existing
story, portrait, and unit variant discovery paths.
This batch expands the most repeated story backgrounds, adds variants for major
late-campaign speakers, and strengthens low-variant unit families.
### Story
- `65-yizhou-luo-road-cliff-fortress.png`
- `66-yizhou-luo-road-mountain-scouts.png`
- `67-nanzhong-captures-bamboo-gorge.png`
- `68-nanzhong-captures-river-night-camp.png`
- `69-wandering-market-shelter.png`
- `70-wandering-cold-mountain-pass.png`
- `71-northern-supply-valley.png`
- `72-northern-mountain-war-council.png`
- `73-red-cliffs-chain-smoke.png`
- `74-wolong-river-strategy.png`
- `75-jingzhou-crisis-river-watchtowers.png`
- `76-fan-castle-flood-river-breach.png`
### Portraits
- `zhao-yun-campaign.png`
- `jiang-wei-campaign.png`
- `sima-yi-campaign.png`
- `cao-cao-campaign.png`
- `ma-chao-campaign.png`
- `huang-zhong-campaign.png`
- `wang-ping-campaign.png`
### Units
- `unit-shu-archer-veteran.png` + `unit-shu-archer-veteran-actions.png`
- `unit-shu-strategist-white.png` + `unit-shu-strategist-white-actions.png`
- `unit-wei-officer-iron.png` + `unit-wei-officer-iron-actions.png`
- `unit-wu-infantry-river.png` + `unit-wu-infantry-river-actions.png`
- `unit-rebel-archer-veteran.png` + `unit-rebel-archer-veteran-actions.png`
## Batch 6 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed. `sun-qian-campaign.png` was
regenerated once for clearer character differentiation. Code connection uses the
existing story, portrait, and unit variant discovery paths.
This batch expands mid-campaign and late northern-campaign story backgrounds,
adds campaign variants for supporting speakers, and improves the lowest-count
unit families.
### Story
- `77-xuzhou-gate-council.png`
- `78-xuzhou-night-evacuation.png`
- `79-anti-dong-coalition-council.png`
- `80-anti-dong-night-assault.png`
- `81-chengdu-surrender-court.png`
- `82-chengdu-outer-gate-surrender.png`
- `83-wudu-yinping-cloud-road.png`
- `84-chencang-siege-fortress-standoff.png`
- `85-chencang-siege-engineering-camp.png`
- `86-weishui-camps-logistics.png`
- `87-weishui-camps-night-alarm.png`
- `88-lucheng-pursuit-valley-road.png`
### Portraits
- `mi-zhu-campaign.png`
- `jian-yong-campaign.png`
- `sun-qian-campaign.png`
- `pang-tong-campaign.png`
- `fa-zheng-campaign.png`
- `meng-huo-campaign.png`
### Units
- `unit-wu-strategist-river.png` + `unit-wu-strategist-river-actions.png`
- `unit-nanman-infantry-jungle.png` + `unit-nanman-infantry-jungle-actions.png`
- `unit-rebel-cavalry-veteran.png` + `unit-rebel-cavalry-veteran-actions.png`
- `unit-rebel-leader-warlord.png` + `unit-rebel-leader-warlord-actions.png`
- `unit-shu-officer-council.png` + `unit-shu-officer-council-actions.png`
## Batch 7 Priority
Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed.
This batch keeps pressure on the highest-repeat story backgrounds, adds campaign
variants for mid-campaign supporting officers, and moves the unit design count
toward the 100+ complete-pair target.
### Story
- `89-yizhou-luo-road-hidden-bridge.png`
- `90-nanzhong-captures-monsoon-ravine.png`
- `91-wandering-snow-shrine.png`
- `92-northern-supply-depot.png`
- `93-yizhou-mountain-pass-command-post.png`
- `94-red-cliffs-dawn-aftermath.png`
- `95-yellow-pursuit-rural-crossroads.png`
- `96-wolong-autumn-study.png`
### Portraits
- `ma-liang-campaign.png`
- `yi-ji-campaign.png`
- `gong-zhi-campaign.png`
- `wu-yi-campaign.png`
- `yan-yan-campaign.png`
### Units
- `unit-wei-infantry-shield.png` + `unit-wei-infantry-shield-actions.png`
- `unit-wu-archer-naval.png` + `unit-wu-archer-naval-actions.png`
- `unit-nanman-officer-bronze.png` + `unit-nanman-officer-bronze-actions.png`