forked from xhgit/webup-cloud
2718 lines
53 KiB
Markdown
2718 lines
53 KiB
Markdown
# 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。**
|
||
|
||
请以长期运行、可扩展、可维护、安全隔离和真实商业运营为设计目标,完成整个项目。
|
||
|
||
在开发过程中,如果发现某个设计存在技术风险、第三方接口限制或资源成本问题,应主动指出并提出可实施的替代方案,不要为了满足文字要求而实现一个实际上无法可靠运行的功能。 |