How falconbhai/admin-managment works
Supreme Portal is a PHP staff-management portal for roleplay communities. Personnel enter through password or Discord login, then use permission-gated interview and administration workflows; staff use the operational hub for roster, attendance, leave, salary, chat, and notifications. The admin dashboard covers question-bank and notice administration, while audit logging spans database, local files, and optional Sheets sync. The README documents several capabilities whose implementation was not sampled, so those links are shown only where the documented entry point supports them; internal wiring is otherwise limited to the excerpts.
Main entry points: auditlogs/index.php Personnel hub · db.php Database connection · index.php Login gateway · audit_helper.php Audit logging
Components 24
Entry and Access
- Login gateway
index.php - Sessions and permissions
auth.php - Discord OAuth callback
discord_callback.php - Discord proxy
cloudflare_worker.js
Interview Operations
- Interview setup
setup.php - Interview session
interview.php - Supervisor dashboard
admin.php
Personnel Operations
- Personnel hub
auditlogs/index.php - Roster and ranks
auditlogs/modules/roster.php - Attendance
auditlogs/modules/attendance.php - Salary payouts
auditlogs/modules/salary.php - Leave requests
auditlogs/modules/loa.php - Staff chat
auditlogs/modules/chat.php - Notifications
auditlogs/modules/notifications.php
Shared Services
- System action handler
api.php - Chat handler
chat_api.php - Database connection
db.php - Portal database
- Audit logging
audit_helper.php - Sheets synchronization
google_sheets_helper.php
Other components
- Staff member
- Supervisor
- Google Sheets
- Discord API
Connections 31
- Staff member → Login gateway: signs in
- Supervisor → Login gateway: signs in
- Login gateway → Sessions and permissions: checks access
- Login gateway → Database connection: queries
- Login gateway → Audit logging: logs login
- Login gateway → Discord OAuth callback: starts OAuth
- Discord OAuth callback → Discord proxy: requests proxy
- Discord proxy → Discord API: exchanges token
- Discord OAuth callback → Database connection: resolves user
- Staff member → Interview setup: starts interview
- Interview setup → Interview session: begins session
- Supervisor → Supervisor dashboard: manages portal
- Supervisor dashboard → Database connection: reads and writes
- Supervisor dashboard → Audit logging: records actions
- Staff member → Personnel hub: opens hub
- Personnel hub → Sessions and permissions: checks permissions
- Personnel hub → Database connection: loads modules
- Personnel hub → Roster and ranks: renders page
- Personnel hub → Attendance: renders page
- Personnel hub → Salary payouts: renders page
- Personnel hub → Leave requests: renders page
- Personnel hub → Staff chat: renders page
- Personnel hub → Notifications: renders page
- Salary payouts → System action handler: submits decisions
- Staff chat → Chat handler: sends requests
- Chat handler → Database connection: reads and writes
- System action handler → Database connection: updates records
- Database connection → Portal database: queries
- Audit logging → Database connection: stores events
- Audit logging → Sheets synchronization: syncs events
- Sheets synchronization → Google Sheets: posts records