How rroix/avenue-guard-gd-avenue works
Avenue Guard is a Discord-centered community operations system, with public website and private Staff Portal interfaces sharing durable workflows and records. The main journey is a member submitting a level request, staff reviewing it, and positive outcomes entering recommendation and outreach operations. The map also preserves documented appeals, applications, rewards, tickets, moderation, telemetry, and recovery capabilities. Some capabilities are represented by their documented subsystem directories because their implementation was not sampled; edges are limited to indexed references or README statements.
Main entry points: main.py Discord Bot · staff_portal.py Staff Portal API · RequestLevels.py Level Requests · priority_system.py Priority and Outreach
Components 24
Community Interfaces
- Discord Bot
main.py - Public Website
- Staff Portal API
services/staff_portal.py
Community Workflows
- Level Requests
cogs/RequestLevels.py - Request Validation
services/request_validation.py - Review Operations
services/request_reviews.py - Priority and Outreach
services/priority_system.py - Creator Points
services/creator_points.py - Punishment Appeals
services/punishment_appeals.py - Weekly Rewards
cogs/Tracking.py - Help and Tickets
cogs/Help.py - Moderation and Forums
cogs/Mod.py
Staff Operations
- Staff Applications
services/staff_portal.py - Staff Operations
cogs/Operations.py - Telemetry and Audits
services/impact.py - Public Status Data
utils/keepalive.py
Runtime and State
- Turso / libSQL
utils/db.py - Database Worker
utils/libsql_worker.py - Durable Delivery
utils/outbox.py - Workflow State Rules
utils/workflows.py - Staff Authorization
utils/staff_auth.py - Application Startup
main.py
Other components
- Members and Staff
- Geometry Dash Data
Connections 24
- Members and Staff → Discord Bot: use commands
README.md - Members and Staff → Public Website: use services
README.md - Members and Staff → Staff Portal API: staff access
README.md - Discord Bot → Level Requests: routes requests
README.md - Level Requests → Request Validation: uses validation
cogs/RequestLevels.py - Level Requests → Review Operations: uses review logic
cogs/RequestLevels.py - Level Requests → Geometry Dash Data: checks levels
README.md - Review Operations → Priority and Outreach: positive outcomes queue
README.md - Priority and Outreach → Creator Points: uses evidence
services/priority_system.py - Staff Portal API → Priority and Outreach: manages queue
services/staff_portal.py - Public Website → Punishment Appeals: submits appeals
README.md - Staff Portal API → Punishment Appeals: supports review
services/staff_portal.py - Staff Portal API → Staff Applications: supports applications
README.md - Discord Bot → Weekly Rewards: tracks activity
README.md - Discord Bot → Help and Tickets: handles support
README.md - Discord Bot → Moderation and Forums: provides tools
README.md - Discord Bot → Telemetry and Audits: records activity
README.md - Application Startup → Turso / libSQL: initializes storage
main.py - Turso / libSQL → Database Worker: delegates driver work
utils/db.py - Staff Portal API → Staff Authorization: checks capabilities
services/staff_portal.py - Staff Portal API → Workflow State Rules: records workflows
services/staff_portal.py - Discord Bot → Durable Delivery: uses delivery queue
main.py - Discord Bot → Public Status Data: serves public status
main.py - Staff Operations → Turso / libSQL: manages recovery