Files
miti99bot/docs/development-roadmap.md
tiennm99 4277f11c48 docs: add CLAUDE.md and project documentation
Add CLAUDE.md for AI assistant context. Create four new docs:
deployment-guide.md (full deploy flow + secret rotation + rollback),
code-standards.md (formatting, naming, module conventions, testing),
codebase-summary.md (tech stack, modules, data flows, external APIs),
development-roadmap.md (completed phases + planned work).
2026-04-14 15:28:53 +07:00

1.7 KiB

Development Roadmap

Current State: v0.1.0

Core framework complete. One fully implemented module (trading), three stubs (wordle, loldle, misc). 110 passing tests. Deployed to Cloudflare Workers.

Completed

Phase 1: Bot Framework (v0.1.0)

  • Cloudflare Workers entry point with webhook validation
  • grammY bot factory with memoized cold-start handling
  • Plug-n-play module system with static import map
  • Three-tier command visibility (public/protected/private)
  • Unified conflict detection across all modules
  • KVStore interface with auto-prefixed per-module namespacing
  • Post-deploy register script (setWebhook + setMyCommands)
  • /info and /help commands
  • 56 unit tests covering all framework seams

Phase 2: Trading Module (v0.1.0)

  • Paper trading with 5 commands (topup/buy/sell/convert/stats)
  • Real-time prices: CoinGecko (crypto+gold), TCBS (VN stocks), ER-API (forex)
  • 60-second price caching in KV with stale fallback
  • Per-user portfolio storage with VND as base currency
  • P&L tracking (total invested vs current portfolio value)
  • 54 unit tests for symbols, formatters, portfolio CRUD, handlers

Planned

Phase 3: Game Modules

  • Wordle implementation (currently stub)
  • Loldle implementation (currently stub)
  • Game state persistence in KV

Phase 4: Infrastructure

  • CI pipeline (GitHub Actions: lint + test on PR)
  • KV namespace IDs in wrangler.toml (currently REPLACE_ME placeholders)
  • Per-module rate limiting consideration

Future Considerations

  • Internationalization (per-module if needed)
  • More trading assets (expand symbol registry)
  • Trading history / transaction log
  • Group chat features