docs: 3.5.0设计文档

docs/v3.5/Web与服务端生成策略.md

@@ -1,8 +1,10 @@
 # Doodle Mini v3.5 Web 与服务端生成策略
 
-> 状态：架构决策草案
+> 状态：迁移到自有云服务器的方向已确认；Web 与绘图试点待实施
 >
-> 更新日期：2026-09-24
+> 更新日期：2026-10-12
+
+> 现有业务后端的迁移范围、切换顺序和验收以[云服务端迁移方案（doodle-store）](../../../doodle-store/docs/云服务端迁移方案.md)为准。本文说明迁移后 Web 与服务端生成的演进，不再以继续保留 CloudBase 业务后端为目标。
 
 ## 1. 决策结论
 
@@ -10,9 +12,7 @@
 
 Web 是长期的搜索获客、内容沉淀、电脑打印和教师/机构扩展渠道；小程序仍是当前的微信内打开、分享、每日推荐和家庭留存主产品。
 
-因此，v3.5 采用：
-
-> **70% 投入小程序核心体验，30% 投入 Web 与服务端生成试点。**
+v3.5 将现有业务后端迁移作为独立实施任务，小程序体验和小规模 Web/服务端生成按里程碑推进，不预设固定投入比例。
 
 不等待小程序“达到很大用户量”才准备 Web，因为搜索内容、服务端渲染和内容生产机制都需要时间积累；但也不在内容库、内容生产和核心留存未验证时建设完整 Web 平台。
 
@@ -102,28 +102,27 @@ favoriteService.toggle(worksheetId)
 historyService.list()
 ```
 
-小程序适配器可以暂时使用云函数，Web 使用 HTTP；上层页面不感知具体实现。
+新版小程序与后续 Web 统一使用 HTTP 业务 API；旧版云函数只在过渡期转发同一业务实现。上层页面不感知数据库与文件存储实现。
 
 ## 5. 后端演进路径
 
-### 阶段 A：现在至创意涂色 MVP
+### 阶段 A：现有业务后端迁移
 
-- 保留 CloudBase 数据库、存储和既有云函数。
-- 新建可通过 HTTP 调用的 Render API；可先使用 CloudBase 云托管容器，无需立即维护独立云服务器。
-- 私有素材存放在不可公开枚举的对象存储路径；最终文件通过短期 URL 交付。
-- 只迁移创意涂色纸，验证延迟、成本和保护边界。
+- 按专项方案迁移现有云函数、数据库、文件和定时任务到自有腾讯云服务器 + MySQL + 七牛。
+- 新版小程序经业务服务层调用统一 HTTP API；短期兼容桥照顾旧正式版本，只有一个业务写入源。
+- 先保持现有生成与保存行为，再验收数据关联、文件、计数和切换；不同时重写所有绘图代码。
 
-### 阶段 B：Web 小规模试点
+### 阶段 B：服务端生成样板
 
-- Web 调用统一 HTTP API；小程序继续调用业务服务层。
-- 新题型优先服务端生成；旧题型按商业价值与迁移成本逐步处理。
-- 增加异步渲染任务、缓存、批量导出和基础监控。
+- 在同一后端增加受控 Render API，以创意涂色或一个简单现有题型验证生成、字体、延迟和文件交付。
+- 原始素材和模板采用私有存储；最终文件通过受控地址交付，不依赖隐藏对象路径保护素材。
+- 根据实际任务量增加缓存/异步处理，不预先搭建独立队列平台。
 
-### 阶段 C：扩张决策
+### 阶段 C：Web 小规模试点与扩张
 
-当 Web 需要 SEO、会员支付、复杂搜索、教师版、批量 PDF、AI/异步任务，或 CloudBase 成本与能力成为瓶颈时，再迁核心 API 到 NestJS + MySQL/对象存储。
-
-迁移的是业务 API 和数据，不是让前端重新实现一套生成逻辑。
+- Web 复用统一 API 和内容源，内容页面使用适当的预生成或服务端渲染，生成规则留在服务器。
+- 只建设下节规定的 MVP；旧题型按价值与实际适配成本逐步接入，批量 PDF/会员另行评估。
+- 私有生成进程可按资源需求拆分，但不另建用户、收藏、内容数据库或第二套业务规则。
 
 ## 6. 安全、成本与体验基线