237c7802e5
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>
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# 前后端集成总结（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/`
|
||
|
||
## 推荐启动流程
|
||
1. 安装依赖
|
||
```bash
|
||
cd backend && npm install
|
||
cd ../frontend-vben && pnpm install
|
||
```
|
||
2. 一键启动
|
||
```bash
|
||
cd ..
|
||
./start-background.sh
|
||
```
|
||
如需手动启动，可分别运行 `npm start`（后端）和 `pnpm dev:antd`（前端）。
|
||
3. 结束调试
|
||
```bash
|
||
./stop-services.sh
|
||
```
|
||
|
||
## 后续建议
|
||
1. **完善接口覆盖面**：补齐账号、群组、消息等模块的 Node API 对接与错误处理。
|
||
2. **统一权限模型**：前端基于 TanStack 缓存的权限接口输出，配合后端角色体系进行细粒度控制。
|
||
3. **生产部署**：参考 `DEPLOYMENT.md`，配置 Nginx 反向代理、PM2/系统服务守护以及环境变量（MySQL/Redis/队列）。
|
||
4. **监控告警**：结合 `OPERATIONS.md` 中建议，为队列、WebSocket、第三方代理平台等关键点增加健康检查与日志轮转。
|