TitanBot/roadmap.txt at main · codebymitch/TitanBot · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
TitanBot Roadmap / Structure Overview

Goal
- Keep this as a practical map of the codebase.
- Show main folders and important files only (not every file).

Root
- index.js                    -> process entry point
- package.json                -> scripts, dependencies, project metadata
- README.md                   -> setup and usage docs
- SECURITY.md                 -> security policy
- scripts/                    -> utility/maintenance scripts (backup, restore, migrate)
- logs/                       -> runtime log output
- src/                        -> main bot application code
- tests/                      -> unit tests (run via npm test)

src/
- app.js                      -> creates client, initializes systems, starts web server

- commands/                   -> slash command categories by feature
  - Core/                     -> help, ping, stats, uptime, invite
  - Community/                -> application management + dashboards
  - Logging/                  -> audit logging + event management
    - modules/logging_dashboard.js
    - modules/logging_setchannel.js
  - Ticket/                   -> support ticket system + dashboard
  - ServerStats/              -> server stats channel system
  - Economy/                  -> economy system
  - Moderation/               -> moderation/admin commands
  - Verification/             -> member verification flow
  - JoinToCreate/             -> dynamic voice channel creation
  - Reaction_roles/           -> automatic role assignment
  - Birthday/, Fun/, Giveaway/, Leveling/, Search/, Tools/, Utility/, Welcome/

- config/                     -> centralized configuration modules
- events/                     -> Discord event listeners
- handlers/                   -> interaction routing and component handlers
  - commandLoader.js          -> loads slash commands at startup
  - events.js                 -> Discord event listener registration
  - interactions.js           -> button/select/modal router
  - ticketButtons.js, reactionRoles.js, etc.

- interactions/               -> button, modal, and select menu handlers
- services/                   -> business logic + data operations
- utils/                      -> shared helpers
  - database.js               -> facade re-exporting database modules
  - database/wrapper.js       -> DatabaseWrapper, get/set helpers
  - database/keys.js          -> Redis-style key builders
  - database/tickets.js       -> ticket persistence + guild ticket stats
  - panelStatus.js            -> shared panel message detection
  - errorHandler.js, logger.js, embeds.js, etc.

Database
- PostgreSQL (primary) with in-memory fallback for development
- Graceful degradation when PostgreSQL is unavailable

Notes
- Modular by feature area: commands -> handlers -> services -> utils
- bot.js is the single source of truth for embed theming/colors and core bot config