heros_web/docs/asset-backlog.md

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: 88 files after Batch 6.
• Portraits: 44 files after Batch 6.
• Unit sheets: 142 files, 71 complete base/action design pairs after Batch 6.
• 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