Some checks failed
Deploy / deploy (push) Has been cancelled
Full-stack web application for Telegram management - Frontend: Vue 3 + Vben Admin - Backend: NestJS - Features: User management, group broadcast, statistics 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2.2 KiB
2.2 KiB
前后端集成总结(Node.js 方案)
架构现状
- 后端:
backend/(Node.js + Hapi.js + gramJS + Sequelize),提供 REST API、WebSocket 实时通道以及 Telegram 业务逻辑。 - 前端:
frontend-vben/(Vue 3 + Vben Admin)作为主管理端;frontend/旧版界面保留备查。 - 支撑组件:MySQL、Redis、可选 RabbitMQ;前端通过 Axios/Request 封装访问 Node API,并使用 TanStack 进行数据管理。
已完成的集成工作
- ✅ 将 Vben 前端的环境配置指向 Node 后端:API 基地址统一为
http://localhost:3000。 - ✅ 登录、Token 鉴权、用户信息等基础接口均已对接 Node 实现(基于
/admin/login、/admin/info等路由)。 - ✅ WebSocket 实时监控通道接入并可通过
ws://localhost:18081获得在线状态推送。 - ✅
./start-background.sh脚本更新为默认拉起 Node 后端 + Vben 前端,方便本地联调。 - ✅ 前端 TanStack 查询、Mutations 逐步替换原本的手动请求逻辑,数据缓存策略与 Node 返回结构保持一致。
启动地址
- 前端开发服:
http://localhost:5173/(如端口被占,Vite 会自动+1,具体以日志为准) - 后端 API:
http://localhost:3000/ - 实时监控 WS:
ws://localhost:18081/
推荐启动流程
- 安装依赖
cd backend && npm install cd ../frontend-vben && pnpm install - 一键启动
如需手动启动,可分别运行
cd .. ./start-background.shnpm start(后端)和pnpm dev:antd(前端)。 - 结束调试
./stop-services.sh
后续建议
- 完善接口覆盖面:补齐账号、群组、消息等模块的 Node API 对接与错误处理。
- 统一权限模型:前端基于 TanStack 缓存的权限接口输出,配合后端角色体系进行细粒度控制。
- 生产部署:参考
DEPLOYMENT.md,配置 Nginx 反向代理、PM2/系统服务守护以及环境变量(MySQL/Redis/队列)。 - 监控告警:结合
OPERATIONS.md中建议,为队列、WebSocket、第三方代理平台等关键点增加健康检查与日志轮转。