🔮 Psychic Chat & Call Platform

Connect. Consult. Transform.

A complete white-label solution connecting users with psychics for real-time chat and audio/video calls.
Includes credit-based payments, automated spam detection, 3-strike suspension system, and 75/25 revenue split.

🌐 Live Demo • 📚 API Docs • 🐛 Report Bug • 💡 Request Feature

---

📋 Table of Contents

• ✨ Features
• 🏗️ Architecture
• ⚙️ Tech Stack
• 📸 Screenshots
• 🚀 Quick Start
• 📁 Project Structure
• 🔧 Environment Variables
• 💳 Payment Flow
• 🔒 Security Features
• 📡 Real-time Events
• 🧪 Testing
• 📈 Deployment
• 🤝 Contributing
• 📄 License
• 🙏 Acknowledgments

---

✨ Features

👤 User Features

Feature	Description
🔐 Register/Login	JWT authentication with refresh tokens
💰 Credit Purchase	Stripe integration (cards, Apple Pay, Google Pay)
🔮 Browse Psychics	Filter by category, rating, price, availability
💬 Real-time Chat	Socket.io messaging with typing indicators
📞 Audio/Video Calls	Twilio Voice & Video API integration
⭐ Rate & Review	Post-session ratings (1-5 stars)
📜 History	Complete chat/call transaction history
🎁 Free Credits	5 free credits on signup (anti-fraud)

🔮 Psychic Features

Feature	Description
📝 Professional Profile	Bio, specialties, hourly rates, profile photo
🟢 Availability	Manual online/offline + auto-away
💬 Instant Messaging	Real-time chat with multiple users
📞 Call Management	Accept/reject/end calls
📊 Earnings Dashboard	Daily/weekly/monthly analytics
💸 Withdrawals	75% platform / 25% psychic payout

👨‍💼 Admin Features

Feature	Description
✅ Psychic Approval	Approve/reject applications with KYC
👥 User Management	View, edit, block, suspend users
🔮 Psychic Management	Manage profiles, adjust rates, force offline
⚙️ Commission Settings	Dynamic platform commission (default 75/25)
💳 Transaction Viewer	View all platform transactions
🚨 Security Dashboard	Auto-block logs, violation history

🔒 Security & Anti-Spam

Feature	Description
🔗 Link Detection	Automated regex detection for emails/phones/URLs
⚠️ 3-Strike System	Warning → 1h mute → 24h mute → Permanent block
🛡️ Auto-block	After 3 violations across any session
👁️ Chat Monitoring	Real-time admin surveillance
🚫 Spam Protection	Rate limiting per user (20 msg/min)

---

🏗️ Architecture