# नया update: Bot + Avatar + Voice

इस ZIP में public matchmaking के automated opponents, 10 नए original avatars,
और 10 quick voice clips शामिल हैं। **पूरा विवरण:** `BOTS-AVATAR-VOICE-HINDI.md`।
अपग्रेड के लिए `npm run migrate` चलाना जरूरी है। यह केवल free virtual-chip game है।

---

> **नई सुविधा:** अब Royal Teen Patti में Public Room List भी है। Boot 50/100/250/500/1000/2000 chips चुनकर कोई भी registered player बिना code normal table join कर सकता है। पूरी जानकारी: [PUBLIC-ROOMS-HINDI.md](PUBLIC-ROOMS-HINDI.md)।

# Royal Teen Patti — Hindi mein shuru karein

Yeh **sirf Teen Patti** ka React + Node.js + PostgreSQL source-code project hai. Ismein free virtual chips, private rooms, OTP login, unique Game ID aur owner dashboard hai. Abhi **native Android APK nahi** hai; Android Chrome mein website se PWA install ki ja sakti hai, jab site HTTPS par chal rahi ho.

## 1. Owner kaise login karega?

1. Node.js 22+, npm, PostgreSQL 16+ install karein. PostgreSQL ke liye `docker compose up -d postgres` use kar sakte hain.
2. `.env.example` ko `.env` copy karein. Ismein `DATABASE_URL`, random `OTP_PEPPER`, `WEB_ORIGIN`, SMTP email ki details bharein.
3. Project directory mein ye commands chalayein:

```bash
npm install
npm run migrate
OWNER_EMAIL='your@email.com' OWNER_PASSWORD='your-very-long-password' npm run seed:owner
npm run dev:api
```

4. Alag terminal mein `npm run dev:web` chalayein. Browser mein `http://localhost:5173` open karein.
5. Owner ka email/password jo `seed:owner` mein set kiya hai, usi se login karein. Left side **Owner Dashboard** dikhega.
6. `seed:owner` dobara same email ke liye na chalayein. Owner username/password ZIP mein pehle se rakhe hue nahi hain.

**Important:** Sirf local PC se phone testing ke liye HTTPS/domain aur proper networking chahiye. `localhost:5173` phone par PC ko point nahi karta.

## 2. Dost register aur login kaise karenge?

- Full name, mobile number (`+919876543210` format) aur email dalenge.
- Email par **6 digit OTP** aayega (5 minute valid, 5 wrong attempts max, 60 second resend cooldown).
- Registration hone par **5,000 welcome free chips** aur stable **Game ID `TP...`** milega.
- OTP se login kar sakte hain; optional password bhi hai. Real SMS OTP ke liye alag Twilio configuration chahiye.

## 3. Game kaise khelenge?

- Owner ya friend **Create Room → Private → Teen Patti** select kare.
- Room code doston ko bheje; kam se kam 3 aur zyada se zyada 6 players.
- Players **Add to Table** se apne free wallet chips table par le aayein.
- Sab **I'm Ready** dabayein aur room host **Start Round** kare.
- Blind, See Cards, Chaal, Pack, Show aur Side Show buttons use karein.
- Wallet chips se table par beech round mein aur chips la sakte hain. Jo chips pot mein bet ho chuke hain, unko round khatam hone se pehle nahi nikal sakte.
- **Withdraw to Wallet** sirf unused virtual table chips ke liye hai. Yeh bank/UPI cash withdrawal nahi hai.

## 4. Chips khatam ho gaye to?

- Pehle **Daily / Weekly / Lucky Spin / Free Refill** try karein.
- Wallet page ya match table ke neeche **Request free chips from owner** mein `5000` jaisi amount bharein, phir Send to Owner.
- Request in-game Owner Dashboard mein dikhegi; agar Telegram bot configured hai to owner ko Telegram message bhi aayega.
- Player **Copy Telegram message** se apna Game ID copy kar sakta hai, aur `OWNER_TELEGRAM_USERNAME` set hone par **Open Owner Telegram** milega.
- Owner request **Approve** ya **Reject** karega. Approve hone par wallet balance turant update hoga. Player phir Add to Table karega.
- Ye **free promotional chips** hain. Na player cash dega, na cash withdraw karega.

## 5. Owner kisi ka balance kaise edit karega?

Owner Dashboard → **Players** → Game ID (`TP100001` jaisa) se Search → player Select → **Required Reason** fill kare.

- `Adjustment Amount = 5000` + Apply: wallet mein 5,000 free chips badhenge.
- `Adjustment Amount = -1000` + Apply: wallet se 1,000 chips kam honge, agar kaafi balance ho.
- **Set Exact Wallet Balance = 10000** + **Overwrite Wallet**: wallet 10,000 ho jayega, chahe pehle kuch bhi tha.
- VIP +500, Block/Unblock aur recent transactions/login history bhi yahin hain.
- **Table stack aur pot** ko overwrite nahi kiya jata; woh alag hisab hai. Har admin change ka audit log save hota hai.

## 6. Telegram notification system kaise configure karein?

`.env` file mein:

```dotenv
OWNER_TELEGRAM_USERNAME=YourTelegramUsername
TELEGRAM_BOT_TOKEN=
TELEGRAM_OWNER_CHAT_ID=
```

- Direct contact ke liye sirf owner username kafi hai; player message copy karke Telegram par bhej sakta hai.
- Automatic alert chahiye to Telegram par BotFather se apna bot banayein, owner apne bot ko `/start` bheje aur bot token + owner chat ID configure karein.
- Telegram sirf notification bhejega. Chip approval **Owner Dashboard** mein hogi.
- Token kabhi kisi dost se share na karein.

## 7. Owner cheating kaise check karega?

- Owner Dashboard → **Live Rooms** mein players, pot, phase aur **Actions** log dekhein.
- **Round History** mein har completed round ke cards, winner aur betting actions dikhte hain.
- **Safety Flags** mein unusual win rate, frequent refill jaise indicators milte hain; yeh cheat ka final proof nahi hain.
- Normal table par Owner khud player bankar bhi khel sakta hai, lekin dusre players ke hidden cards active round mein nahi dekhega.
- Optional **Owner Spectator Mode** sirf private room mein sabki informed consent ke saath, owner ke round mein na khelne par milta hai.

## 8. Game online karne ke pehle

- Production SMTP, HTTPS, secure database/passwords, Nginx WebSocket proxy, backup, device tests, Node dependency install aur `npm run build` verify karein.
- `docs/DELIVERY_STATUS.md` mein unverified cheezein padh lein.
- Poore project ka owner handbook: **OWNER-PLAYBOOK-HINDI.md**.