53 KiB
AI 全栈网站开发与云托管平台——完整开发需求
一、项目总体说明
你现在需要从零开发一个完整的商业化 AI 网站开发与云托管平台。
这不是一个普通的 AI 网站生成器,而是一个集以下能力于一体的平台:
- AI 全栈网站自动开发。
- 多大模型、多供应商及 AI 中转站接入。
- AI Agent 自动编写代码、运行命令、安装依赖、调试和测试。
- Docker/OCI 容器化开发与网站运行。
- 多服务器节点管理及资源调度。
- 网站 7×24 小时持续运行。
- 网站在线预览、源码下载和版本管理。
- 静态网站、动态网站、后端服务和数据库托管。
- 类似 Cloudflare Pages 的网站部署服务。
- 阿里云 ESA CDN、DNS API 自动化接入。
- 自定义域名及平台随机二级域名。
- 网站资源迁移、故障检测及自动故障恢复。
- PostgreSQL、MySQL、MariaDB 数据库服务。
- 对象存储、持久化卷、缓存及镜像仓库。
- AI Token 计费、余额系统、托管套餐及流量计费。
- 微信支付、支付宝、PayPal、易支付、码支付。
- 完整的管理员后台、用户管理和运营系统。
- 邮件、短信、优惠码、通知及风控系统。
平台必须具备真实可用的业务逻辑,不能只是展示界面。
所有功能必须有实际后端接口、数据库结构、权限验证和必要的自动化流程。
平台名称、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 整体架构
系统划分为以下中心:
- 用户中心。
- AI 开发中心。
- 项目管理中心。
- 云托管中心。
- Pages 部署中心。
- 数据库管理中心。
- 统一存储中心。
- 节点调度中心。
- 高可用与容灾中心。
- 计费中心。
- 支付中心。
- 消息通知中心。
- 管理员运营中心。
各中心之间通过明确的服务接口通信。
所有核心业务数据统一由 PostgreSQL 管理。
Redis 不能作为核心业务数据的唯一存储位置。
三、用户注册、登录与账户管理
3.1 注册系统
支持:
- 用户注册。
- 用户登录。
- 用户退出。
- 找回密码。
- 修改密码。
- 邮箱绑定。
- 手机号绑定。
- 修改邮箱。
- 修改手机号。
- 用户账户状态管理。
管理员可以设置注册验证方式:
- 不验证。
- 邮箱验证。
- 短信验证。
- 邮箱和短信同时验证。
注册和登录均必须支持服务器生成的图片验证码。
3.2 图片验证码
要求:
- 图片由服务器生成。
- 验证码随机生成。
- 验证码具有过期时间。
- 验证码一次性使用。
- 验证失败后不能重复使用原验证码。
- 具有防暴力破解机制。
- 支持刷新验证码。
- 验证码不能仅在前端进行校验。
3.3 用户设备管理
记录用户:
- 注册 IP。
- 登录 IP。
- 登录时间。
- User-Agent。
- 浏览器信息。
- 操作系统信息。
- 设备标识。
- 登录结果。
- 登录异常记录。
用户可以查看自己的登录历史和设备会话。
管理员可以查看用户设备信息、登录记录,并强制注销异常会话。
注意:设备信息采集应遵守隐私保护要求,不要收集不必要的信息。
3.4 用户账户安全
支持:
- 密码强度配置。
- 登录频率限制。
- 验证码错误限制。
- IP 限制。
- 用户封禁。
- 用户解封。
- 强制退出登录。
- 管理员操作审计。
四、用户控制台
用户登录后进入独立控制台。
界面采用现代 SaaS 风格,简洁、专业,以白色为主,支持深色模式。
侧边栏包括:
控制台
- 数据概览。
- 当前余额。
- 项目数量。
- 正在运行的网站。
- AI 开发任务。
- 资源使用情况。
- 最近消费记录。
- 系统通知。
AI 开发
- 创建 AI 网站。
- 我的开发项目。
- 开发任务。
- AI 对话记录。
- 模型选择。
- 开发费用记录。
项目管理
- 我的项目。
- 项目文件。
- 项目版本。
- 在线预览。
- 源码下载。
- 项目部署。
- 运行日志。
- 项目设置。
云托管
- 网站列表。
- 网站运行状态。
- 运行资源。
- 数据库管理。
- 存储管理。
- 域名管理。
- CDN 管理。
- 网站备份。
- 网站迁移记录。
账户与计费
- 余额中心。
- 余额充值。
- 消费明细。
- 订单管理。
- 套餐购买。
- 资源升级。
- 流量包。
- 优惠码。
个人设置
- 个人资料。
- 邮箱和手机号。
- 密码修改。
- 设备管理。
- 登录记录。
- 消息通知设置。
五、AI 全栈网站开发中心
这是整个产品最核心的业务模块。
5.1 创建项目
用户可以通过以下方式创建项目:
- AI 从零开发。
- 上传已有网站源码。
- 导入 GitHub 仓库。
- 导入 GitLab 仓库。
- 使用平台模板创建。
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 开发采用:
- 估算开发费用。
- 检查用户余额。
- 预留预算。
- 开始开发。
- 按实际 Token 使用量计算费用。
- 结算真实消费。
- 释放未使用的预留金额。
例如:
预估费用: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 判断项目需要数据库时,可以申请数据库资源。
自动执行:
- 检查套餐权限。
- 检查资源配额。
- 创建数据库。
- 创建数据库账号。
- 配置权限。
- 生成连接配置。
- 执行数据库迁移。
- 测试连接。
- 将数据库绑定到项目。
破坏性生产数据库迁移必须先备份,并按风险要求取得用户确认。
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 迁移流程
- 选择目标节点。
- 检查目标节点资源。
- 检查运行环境兼容性。
- 同步镜像。
- 同步持久化数据。
- 执行数据库同步。
- 创建目标容器。
- 恢复环境变量。
- 启动新服务。
- 执行健康检查。
- 最终数据同步。
- 切换入口流量。
- 确认迁移成功。
- 释放旧节点资源。
- 保留回滚信息。
支持低停机迁移和维护窗口迁移。
必须考虑数据库写入一致性,不能只复制文件后就宣布迁移成功。
12.4 迁移后台
显示:
- 迁移 ID。
- 用户。
- 项目。
- 原节点。
- 目标节点。
- 迁移类型。
- 当前阶段。
- 进度。
- 已同步数据量。
- 数据库状态。
- 健康检查结果。
- 开始时间。
- 完成时间。
- 错误日志。
支持:
- 取消。
- 重试。
- 回滚。
- 批量迁移。
- 查看历史。
十三、高可用与故障恢复中心
必须支持自动故障恢复和管理员手动恢复。
具体权限按照套餐配置。
13.1 故障类型
- 网站进程崩溃。
- 容器崩溃。
- 节点宕机。
- 节点网络异常。
- 数据库故障。
- 磁盘故障。
- 网关故障。
- 存储故障。
13.2 基础恢复
网站进程异常时自动重启。
容器异常时自动重建。
节点故障时执行套餐对应的恢复策略。
13.3 套餐控制
管理员可以为不同套餐配置:
- 是否允许自动故障迁移。
- 是否允许手动迁移。
- 是否允许多副本。
- 是否允许备用节点。
- 是否提供数据库高可用。
- RTO 目标。
- RPO 目标。
- 故障通知方式。
- 故障恢复优先级。
免费版可以只支持管理员手动恢复。
高级套餐可以开启自动故障迁移。
具体权限不得硬编码。
13.4 自动故障迁移
检测到节点故障:
- 多次检查节点心跳。
- 通过独立探测验证故障。
- 确认故障状态。
- 检查目标节点资源。
- 确认旧节点已经隔离或被可靠 fencing。
- 恢复网站。
- 恢复数据库连接。
- 恢复持久化数据。
- 健康检查。
- 切换流量。
- 通知用户。
- 记录故障事件。
必须防止旧节点恢复后出现两个实例同时写入同一份数据的情况。
不能只依赖 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 自动部署域名
用户选择平台域名时:
- 生成项目域名。
- 根据配置创建或关联 ESA 站点。
- 配置 CDN 回源。
- 配置源站非标准端口。
- 调用阿里云 DNS API 添加解析。
- 检查 DNS。
- 检查 ESA。
- 检查源站。
- 配置 HTTPS。
- 完成部署。
ESA 站点管理必须根据实际 API 能力、账户配额和域名接入规则设计。
支持管理员选择:
- 每个项目独立站点。
- 统一站点加通配符域名。
- 其他受 ESA 实际能力支持的接入策略。
不得假设某种站点创建方式必然可用。
所有 API 调用必须支持幂等、错误重试和执行记录。
15.4 平台随机域名
保留以下域名生成规则:
日期 + 用户公开标识 + 版本。
例如:
20261031-hui-v1.example.com
需要增加项目唯一标识或随机后缀,防止冲突。
正式项目域名应保持稳定,不能因为每次更新网站就导致正式地址变化。
历史版本和预览版本可以拥有独立版本域名。
15.5 自定义域名
用户可以绑定自己的域名。
流程:
- 用户填写域名。
- 平台验证域名所有权。
- 创建或关联 ESA 站点。
- 配置回源。
- 向用户提供 CNAME。
- 用户配置 DNS。
- 平台检测解析。
- 自动配置 HTTPS。
- 检查 CDN。
- 绑定项目。
支持:
- 多域名。
- 主域名。
- 域名解绑。
- 域名验证。
- HTTPS。
- 自动续期。
- HTTP 跳转 HTTPS。
- 域名状态。
15.6 CDN 缓存
默认规则:
- 静态资源可以缓存。
- HTML 按项目策略缓存。
- 登录请求默认不缓存。
- API 请求默认不缓存。
- 用户隐私数据不缓存。
- WebSocket 支持正确转发。
- 缓存规则可以由管理员配置。
十六、网站流量计费
平台域名默认提供每月 5GB 免费流量。
超出部分按每 GB 0.5 CNY 计算。
以上价格必须允许管理员修改。
支持:
- 每日流量。
- 每月流量。
- 单网站流量。
- 用户总流量。
- 流量包。
- 超额计费。
- 流量提醒。
- 流量使用历史。
管理员可以设置:
- 默认免费流量。
- 超额价格。
- 流量包价格。
- 流量包有效期。
- 流量统计周期。
- 是否自动扣费。
- 流量不足时的处理方式。
自定义域名的流量政策可以由套餐配置。
流量统计必须避免重复计算 CDN 下行和回源流量。
优先使用 ESA 可获得的项目级流量统计数据;如果 API 无法提供准确的项目级统计,需要设计可靠的日志统计方案,并明确统计精度。
流量包和免费额度的抵扣顺序由管理员设置。
十七、网站运行配置套餐中心
网站运行资源可以购买。
套餐不是写死的,管理员可以随时创建和修改。
17.1 套餐管理
管理员可以创建任意数量的套餐。
例如:
免费版、基础版、专业版、企业版。
每个套餐配置:
- 套餐名称。
- 套餐介绍。
- 价格。
- 月付价格。
- 年付价格。
- 计费周期。
- CPU。
- 内存。
- 磁盘。
- 数据库空间。
- 对象存储。
- 持久化卷。
- 备份空间。
- 流量额度。
- 带宽限制。
- 域名数量。
- 服务数量。
- Worker 数量。
- 定时任务数量。
- WebSocket 权限。
- 自动部署权限。
- 数据库类型。
- 数据库模式。
- 是否允许独立数据库。
- 是否允许自动故障迁移。
- 是否允许手动迁移。
- 是否允许多副本。
- 是否允许独立节点。
- 备份策略。
所有资源参数都必须可配置。
17.2 默认配置
后台必须有独立的默认配置管理页面。
支持设置:
- 新用户默认套餐。
- 新项目默认 CPU。
- 新项目默认内存。
- 新项目默认磁盘。
- 新项目默认流量。
- 新数据库默认类型。
- 新数据库默认模式。
- 新项目默认存储。
- 新项目默认备份策略。
- 默认运行环境。
- 默认故障恢复策略。
修改默认配置不能自动影响已有用户和项目。
17.3 资源扩展购买
用户可以单独购买:
- CPU 扩展。
- 内存扩展。
- 磁盘扩展。
- 数据库扩展。
- 对象存储扩展。
- 持久化卷扩展。
- 备份空间扩展。
- 流量包。
- 域名数量扩展。
- Worker 数量扩展。
管理员设置价格、有效期、限制及叠加规则。
17.4 套餐升级降级
支持:
- 套餐升级。
- 套餐降级。
- 月付。
- 年付。
- 差价计算。
- 资源变更。
- 自动续费选项。
升级前检查节点资源。
降级前检查实际资源使用情况。
如果用户当前使用资源超过新套餐限制,不允许直接执行破坏性降级。
17.5 持续运行
所有正式网站默认 7×24 小时运行。
不允许因为网站长时间无人访问而自动休眠。
AI 开发容器可以按任务启动和停止,但必须保存项目工作状态。
十八、AI 开发资源与网站运行资源分开计费
必须区分:
AI 开发资源
用于:
- AI Agent。
- 终端命令。
- 依赖安装。
- 构建。
- 浏览器测试。
- 临时测试服务。
正式运行资源
用于:
- 网站容器。
- API。
- Worker。
- 定时任务。
- 数据库。
- 文件存储。
管理员可以分别设置资源上限。
购买网站运行套餐不意味着 AI 开发资源无限制。
十九、支付中心
必须支持以下支付渠道:
- PayPal。
- 微信支付。
- 支付宝。
- 易支付。
- 码支付。
采用独立支付适配器架构。
不能将所有支付方式写在同一个业务逻辑中。
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 等成熟方案。
不能让日志无限增长,必须配置轮转、保留期限和容量限制。
三十、网站运行状态和欠费处理
网站需要始终运行,但必须有明确的欠费策略。
余额不足时:
- 通知用户。
- 暂停新的 AI 开发任务。
- 根据套餐和账单策略提醒充值。
- 进入可配置的欠费宽限期。
- 宽限期结束后,根据合同和套餐规则暂停服务。
- 保留项目数据及备份一段时间。
- 用户补缴后允许恢复。
不能因为余额不足就直接删除用户的网站和数据库。
所有数据清理必须经过明确的保留期限和安全检查。
三十一、前端设计要求
整体采用专业 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 支付测试
- 创建订单。
- 支付成功。
- 支付失败。
- 回调验签。
- 重复回调。
- 超时订单。
- 退款。
- 余额到账。
- 账单记录。
所有支付渠道必须在真实商户测试环境或正式授权环境中验证。
没有配置真实凭证时,不得声称支付已经完成真实联调。
三十四、开发执行要求
请严格遵守以下要求。
- 开始前检查当前工作目录和现有项目。
- 如果已经存在代码,先分析现有结构,不要随意删除或覆盖。
- 如果是空目录,建立完整项目结构。
- 先输出技术架构、模块划分、数据库设计和实施计划。
- 然后按照开发阶段持续实施,不要只给出方案。
- 每完成一个阶段都必须实际运行测试。
- 发现错误必须修复,不要通过隐藏错误或绕过测试来宣布成功。
- 所有核心功能必须有真实业务逻辑。
- 所有页面必须连接真实后端接口。
- 所有重要数据必须持久化。
- 所有 API 必须有权限验证。
- 所有敏感操作必须有审计日志。
- 所有配置必须有合理默认值。
- 所有密钥不得硬编码。
- 必须提供
.env.example。 - 不得提交真实 API Key、支付密钥和数据库密码。
- 数据库必须使用迁移工具管理。
- 不能使用大量虚假数据代替真实功能。
- 不允许出现点击无效的按钮。
- 不允许出现只有 UI 没有后端实现的功能。
- 第三方 API 未配置时,必须明确显示未配置或未连接。
- 不允许伪造 API 调用成功。
- 所有异步任务必须有状态管理、超时、重试和失败记录。
- 资金相关业务必须考虑幂等、事务和并发。
- 容器相关操作必须通过受控的基础设施管理接口执行。
- 不能把 Docker Socket 暴露给用户网站。
- 不允许未经授权修改生产数据库。
- 不允许删除用户数据而不经过明确的生命周期策略。
- 所有模块必须考虑未来多节点扩展。
- 不要为了赶进度省略安全隔离和数据备份。
如果某个第三方接口缺少 API 凭证:
- 先实现完整适配器。
- 实现配置界面。
- 实现连接测试。
- 实现错误处理。
- 使用 Mock 进行开发测试。
- 明确标注真实接口尚未联调。
不得伪造第三方 API 成功结果。
三十五、最终交付要求
开发完成后必须交付:
- 完整前端源码。
- 完整后端源码。
- AI Agent 相关代码。
- 节点 Agent。
- Dockerfile 和 OCI 构建配置。
- 容器编排配置。
- 数据库迁移文件。
- 数据库初始化脚本。
- 默认系统配置。
- 完整 API 文档。
- 管理员使用说明。
- 用户使用说明。
- 节点安装说明。
- 服务器部署说明。
- 阿里云 ESA 接入说明。
- DNS 配置说明。
- 支付接口配置说明。
- SMTP 配置说明。
- 阿里云短信配置说明。
- 数据备份和恢复说明。
- 故障迁移说明。
- 安全配置说明。
- 测试报告。
.env.example。- 完整的 Docker Compose 本地开发环境配置。
必须提供可以实际运行的本地开发环境。
本地环境至少包含:
- PostgreSQL。
- Redis。
- 后端服务。
- 前端服务。
- 对象存储测试服务。
- AI Worker。
- 必要的测试组件。
生产环境配置应与本地开发配置分离。
必须提供部署脚本、数据库迁移命令和初始化管理员的安全流程。
三十六、最终验收标准
只有同时满足以下条件,才能宣布项目完成:
- 用户可以正常注册、登录。
- 用户可以充值并查看余额。
- 管理员可以配置多个 AI 供应商。
- 用户可以选择开放的 AI 模型。
- AI 可以真正使用终端和文件工具开发网站。
- AI 可以开发前端、后端和数据库。
- AI 可以开发多个独立服务组成的网站。
- AI 开发费用可以按照实际 Token 用量计算。
- 用户可以在线预览网站。
- 用户可以下载完整网站源码。
- 网站可以构建为容器镜像。
- 网站能够 7×24 小时持续运行。
- 网站能够连接数据库和对象存储。
- 用户可以购买运行配置套餐。
- 管理员可以配置默认资源。
- 网站能够部署到多个服务器节点。
- 网站可以绑定平台域名和自定义域名。
- 阿里云 ESA 可以按实际接口完成自动化配置。
- 非标准端口回源能够正常工作。
- 网站流量能够统计和计费。
- 网站能够跨节点迁移。
- 自动故障迁移能够按照套餐生效。
- 管理员能够手动恢复网站。
- 数据库和文件能够备份、恢复。
- 支付回调能够正确验签和防重复。
- 优惠码能够正常使用。
- 邮件和短信能够真实发送。
- 用户数据与项目数据相互隔离。
- 管理员可以管理全部核心业务。
- 整个平台具备完整的日志、监控和审计能力。
最重要的原则:这是一个真正提供 AI 开发和云托管服务的商业平台,不是一个只展示功能的 Demo。
请以长期运行、可扩展、可维护、安全隔离和真实商业运营为设计目标,完成整个项目。
在开发过程中,如果发现某个设计存在技术风险、第三方接口限制或资源成本问题,应主动指出并提出可实施的替代方案,不要为了满足文字要求而实现一个实际上无法可靠运行的功能。