Telegram Management System

Telegram 管理系统由一套 Node.js 后端（集成 gramJS）和两套前端管理界面组成，覆盖账号管理、消息监控、代理配置等业务能力。

📁 项目结构

telegram-management-system/
├── backend/          # Node.js + Hapi + Sequelize + gramJS 后端服务
├── frontend/         # 旧版 Vue 2 + View UI Plus 管理台（仅保留参考）
├── frontend-vben/    # 新版 Vue 3 + Vite + Vben Admin 管理台
├── scripts & docs    # 启动脚本、部署指南、调试脚本与相关文档
└── README.md

🚀 后端（backend/）

• 技术栈：Node.js 18+、Hapi.js、Sequelize、Redis、MySQL、gramJS。
• 功能：Telegram 账号管理、实时监控 WebSocket（默认端口 18081）、代理管理、任务调度等。
• 启动方式：

  cd backend
  npm install
  npm start
  

• 亦可在仓库根目录执行 ./start-background.sh 同时拉起后端与推荐前端。

💻 前端（推荐使用 frontend-vben/）

frontend-vben/

• 技术栈：Vue 3、TypeScript、Vite、Vben Admin、TanStack。
• 依赖安装及启动：

  corepack enable      # 确保 pnpm 可用
  cd frontend-vben
  pnpm install
  pnpm dev:antd
  

• 默认开发地址：http://localhost:5173/（如端口占用将自动顺延，具体以终端输出为准）。

frontend/（Legacy）

• 早期的 Vue 2 + View UI Plus 实现，保留作参考。目前未做同步维护，默认启动脚本已改为 frontend-vben 版本。

📦 一键启动脚本

在仓库根目录执行：

./start-background.sh

• 启动 Node 后端（API：http://localhost:3000，实时监控 WS：ws://localhost:18081）。
• 启动 Vben 前端（开发服，默认端口 5173）。
• 可通过环境变量覆盖：
  • REALTIME_MONITOR_PORT：实时监控 WebSocket 端口。
  • FRONTEND_PORT：Vben 前端端口。

停止服务：

./stop-services.sh

📚 文档与运维

• DEPLOYMENT.md：生产部署、环境搭建、配置说明。
• OPERATIONS.md：日常运维、监控告警、故障排查建议。
• 其余 *.md 文件记录了各阶段联调成果与专项功能说明，可按需查阅。

提示：项目内 Java（SpringBoot）实现已移除，当前唯一后端实现即 backend/ 目录的 Node.js 服务。