JIGAIDO

Named after Nanami Kento's Cursed Technique restriction. Suppresses power during normal hours, exerts it during overtime.

A bounty tracking platform. Currently ships with a Telegram bot for managing and tracking bounties in groups and DMs.

Apps

• Telegram Bot — Group and personal bounty tracking via Telegram commands, with due date reminders

Overview

• Group bounties: Each Telegram group has its own bounty list
• Personal bounties: Private DM bounty list for individuals
• Admin-only posting: Only group admins can add/update/delete bounties
• Universal tracking: Any member can track bounties to their personal list
• Due date reminders: Daily cron notifies users when bounties are due within 7 days
• Free-form dates: Natural language due dates ("tomorrow", "in 3 days", "april 15")
• Link deduplication: No duplicate links within the same group

Project Structure

jigaido/
├── core/                    # Domain layer (pure Python, no external deps)
│   ├── models.py            # Domain dataclasses (Bounty, Tracking)
│   ├── ports.py             # Port interfaces
│   └── services.py          # Domain services
├── adapters/                # Infrastructure adapters
│   └── storage/
│       └── json_file.py     # JSON file storage implementation
├── apps/
│   └── telegram-bot/        # Telegram bot CLI application
│       ├── bot.py            # Bot entry point
│       └── commands.py       # Command handlers
├── tests/                   # Unit tests
├── config.py               # Configuration management
└── SPEC.md                 # Full design specification

Quick Start

# Install dependencies
pip install -r apps/telegram-bot/requirements.txt

# Set bot token
export JIGAIDO_BOT_TOKEN="your_bot_token"

# Run bot
python -m apps.telegram-bot.bot

License

MIT