Files
WebUp Cloud db82325ed7
Verify control plane / verify (push) Canceled after 0s
Initial import of WebUp Cloud
2026-11-07 13:31:14 +08:00

2718 lines
53 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AI 全栈网站开发与云托管平台——完整开发需求
## 一、项目总体说明
你现在需要从零开发一个完整的商业化 AI 网站开发与云托管平台。
这不是一个普通的 AI 网站生成器,而是一个集以下能力于一体的平台:
1. AI 全栈网站自动开发。
2. 多大模型、多供应商及 AI 中转站接入。
3. AI Agent 自动编写代码、运行命令、安装依赖、调试和测试。
4. Docker/OCI 容器化开发与网站运行。
5. 多服务器节点管理及资源调度。
6. 网站 7×24 小时持续运行。
7. 网站在线预览、源码下载和版本管理。
8. 静态网站、动态网站、后端服务和数据库托管。
9. 类似 Cloudflare Pages 的网站部署服务。
10. 阿里云 ESA CDN、DNS API 自动化接入。
11. 自定义域名及平台随机二级域名。
12. 网站资源迁移、故障检测及自动故障恢复。
13. PostgreSQL、MySQL、MariaDB 数据库服务。
14. 对象存储、持久化卷、缓存及镜像仓库。
15. AI Token 计费、余额系统、托管套餐及流量计费。
16. 微信支付、支付宝、PayPal、易支付、码支付。
17. 完整的管理员后台、用户管理和运营系统。
18. 邮件、短信、优惠码、通知及风控系统。
平台必须具备真实可用的业务逻辑,不能只是展示界面。
所有功能必须有实际后端接口、数据库结构、权限验证和必要的自动化流程。
平台名称、Logo、域名、备案信息等均由管理员在后台设置,不要将品牌名称写死在代码中。
---
# 二、总体技术架构
## 2.1 技术选型
采用模块化、可扩展、支持多节点部署的架构。
推荐技术方案:
### 前端
- Vue 3
- TypeScript
- Vite
- Pinia
- Vue Router
- Element Plus 或其他成熟的 Vue 组件库
- 支持 WebSocket 或 SSE 实时更新
- 支持响应式布局
用户端和管理后台可以采用统一前端工程,但必须有清晰的路由、权限和布局隔离。
### 后端
推荐:
- Java 21+
- Spring Boot 3.x
- Spring Security
- RESTful API
- WebSocket / SSE
- 数据库迁移工具
- 统一异常处理
- 统一权限控制
具体依赖版本应选择稳定、兼容的版本。
### 基础设施
- PostgreSQL:平台核心业务数据库。
- Redis:缓存、队列、分布式锁、任务状态。
- Docker / OCI:容器镜像及开发环境。
- Kubernetes / K3s:多节点容器编排,兼容 Dockerfile 和 OCI 镜像。
- S3 兼容对象存储:用户文件和备份。
- Nginx 或兼容的 Ingress 网关:网站请求分发。
- 阿里云 ESA:CDN 和域名加速。
- Git:项目版本管理。
- 独立 Node Agent:服务器节点管理及监控。
如果选用其他技术方案,必须先说明原因,并保证上述业务能力能够实现。
不要为了追求微服务而将所有模块拆成大量独立服务。平台控制面优先采用模块化架构,AI Worker、构建服务、节点 Agent 等需要独立运行的部分再单独部署。
## 2.2 整体架构
系统划分为以下中心:
1. 用户中心。
2. AI 开发中心。
3. 项目管理中心。
4. 云托管中心。
5. Pages 部署中心。
6. 数据库管理中心。
7. 统一存储中心。
8. 节点调度中心。
9. 高可用与容灾中心。
10. 计费中心。
11. 支付中心。
12. 消息通知中心。
13. 管理员运营中心。
各中心之间通过明确的服务接口通信。
所有核心业务数据统一由 PostgreSQL 管理。
Redis 不能作为核心业务数据的唯一存储位置。
---
# 三、用户注册、登录与账户管理
## 3.1 注册系统
支持:
- 用户注册。
- 用户登录。
- 用户退出。
- 找回密码。
- 修改密码。
- 邮箱绑定。
- 手机号绑定。
- 修改邮箱。
- 修改手机号。
- 用户账户状态管理。
管理员可以设置注册验证方式:
1. 不验证。
2. 邮箱验证。
3. 短信验证。
4. 邮箱和短信同时验证。
注册和登录均必须支持服务器生成的图片验证码。
## 3.2 图片验证码
要求:
- 图片由服务器生成。
- 验证码随机生成。
- 验证码具有过期时间。
- 验证码一次性使用。
- 验证失败后不能重复使用原验证码。
- 具有防暴力破解机制。
- 支持刷新验证码。
- 验证码不能仅在前端进行校验。
## 3.3 用户设备管理
记录用户:
- 注册 IP。
- 登录 IP。
- 登录时间。
- User-Agent。
- 浏览器信息。
- 操作系统信息。
- 设备标识。
- 登录结果。
- 登录异常记录。
用户可以查看自己的登录历史和设备会话。
管理员可以查看用户设备信息、登录记录,并强制注销异常会话。
注意:设备信息采集应遵守隐私保护要求,不要收集不必要的信息。
## 3.4 用户账户安全
支持:
- 密码强度配置。
- 登录频率限制。
- 验证码错误限制。
- IP 限制。
- 用户封禁。
- 用户解封。
- 强制退出登录。
- 管理员操作审计。
---
# 四、用户控制台
用户登录后进入独立控制台。
界面采用现代 SaaS 风格,简洁、专业,以白色为主,支持深色模式。
侧边栏包括:
### 控制台
- 数据概览。
- 当前余额。
- 项目数量。
- 正在运行的网站。
- AI 开发任务。
- 资源使用情况。
- 最近消费记录。
- 系统通知。
### AI 开发
- 创建 AI 网站。
- 我的开发项目。
- 开发任务。
- AI 对话记录。
- 模型选择。
- 开发费用记录。
### 项目管理
- 我的项目。
- 项目文件。
- 项目版本。
- 在线预览。
- 源码下载。
- 项目部署。
- 运行日志。
- 项目设置。
### 云托管
- 网站列表。
- 网站运行状态。
- 运行资源。
- 数据库管理。
- 存储管理。
- 域名管理。
- CDN 管理。
- 网站备份。
- 网站迁移记录。
### 账户与计费
- 余额中心。
- 余额充值。
- 消费明细。
- 订单管理。
- 套餐购买。
- 资源升级。
- 流量包。
- 优惠码。
### 个人设置
- 个人资料。
- 邮箱和手机号。
- 密码修改。
- 设备管理。
- 登录记录。
- 消息通知设置。
---
# 五、AI 全栈网站开发中心
这是整个产品最核心的业务模块。
## 5.1 创建项目
用户可以通过以下方式创建项目:
1. AI 从零开发。
2. 上传已有网站源码。
3. 导入 GitHub 仓库。
4. 导入 GitLab 仓库。
5. 使用平台模板创建。
AI 创建项目时,用户需要填写:
- 项目名称。
- 项目简介。
- 网站开发需求。
- 网站风格。
- 目标技术栈。
- 是否需要数据库。
- 是否需要用户登录系统。
- 是否需要管理员后台。
- 是否需要 API。
- 是否需要定时任务。
- 其他特殊需求。
支持上传:
- 图片。
- Logo。
- 设计稿。
- PDF。
- Word 文档。
- 其他开发资料。
支持提供参考网站地址。
## 5.2 AI 模型选择
用户可以选择管理员开放的模型。
模型信息包括:
- 模型名称。
- 模型介绍。
- 所属供应商。
- 输入 Token 价格。
- 输出 Token 价格。
- 缓存 Token 价格。
- 上下文长度。
- 模型能力。
- 是否支持工具调用。
- 是否支持视觉输入。
- 是否开放使用。
用户只能选择管理员允许使用的模型。
模型选择后显示对应计费规则。
## 5.3 AI Agent 开发能力
AI 不能只是根据提示词输出代码。
必须真正具备执行开发任务的能力。
至少包括:
### 文件操作
- 创建文件。
- 读取文件。
- 编辑文件。
- 删除文件。
- 文件夹管理。
- 文件搜索。
- 项目文件树。
### 终端操作
- 执行命令。
- 安装依赖。
- 编译项目。
- 构建项目。
- 启动开发服务。
- 查看终端输出。
- 获取错误日志。
### 数据库操作
- 创建数据库。
- 创建数据表。
- 设计数据结构。
- 执行数据库迁移。
- 初始化数据。
- 测试数据库连接。
### 浏览器测试
- 访问预览网站。
- 检查页面。
- 测试用户操作。
- 测试登录注册。
- 测试表单。
- 测试 API。
- 页面截图。
- 检查移动端布局。
### 构建和测试
- 自动安装依赖。
- 自动运行构建。
- 自动执行测试。
- 自动检查错误。
- 自动修复能够安全修复的问题。
- 输出最终构建结果。
AI 需要根据项目需求决定实际使用哪些工具。
## 5.4 技术栈支持
首批支持:
前端:
- HTML。
- CSS。
- JavaScript。
- Vue 3。
- React。
- Next.js。
- Nuxt。
后端:
- Node.js。
- Express。
- NestJS。
- PHP。
- Laravel。
- Python。
- Django。
- FastAPI。
数据库:
- PostgreSQL。
- MySQL。
- MariaDB。
- Redis。
后续支持:
- Java。
- Go。
- 其他常见技术栈。
管理员可以设置可用的语言版本、运行环境、基础镜像和模板。
用户可以指定技术栈,AI 不得随意更换用户指定的技术方案。
## 5.5 多轮开发
AI 必须支持在原有项目基础上持续开发。
例如:
用户第一次要求开发论坛。
完成后用户继续要求:
- 增加用户中心。
- 增加管理员后台。
- 修改首页布局。
- 增加微信登录。
- 增加文件上传。
- 修改主题色。
AI 必须在原有项目基础上修改代码,不能每次都重新生成整个网站。
## 5.6 多模型切换
同一个项目支持在不同开发阶段切换模型。
切换模型后必须保留:
- 项目文件。
- 项目版本。
- 历史对话。
- 开发计划。
- 当前任务状态。
- 工具执行记录。
- 上下文摘要。
不同模型的能力需要经过检测,不能将不支持工具调用的模型当成完整 Agent 模型使用。
## 5.7 开发过程展示
实时显示:
- 当前开发任务。
- AI 执行步骤。
- 当前使用模型。
- 正在操作的文件。
- 终端命令。
- 命令执行结果。
- 输入 Token。
- 输出 Token。
- 缓存 Token。
- 当前消费金额。
- 累计消费金额。
- 预计剩余费用。
- 构建进度。
- 测试结果。
支持:
- 暂停。
- 继续。
- 取消。
- 重新执行。
- 追加需求。
- 切换模型。
- 查看完整日志。
## 5.8 开发任务预算
用户可以为每个开发项目设置预算上限。
AI 执行任务前检查余额和预算。
余额不足时:
- 自动暂停新的 AI 调用。
- 保存当前项目状态。
- 提示用户充值。
- 充值后允许继续执行。
不得出现无限透支。
---
# 六、AI 供应商与模型管理
## 6.1 供应商管理
管理员可以添加多个模型供应商。
支持:
- OpenAI。
- Anthropic。
- Google Gemini。
- DeepSeek。
- 智谱。
- 阿里云百炼。
- OpenAI 兼容 API。
- AI 中转站。
- 自定义 API 供应商。
每个供应商配置:
- 名称。
- API Base URL。
- API Key。
- API 类型。
- 状态。
- 请求超时时间。
- 连接测试。
- 错误日志。
支持一个供应商下配置多个模型。
## 6.2 模型管理
管理员可以创建、编辑、禁用、删除模型配置。
字段包括:
- 模型显示名称。
- 实际模型 ID。
- 所属供应商。
- 输入 Token 单价。
- 输出 Token 单价。
- 缓存读取价格。
- 缓存写入价格(适用时)。
- 最大上下文长度。
- 最大输出 Token。
- 是否支持视觉。
- 是否支持工具调用。
- 是否支持流式输出。
- 是否允许用户选择。
- 是否作为默认模型。
- 排序权重。
价格使用统一计价单位,例如人民币元 / 百万 Token。
所有价格支持小数精度。
## 6.3 模型计费
根据 API 返回的实际 Token 使用量进行计费。
计算公式:
消费金额 = 输入 Token 消费 + 输出 Token 消费 + 缓存 Token 消费 + 其他明确计费项目。
必须记录:
- 原始 Token 使用量。
- 模型价格快照。
- 模型 ID。
- 供应商。
- 请求 ID。
- 任务 ID。
- 计费结果。
管理员修改模型价格后,不得改变已经开始的任务所使用的价格快照。
如果供应商没有返回完整 usage 信息,必须明确记录估算计费状态,并使用管理员配置的兜底策略,不能伪装成精确计费。
## 6.4 API 密钥安全
- 密钥加密存储。
- 前端脱敏展示。
- 不允许通过普通接口读取完整密钥。
- 日志中不能打印密钥。
- 支持密钥轮换。
- 支持供应商连接测试。
- 不允许用户访问其他供应商的凭证。
---
# 七、AI 费用、余额和账本
## 7.1 余额体系
每个用户拥有独立钱包。
支持:
- 充值余额。
- 消费扣款。
- 退款。
- 管理员增加余额。
- 管理员扣除余额。
- 优惠赠送。
- 冻结金额。
- 可用余额。
- 余额明细。
采用不可随意修改的交易账本。
不能仅通过直接修改 users.balance 的方式处理所有资金业务。
每笔余额变化都必须有唯一交易记录、业务关联和幂等标识。
## 7.2 AI 任务预留机制
AI 开发采用:
1. 估算开发费用。
2. 检查用户余额。
3. 预留预算。
4. 开始开发。
5. 按实际 Token 使用量计算费用。
6. 结算真实消费。
7. 释放未使用的预留金额。
例如:
预估费用:20 元。
实际使用:13.50 元。
最终扣费:13.50 元。
剩余预留:6.50 元,释放回可用余额。
任务取消、失败或中断时,也必须正确结算已经产生的费用。
## 7.3 账单
用户可以查看:
- 充值账单。
- AI 消费账单。
- 网站托管账单。
- 流量账单。
- 存储账单。
- 套餐账单。
- 优惠抵扣。
- 退款记录。
每笔消费必须能够追溯到具体项目和业务。
---
# 八、Docker 容器化开发与网站运行
## 8.1 总体要求
AI 开发环境和正式网站运行环境必须分离。
开发容器可以按任务启动,项目数据必须持久化保存。
正式网站必须 7×24 小时持续运行,不允许因网站暂时没有访问而自动休眠。
采用 Dockerfile / OCI 镜像体系,生产环境优先通过 K3s 或 Kubernetes 进行多节点容器调度。
## 8.2 AI 开发容器
每个开发任务拥有独立隔离环境。
支持:
- 独立工作目录。
- 独立运行用户。
- 独立临时磁盘。
- CPU 限制。
- 内存限制。
- 执行时间限制。
- 网络访问限制。
- 文件访问隔离。
- 环境变量隔离。
AI 可以在授权范围内执行终端命令。
开发环境不得直接获得宿主机权限。
## 8.3 正式运行容器
每个项目可以由多个独立服务组成。
例如:
商城项目:
- frontend。
- backend。
- worker。
- scheduler。
- redis。
- database。
每个服务可以独立设置:
- 镜像。
- 启动命令。
- 环境变量。
- CPU。
- 内存。
- 端口。
- 健康检查。
- 重启策略。
- 副本数量。
所有服务归属于同一个项目,并由平台统一管理。
## 8.4 项目服务发现
支持项目内部服务之间通过内部地址通信。
例如:
- backend 访问 database。
- backend 访问 redis。
- frontend 访问 backend。
- worker 访问 database。
内部服务不需要暴露公网端口。
用户不能直接访问其他用户的内部服务。
## 8.5 容器安全
这是平台的关键安全要求。
必须做到:
- 禁止普通用户容器使用 privileged。
- 禁止用户容器访问宿主机 Docker Socket。
- 禁止随意挂载宿主机目录。
- 默认非 root 运行。
- 使用 seccomp、AppArmor 等安全机制。
- 限制 CPU、内存、磁盘、进程和网络。
- 不允许容器访问平台内部管理接口。
- 阻止访问云厂商元数据地址。
- 控制容器出站网络。
- 防止 SSRF。
- 项目之间网络隔离。
- 项目之间文件系统隔离。
对于不可信的 AI 生成代码,应评估使用 gVisor、Kata Containers 等更强隔离运行时。
不能认为普通 Docker 容器就天然拥有完整虚拟机级别的安全隔离。
## 8.6 容器管理
用户可以:
- 查看容器状态。
- 查看容器日志。
- 重启服务。
- 查看 CPU。
- 查看内存。
- 查看磁盘。
- 查看网络流量。
- 查看服务运行时间。
管理员可以:
- 创建容器。
- 停止容器。
- 重建容器。
- 查看异常。
- 执行维护。
- 查看节点容器列表。
---
# 九、数据库服务中心
平台自身核心数据库必须使用 PostgreSQL。
用户开发的网站支持:
- PostgreSQL。
- MySQL。
- MariaDB。
## 9.1 两种数据库模式
### 共享数据库集群
多个项目使用统一数据库集群。
但必须做到:
- 每个项目独立数据库。
- 每个项目独立数据库账号。
- 独立访问权限。
- 独立空间配额。
- 独立连接数限制。
- 独立备份。
- 不允许跨项目访问。
### 独立数据库实例
高级套餐可以使用独立数据库容器或实例。
支持:
- 独立 CPU。
- 独立内存。
- 独立磁盘。
- 独立账号。
- 独立备份。
- 独立恢复。
- 独立监控。
管理员决定哪些套餐允许使用独立数据库。
## 9.2 自动创建数据库
AI 判断项目需要数据库时,可以申请数据库资源。
自动执行:
1. 检查套餐权限。
2. 检查资源配额。
3. 创建数据库。
4. 创建数据库账号。
5. 配置权限。
6. 生成连接配置。
7. 执行数据库迁移。
8. 测试连接。
9. 将数据库绑定到项目。
破坏性生产数据库迁移必须先备份,并按风险要求取得用户确认。
## 9.3 用户数据库管理
用户可以:
- 查看数据库。
- 查看数据库状态。
- 查看空间使用情况。
- 查看数据库连接信息。
- 查看数据表。
- 执行 SQL。
- 下载备份。
- 创建备份。
- 恢复备份。
- 修改数据库配置。
危险操作需要二次确认。
## 9.4 数据库备份
支持:
- 自动定时备份。
- 手动备份。
- 数据库恢复。
- 时间点恢复(在备份技术支持时)。
- 备份下载。
- 备份保留期限。
- 跨节点恢复。
备份不能只放在原数据库所在的服务器。
---
# 十、统一存储中心
采用混合存储架构。
## 10.1 对象存储
采用 S3 兼容接口。
用于:
- 用户上传图片。
- 网站附件。
- 视频。
- 文件。
- 源码压缩包。
- 构建产物。
- 网站备份。
- 数据库备份。
支持独立 Bucket 或等效的强隔离策略。
## 10.2 持久化卷
用于网站运行期间需要长期保存的文件。
支持:
- 独占卷 RWO。
- 共享卷 RWX。
- 磁盘配额。
- 快照。
- 恢复。
- 迁移。
- 扩容。
需要根据底层存储系统实际能力实现。
可以评估 Ceph RBD、CephFS、Longhorn 等方案。
## 10.3 本地缓存
节点本地缓存包括:
- Docker/OCI 镜像缓存。
- 依赖缓存。
- 构建缓存。
- 临时文件。
缓存可以删除并重新生成。
任何重要用户数据都不能只保存在本地缓存中。
## 10.4 镜像仓库
集中保存:
- AI 构建镜像。
- 项目历史版本镜像。
- 基础运行镜像。
- 预览镜像。
支持镜像清理策略,但必须保护仍在运行和可回滚的版本。
## 10.5 存储计费
记录:
- 对象存储用量。
- 持久化卷用量。
- 数据库用量。
- 备份用量。
- 镜像仓库用量。
管理员可设置:
- 存储上限。
- 超额价格。
- 备份空间价格。
- 文件大小限制。
- 文件保留期限。
---
# 十一、多服务器节点管理
平台必须从架构上支持多台服务器。
## 11.1 节点架构
包括:
- 控制中心。
- AI 开发节点。
- 网站运行节点。
- 数据库节点。
- 存储节点。
- 网关节点。
不同用途可以部署在同一台服务器,也可以独立部署。
## 11.2 节点管理
管理员可以添加节点。
配置:
- 节点名称。
- 节点地址。
- 通信端口。
- 节点认证信息。
- 节点用途。
- CPU 总量。
- 内存总量。
- 磁盘容量。
- 节点标签。
- 调度权重。
- 节点状态。
节点需要安装独立 Agent。
节点 Agent 与控制中心通过安全认证通信。
不得直接将 Docker Remote API 暴露到公网。
## 11.3 自动资源调度
创建项目时,系统根据:
- CPU。
- 内存。
- 磁盘。
- 节点健康状态。
- 项目套餐。
- 节点用途。
- 节点标签。
- 当前运行负载。
选择适合的节点。
节点资源不足时,不得继续分配超过可用容量的项目。
## 11.4 节点维护
支持:
- 节点上线。
- 节点下线。
- 节点维护。
- 节点排空。
- 项目批量迁移。
- 节点资源统计。
- 节点故障告警。
---
# 十二、网站资源迁移中心
这是必须实现的正式业务功能。
不能只是简单复制 Docker 镜像。
## 12.1 支持迁移场景
- 管理员手动迁移网站。
- 服务器维护前批量迁移。
- 节点资源不足时迁移。
- 用户升级套餐后迁移。
- 节点故障后恢复。
- 数据库从共享模式迁移到独立模式。
- 数据库在兼容条件下进行反向迁移。
- 存储节点迁移。
## 12.2 迁移内容
包括:
- 项目源码。
- Docker 镜像。
- 容器配置。
- 环境变量。
- 数据库。
- 用户上传文件。
- 持久化卷。
- 后台 Worker。
- 定时任务。
- 内部服务配置。
- 项目域名关联信息。
不需要复制已经存放在统一对象存储中的全部文件,但必须保证目标节点能够正常访问。
## 12.3 迁移流程
1. 选择目标节点。
2. 检查目标节点资源。
3. 检查运行环境兼容性。
4. 同步镜像。
5. 同步持久化数据。
6. 执行数据库同步。
7. 创建目标容器。
8. 恢复环境变量。
9. 启动新服务。
10. 执行健康检查。
11. 最终数据同步。
12. 切换入口流量。
13. 确认迁移成功。
14. 释放旧节点资源。
15. 保留回滚信息。
支持低停机迁移和维护窗口迁移。
必须考虑数据库写入一致性,不能只复制文件后就宣布迁移成功。
## 12.4 迁移后台
显示:
- 迁移 ID。
- 用户。
- 项目。
- 原节点。
- 目标节点。
- 迁移类型。
- 当前阶段。
- 进度。
- 已同步数据量。
- 数据库状态。
- 健康检查结果。
- 开始时间。
- 完成时间。
- 错误日志。
支持:
- 取消。
- 重试。
- 回滚。
- 批量迁移。
- 查看历史。
---
# 十三、高可用与故障恢复中心
必须支持自动故障恢复和管理员手动恢复。
具体权限按照套餐配置。
## 13.1 故障类型
- 网站进程崩溃。
- 容器崩溃。
- 节点宕机。
- 节点网络异常。
- 数据库故障。
- 磁盘故障。
- 网关故障。
- 存储故障。
## 13.2 基础恢复
网站进程异常时自动重启。
容器异常时自动重建。
节点故障时执行套餐对应的恢复策略。
## 13.3 套餐控制
管理员可以为不同套餐配置:
- 是否允许自动故障迁移。
- 是否允许手动迁移。
- 是否允许多副本。
- 是否允许备用节点。
- 是否提供数据库高可用。
- RTO 目标。
- RPO 目标。
- 故障通知方式。
- 故障恢复优先级。
免费版可以只支持管理员手动恢复。
高级套餐可以开启自动故障迁移。
具体权限不得硬编码。
## 13.4 自动故障迁移
检测到节点故障:
1. 多次检查节点心跳。
2. 通过独立探测验证故障。
3. 确认故障状态。
4. 检查目标节点资源。
5. 确认旧节点已经隔离或被可靠 fencing。
6. 恢复网站。
7. 恢复数据库连接。
8. 恢复持久化数据。
9. 健康检查。
10. 切换流量。
11. 通知用户。
12. 记录故障事件。
必须防止旧节点恢复后出现两个实例同时写入同一份数据的情况。
不能只依赖 Docker restart policy 实现高可用。
## 13.5 管理员手动恢复
管理员可以:
- 选择故障项目。
- 选择目标节点。
- 执行恢复。
- 查看恢复进度。
- 进行健康检查。
- 完成流量切换。
## 13.6 高可用管理后台
显示:
- 节点健康状态。
- 故障事件。
- 自动迁移记录。
- 手动迁移记录。
- 备用资源。
- 恢复进度。
- 恢复结果。
- RTO/RPO 实际表现。
---
# 十四、Pages 网站部署中心
参考 Cloudflare Pages、Vercel 等产品的项目管理和部署体验。
但不能简单照搬页面。
需要支持完整的静态和动态网站部署。
## 14.1 创建方式
用户可以:
- AI 开发完成后部署。
- 上传 ZIP 文件部署。
- GitHub 部署。
- GitLab 部署。
- 使用模板部署。
## 14.2 部署类型
支持:
### 静态网站
- HTML。
- Vue。
- React。
- 其他构建后的静态资源。
### 全栈网站
- 前端服务。
- 后端服务。
- API。
- 数据库。
- Redis。
- Worker。
- Scheduler。
### 单独后端服务
- REST API。
- WebSocket。
- Webhook。
- 后台服务。
## 14.3 版本部署
每次正式部署生成一个版本。
支持:
- 历史版本。
- 指定版本部署。
- 版本回滚。
- 预览版本。
- 构建日志。
- 部署日志。
- 部署状态。
- 健康检查。
正式发布采用新版本先启动、健康检查通过后切换流量的方式。
新版本失败时恢复旧版本。
## 14.4 在线预览
每个开发版本拥有独立预览地址。
预览环境支持:
- 前端页面。
- 后端 API。
- 数据库连接。
- 文件上传。
- WebSocket。
- 用户操作测试。
预览环境默认使用测试数据库和独立测试数据,避免影响生产环境。
---
# 十五、阿里云 ESA 与 DNS 自动化
这是平台重要的基础设施功能。
## 15.1 阿里云 ESA 接入
后台配置:
- AccessKey ID。
- AccessKey Secret。
- 地域及相关 API 参数。
- ESA 账号信息。
- 默认站点配置。
- 源站 IP。
- 源站端口。
- 回源协议。
- 回源 Host。
- SNI。
- 缓存规则。
密钥必须加密存储,不能暴露在前端。
## 15.2 非标准端口回源
我的服务器使用非标准端口。
因此必须支持:
- 自定义源站端口。
- HTTPS 回源。
- HTTP 回源。
- 自定义 Host。
- 自定义 SNI。
- 源站连接测试。
- 回源错误日志。
不能假设源站使用 80 或 443 端口。
建议统一使用入口网关接收请求,再通过内部服务发现转发到项目容器。
用户容器不需要直接暴露公网端口。
## 15.3 自动部署域名
用户选择平台域名时:
1. 生成项目域名。
2. 根据配置创建或关联 ESA 站点。
3. 配置 CDN 回源。
4. 配置源站非标准端口。
5. 调用阿里云 DNS API 添加解析。
6. 检查 DNS。
7. 检查 ESA。
8. 检查源站。
9. 配置 HTTPS。
10. 完成部署。
ESA 站点管理必须根据实际 API 能力、账户配额和域名接入规则设计。
支持管理员选择:
- 每个项目独立站点。
- 统一站点加通配符域名。
- 其他受 ESA 实际能力支持的接入策略。
不得假设某种站点创建方式必然可用。
所有 API 调用必须支持幂等、错误重试和执行记录。
## 15.4 平台随机域名
保留以下域名生成规则:
日期 + 用户公开标识 + 版本。
例如:
20261031-hui-v1.example.com
需要增加项目唯一标识或随机后缀,防止冲突。
正式项目域名应保持稳定,不能因为每次更新网站就导致正式地址变化。
历史版本和预览版本可以拥有独立版本域名。
## 15.5 自定义域名
用户可以绑定自己的域名。
流程:
1. 用户填写域名。
2. 平台验证域名所有权。
3. 创建或关联 ESA 站点。
4. 配置回源。
5. 向用户提供 CNAME。
6. 用户配置 DNS。
7. 平台检测解析。
8. 自动配置 HTTPS。
9. 检查 CDN。
10. 绑定项目。
支持:
- 多域名。
- 主域名。
- 域名解绑。
- 域名验证。
- HTTPS。
- 自动续期。
- HTTP 跳转 HTTPS。
- 域名状态。
## 15.6 CDN 缓存
默认规则:
- 静态资源可以缓存。
- HTML 按项目策略缓存。
- 登录请求默认不缓存。
- API 请求默认不缓存。
- 用户隐私数据不缓存。
- WebSocket 支持正确转发。
- 缓存规则可以由管理员配置。
---
# 十六、网站流量计费
平台域名默认提供每月 5GB 免费流量。
超出部分按每 GB 0.5 CNY 计算。
以上价格必须允许管理员修改。
支持:
- 每日流量。
- 每月流量。
- 单网站流量。
- 用户总流量。
- 流量包。
- 超额计费。
- 流量提醒。
- 流量使用历史。
管理员可以设置:
- 默认免费流量。
- 超额价格。
- 流量包价格。
- 流量包有效期。
- 流量统计周期。
- 是否自动扣费。
- 流量不足时的处理方式。
自定义域名的流量政策可以由套餐配置。
流量统计必须避免重复计算 CDN 下行和回源流量。
优先使用 ESA 可获得的项目级流量统计数据;如果 API 无法提供准确的项目级统计,需要设计可靠的日志统计方案,并明确统计精度。
流量包和免费额度的抵扣顺序由管理员设置。
---
# 十七、网站运行配置套餐中心
网站运行资源可以购买。
套餐不是写死的,管理员可以随时创建和修改。
## 17.1 套餐管理
管理员可以创建任意数量的套餐。
例如:
免费版、基础版、专业版、企业版。
每个套餐配置:
- 套餐名称。
- 套餐介绍。
- 价格。
- 月付价格。
- 年付价格。
- 计费周期。
- CPU。
- 内存。
- 磁盘。
- 数据库空间。
- 对象存储。
- 持久化卷。
- 备份空间。
- 流量额度。
- 带宽限制。
- 域名数量。
- 服务数量。
- Worker 数量。
- 定时任务数量。
- WebSocket 权限。
- 自动部署权限。
- 数据库类型。
- 数据库模式。
- 是否允许独立数据库。
- 是否允许自动故障迁移。
- 是否允许手动迁移。
- 是否允许多副本。
- 是否允许独立节点。
- 备份策略。
所有资源参数都必须可配置。
## 17.2 默认配置
后台必须有独立的默认配置管理页面。
支持设置:
1. 新用户默认套餐。
2. 新项目默认 CPU。
3. 新项目默认内存。
4. 新项目默认磁盘。
5. 新项目默认流量。
6. 新数据库默认类型。
7. 新数据库默认模式。
8. 新项目默认存储。
9. 新项目默认备份策略。
10. 默认运行环境。
11. 默认故障恢复策略。
修改默认配置不能自动影响已有用户和项目。
## 17.3 资源扩展购买
用户可以单独购买:
- CPU 扩展。
- 内存扩展。
- 磁盘扩展。
- 数据库扩展。
- 对象存储扩展。
- 持久化卷扩展。
- 备份空间扩展。
- 流量包。
- 域名数量扩展。
- Worker 数量扩展。
管理员设置价格、有效期、限制及叠加规则。
## 17.4 套餐升级降级
支持:
- 套餐升级。
- 套餐降级。
- 月付。
- 年付。
- 差价计算。
- 资源变更。
- 自动续费选项。
升级前检查节点资源。
降级前检查实际资源使用情况。
如果用户当前使用资源超过新套餐限制,不允许直接执行破坏性降级。
## 17.5 持续运行
所有正式网站默认 7×24 小时运行。
不允许因为网站长时间无人访问而自动休眠。
AI 开发容器可以按任务启动和停止,但必须保存项目工作状态。
---
# 十八、AI 开发资源与网站运行资源分开计费
必须区分:
### AI 开发资源
用于:
- AI Agent。
- 终端命令。
- 依赖安装。
- 构建。
- 浏览器测试。
- 临时测试服务。
### 正式运行资源
用于:
- 网站容器。
- API。
- Worker。
- 定时任务。
- 数据库。
- 文件存储。
管理员可以分别设置资源上限。
购买网站运行套餐不意味着 AI 开发资源无限制。
---
# 十九、支付中心
必须支持以下支付渠道:
1. PayPal。
2. 微信支付。
3. 支付宝。
4. 易支付。
5. 码支付。
采用独立支付适配器架构。
不能将所有支付方式写在同一个业务逻辑中。
## 19.1 支付配置
管理员可以独立配置:
- 是否启用。
- 商户 ID。
- 商户密钥。
- API 地址。
- 回调地址。
- 支付方式。
- 其他渠道参数。
支持连接测试。
## 19.2 支付安全
必须:
- 验证支付签名。
- 校验订单金额。
- 校验商户信息。
- 防止重复回调。
- 防止重复充值。
- 处理订单超时。
- 记录支付状态。
- 支持退款记录。
- 支持订单查询。
- 支持异常订单处理。
不能仅凭前端返回支付成功就增加余额。
所有支付回调必须经过服务端验签和幂等处理。
## 19.3 订单管理
用户可以查看:
- 订单号。
- 订单金额。
- 支付方式。
- 创建时间。
- 支付时间。
- 订单状态。
- 退款状态。
管理员可以查询订单、查看回调记录、处理异常订单。
---
# 二十、优惠码系统
管理员可以创建优惠码。
支持:
- 固定金额优惠。
- 百分比优惠。
- 充值赠送。
- 指定套餐优惠。
- AI 开发费用优惠。
- 指定模型优惠。
- 流量包兑换。
- 资源包兑换。
每个优惠码可以设置:
- 使用次数。
- 每人使用次数。
- 有效期。
- 最低消费金额。
- 最高抵扣金额。
- 指定用户。
- 指定套餐。
- 是否允许叠加。
支持批量生成。
用户使用后记录完整的兑换历史。
---
# 二十一、邮件与短信系统
## 21.1 邮件配置
支持 SMTP。
管理员可以配置:
- SMTP 地址。
- 端口。
- 用户名。
- 密码。
- SSL/TLS。
- 发件人名称。
- 发件人邮箱。
提供测试邮件功能。
## 21.2 阿里云短信
使用阿里云 SMS API。
配置:
- AccessKey ID。
- AccessKey Secret。
- 地域。
- 短信签名。
- 模板 ID。
提供短信测试功能。
密钥加密存储。
## 21.3 模板管理
管理员可以创建、编辑、删除模板。
邮件模板包括:
- 注册验证码。
- 登录验证码。
- 密码重置。
- 充值成功。
- AI 开发完成。
- 网站部署成功。
- 网站故障通知。
- 余额不足。
- 流量超额。
- 订单通知。
短信模板也支持对应场景。
模板支持变量。
例如:
{{username}}
{{code}}
{{amount}}
{{project_name}}
{{domain}}
支持模板预览。
## 21.4 手动发送
后台增加消息发送中心。
管理员可以:
- 选择用户。
- 选择邮件模板。
- 选择短信模板。
- 填写变量。
- 发送消息。
- 查看发送状态。
- 查看发送失败原因。
支持批量发送,但必须设置频率限制和权限。
---
# 二十二、网站资源监控中心
用户可以查看自己的项目运行情况。
包括:
- 网站在线状态。
- CPU 使用率。
- 内存使用率。
- 磁盘使用率。
- 网络流量。
- 数据库状态。
- 容器状态。
- API 响应时间。
- 网站错误日志。
- 部署历史。
支持网站健康检查。
管理员可以配置检测频率。
网站出现异常时,可以:
- 自动重启。
- 自动恢复。
- 触发 AI 故障分析。
- 发送邮件。
- 发送短信。
- 创建故障事件。
AI 自动修复生产网站前,需要根据操作风险进行权限判断。
涉及数据库删除、重大配置变更等操作必须经过确认。
---
# 二十三、网站模板市场
预留网站模板市场功能。
管理员可以发布:
- 企业官网。
- 个人博客。
- 论坛。
- 商城。
- SaaS 后台。
- 管理系统。
- 文档网站。
支持:
- 免费模板。
- 付费模板。
- 模板分类。
- 模板预览。
- 模板安装。
- 模板版本。
- 模板更新。
用户可以基于模板让 AI 继续开发。
模板市场不应该影响核心 AI 开发流程。
---
# 二十四、Git 集成
支持:
- GitHub。
- GitLab。
- 自定义 Git 仓库。
用户可以:
- 导入仓库。
- 推送源码。
- 拉取更新。
- 查看提交记录。
- 指定分支。
- 设置自动部署。
- 通过提交触发构建。
Git 凭证需要加密保存。
---
# 二十五、管理员后台
管理员后台是整个商业平台的运营中心。
界面要求:
- 白色简洁风格。
- 支持深色模式。
- 清晰的侧边栏。
- 专业的数据表格。
- 搜索和筛选。
- 分页。
- 数据统计图表。
- 操作确认。
- 操作日志。
## 25.1 数据总览
显示:
- 用户总数。
- 今日新增用户。
- 在线用户。
- 项目总数。
- 网站运行数量。
- AI 开发任务数量。
- 今日 Token 使用量。
- 今日 AI 消费金额。
- 今日充值金额。
- 今日收入。
- 网站流量。
- 存储使用量。
- 服务器资源使用率。
- 故障数量。
## 25.2 用户管理
支持:
- 创建用户。
- 添加用户。
- 查看用户。
- 编辑用户。
- 禁用用户。
- 解封用户。
- 删除用户(软删除优先)。
- 修改用户角色。
- 修改用户套餐。
- 查看用户余额。
- 增加余额。
- 扣除余额。
- 查看用户项目。
- 查看用户消费。
- 查看登录 IP。
- 查看设备。
- 强制退出登录。
余额调整必须填写原因并写入审计日志。
## 25.3 AI 模型管理
支持供应商管理、模型管理、价格管理、模型开放权限、连接测试和调用日志。
## 25.4 AI 任务管理
管理员可以:
- 查看所有任务。
- 查看用户。
- 查看项目。
- 查看模型。
- 查看 Token 消耗。
- 查看费用。
- 查看运行日志。
- 暂停任务。
- 取消任务。
- 重试任务。
## 25.5 套餐管理
管理充值套餐、托管套餐、流量包和资源扩展包。
## 25.6 余额管理
支持:
- 查询。
- 增加。
- 扣除。
- 冻结。
- 解冻。
- 退款。
- 消费记录。
- 余额变动记录。
## 25.7 支付管理
管理所有支付渠道、订单、支付回调、退款和异常订单。
## 25.8 Pages 管理
管理:
- 项目。
- 网站。
- 域名。
- 部署。
- 版本。
- CDN。
- ESA 站点。
- DNS 记录。
- 流量。
- 证书。
## 25.9 节点管理
管理所有运行节点和资源。
## 25.10 存储管理
管理对象存储、数据库、持久化卷、缓存、镜像仓库和备份。
## 25.11 故障管理
管理故障事件、自动迁移、人工迁移和恢复记录。
## 25.12 消息中心
管理 SMTP、阿里云 SMS、模板和发送记录。
## 25.13 系统设置
可以设置:
- 网站名称。
- Logo。
- Favicon。
- 主域名。
- 备案信息。
- 页脚。
- 公告。
- 注册设置。
- 验证方式。
- 默认套餐。
- 默认模型。
- 默认资源配置。
- 默认数据库。
- 默认存储配置。
- 默认流量额度。
- 默认故障恢复策略。
---
# 二十六、后台权限管理
采用 RBAC 权限管理。
至少包含:
- 超级管理员。
- 普通管理员。
- 财务管理员。
- 技术运维管理员。
- 客服管理员。
权限可以细分到模块和操作。
例如:
财务管理员可以管理订单和余额,但不能修改服务器节点。
技术运维管理员可以管理节点,但不能随意修改用户余额。
所有管理员操作必须记录:
- 管理员 ID。
- 操作类型。
- 操作对象。
- 操作时间。
- IP。
- 操作结果。
- 操作前后变化。
敏感操作需要二次确认。
---
# 二十七、安全与风控
这是商业网站托管平台必须重视的部分。
## 27.1 用户隔离
- 用户之间的数据隔离。
- 项目之间的容器隔离。
- 数据库账号隔离。
- 文件存储隔离。
- 网络隔离。
- 环境变量隔离。
## 27.2 AI 开发安全
- AI 不能访问平台管理密钥。
- AI 不能读取其他用户项目。
- AI 不能访问宿主机敏感目录。
- AI 不能访问 Docker 管理接口。
- AI 执行命令必须在隔离环境中。
- AI 浏览器和终端需要 SSRF 防护。
- 限制访问云元数据和内部管理网络。
- 对上传文件进行安全检查。
## 27.3 网站安全
- 恶意文件扫描。
- 网站钓鱼检测。
- 恶意程序检测。
- 异常流量监控。
- 网站投诉。
- 违规网站暂停。
- 用户滥用检测。
## 27.4 平台安全
- API 限流。
- 防暴力破解。
- 防 SQL 注入。
- 防 XSS。
- CSRF 防护。
- 支付签名校验。
- 数据加密。
- 密钥轮换。
- 操作审计。
- 备份保护。
还需要提供服务条款、隐私政策和可接受使用政策的管理入口,具体法律文本由运营方审核配置。
---
# 二十八、核心数据库设计
使用 PostgreSQL 作为平台主数据库。
需要进行规范化设计。
至少考虑以下业务实体:
### 用户相关
- users
- user_profiles
- user_devices
- user_sessions
- user_roles
- roles
- permissions
- login_logs
### AI 相关
- ai_providers
- ai_models
- ai_model_price_versions
- ai_tasks
- ai_task_messages
- ai_task_steps
- ai_usage_records
- ai_tool_logs
### 项目相关
- projects
- project_services
- project_files
- project_versions
- project_environments
- project_environment_variables
- project_deployments
- project_domains
- project_logs
### 容器相关
- runtime_nodes
- node_agents
- node_heartbeats
- container_instances
- service_instances
- runtime_resource_usage
- runtime_events
### 数据库相关
- database_clusters
- database_instances
- project_databases
- database_backups
- database_restore_tasks
### 存储相关
- storage_clusters
- storage_buckets
- storage_volumes
- storage_snapshots
- storage_backups
- storage_usage_records
- image_registry_records
### 迁移与高可用
- migration_tasks
- migration_steps
- failover_policies
- failure_events
- recovery_tasks
- node_maintenance_tasks
### 计费相关
- wallets
- wallet_ledger
- wallet_reservations
- recharge_orders
- consumption_records
- billing_plans
- plan_resources
- user_subscriptions
- resource_addons
- traffic_packages
- traffic_usage_records
- coupons
- coupon_redemptions
### 支付相关
- payment_channels
- payment_orders
- payment_callbacks
- refund_orders
### 消息相关
- email_configs
- sms_configs
- email_templates
- sms_templates
- message_records
### 管理相关
- admin_users
- admin_roles
- admin_permissions
- admin_operation_logs
- system_settings
- system_notifications
- security_events
以上为业务实体建议,实际可以合理拆分或合并,但必须保证数据关系完整。
所有重要表需要:
- 主键。
- 外键。
- 必要索引。
- 创建时间。
- 更新时间。
- 状态字段。
- 软删除策略(适用时)。
资金、支付、任务和迁移等业务必须考虑事务、幂等及并发控制。
---
# 二十九、系统运行与可观测性
平台必须具备完整的监控和日志体系。
至少包括:
- 应用日志。
- AI 请求日志。
- 容器日志。
- 节点日志。
- 构建日志。
- 部署日志。
- 支付日志。
- 数据库日志。
- 迁移日志。
- 故障日志。
支持:
- 日志搜索。
- 时间筛选。
- 项目筛选。
- 用户筛选。
- 错误等级筛选。
支持基础设施监控:
- CPU。
- 内存。
- 磁盘。
- 网络。
- 容器数量。
- 数据库连接数。
- Redis 状态。
- 对象存储状态。
- 节点心跳。
可以采用 Prometheus、Grafana、OpenTelemetry、Loki 等成熟方案。
不能让日志无限增长,必须配置轮转、保留期限和容量限制。
---
# 三十、网站运行状态和欠费处理
网站需要始终运行,但必须有明确的欠费策略。
余额不足时:
1. 通知用户。
2. 暂停新的 AI 开发任务。
3. 根据套餐和账单策略提醒充值。
4. 进入可配置的欠费宽限期。
5. 宽限期结束后,根据合同和套餐规则暂停服务。
6. 保留项目数据及备份一段时间。
7. 用户补缴后允许恢复。
不能因为余额不足就直接删除用户的网站和数据库。
所有数据清理必须经过明确的保留期限和安全检查。
---
# 三十一、前端设计要求
整体采用专业 SaaS 平台风格。
要求:
- 简洁。
- 白色主题为主。
- 支持深色模式。
- 响应式。
- 统一组件。
- 统一表格风格。
- 统一弹窗风格。
- 清晰的导航。
- 合理的空状态。
- 合理的加载状态。
- 完整的错误提示。
- 操作成功提示。
AI 开发页面应重点优化:
- 对话区域。
- 文件树。
- 开发过程。
- 实时日志。
- 在线预览。
- Token 和费用展示。
支持桌面浏览器优先,兼容移动端。
不能把所有页面做成同一个简单模板。
---
# 三十二、开发阶段规划
这是一个大型系统,必须分阶段开发。
不能一次性生成大量没有实际功能的页面。
## 第一阶段:项目基础
完成:
- 前后端项目初始化。
- PostgreSQL。
- Redis。
- 用户系统。
- 登录注册。
- 图片验证码。
- 用户权限。
- 管理员后台基础。
- 系统配置。
要求能够本地运行。
## 第二阶段:AI 模型与开发系统
完成:
- 供应商管理。
- 模型管理。
- 中转站接入。
- 模型计费。
- Token 统计。
- 钱包。
- 余额预留。
- AI Agent。
- 开发容器。
- 文件操作。
- 终端操作。
- 浏览器测试。
- 多轮开发。
- 在线预览。
## 第三阶段:项目和网站运行
完成:
- 项目管理。
- Dockerfile 构建。
- OCI 镜像。
- 多服务项目。
- 运行环境管理。
- 容器调度。
- 服务发现。
- 健康检查。
- 网站持续运行。
- 运行日志。
- 资源监控。
## 第四阶段:数据库与存储
完成:
- PostgreSQL 集群。
- MySQL / MariaDB。
- 共享数据库。
- 独立数据库。
- 对象存储。
- 持久化卷。
- 本地缓存。
- 镜像仓库。
- 备份。
- 恢复。
## 第五阶段:Pages 与 CDN
完成:
- 网站部署。
- 版本管理。
- 在线预览。
- 平台二级域名。
- 自定义域名。
- 阿里云 ESA API。
- DNS API。
- 非标准端口回源。
- SSL。
- CDN 缓存。
- 流量统计。
## 第六阶段:多节点与高可用
完成:
- 节点 Agent。
- 节点管理。
- 资源调度。
- 网站迁移。
- 数据库迁移。
- 存储迁移。
- 故障检测。
- 自动故障迁移。
- 手动故障恢复。
- 备用资源管理。
## 第七阶段:商业化
完成:
- 充值。
- PayPal。
- 微信支付。
- 支付宝。
- 易支付。
- 码支付。
- 套餐。
- 资源包。
- 流量包。
- 优惠码。
- 退款。
- 账单。
- 邮件。
- 短信。
## 第八阶段:运营和安全
完成:
- 用户管理。
- 管理员权限。
- 风控。
- 网站审核。
- 操作日志。
- 监控。
- 告警。
- 消息中心。
- 备份测试。
- 安全测试。
---
# 三十三、测试要求
不能仅以页面能够打开作为开发完成标准。
必须进行完整测试。
## 33.1 用户系统
- 注册。
- 登录。
- 图片验证码。
- 邮箱验证。
- 短信验证。
- 密码找回。
- 权限验证。
## 33.2 AI 系统
- 多供应商连接。
- 中转站连接。
- 多模型调用。
- Token 统计。
- 费用计算。
- 余额不足。
- 任务中断。
- 任务恢复。
- 多轮修改。
- 文件操作。
- 终端执行。
- 构建测试。
## 33.3 容器系统
- 容器创建。
- 容器重启。
- 容器停止。
- 容器重建。
- CPU 限制。
- 内存限制。
- 磁盘限制。
- 网络隔离。
- 项目隔离。
- 多服务运行。
## 33.4 数据库和存储
- 自动创建数据库。
- 数据库隔离。
- 数据库备份。
- 数据库恢复。
- 文件上传。
- 文件下载。
- 持久化卷。
- 卷快照。
- 跨节点恢复。
## 33.5 部署系统
- 静态网站。
- 动态网站。
- 多服务项目。
- API 服务。
- WebSocket。
- 自定义域名。
- 平台域名。
- CDN。
- HTTPS。
- 非标准端口回源。
- 版本回滚。
## 33.6 故障测试
必须模拟:
- 容器崩溃。
- 网站进程崩溃。
- 节点断网。
- 节点宕机。
- 数据库故障。
- 存储异常。
- 迁移失败。
- 新版本部署失败。
验证自动恢复和人工恢复是否正常。
故障演练必须在测试环境中进行,不能拿真实生产用户数据做破坏性测试。
## 33.7 支付测试
- 创建订单。
- 支付成功。
- 支付失败。
- 回调验签。
- 重复回调。
- 超时订单。
- 退款。
- 余额到账。
- 账单记录。
所有支付渠道必须在真实商户测试环境或正式授权环境中验证。
没有配置真实凭证时,不得声称支付已经完成真实联调。
---
# 三十四、开发执行要求
请严格遵守以下要求。
1. 开始前检查当前工作目录和现有项目。
2. 如果已经存在代码,先分析现有结构,不要随意删除或覆盖。
3. 如果是空目录,建立完整项目结构。
4. 先输出技术架构、模块划分、数据库设计和实施计划。
5. 然后按照开发阶段持续实施,不要只给出方案。
6. 每完成一个阶段都必须实际运行测试。
7. 发现错误必须修复,不要通过隐藏错误或绕过测试来宣布成功。
8. 所有核心功能必须有真实业务逻辑。
9. 所有页面必须连接真实后端接口。
10. 所有重要数据必须持久化。
11. 所有 API 必须有权限验证。
12. 所有敏感操作必须有审计日志。
13. 所有配置必须有合理默认值。
14. 所有密钥不得硬编码。
15. 必须提供 `.env.example`。
16. 不得提交真实 API Key、支付密钥和数据库密码。
17. 数据库必须使用迁移工具管理。
18. 不能使用大量虚假数据代替真实功能。
19. 不允许出现点击无效的按钮。
20. 不允许出现只有 UI 没有后端实现的功能。
21. 第三方 API 未配置时,必须明确显示未配置或未连接。
22. 不允许伪造 API 调用成功。
23. 所有异步任务必须有状态管理、超时、重试和失败记录。
24. 资金相关业务必须考虑幂等、事务和并发。
25. 容器相关操作必须通过受控的基础设施管理接口执行。
26. 不能把 Docker Socket 暴露给用户网站。
27. 不允许未经授权修改生产数据库。
28. 不允许删除用户数据而不经过明确的生命周期策略。
29. 所有模块必须考虑未来多节点扩展。
30. 不要为了赶进度省略安全隔离和数据备份。
如果某个第三方接口缺少 API 凭证:
- 先实现完整适配器。
- 实现配置界面。
- 实现连接测试。
- 实现错误处理。
- 使用 Mock 进行开发测试。
- 明确标注真实接口尚未联调。
不得伪造第三方 API 成功结果。
---
# 三十五、最终交付要求
开发完成后必须交付:
1. 完整前端源码。
2. 完整后端源码。
3. AI Agent 相关代码。
4. 节点 Agent。
5. Dockerfile 和 OCI 构建配置。
6. 容器编排配置。
7. 数据库迁移文件。
8. 数据库初始化脚本。
9. 默认系统配置。
10. 完整 API 文档。
11. 管理员使用说明。
12. 用户使用说明。
13. 节点安装说明。
14. 服务器部署说明。
15. 阿里云 ESA 接入说明。
16. DNS 配置说明。
17. 支付接口配置说明。
18. SMTP 配置说明。
19. 阿里云短信配置说明。
20. 数据备份和恢复说明。
21. 故障迁移说明。
22. 安全配置说明。
23. 测试报告。
24. `.env.example`。
25. 完整的 Docker Compose 本地开发环境配置。
必须提供可以实际运行的本地开发环境。
本地环境至少包含:
- PostgreSQL。
- Redis。
- 后端服务。
- 前端服务。
- 对象存储测试服务。
- AI Worker。
- 必要的测试组件。
生产环境配置应与本地开发配置分离。
必须提供部署脚本、数据库迁移命令和初始化管理员的安全流程。
---
# 三十六、最终验收标准
只有同时满足以下条件,才能宣布项目完成:
1. 用户可以正常注册、登录。
2. 用户可以充值并查看余额。
3. 管理员可以配置多个 AI 供应商。
4. 用户可以选择开放的 AI 模型。
5. AI 可以真正使用终端和文件工具开发网站。
6. AI 可以开发前端、后端和数据库。
7. AI 可以开发多个独立服务组成的网站。
8. AI 开发费用可以按照实际 Token 用量计算。
9. 用户可以在线预览网站。
10. 用户可以下载完整网站源码。
11. 网站可以构建为容器镜像。
12. 网站能够 7×24 小时持续运行。
13. 网站能够连接数据库和对象存储。
14. 用户可以购买运行配置套餐。
15. 管理员可以配置默认资源。
16. 网站能够部署到多个服务器节点。
17. 网站可以绑定平台域名和自定义域名。
18. 阿里云 ESA 可以按实际接口完成自动化配置。
19. 非标准端口回源能够正常工作。
20. 网站流量能够统计和计费。
21. 网站能够跨节点迁移。
22. 自动故障迁移能够按照套餐生效。
23. 管理员能够手动恢复网站。
24. 数据库和文件能够备份、恢复。
25. 支付回调能够正确验签和防重复。
26. 优惠码能够正常使用。
27. 邮件和短信能够真实发送。
28. 用户数据与项目数据相互隔离。
29. 管理员可以管理全部核心业务。
30. 整个平台具备完整的日志、监控和审计能力。
**最重要的原则:这是一个真正提供 AI 开发和云托管服务的商业平台,不是一个只展示功能的 Demo。**
请以长期运行、可扩展、可维护、安全隔离和真实商业运营为设计目标,完成整个项目。
在开发过程中,如果发现某个设计存在技术风险、第三方接口限制或资源成本问题,应主动指出并提出可实施的替代方案,不要为了满足文字要求而实现一个实际上无法可靠运行的功能。