跳到主要内容

SayClaw 项目落地规划

本文档记录 SayClaw 的完整落地计划，包含已完成的基础设施、已确认的技术决策和待建设的功能模块。

基础设施现状​

服务域名状态备注
主站sayclaw.ai✅ 运行中Nginx + Let's Encrypt，小龙节点
文档站doc.sayclaw.ai✅ 运行中Docusaurus，小龙节点
GitLabgit.sayclaw.ai✅ 运行中GitLab CE，Docker，小龙节点
AI 节点（小龙）35.243.76.69✅ 运行中GCP Japan，OpenClaw gpt-5.2-pro

域名规划​

用途域名状态备注
主站sayclaw.ai✅ 已上线
文档doc.sayclaw.ai✅ 已上线
GitLabgit.sayclaw.ai✅ 已上线
员工前台portal.sayclaw.ai🔲 待建设Vue3
管理后台admin.sayclaw.ai🔲 待建设内网/VPN 访问
C端 APIapi.sayclaw.ai🔲 待建设Go
LiteLLM 代理llm.sayclaw.ai🔲 待建设内部

仓库结构​

GitLab 组织：sayclaw（托管在 git.sayclaw.ai）

sayclaw/                     ← 主 Monorepo
├── apps/
│   ├── sayclaw-portal        # 员工前台（Vue3 + TS）
│   ├── sayclaw-portal-api    # 员工前台后端（Go）
│   ├── sayclaw-admin         # 管理后台（Vue3 + Soybean Admin）
│   └── sayclaw-admin-api     # 管理后台后端（Go）
└── packages/
    ├── sayclaw-shared        # 公共 Go 库
    ├── sayclaw-ui            # 共享前端组件
    └── sayclaw-types         # 共享 TS 类型

sayclaw-docs/                ← 文档站（Docusaurus）
sayclaw-infra/               ← 基础设施（GCP / Terraform）
sayclaw-ops/                 ← 运维脚本

安全规范​

  • admin.sayclaw.ai 不暴露公网：只允许 VPN / Tailscale 访问
  • GitLab 关闭公开注册：✅ 已配置（只允许管理员创建账号）
  • SSH Key 推代码：开发者用 SSH Key，禁用密码登录
  • Secrets 管理：API Key 不进代码仓库，用 GitLab CI Variables 或 GCP Secret Manager
  • GCP 防火墙：admin-api 只允许内网访问

CI/CD 规划​

开发者 push 代码
       │
       ▼
GitLab Runner（小龙节点）
       │
       ├── 单元测试 (go test / vitest)
       ├── 代码 Lint 检查
       ├── Docker 镜像构建
       └── 自动部署
              ├── feature/* → dev 环境
              ├── develop   → staging 环境
              └── main      → prod 环境

分支策略：

  • main — 生产环境，protected，需 MR + review
  • develop — 开发主线
  • feature/* — 功能开发
  • hotfix/* — 紧急修复

成本估算（月）​

项当前状态月费估算
小龙 VPS（ai-jp-1，GCP Japan）✅ 运行中~$50
GCP Cloud SQL for MySQL🔲 待建设~$20-50
域名（sayclaw.ai）✅ 已购~$3
OpenAI API按用量按实际
合计估算~$80-120/月（初期）

注：GitLab 与小龙共用，节省一台 VPS 费用。后期流量增大再迁移独立节点。

Sprint 计划​

Sprint 1（2周）— 地基​

  • GitLab sayclaw 组织 + 仓库初始化
  • Monorepo 脚手架（目录结构 + 基础配置）
  • Go 项目骨架（portal-api + admin-api）
  • Vue3 项目骨架（portal + admin）
  • GitLab CI/CD 基础流水线
  • MySQL 数据库初始化（users / instances 表）

Sprint 2（2周）— 认证 + 核心功能​

  • GCP IAP 接入（Google SSO）
  • 员工 CRUD（admin-api）
  • 实例分配管理
  • 员工前台 Dashboard（我的 AI 助理列表）

Sprint 3（2周）— AI 接入 + 用量​

  • LiteLLM Proxy 部署接入
  • 用量统计 API + ECharts 图表
  • 审计日志写入（BigQuery）

Sprint 4（2周）— 报警 + 上线​

  • 超标报警（Telegram + 邮件）
  • 审计日志查询界面
  • 完整测试 + prod 部署

监控规划​

  • 基础设施：GCP Cloud Monitoring（CPU/内存/磁盘告警）
  • 应用层：Sentry（错误追踪）
  • Uptime：UptimeRobot 或 Cloudflare Health Checks（免费）
  • AI 用量：LiteLLM 内置 Dashboard