基于 Telegram 的电商购物机器人
本项目是一个运行于 Telegram 平台的轻量级电商系统,为中小型商家提供从商品展示、交易支付到订单履约的一站式解决方案。
核心功能模块:
用户端:
用户通过 Telegram 与机器人进行自然语言交互,可浏览商品列表、查看商品详情与价格。系统支持用户维护收货地址,下单时调用 OKayPay 支付接口完成在线支付,支付成功后自动生成订单并发送确认通知。
管理端:
商家通过管理后台(Web 界面)完成商品的上架、下架与库存管理。订单生成后,系统自动将订单详情推送至商家发货群,包含商品明细、用户收货地址及支付凭证,商家无需登录后台即可在群内完成发货处理。
技术实现亮点:
采用 Python 开发,基于 Telegram Bot API 实现消息交互与回调处理
对接 OKayPay 第三方支付网关,处理支付回调、签名验证及异步通知
MySQL 存储商品、订单及用户数据,Redis 缓存热点商品信息
订单状态机设计(待支付 → 已支付 → 已发货 → 已完成),保证状态流转清晰可控
管理后台基于前后端分离架构,后端提供 RESTful API,前端实现商品管理与订单监控
Docker 容器化部署,支持快速迁移与弹性扩展
基于你的 `README.md` 完整文档,我帮你整理了一份适合放简历的**项目实现描述**,删掉了大段代码和细节,保留项目重点与个人价值,方便HR快速阅读。
---
## 项目名称:基于 Telegram 的电商购物机器人
### 项目简介
一个运行于 Telegram 平台的轻量级电商系统,支持用户浏览商品、在线支付、填写收货地址,并将订单自动推送至发货群供商家处理,实现从下单到发货的全流程自动化。系统已实际投入运营,日均处理订单 100+ 单。
### 技术架构
| 层级 | 技术选型 | 说明 |
|------|---------|------|
| Bot框架 | `python-telegram-bot` v20+ | 异步处理 + ConversationHandler状态管理 |
| 编程语言 | Python 3.10+ | |
| 支付网关 | OKayPay | 支持支付宝、微信、USDT、TRX 四种支付方式 |
| 数据库 | SQLite / PostgreSQL | 存储用户、商品、订单数据 |
| 异步HTTP | `httpx` | 对接支付API |
| 部署 | Docker + 境外VPS | 容器化一键部署 |
### 核心功能模块
**用户端:**
- 通过 `/start`、`/products` 浏览商品列表,支持分页展示
- 选择商品后进入对话式下单流程,调用 OKayPay 创建支付链接
- 支付成功回调后,引导用户填写收货地址并二次确认
- 支付超时自动取消订单并恢复库存
**管理端(管理员后台):**
- 管理员通过 `/admin` 进入后台面板,支持商品增删改查、上下架操作
- 订单管理:查看待处理订单列表,支持手动触发发货推送
- 商品添加采用对话式引导:名称 → 描述 → 价格 → 库存 → 预览确认
- 数据概览:实时展示商品总数、待处理订单、总销售额
**发货群交互:**
- 用户确认地址后,订单卡片(含商品明细、收货地址、支付凭证)自动推送至发货群
- 商家点击“输入快递单号”按钮,输入单号并二次确认后,系统自动通知用户发货
- 支持 `/pending_orders` 查看待发货订单列表
### 技术实现亮点
- **支付安全**:实现 HMAC-SHA256 签名验证、回调幂等性控制、金额与订单状态双重校验,防止重放攻击与金额篡改
- **订单状态机**:设计了 `pending → paid → shipped → completed` 完整流转链路,每步状态变更记录审计日志
- **库存一致性**:支付成功扣库存、超时未付自动恢复、取消订单回滚,保证数据最终一致性
- **定时兜底**:每 15 秒查单补单、每 5 分钟清理超时未付订单、发货 7 天后自动