컷별 데이터 연계

COUNTER_DEBUG.md

@@ -0,0 +1,31 @@
+# Counter Debug Notes
+
+Date: 2026-04-14
+
+## Summary
+
+- Scene: `1-2위_ani_광역단체장`
+- Counter objects: `득표율01`, `득표율02`
+- API: `IKACounter.SetCounterNumberKey(KeyIndex, Number)`
+- Key index used for this test: `1`
+
+## Current test values
+
+- `득표율01` -> `30`
+- `득표율02` -> `20`
+
+## Verification
+
+- `tools/KarismaTcpProbe` supports `--test-counter`.
+- Verified against `127.0.0.1:30001`.
+- `OnSetCounterNumberKey` returned `RESULT_SUCCESS` for both `득표율01` and `득표율02`.
+
+## Runtime Mapping Update
+
+- `KarismaTornado3Adapter` now maps scene variables from `ElectionDataSnapshot` at send time.
+- Candidate text keys such as `후보명NN`, `정당명NN`, `득표수NN`, `득표율NN`, `순위NN`, `표차NN`, `득표차NN` are populated automatically.
+- Common scene keys such as `선거구명01`, `시도명01`, `개표율01`, `투표율01`, `전국투표율01` are populated automatically.
+- Animated templates with `ani` in the template id or name also send `IKACounter.SetCounterNumberKey(1, voteRate)` for each `득표율NN`.
+- `유확당NN` resolves to `유력.vrv`, `확정.vrv` or `확실.vrv`, and `당선.vrv`.
+- `후보사진NN` falls back to `Images/Photo/sampleNEW.png` when a candidate-specific photo is not found.
+- Party image keys such as `정당바NN`, `정당판NN`, `정당심볼NN`, `그룹NN` resolve from the `Images/Dang` asset folders when a matching party file exists.