# 📊 GAP ANALYSIS — Thương mại hóa NEON SURVIVORS

> Trạng thái đánh giá: bản hiện tại (v1.0 — core loop hoàn chỉnh, playable end-to-end).
> Mục tiêu: trả lời "thiếu gì để bán được tiền / lên store".

---

## 1. Điểm mạnh sẵn có (không phải làm lại)

| Hạng mục | Trạng thái |
|---|---|
| Core loop | ✅ Hoàn chỉnh: bắn tự động, XP, level-up choice, chest/evolution, boss, win/lose |
| Nội dung nền | 10 vũ khí + 10 tiến hóa, 13 passive, 8 nhân vật, 8 loại quái, 4 trùm |
| Meta progression | Vàng vĩnh viễn + 12 nâng cấp shop + unlock nhân vật theo thành tích |
| Kỹ thuật | Không dependency, offline-first, WebAudio tự sinh, test headless, dev tools |
| Platform-ready | Touch + desktop, responsive DPR, i18n VI/EN, localStorage |

→ Đây là mức **"vertical slice tốt"**. Khoảng cách tới sản phẩm thương mại nằm ở các nhóm dưới.

---

## 2. Khoảng trống — xếp theo độ chặn đường kinh doanh

### 🔴 Nhóm A — CHẶN BÁN (bắt buộc có trước khi thu tiền)

| # | Thiếu | Vì sao chặn | Effort |
|---|---|---|---|
| A1 | **Art thật thay programmer-art** | Emoji + hình vector là chuẩn prototype. Store screenshot/video quyết định 80% conversion. Đây là điểm yếu lớn nhất | Lớn (asset pack ~$50–300 hoặc commission $500–2000) |
| A2 | **Âm nhạc/nhạc stage** | Loop generative 1 track duy nhất → nghe chán sau 10 phút. Cần 3–5 track (menu/stage/boss) + stingers thắng/thua | Trung ($20 license pack hoặc commission) |
| A3 | **Đủ nội dung để chơi lại (replayability)** | 1 stage duy nhất × 20 phút × cùng timeline mỗi lần = người chơi hết việc sau 2–3 giờ. Genre chuẩn cần ≥3 stage + endless + độ khó leo thang | Trung — code sẵn chỗ cắm (SPAWN_TABLE/BOSSES là data) |
| A4 | **Tutorial onboarding** | Hiện 1 dòng toast. Người mới không hiểu evolution/chest/meta → churn ngay phút đầu | Nhỏ |
| A5 | **Pháp lý**: Privacy Policy, EULA, tuổi (IARC), kiểm tra trùng tên "Neon Survivors" | Store từ chối duyệt nếu thiếu; trademark trùng bị gỡ | Nhỏ (giấy tờ) + phí nền tảng |

### 🟠 Nhóm B — QUYẾT ĐỊNH DOANH THU (chọn mô hình thì làm)

Tùy mô hình:

**Premium (Steam, $4.99 — mô hình của chính Vampire Survivors):**
| # | Thiếu | Ghi chú |
|---|---|---|
| B1 | Steam wrapper (Tauri/Electron) + Steamworks: achievements, cloud save, overlay | Cần tài khoản Steam partner ($100/app) |
| B2 | **Achievements hệ thống trong game** (30–50 thành tựu gắn unlock) | Hiện chưa có khung achievement |
| B3 | DLC pipeline: bộ nhân vật/stage/cosmetic bán thêm | Cần tách data content khỏi code (đang hard-code JS) |
| B4 | **Mod support** (Workshop) | VS sống dai nhờ mod; yêu cầu data-driven + sandbox loader |

**F2P (mobile/web portal):**
| # | Thiếu | Ghi chú |
|---|---|---|
| B5 | **Rewarded ads** (xem quảng cáo: hồi sinh, x2 vàng, reroll thêm) | Nguồn thu chính F2P; tích AdMob/AppLovin |
| B6 | IAP: gói khởi đầu, skin nhân vật/vũ khí, bỏ quảng cáo | Cần cosmetic system (hiện không có skin layer) |
| B7 | Daily quests + daily login + mission chain | Retention D1/D7 |
| B8 | Battle pass mùa (nếu đủ scale) | Chỉ làm khi có DAU |

