# 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`）、代理管理、任务调度等。
- 启动方式：
  ```bash
  cd backend
  npm install
  npm start
  ```
- 亦可在仓库根目录执行 `./start-background.sh` 同时拉起后端与推荐前端。

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

### `frontend-vben/`
- 技术栈：Vue 3、TypeScript、Vite、Vben Admin、TanStack。
- 依赖安装及启动：
  ```bash
  corepack enable      # 确保 pnpm 可用
  cd frontend-vben
  pnpm install
  pnpm dev:antd
  ```
- 默认开发地址：`http://localhost:5173/`（如端口占用将自动顺延，具体以终端输出为准）。

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

## 📦 一键启动脚本

在仓库根目录执行：
```bash
./start-background.sh
```
- 启动 Node 后端（API：`http://localhost:3000`，实时监控 WS：`ws://localhost:18081`）。
- 启动 Vben 前端（开发服，默认端口 5173）。
- 可通过环境变量覆盖：
  - `REALTIME_MONITOR_PORT`：实时监控 WebSocket 端口。
  - `FRONTEND_PORT`：Vben 前端端口。

停止服务：
```bash
./stop-services.sh
```

## 📚 文档与运维

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

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