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: 54 files after Batch 2.
• Portraits: 26 files after Batch 2.
• Unit sheets: 114 files, 57 complete base/action design pairs after Batch 3.
• 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

• ma-dai.png