Home

LittleBoatPoll Wiki

LittleBoatPoll is a Discord bot for book-club polling with weighted voting support and draft-based poll management.

This wiki is the operational and technical reference for the current codebase.

Quick Navigation

• Getting Started
• Architecture
• Commands Reference
• Permissions Model
• Data and Environments
• Dashboard API
• Testing and Quality
• Troubleshooting

Project Scope

Core capabilities:

• Create and manage Discord polls.
• Enforce per-user vote limits.
• Apply optional weighted votes for monthly members.
• Manage draft polls before publication.
• Control administrative permissions through an internal creator list.
• Expose HTTP endpoints for dashboard integration (CSV upload and command execution).

Repository and Canonical Docs

Source repository:

• https://github.com/willianpm/LittleBoatPoll

Canonical development docs in repository:

• Setup: https://github.com/willianpm/LittleBoatPoll/blob/develop/docs/development/SETUP.md
• Architecture: https://github.com/willianpm/LittleBoatPoll/blob/develop/docs/development/ARCHITECTURE.md
• Git workflow: https://github.com/willianpm/LittleBoatPoll/blob/develop/docs/development/GIT-WORKFLOW.md
• Staging: https://github.com/willianpm/LittleBoatPoll/blob/develop/docs/technical/staging-bot.md

Use this wiki for fast project onboarding and operation.