项目简介
产品为 Telegram 群组提供专业的财务记账服务，支持本地币种与统一记账币种双模式计价、中英双语自动识别、群组隔离的多租户数据架构。用户通过简单指令完成记账，系统自动生成 Web 版账单，管理员可随时通过浏览器查看完整数据。产品以订阅制 SaaS 形态运营，已稳定服务多个群组，覆盖跨境结算、社群经营、工作室分账等真实业务场景。
核心功能
- 实时记账：群内指令快速记录收入、支出，支持撤销与备注
- 双计价模式：本地币种 / 统一记账币种，两套视图灵活切换
- Web 账单：生成可分享的网页版账单，支持日期筛选与 Excel 导出
- 多租户架构：每个群组独立数据与配置，互不干扰
- 订阅计费：完整的试用 / 订阅 / 授权管理体系
- 三级权限：超级管理员 / 群主 / 操作员分级管控
- 多语言支持：中英文自动识别切换，适合跨国团队使用
- 钱包监控：对接群组指定的外部记账钱包，余额与动账实时同步到群，资金动态一目了然
技术栈
Python python-telegram-bot FastAPI PostgreSQL SQLAlchemy pytz
关键技术亮点
1. 群组级多租户隔离 以 Telegram chat_id 为租户键，数据库层面强隔离，每个群组有独立的汇率、语言、权限、订阅状态。一个实例同时服务 N 个群组，新增群组无需部署新服务。
2. 本地币种与统一币种双模式共存 账单同时承载本地币种与统一记账币种两套数据，前端切换模式时由后端按实时汇率换算。避免"记账时用本地币、对账时算统一币"的场景下的汇率漂移。
3. 外部钱包余额监控 通过外部监控服务轮询 + 去抖策略，实时捕获绑定记账钱包的余额变化与动账记录，直接推送到群。避免了第三方 API 延迟与丢失问题。
4. Web 账单与机器人共享数据库 FastAPI 账单页面和 python-telegram-bot 指令共享同一份 PostgreSQL 数据，不存在同步滞后，管理员刷新页面即见最新数据。
交付成果
- 完整的订阅制多币种记账 SaaS，含试用、付费、授权、续费全流程
- 中英双语自动识别，跨国团队无需手动切换
- 已稳定服务多个付费群组，长期运营迭代中
