/mod-bot

Moderation tools for Discord communities

Primary LanguageTypeScriptGNU Affero General Public License v3.0AGPL-3.0

Mod bot

This code powers the Euno bot on Discord.

Initial setup

npm i
npm run dev

Tech

CI/CD

Implementation Details

migrations with npm run start:migrate. latest installed version is tracked in 2 tables of the sqlite data. schema changes must be done cautiously, should have a set up/tear down function tested before merging. Start a new migration with npx kysely migrate:make <name>

Migrations are stored in migrations/.

Generated DB types are stored in app/db.d.ts and generated automatically in a precommit hook and on app startup.

The code runs on a managed Kubernetes instance on Digital Ocean, using GitHub Actions as CI/CD. The service is configured using a kustomization.yaml file, which relies on configuration files within cluster/. Most of the configuration is in place to inject secrets stored in GitHub into the service upon deployment. Maybe most confusingly, there's a k8s-context file generated as part of CI that exists to pass along the latest Docker image tag from CI into the cluster configuration.

This bot was architected to support a web portal, but the k8s cluster configuration currently is not configured to be exposed to the internet, so it can not be used for a web portal in its current form.

The auth system is simple delegated auth to Discord. accounts are created if not found locally, no passwords or secondary confirmation atm. This system is not currently used for anything, it's a remnant of an earlier project that was abandoned.