Cryso Calc Bot

A Discord bot for fraternity treasury management. Tracks dues, payments, deductions, payment plans, donations, expenses, and Slash bank account activity — with full audit trails and XLSX exports.

What it does

• Dues — record cash / Venmo / Zelle / Apple Pay payments, credit out-of-pocket spending, support payment plans and IOUs
• Banking — live Slash account integration: real-time card-swipe alerts, transaction browse, MCC-categorized spending reports
• Receipts — attach images/PDFs to any payment, deduction, donation, expense, or transaction
• Rooms — house occupancy → automatic per-brother dues math, including shared rooms
• Expenses — recurring obligations (utilities, nationals, insurance) with auto-rolling next instances
• Reminders — personal todos with optional DM digest
• Exports — multi-sheet XLSX downloads of dues, transactions, and audit trails
• Audit — every officer action logged

Quick start

If you're just getting started, head to Getting Started for a guided walkthrough. The first three commands you'll run:

1. /onboard @brother — add each member to the roster
2. /set_semester 400 — set this semester's dues amount
3. /log_payment @joe 100 cash — record your first payment

Need every command at a glance? Run /help in Discord, or see the Command Reference.

Two ways the bot stays in sync with Slash

• Real-time webhooks — when a card swipes or money moves, Slash POSTs to the bot within seconds. The bot ingests and posts a live card in your treasurer channel.
• Hourly catch-up sync — even if a webhook delivery is missed, the bot reconciles its mirror against Slash every hour. The local data is always at most an hour stale.

See How webhooks work for details.

Who can run what

For now, every command is gated to a single Discord user (the treasurer) — set in the bot's .env as AUTHORIZED_USER_ID. Member-facing read commands (/my_dues, /my_history) are open to anyone.

Future versions will add role-based access (@Treasurer, @President).