New City Roleplay — UCP & Admin Panel

The New City Roleplay — UCP (User Control Panel) is a web-based application built for the New City Roleplay SA-MP server (NCRP).
It provides players and admins with a robust, installable platform to manage accounts, view updates, receive push notifications, and handle in-game integrations seamlessly.

This project is actively maintained and forms the backbone of the community management system for NCRP.

---

Key Features

• Discord OAuth (robust flow): Handles idempotent callbacks and duplicate requests from TWA environments.
• Installable PWA / TWA: Deep-link support with protocol_handlers for web+ncrp.
• JWT Authentication: Secure token-based auth for persistent sessions.
• Push Notifications: Category-based subscriptions (server_status, events, faction_updates, premium_offers).
• Admin Debug Console: Live log capture, XHR/fetch monitoring, runtime error reporting, safe evaluator, and command history.
• Mongo → MySQL Migration Utilities: Tools for converting legacy patch notes, roles, permissions, and routes into normalized MySQL w_ tables.
• Clear App Data Tools: Secure two-step reset for cached data and tokens.

---

Tech Stack

• Frontend: React, React Router, Tailwind CSS, Helmet, Vite/CRA
• Backend: Node.js, Express, Passport (Discord OAuth strategy), JWT
• Database: MySQL (primary), MongoDB (legacy migration)
• Push Service: Web Push (VAPID)
• Optional: Redis (recommended for scaling)
• Other: Service Workers & Web Manifest for PWA installability

---

Project Notes

• Originally designed for NCRP (New City Roleplay) as a personal project.
• Still actively maintained and updated with new server integrations.
• Includes admin panel modules for monitoring and management.

📅 First deployed: 2025 (actively maintained)