### 🟡 Nhóm C — GIỮ NGƯỜI CHƠI & VẬN HÀNH

| # | Thiếu | Ghi chú |
|---|---|---|
| C1 | **Leaderboard** (daily-seeded run, global + bạn bè) | Cần backend nhẹ — hợp nhất: Cloudflare Workers + KV/D1 (đang dùng CF tunnel sẵn) |
| C2 | Cloud save / account | Cùng backend ở trên; cần chống sửa save (checksum/signed) |
| C3 | Analytics funnel (install→phút 5→churn), remote config để tune balance không cần update | Tự host hoặc PostHog/Firebase |
| C4 | Crash reporting (Sentry), profiling budget 60fps mobile low-end | |
| C5 | Run history / stats cá nhân theo nhân vật-stage, best từng loại | |
| C6 | Live-ops cadence: cập nhật nhân vật/vũ khí 4–8 tuần/lần | Quy trình, không phải code |

### 🟢 Nhóm D — CHẤT LƯỢNG & TIỆN NGHI (nâng cấp dần)

| # | Thiếu | Ghi chú |
|---|---|---|
| D1 | **Gamepad support + remap phím** | Genre này kỳ vọng cao; Gamepad API |
| D2 | Viewport culling + object pooling | Hiện render mọi entity kể cả ngoài màn hình; GC pressure do tạo object liên tục — quan trọng cho mobile low-end |
| D3 | Seeded RNG | Math.random hiện tại — chặn daily-challenge/replay/anti-cheat |
| D4 | Fullscreen toggle, khóa hướng ngang mobile, PWA manifest | |
| D5 | Accessibility: colorblind palette, giảm motion, chữ to | |
| D6 | Save slot + export/import code | |
| D7 | Bản dịch thêm (ES/PT-BR/ZH/JA...) — khung i18n sẵn | |
| D8 | Interactive props trong trận (đèn phá rơi vàng, bẫy môi trường) | Genre-standard juice |

---

## 3. Roadmap đề xuất

```
PHASE 1 — "Store-ready core"          (2–4 tuần dev)
├─ D2 culling + pooling (perf mobile)
├─ D1 gamepad + D4 fullscreen/PWA
├─ A4 tutorial tương tác run đầu
├─ A3 stage #2/#3 (biome + boss riêng) + Endless + Difficulty grade
├─ B2 khung achievements (30 cái) — dùng chung cho Steam sau này
├─ C5 run history
└─ D3 seeded RNG (chuẩn bị daily)

PHASE 2 — "Thu tiền được"             (song song art/audio)
├─ A1+A2 art pack + soundtrack
├─ A5 pháp lý + chọn model (premium vs F2P)
├─ Steam build (B1) HOẶC mobile build (B5–B7)
└─ C3 analytics + remote config

PHASE 3 — "Sống lâu"
├─ C1+C2 leaderboard/cloud-save (Cloudflare Workers)
├─ B3 DLC / B8 pass
├─ B4 mod support
└─ C6 live-ops nhịp 4–8 tuần
```

Chi phí nền tảng tham khảo: Steam $100/app · Google Play $25 một lần · Apple $99/năm · Web portal (Poki/CrazyGames): miễn phí, chia doanh thu quảng cáo.

---

## 4. Tôi có thể code NGAY trong repo này (không cần asset ngoài)

1. **D2** Viewport culling + object pool cho Particle/Proj (perf)
2. **D1** Gamepad API + remap phím
3. **A3** Stage system: 2 biome mới + Endless mode + difficulty grade (data-driven sẵn)
4. **B2** Khung achievements + popup + gắn unlock (dùng luôn điều kiện cond của nhân vật)
5. **D3** Seeded RNG + **Daily Challenge** (seed theo ngày UTC, lưu best local)
6. **A4** Tutorial tương tác (mốc: di chuyển → lên cấp → chọn → mở rương → gặp trùm)
7. **C5** Run history + trang stats
8. **D6** Export/import save code (base64)
9. **D8** Props phá được (đèn đá rơi vàng/chicken)
10. **D4** Fullscreen + PWA manifest

> Nói "làm phase 1" (hoặc liệt kê số) là tôi triển khai tiếp.