OpenClaw + ClawTeam + Superpowers Git Initialization

.openclaw/workspace/projects/lotto-game/PRD.md

@@ -0,0 +1,169 @@
+# Lô Tô Online — Product Requirements Document (PRD)
+
+---
+
+## 1. Vision
+
+Mang trải nghiệm **Lô Tô truyền thống miền Nam** lên nền tảng Zalo Mini App với phong cách hoài niệm tuổi thơ: giấy cũ ố vàng, rổ tre, túi vải đen đựng số, hạt gạo đặt lên vé. Người chơi tự tay bấm đặt hạt gạo — đúng sai tự chịu, giữ nguyên cảm giác hồi hộp của Lô Tô đời thực.
+
+**MVP đầu tiên** sẽ chạy trên **web (mobile-first)** để thử nghiệm, sau đó chuyển sang **Zalo Mini App** khi ổn định.
+
+---
+
+## 2. Target Users
+
+| Persona | Mô tả |
+|---|---|
+| Người Việt 20–45 tuổi | Lớn lên với Lô Tô, muốn hoài niệm |
+| Nhóm bạn / gia đình | Chơi giải trí online cùng nhau |
+| Casual gamer | Thích game đơn giản, may rủi, vui nhộn |
+
+---
+
+## 3. Core Game Rules (Lô Tô truyền thống)
+
+### 3.1 Vé Lô Tô
+
+- Bảng **3 hàng × 9 cột** = 27 ô
+- Mỗi hàng có đúng **5 ô số** + 4 ô trống
+- Số từ **1–90**, mỗi cột chứa số thuộc hàng chục tương ứng (cột 1: 1–9, cột 2: 10–19, …, cột 9: 80–90)
+- Mỗi vé có **15 số** duy nhất, không trùng
+
+### 3.2 Lượt chơi
+
+1. Hệ thống **lắc túi vải** → **bốc 1 viên số** ngẫu nhiên (1–90, không lặp)
+2. Hiển thị animation bốc số + **đọc số bằng giọng miền Nam**
+3. Người chơi có **1–5 giây** (cài đặt khi tạo phòng) để **tự bấm đặt hạt gạo** vào ô tương ứng
+4. Hết thời gian highlight → người hô đọc số tiếp, **không chờ** ai
+5. Người chơi vẫn có thể **đặt muộn** (theo trí nhớ) bất cứ lúc nào
+
+### 3.3 Điều kiện "Kinh" (Thắng)
+
+- Hoàn thành **1 hàng ngang** (5/5 ô số trong hàng đều có hạt gạo)
+- Hô **"Kinh!"** → hệ thống verify
+
+### 3.4 Verify & Phạt
+
+| Trường hợp | Kết quả |
+|---|---|
+| Tất cả hạt gạo đúng ô đã bốc | ✅ **Thắng** — nhận tiền thưởng từ tất cả người thua. Nếu có nhiều người cùng Kinh đúng ở một lượt, tiền thưởng được **chia đều** |
+| Có ≥1 hạt gạo đặt nhầm ô (ô chưa được bốc) | ❌ **Phạt** — đền bằng **mức cược của phòng** cho **mỗi** người chơi còn lại |
+
+### 3.5 Kết thúc ván
+
+- Khi có người **kinh hợp lệ** → ván kết thúc (hoặc kết thúc lượt bốc hiện tại để xét những người kinh cùng lúc)
+- Hoặc khi bốc hết 90 số mà chưa ai kinh → hoà (trả lại cược)
+
+---
+
+## 4. Features
+
+### 4.1 Lobby & Phòng chơi
+
+| Feature | Chi tiết |
+|---|---|
+| Lobby công khai | Danh sách phòng đang chờ, lọc theo mức cược |
+| Tạo phòng | Chủ phòng cài đặt: mức cược, thời gian highlight (1–5s), số người (2–8) |
+| Vào phòng | Click vào phòng trong lobby |
+| Chờ & sẵn sàng | Tất cả sẵn sàng → bắt đầu |
+| Rời phòng | Rời giữa chừng = bỏ cuộc, mất cược |
+
+### 4.2 Gameplay
+
+| Feature | Chi tiết |
+|---|---|
+| Lắc túi vải | Animation túi vải đen mềm mại + vật lý khi lắc |
+| Bốc số | Animation tay rút viên số từ túi ra |
+| Đọc số | Giọng đọc miền Nam truyền thống |
+| Đặt hạt gạo | Click vào ô trên vé → hạt gạo rơi xuống (animation) |
+| Đặt muộn | Vẫn bấm được sau khi hết highlight |
+| Hô kinh | Nút hô kinh khi nghĩ mình hoàn thành hàng |
+| Verify | Hệ thống kiểm tra → thắng hoặc phạt |
+
+### 4.3 Economy (Hệ thống tiền tệ)
+
+| Feature | Chi tiết |
+|---|---|
+| Đơn vị tiền | **"Đồng"** (xu ảo) |
+| Nhận đồng miễn phí | Sự kiện hàng ngày, nhiệm vụ, hoạt động |
+| Nạp tiền | Mua đồng bằng tiền thật (IAP / Zalo Pay) |
+| Cược | Đặt cược khi vào phòng |
+| Thắng | Nhận cược từ tất cả người chơi thua |
+| Phạt kinh sai | Trả mức cược × số người chơi còn lại |
+
+### 4.4 Profile & Xếp hạng
+
+| Feature | Chi tiết |
+|---|---|
+| Đăng nhập Zalo | Dùng Zalo account, lấy avatar + tên |
+| Profile | Tổng đồng, số ván thắng/thua, tỷ lệ thắng |
+| Lịch sử chơi | Danh sách ván đã chơi, kết quả, thời gian |
+| Bảng xếp hạng | Theo tổng đồng kiếm được |
+
+### 4.5 Social (Trong phòng)
+
+| Feature | Chi tiết |
+|---|---|
+| Chat | Nhắn tin trong phòng chơi |
+| Reactions / Emoji | Gửi emoji nổi lên màn hình |
+
+### 4.6 Audio
+
+| Feature | Chi tiết |
+|---|---|
+| Giọng đọc số | Giọng miền Nam, đọc từng số theo kiểu lô tô |
+| Nhạc nền | Vui tươi, gợi hoài niệm tuổi thơ |
+| SFX — đặt hạt gạo | Tiếng gạo rơi nhẹ |
+| SFX — đợi | Tiếng hò reo nhỏ, xì xào khi đợi |
+| SFX — kinh | La lên, pháo hoa, reo hò |
+| SFX — kinh sai | Tiếng thở dài, ồ tiếc nuối |
+
+---
+
+## 5. Art Direction (Phong cách hoài niệm)
+
+| Yếu tố | Chi tiết |
+|---|---|
+| **Nền** | Giấy cũ ố vàng, texture gỗ mộc |
+| **Vé lô tô** | Giấy carton cũ, viền tròn, chữ in mờ kiểu cũ |
+| **Túi số** | Vải đen mềm, animation vật lý khi lắc |
+| **Viên số** | Bi gỗ tròn, khắc số đỏ |
+| **Hạt gạo** | Hạt gạo trắng thật, có bóng đổ nhẹ |
+| **Rổ tre** | Đựng các viên số đã bốc |
+| **Font** | Handwritten / retro Việt Nam |
+| **Màu chủ đạo** | Nâu gỗ, vàng ố, đỏ đất, xanh lá cũ |
+
+---
+
+## 6. Platform & Technical Constraints
+
+| Hạng mục | Chi tiết |
+|---|---|
+| **MVP platform** | Web (mobile-first), responsive cho điện thoại |
+| **Production platform** | Zalo Mini App |
+| **Multiplayer** | Real-time (WebSocket) |
+| **Min players** | 2 |
+| **Max players** | 8 |
+| **Target device** | Mobile only |
+
+---
+
+## 7. Out of Scope (v1)
+
+- Tablet / Desktop optimized layout
+- Tournament mode
+- Friend list / invite via Zalo
+- Spectator mode
+- AI bot players
+- Multiple vé per player
+
+---
+
+## 8. Success Metrics
+
+| Metric | Target |
+|---|---|
+| Prototype hoàn chỉnh | Full gameplay + multiplayer + animation + audio |
+| Latency bốc số → hiện | < 200ms |
+| Animation FPS | ≥ 30fps trên mid-range phone |
+| Ván chơi trung bình | 3–8 phút |