基于 Next.js 15 + Go 构建的 IDC 服务器销售与运营管理系统，全链路 AI 辅助开发，功能持续迭代中。

⚠️ 免责声明：本项目为开源参考实现，大量功能仍在完善阶段。请勿直接用于生产环境，线上出现的任何问题由使用者自行承担。

服务器销售 · 客户自助 · 代理分销 · 工单 / 知识库 / AI 客服 四位一体。
前台极简，聚焦商品展示与下单；后台全面，覆盖所有运营业务。用户、代理、管理员三端完全分离。

• 对接 OpenAI 兼容接口，工单自动分类与初次回复
• AI 用量配额管控 + 输入清洗（防 prompt 注入、过滤敏感词）
• 多通道通知：SMTP 邮件、阿里云短信、站内信、Web Push、WebSocket

• 密码 bcrypt、JWT HS256（密钥强制 ≥ 32 字节）
• CSRF 双 Cookie、CORS 白名单、Admin IP 白名单
• 内部接口 X-Internal-Key 前置校验（仅允许 BFF 发起）
• WAF：速率限制、请求体大小限制、规则匹配、自动封禁
• 登录限流、登录历史记录、异常登录侦测
• 完整审计日志（用户操作 / 定时任务 / 事件流）

yuanma/
├── houduan/                      # Go 后端
│   ├── cmd/
│   │   ├── server/               # 启动入口、.env 加载
│   │   └── import_region_json/   # 行政区 JSON 导入工具
│   ├── config/                   # 配置加载与校验
│   ├── internal/
│   │   ├── database/             # GORM 初始化 + 自动迁移
│   │   ├── model/                # 数据表模型
│   │   ├── handler/              # 前台 HTTP 处理
│   │   │   └── admin/            # 管理后台 HTTP 处理
│   │   ├── middleware/           # auth / cors / csrf / waf / internal_key 等
│   │   ├── router/               # 路由注册
│   │   └── service/              # 业务层（定时任务、定价、AI、通知、JWT、邮件、短信、Realtime Hub）
│   ├── go.mod / go.sum
│   └── .env.example              # 环境变量示例
│
├── index/                        # Next.js 前端
│   ├── src/
│   │   ├── app/
│   │   │   ├── (前台页面)        # 首页、商城、登录、工作台、代理、文档……
│   │   │   ├── admin/            # 管理后台页面
│   │   │   └── api/[...proxy]/   # BFF 代理层
│   │   ├── components/           # 全局组件（Header、购物车、通知、实时 Provider 等）
│   │   └── lib/                  # 客户端 SDK、工具函数
│   ├── public/sw.js              # Web Push Service Worker
│   ├── scripts/                  # 启停辅助脚本
│   └── next.config.js
│
└── sql/
    ├── schema.sql                # 全量数据库 Schema
    └── backfill_core_scoring_policy.sql

PORT=8080
APP_ENV=production
DATABASE_URL=postgres://USER:PASS@HOST:5432/DBNAME?sslmode=disable

# 安全（必填，生产环境不得使用默认值）
JWT_SECRET=<随机字符串，≥32 字节>
INTERNAL_API_KEY=<随机字符串，≥32 字节，须与前端一致>

# 网络
TRUSTED_PROXIES=127.0.0.1,::1
CORS_ALLOWED_ORIGINS=https://your-domain.com
COOKIE_SECURE=true

# WAF
WAF_ENABLED=true
WAF_RATE_LIMIT_PER_SEC=60
WAF_MAX_BODY_BYTES=26214400

# 可选：邮件
SMTP_HOST=
SMTP_PORT=
SMTP_USER=
SMTP_PASS=
SMTP_FROM=

# 可选：短信（阿里云）
ALIYUN_SMS_KEY=
ALIYUN_SMS_SECRET=
ALIYUN_SMS_SIGN=

# 可选：AI
OPENAI_API_KEY=
OPENAI_BASE_URL=
OPENAI_MODEL=

# 可选：Web Push
VAPID_PUBLIC=
VAPID_PRIVATE=
VAPID_SUBJECT=

GO_BACKEND_URL=http://127.0.0.1:8080
API_INTERNAL_KEY=<与后端 INTERNAL_API_KEY 完全一致>
NEXT_PUBLIC_SITE_URL=https://your-domain.com

重要：INTERNAL_API_KEY 与 JWT_SECRET 均不得少于 32 字节，不得使用示例默认值，否则后端启动时会直接 fatal 退出。

# 1. 初始化数据库
createdb serverai
psql -d serverai -f sql/schema.sql    # 也可首次启动时由 GORM 自动迁移

# 2. 启动后端
cd houduan
cp .env.example .env.local            # 按需填写配置项
go run ./cmd/server                   # 监听 :8080

# 3. 启动前端
cd ../index
pnpm install
pnpm dev                              # 监听 :3000

1. 数据库：新建专用数据库及账户，赋予 SELECT / INSERT / UPDATE / DELETE / CREATE 权限。

2. 后端编译：

   GOOS=linux GOARCH=amd64 go build -o server ./cmd/server

   上传二进制，写入环境变量到 /etc/serverai/backend.env，用 systemd 守护进程管理。

3. 前端构建：

   pnpm build && pnpm start    # 或使用 PM2 守护

   Nginx 反向代理到 Next.js，不要直接暴露 Go 端口，必须经 BFF 层。

4. HTTPS：使用 Nginx / Caddy 终止 TLS，并设置 COOKIE_SECURE=true。

5. 创建管理员账号：

   • 方式 A：首次启动，users 表为空时，第一个注册账号自动提升为 admin。
   • 方式 B：手动执行 SQL：

     UPDATE users SET role = 'ADMIN' WHERE email = 'you@example.com';

6. 初始化配置：登录管理后台 → 依次完善「设置」「定价」「邮件模板」「短信模板」「WAF 规则」「区域」「CPU 配置」等。

7. 备份策略：管理后台手动创建首份全库备份，并配合系统级 pg_dump 定时执行。

# 查看后端日志
tail -f /var/log/serverai/backend.log

# 重启服务（systemd）
systemctl restart serverai-backend
systemctl restart serverai-frontend

# 数据库备份
pg_dump -d serverai -Fc -f backup-$(date +%Y%m%d).dump

# 健康检查
curl -I https://your-domain.com/api/health

# ⚠️ 危险：清空所有业务数据（不可恢复）
psql -d serverai -c "TRUNCATE users, orders, servers RESTART IDENTITY CASCADE;"

为便于上手与交接，下面给出管理后台核心页面的用途说明（对应 index/src/app/admin 下页面）。

说明：部分页面需要有对应业务数据后才会展示完整图表或列表，空库时显示为“暂无数据”属于正常行为。

以下截图已放入 docs/ui-previews/，用于给用户直观看到后台界面。

本项目围绕 IDC 业务、财务管理、代理分销等方向构建，代码与思路均开放参考，适合交流学习与二次开发。

我们希望它是一个真正能被参考、能持续演进的系统，而不是停留在设想里的东西。
欢迎对 IDC、云业务、财务管理感兴趣的朋友一起交流。

• QQ 交流群：770906516
• 官网：青龙云 www.qinglongyun.com