feat: 英文字母描红开发

2026-04-03 15:21:04 +08:00
parent 206c44cf6d
commit 1ef6770810
37 changed files with 1812 additions and 179 deletions
@@ -697,7 +697,65 @@ interface WeekPlan {
 | 热点响应 | 随时        | 追节日/热点快速上线应景内容                 |
 | 版本迭代 | 每 2-4 周   | 新排版模板、新生成算法、UI 改进等需发版内容 |

-### 7.3 分包优化
+### 7.3 内容交付形态决策框架（客户端生成 vs 云存储）
+
+> 与 [技术架构设计文档](./技术架构设计文档.md) 第七章 §7.4（涂色卡/迷宫等素材型内容方案中的类型 A/B/C）一致，本节从产品视角给出**可执行的判断标准**，避免「像字母描红这种看似固定的内容是否该预生成图放云存储」这类决策反复讨论。
+
+#### 7.3.1 决策树（产品侧）
+
+规划新题型或新资料时，按顺序回答下列问题：
+
+```
+新内容 / 新题型
+    │
+    ├─ 能否通过算法 + 参数（含字库/字母表/随机种子）在客户端产出整页可打印结果？
+    │     ├─ 能 → 【客户端动态生成】
+    │     │        例：加减法、迷宫路径、字母/拼音/数字描红、识字卡选字组合、控笔虚线…
+    │     │
+    │     └─ 否 → 是否依赖设计师绘制的线稿、展开图、贴纸图等「不可替代的美术素材」？
+    │               ├─ 是 → 【云存储素材 + 客户端排版导出】
+    │               │        例：主题涂色卡、折纸展开图、手工模板、装饰贴纸…
+    │               │
+    │               └─ 否 → 【混合型】
+    │                        算法生成结构 + 云存储皮肤/底图
+    │                        例：迷宫（路径算法 + 主题边框）、闪卡（版式 + 配图 URL）…
+```
+
+**一句话原则**：能算出来的不要囤成静态图；只有「画出来才有价值」的才上云存储。
+
+#### 7.3.2 典型内容对照表
+
+| 内容类型           | 推荐交付形态     | 简要理由                                                                 |
+| ------------------ | ---------------- | ------------------------------------------------------------------------ |
+| 字母 / 拼音描红    | 客户端生成       | 字形规则、参数多（每页字数、重复次数、大小写组合）；预生成图组合爆炸     |
+| 数字描红           | 客户端生成       | 同上；与现有数学/练字能力一致                                            |
+| 汉字描红（练字）   | 客户端生成       | 依赖笔画数据 + 田字格排版；用户自选字表                                  |
+| 运算类、规律类题型 | 客户端生成       | 需随机「换一批」；零边际服务器成本                                       |
+| 主题涂色卡线稿     | 云存储 + 排版    | 美术品质依赖设计稿，无法靠通用算法还原                                   |
+| 折纸 / 手工模板    | 云存储 + 排版    | 展开图与步骤图为设计资产                                                 |
+| 贴纸、装饰素材     | 云存储           | 纯素材分发                                                               |
+| 迷宫、找不同等     | 混合型           | 结构或差异点可算法生成，主题视觉可素材化                                 |
+
+#### 7.3.3 与模板引擎的对应关系
+
+| 交付形态     | 常见模板类型（技术文档用语） | 产品侧理解                     |
+| ------------ | ---------------------------- | ------------------------------ |
+| 客户端生成   | `grid-exercise`、`tracing-writing`、`sequence-pattern` 等 | 选模板 + 生成器 + 用户可调参数 |
+| 云存储素材   | `full-page-asset` + `static-asset`                        | 配置素材 URL，按需下载后套 A4  |
+| 混合型       | 自定义生成器 + 素材字段                                     | 产品需拆清「哪部分算、哪部分画」 |
+
+#### 7.3.4 决策时需同步考虑的约束
+
+| 约束         | 说明                                                                 |
+| ------------ | -------------------------------------------------------------------- |
+| 成本与规模   | 客户端生成主路径不增加下载带宽；大量预生成高清 PNG 会放大存储与流量成本 |
+| 离线体验     | 纯客户端生成可在弱网或无网下完成预览（依赖已内置/已缓存的数据与字体）   |
+| 运营迭代     | JSON 配置 + 素材上架即可扩展客户端生成题型变体；云素材适合快速换主题   |
+| 视觉统一     | 描红类建议统一字体与格线规范；云素材需建立插画/线稿风格指南             |
+
+产品评审新需求时，建议在需求单中**显式勾选**交付形态（客户端生成 / 云素材 / 混合），并与设计、研发对齐模板类型与是否需要新增生成器。
+
+### 7.4 分包优化

 ```
 当前分包结构：            建议优化后：
@@ -713,7 +771,7 @@ interface WeekPlan {
                          └── craftPages (创意手工)
 ```

-### 7.4 数据模型扩展
+### 7.5 数据模型扩展

 ```typescript
 interface WorksheetConfig {