joey5628/doodle-mini
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: worksheet发布功能开发

Browse Source
This commit is contained in:
R524809
2026-04-24 17:49:11 +08:00
parent 5106dbbd7c
commit bb69d5c49d
24 changed files with 2540 additions and 1014 deletions
Download Patch File Download Diff File Expand all files Collapse all files
miniprogram/core/data/worksheets.ts
-545
View File
@@ -1,545 +0,0 @@
import type {
GeneratorType,
LayoutConfig,
TemplateType,
WorksheetDefinition,
WorksheetType,
} from '../models/worksheet';
import { difficultyToStars } from './difficulty';
/**
* MathFunctionType - 保持向后兼容（mathPageMixin / mathIndex）
*/
export interface MathFunctionType {
id: string;
page?: string;
title: string;
desc: string;
icon?: string;
img?: string;
}
/**
* FocusFunctionType - 保持向后兼容（focusPageMixin / focusIndex）
*/
export interface FocusFunctionType {
id: string;
page?: string;
title: string;
desc: string;
icon: string;
mode?: string;
img?: string;
}
interface SheetEngine {
subcategory: string;
template: TemplateType;
generator: GeneratorType;
generatorConfig?: Record<string, unknown>;
layoutConfig?: LayoutConfig;
tags?: string[];
sortOrder: number;
}
function legacyPath(ui: WorksheetType): string | null {
if (!ui.page) return null;
if (ui.subpackage) {
return `/${ui.subpackage}/${ui.page}/${ui.page}`;
}
return `/pages/${ui.page}/${ui.page}`;
}
function sheet(ui: WorksheetType, engine: SheetEngine): WorksheetDefinition {
const ageMin = ui.ageRange?.[0] ?? 3;
const ageMax = ui.ageRange?.[1] ?? 8;
return {
...ui,
subcategory: engine.subcategory,
ageMin,
ageMax,
difficultyLevel: difficultyToStars(ui.difficulty),
previewImage: ui.img ?? '',
tags: engine.tags?.length ? engine.tags : [engine.subcategory],
isNew: false,
isHot: false,
sortOrder: engine.sortOrder,
downloadCount: 0,
status: 'active',
template: engine.template,
generator: engine.generator,
generatorConfig: engine.generatorConfig ?? {},
layoutConfig: engine.layoutConfig ?? { showBorder: true },
userConfigurable: null,
legacyPage: legacyPath(ui),
};
}
const L = {
gridEx: { showBorder: true, fontSize: 18 } satisfies LayoutConfig,
card: { showBorder: true, columns: 2, fontSize: 16 } satisfies LayoutConfig,
trace: {
showBorder: true,
showInstruction: true,
fontSize: 20,
} satisfies LayoutConfig,
};
// 现有功能清单 §二：数感启蒙 26 种 + §三 13 种 + §四 §五 语文 2
// prettier-ignore
export const ALL_WORKSHEETS: WorksheetDefinition[] = [
sheet(
{ id: 'number-find', title: '找数字，涂一涂', desc: '在数字方阵中找出目标数字并涂色', category: 'math', page: 'mathDraw', subpackage: 'mathPages', img: '/assets/mathEntrance/number-find.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '🔍 1 2 3' },
{ subcategory: 'number-sense', template: 'grid-coloring', generator: 'counting', sortOrder: 1, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'number-find' } },
),
sheet(
{ id: 'number-write', title: '看数字，写一写', desc: '按笔画顺序练习书写数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', img: '/assets/mathEntrance/number-write.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '1 2 3' },
{ subcategory: 'number-sense', template: 'tracing-writing', generator: 'counting', sortOrder: 2, layoutConfig: { ...L.trace }, generatorConfig: { functionId: 'number-write' } },
),
sheet(
{ id: 'number-coloring', title: '按数字，涂颜色', desc: '按指定数字给对应圆圈涂色', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🎨', img: '/assets/mathEntrance/number-coloring.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '🎨' },
{ subcategory: 'number-sense', template: 'grid-coloring', generator: 'counting', sortOrder: 3, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'number-coloring' } },
),
sheet(
{ id: 'counting-matching', title: '数一数，连一连', desc: '连线配对数字和对应数量图形', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔗', img: '/assets/mathEntrance/count-match.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '3↔🍎🍎🍎' },
{ subcategory: 'counting', template: 'match-connect', generator: 'counting', sortOrder: 4, layoutConfig: { ...L.gridEx }, generatorConfig: { functionId: 'counting-matching' } },
),
sheet(
{ id: 'number-object-match', title: '数物连线', desc: '连线相同数量的物品和数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔗', img: '/assets/mathEntrance/number-object-match.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '🔗' },
{ subcategory: 'counting', template: 'match-connect', generator: 'counting', sortOrder: 5, generatorConfig: { functionId: 'number-object-match' } },
),
sheet(
{ id: 'number-object-fill', title: '数物填写', desc: '数物品数量，填写对应数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✏️', img: '/assets/mathEntrance/number-object-fill.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✏️' },
{ subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 6, generatorConfig: { functionId: 'number-object-fill' } },
),
sheet(
{ id: 'counting-select', title: '数一数，选一选', desc: '数出物品数量，圈出正确答案', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✓', img: '/assets/mathEntrance/counting-select.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✓' },
{ subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 7, generatorConfig: { functionId: 'counting-select' } },
),
sheet(
{ id: 'counting-fill', title: '数一数，填一填', desc: '数出物品数量，填写数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✏️', img: '/assets/mathEntrance/counting-fill.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e8f5e9', previewText: '✏️' },
{ subcategory: 'counting', template: 'grid-exercise', generator: 'counting', sortOrder: 8, generatorConfig: { functionId: 'counting-fill' } },
),
sheet(
{ id: 'compare', title: '数一数，比大小', desc: '比较数量，填入 ＞＜＝', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '⚖️', img: '/assets/mathEntrance/compare.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '3 ○ 5' },
{ subcategory: 'counting', template: 'grid-exercise', generator: 'comparison', sortOrder: 9, generatorConfig: { functionId: 'compare' } },
),
sheet(
{ id: 'number-sort', title: '数字排序', desc: '写出正确的数字顺序', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-sort.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff3e0', previewText: '1→2→3' },
{ subcategory: 'sequence', template: 'sequence-pattern', generator: 'number-sequence', sortOrder: 10, generatorConfig: { functionId: 'number-sort' } },
),
sheet(
{ id: 'missing-number', title: '填上缺少的数字', desc: '在数列中找出并填写缺失数字', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '❓', img: '/assets/mathEntrance/missing-number.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff3e0', previewText: '1_3_5' },
{ subcategory: 'sequence', template: 'sequence-pattern', generator: 'number-sequence', sortOrder: 11, generatorConfig: { functionId: 'missing-number' } },
),
sheet(
{ id: 'number-decompose', title: '10以内数的分与合', desc: '把数字分一分，合一合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-decompose.png', ageRange: [4, 6], difficulty: 'beginner', previewBg: '#fff3e0', previewText: '8=?+?' },
{ subcategory: 'decompose', template: 'grid-exercise', generator: 'number-decompose', sortOrder: 12, generatorConfig: { max: 10 } },
),
sheet(
{ id: 'number-decompose-20', title: '20以内数的分与合', desc: '把数字分一分，合一合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '🔢', img: '/assets/mathEntrance/number-decompose-20.png', ageRange: [5, 7], difficulty: 'basic', previewBg: '#fff3e0', previewText: '15=?+?' },
{ subcategory: 'decompose', template: 'grid-exercise', generator: 'number-decompose', sortOrder: 13, generatorConfig: { max: 20 } },
),
sheet(
{ id: 'one-digit-addition', title: '一位数加法', desc: '通过圆点学习一位数加法运算', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/one-digit-addition.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '2+3=?' },
{ subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 14, generatorConfig: { operators: ['+'], maxNumber: 9, showDots: true } },
),
sheet(
{ id: 'addition-5', title: '5以内加法', desc: '图形化展示 5 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/addition-5.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#e3f2fd', previewText: '2+1=?' },
{ subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 15, generatorConfig: { operators: ['+'], maxNumber: 5, showDots: true } },
),
sheet(
{ id: 'addition-10', title: '10以内加法', desc: '图形化展示 10 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/addition-10.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '3+5=?' },
{ subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 16, generatorConfig: { operators: ['+'], maxNumber: 10, showDots: true } },
),
sheet(
{ id: 'subtraction-10', title: '10以内减法', desc: '图形化展示 10 以内减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/subtraction-10.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '8-3=?' },
{ subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 17, generatorConfig: { operators: ['-'], maxNumber: 10, showDots: true } },
),
sheet(
{ id: 'addition-subtraction-10', title: '10以内加减法', desc: '加减法混合运算', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '±', img: '/assets/mathEntrance/addition-subtraction-10.png', ageRange: [5, 7], difficulty: 'basic', previewBg: '#e3f2fd', previewText: '±' },
{ subcategory: 'arithmetic-visual', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 18, generatorConfig: { operators: ['+', '-'], maxNumber: 10, showDots: true } },
),
sheet(
{ id: 'make-ten', title: '凑十法练习', desc: '20 以内进位加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/make-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '7+?=10' },
{ subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 19, generatorConfig: { method: 'make-ten' } },
),
sheet(
{ id: 'break-ten', title: '破十法练习', desc: '20 以内退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/break-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '15-8=?' },
{ subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 20, generatorConfig: { method: 'break-ten' } },
),
sheet(
{ id: 'flat-ten', title: '平十法练习', desc: '20 以内退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/flat-ten.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '14-6=?' },
{ subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 21, generatorConfig: { method: 'flat-ten' } },
),
sheet(
{ id: 'borrow-ten', title: '借十法练习', desc: '20 以上退位减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/borrow-ten.png', ageRange: [6, 8], difficulty: 'advanced', previewBg: '#e3f2fd', previewText: '32-8=?' },
{ subcategory: 'methods-ten', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 22, generatorConfig: { method: 'borrow-ten' } },
),
sheet(
{ id: 'practice-addition', title: '加法运算', desc: '10/20/50/100 以内加法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➕', img: '/assets/mathEntrance/practice-addition.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '25+18=?' },
{ subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 23, generatorConfig: { operators: ['+'], preset: 'vertical' } },
),
sheet(
{ id: 'practice-subtraction', title: '减法运算', desc: '10/20/50/100 以内减法', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '➖', img: '/assets/mathEntrance/practice-subtraction.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '43-17=?' },
{ subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 24, generatorConfig: { operators: ['-'], preset: 'vertical' } },
),
sheet(
{ id: 'practice-mixed', title: '混合运算', desc: '10/20/50/100 以内加减法混合', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '±', img: '/assets/mathEntrance/practice-mixed.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#e3f2fd', previewText: '±' },
{ subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 25, generatorConfig: { operators: ['+', '-'], preset: 'vertical' } },
),
sheet(
{ id: 'multiplication-table', title: '九九乘法表', desc: '学习九九乘法口诀', category: 'math', page: 'mathDraw', subpackage: 'mathPages', icon: '✖️', img: '/assets/mathEntrance/multiplication-table.png', ageRange: [6, 8], difficulty: 'intermediate', previewBg: '#f3e5f5', previewText: '3×4=12' },
{ subcategory: 'practice', template: 'grid-exercise', generator: 'arithmetic', sortOrder: 26, generatorConfig: { operators: ['×'], mode: 'multiplication-table' } },
),
sheet(
{ id: 'color-shape-match', title: '根据颜色画图形', desc: '根据颜色画出对应图形', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎯', img: '/assets/focusEntrance/color-shape-match.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#f3e5f5', previewText: '🎯' },
{ subcategory: 'focus-visual', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 27, generatorConfig: { functionId: 'color-shape-match' } },
),
sheet(
{ id: 'shape-symbol', title: '图形符号配对', desc: '根据图形画对应符号', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/shape-symbol.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e8eaf6', previewText: '△→♠' },
{ subcategory: 'focus-visual', template: 'match-connect', generator: 'shape-grid', sortOrder: 28, generatorConfig: { functionId: 'shape-symbol' } },
),
sheet(
{ id: 'shape-recognition', title: '识别形状', desc: '识别形状，涂一涂', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔍', img: '/assets/focusEntrance/shape-recognition.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '△ ○ □' },
{ subcategory: 'focus-visual', template: 'grid-coloring', generator: 'shape-grid', sortOrder: 29, generatorConfig: { functionId: 'shape-recognition' } },
),
sheet(
{ id: 'position-coloring', title: '方位涂涂乐', desc: '观察位置，在方格中涂色', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '📍', img: '/assets/focusEntrance/position-coloring.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#e8f5e9', previewText: '📍' },
{ subcategory: 'focus-grid', template: 'grid-coloring', generator: 'shape-grid', sortOrder: 30, generatorConfig: { functionId: 'position-coloring' } },
),
sheet(
{ id: 'color-pattern', title: '颜色找规律', desc: '观察颜色规律，在空白图形中涂色', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', img: '/assets/focusEntrance/color-pattern.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fff8e1', previewText: '🎨' },
{ subcategory: 'focus-grid', template: 'grid-coloring', generator: 'color-pattern', sortOrder: 31, generatorConfig: { functionId: 'color-pattern' } },
),
sheet(
{ id: 'match-connect', title: '连连看', desc: '根据物品连一连', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/match-connect.png', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#e0f7fa', previewText: '🔗' },
{ subcategory: 'focus-connect', template: 'match-connect', generator: 'shape-grid', sortOrder: 32, generatorConfig: { functionId: 'match-connect' } },
),
sheet(
{ id: 'line-recognition', title: '线条识别', desc: '认识不同线条，画出颜色对应的线条', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '📏', img: '/assets/focusEntrance/line-recognition.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#f1f8e9', previewText: '〰️' },
{ subcategory: 'focus-visual', template: 'tracing-writing', generator: 'shape-grid', sortOrder: 33, generatorConfig: { functionId: 'line-recognition' } },
),
sheet(
{ id: 'grid-reasoning', title: '方格推理', desc: '推理出合并方格并连线', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🧩', img: '/assets/focusEntrance/grid-reasoning.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#e8eaf6', previewText: '🧩' },
{ subcategory: 'focus-logic', template: 'special-graphic', generator: 'shape-grid', sortOrder: 34, generatorConfig: { functionId: 'grid-reasoning' } },
),
sheet(
{ id: 'code-connect', title: '译码连线', desc: '按数字顺序将数字对应颜色连线', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔢', img: '/assets/focusEntrance/code-connect.png', ageRange: [5, 7], difficulty: 'intermediate', previewBg: '#fff3e0', previewText: '🔢' },
{ subcategory: 'focus-connect', template: 'match-connect', generator: 'dot-connect', sortOrder: 35, generatorConfig: { functionId: 'code-connect' } },
),
sheet(
{ id: 'dot-connect', title: '数字点连线', desc: '按数字顺序连点成图', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🔗', img: '/assets/focusEntrance/dot-connect.png', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#e3f2fd', previewText: '1→2→3' },
{ subcategory: 'focus-connect', template: 'match-connect', generator: 'dot-connect', sortOrder: 36, generatorConfig: { functionId: 'dot-connect' } },
),
sheet(
{ id: 'grid-drawing-3x3', title: '格子仿画 3×3', desc: '简单有趣，培养专注力', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '3x3', img: '/assets/focusEntrance/grid-drawing-3x3.png', ageRange: [3, 5], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '▦' },
{ subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 37, generatorConfig: { grid: '3x3' } },
),
sheet(
{ id: 'grid-drawing-5x5', title: '格子仿画 5×5', desc: '创意挑战，提升观察力', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '5x5', img: '/assets/focusEntrance/grid-drawing-5x5.png', ageRange: [4, 6], difficulty: 'basic', previewBg: '#fce4ec', previewText: '▦' },
{ subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 38, generatorConfig: { grid: '5x5' } },
),
sheet(
{ id: 'grid-drawing-7x7', title: '格子仿画 7×7', desc: '大师挑战，锻炼耐心', category: 'focus', page: 'focusDraw', subpackage: 'focusPages', icon: '🎨', mode: '7x7', img: '/assets/focusEntrance/grid-drawing-7x7.png', ageRange: [5, 8], difficulty: 'intermediate', previewBg: '#fce4ec', previewText: '▦' },
{ subcategory: 'grid-copy', template: 'grid-exercise', generator: 'shape-grid', sortOrder: 39, generatorConfig: { grid: '7x7' } },
),
sheet(
{ id: 'word-recognition', title: '识字卡', desc: '输入或选字生成涂色识字卡（grid/find 模板）', category: 'chinese', page: 'index', subpackage: '', icon: '📖', img: '', ageRange: [3, 6], difficulty: 'beginner', previewBg: '#fce4ec', previewText: '大 小' },
{ subcategory: 'literacy', template: 'card-layout', generator: 'custom', sortOrder: 40, generatorConfig: { functionId: 'word-recognition' }, layoutConfig: { ...L.card } },
),
sheet(
{ id: 'copybook', title: '练字帖', desc: '选字生成田字格笔顺练字帖', category: 'chinese', page: 'copyBook', subpackage: '', icon: '✏️', img: '', ageRange: [4, 7], difficulty: 'basic', previewBg: '#fff8e1', previewText: '横竖撇' },
{ subcategory: 'copybook', template: 'tracing-writing', generator: 'character-tracing', sortOrder: 41, generatorConfig: { functionId: 'copybook' }, layoutConfig: { ...L.trace } },
),
sheet(
{
id: 'letter-tracing-single',
title: '看图描红',
desc: '单字母配图、例句与六行四线三格描红',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '🔠',
img: '',
ageRange: [4, 7],
difficulty: 'beginner',
previewBg: '#e8f4ff',
previewText: 'Aa',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 42,
layoutConfig: {
...L.trace,
instructionText: '看一看，读一读，再描一描',
},
generatorConfig: {
mode: 'letter-tracing-single',
letterCase: 'upper',
selectedLetter: 'A',
repetitions: 5,
fadePattern: 'gradient',
},
},
),
sheet(
{
id: 'letter-tracing-two-column',
title: '两列练习',
desc: '左 A–M、右 N–Z，每组包含大小写',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '🔤',
img: '',
ageRange: [4, 7],
difficulty: 'beginner',
previewBg: '#e8f4ff',
previewText: 'A|N',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 43,
layoutConfig: {
...L.trace,
columns: 2,
instructionText: '左 A–M、右 N–Z，大小写配对描红',
},
generatorConfig: {
mode: 'letter-tracing-two-column',
letterCase: 'both',
repetitions: 4,
fadePattern: 'gradient',
},
},
),
sheet(
{
id: 'letter-tracing-upper-lower',
title: '字母总览',
desc: 'Uppercase / Lowercase 分区，每区四行（7+7+6+6）',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '🔡',
img: '',
ageRange: [4, 7],
difficulty: 'beginner',
previewBg: '#e8f4ff',
previewText: 'Aa Bb',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 44,
layoutConfig: {
...L.trace,
columns: 13,
instructionText: '认读全部大写与小写字母',
},
generatorConfig: {
mode: 'letter-tracing-upper-lower',
letterCase: 'both',
repetitions: 1,
fadePattern: 'first-only',
},
},
),
sheet(
{
id: 'letter-tracing-case-pairing',
title: '大小写练习',
desc: '半组字母左大写右小写，每行四个',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '✏️',
img: '',
ageRange: [4, 7],
difficulty: 'beginner',
previewBg: '#e8f4ff',
previewText: 'A→Z',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 45,
layoutConfig: {
...L.trace,
instructionText: '左栏大写、右栏小写，逐行对应描红',
},
generatorConfig: {
mode: 'letter-tracing-case-pairing',
letterCase: 'both',
alphabetHalf: 'A-M',
repetitions: 4,
fadePattern: 'gradient',
},
},
),
sheet(
{
id: 'letter-tracing-three',
title: '三字母精练',
desc: '每页聚焦 3 个字母，大写 + 小写深度书写',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '🔤',
img: '',
ageRange: [4, 7],
difficulty: 'basic',
previewBg: '#e8f4ff',
previewText: 'ABC',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 46,
layoutConfig: {
...L.trace,
instructionText: '每页 3 个字母，逐字精练',
},
generatorConfig: {
mode: 'letter-tracing-three',
letterCase: 'both',
repetitions: 5,
fadePattern: 'gradient',
tripleLetters: ['A', 'B', 'C'],
},
},
),
sheet(
{
id: 'letter-tracing-half',
title: '单字母逐行',
desc: '每行一个字母，13 字母半表逐字练习',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '📝',
img: '',
ageRange: [4, 7],
difficulty: 'basic',
previewBg: '#e8f4ff',
previewText: 'A–M',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 47,
layoutConfig: {
...L.trace,
instructionText: '每行一个字母，逐字反复练习',
},
generatorConfig: {
mode: 'letter-tracing-half',
letterCase: 'both',
alphabetHalf: 'A-M',
repetitions: 5,
fadePattern: 'first-only',
},
},
),
sheet(
{
id: 'letter-tracing-daily-checkin',
title: '每日打卡',
desc: '四宫格每日字母打卡，闭合四线三格练习',
category: 'english',
page: 'letterTracing',
subpackage: 'englishPages',
icon: '🗓️',
img: '',
ageRange: [4, 7],
difficulty: 'basic',
previewBg: '#e8f4ff',
previewText: 'ABCD',
},
{
subcategory: 'letter-tracing',
template: 'tracing-writing',
generator: 'letter-tracing',
sortOrder: 48,
layoutConfig: {
...L.trace,
instructionText: '四宫格每日打卡字母描红',
},
generatorConfig: {
mode: 'letter-tracing-daily-checkin',
letterCase: 'both',
repetitions: 5,
fadePattern: 'first-only',
dailyLetters: ['A', 'B', 'C', 'D'],
},
},
),
];
export const MATH_FUNCTION_TYPES: MathFunctionType[] = ALL_WORKSHEETS.filter(
(w) => w.category === 'math',
)
.sort((a, b) => a.sortOrder - b.sortOrder)
.map((w) => ({
id: w.id,
page: w.page,
title: w.title,
desc: w.desc,
icon: w.icon,
img: w.img,
}));
export const FOCUS_FUNCTION_TYPES: FocusFunctionType[] = ALL_WORKSHEETS.filter(
(w) => w.category === 'focus',
)
.sort((a, b) => a.sortOrder - b.sortOrder)
.map((w) => ({
id: w.id,
page: w.page,
title: w.title,
desc: w.desc,
icon: w.icon ?? '・',
mode: w.mode,
img: w.img,
}));
export function getWorksheetsByCategory(
category: string,
): WorksheetDefinition[] {
if (category === 'all') return ALL_WORKSHEETS;
return ALL_WORKSHEETS.filter((w) => w.category === category);
}
export function getWorksheetsByAge<T extends WorksheetType>(
worksheets: readonly T[],
age: number,
): T[] {
return worksheets.filter((w) => {
if (!w.ageRange) return true;
return age >= w.ageRange[0] && age <= w.ageRange[1];
});
}
export function getWorksheetPath(worksheet: WorksheetType): string {
if (!worksheet.page) return '';
if (worksheet.subpackage) {
return `/${worksheet.subpackage}/${worksheet.page}/${worksheet.page}?id=${worksheet.id}`;
}
return `/pages/${worksheet.page}/${worksheet.page}`;
}
export function getWorksheetById(id: string): WorksheetDefinition | undefined {
return ALL_WORKSHEETS.find((w) => w.id === id);
}
miniprogram/core/models/category.ts
+8
View File
@@ -1,3 +1,11 @@
export type CategoryId =
| 'math'
| 'chinese'
| 'english'
| 'puzzle'
| 'craft'
| 'pinyin';
/** Tab / 首页用的分类展示模型 */
export interface CategoryType {
id: string;
miniprogram/core/models/worksheet.ts
+9 -165
View File
@@ -1,106 +1,26 @@
import { CategoryId } from './category';
/**
* 题型与模板引擎相关模型：对齐技术架构 §5.4 与云开发 worksheets 集合 §3.3
*/
/** 小程序现状：专注力单独成类；云端 category 枚举无 focus 时可映射为 puzzle + subcategory */
export type WorksheetCategory =
| 'math'
| 'focus'
| 'chinese'
| 'english'
| 'puzzle'
| 'craft';
/** 云 worksheets.category 严格枚举（§3.3） */
export type WorksheetCloudCategory =
| 'math'
| 'chinese'
| 'english'
| 'puzzle'
| 'craft';
export type DifficultyLevel =
| 'beginner'
| 'basic'
| 'intermediate'
| 'advanced';
export type WorksheetStatus = 'active' | 'draft' | 'hidden';
/** 排版模板（技术架构 §5.4） */
export type TemplateType =
| 'grid-exercise'
| 'match-connect'
| 'grid-coloring'
| 'card-layout'
| 'tracing-writing'
| 'full-page-asset'
| 'sequence-pattern'
| 'special-graphic';
/** 数据生成器（技术架构 §5.4） */
export type GeneratorType =
| 'arithmetic'
| 'number-sequence'
| 'number-decompose'
| 'counting'
| 'comparison'
| 'shape-grid'
| 'color-pattern'
| 'character-tracing'
| 'letter-tracing'
| 'pinyin-tracing'
| 'static-asset'
| 'maze'
| 'dot-connect'
| 'clock'
| 'custom';
export interface LayoutConfig {
columns?: number;
rows?: number;
fontSize?: number;
showBorder?: boolean;
showTitle?: boolean;
padding?: number;
itemSpacing?: number;
showInstruction?: boolean;
instructionText?: string;
}
export interface UserConfigField {
key: string;
label: string;
type: 'select' | 'slider' | 'switch';
options?: { label: string; value: unknown }[];
min?: number;
max?: number;
defaultValue: unknown;
}
/** 与架构文档 WorksheetConfig 一致，供云端下发 / 本地内置 */
export interface WorksheetConfig {
id: string;
title: string;
desc: string;
category: WorksheetCloudCategory;
subcategory: string;
subtitle: string;
category: CategoryId;
subcategory?: string;
ageMin: number;
ageMax: number;
difficulty: 1 | 2 | 3 | 4;
previewImage: string;
previewImg: string;
tags: string[];
isNew: boolean;
isHot: boolean;
sortOrder: number;
status: WorksheetStatus;
template: TemplateType;
generator: GeneratorType;
generatorConfig: Record<string, unknown>;
layoutConfig: LayoutConfig;
userConfigurable?: UserConfigField[] | null;
legacyPage?: string | null;
downloadCount: number;
sortOrder?: number;
status: 'active' | 'draft' | 'hidden';
downloads: number;
likes: number;
}
/** 云集合 `worksheets` 文档（§3.3，含数据库字段） */
@@ -109,79 +29,3 @@ export interface WorksheetRecord extends WorksheetConfig {
createdAt: Date;
updatedAt: Date;
}
/** 列表卡片 / 导航用（兼容存量页面） */
export interface WorksheetType {
id: string;
title: string;
desc: string;
category: WorksheetCategory;
page?: string;
subpackage?: string;
icon?: string;
img?: string;
ageRange?: [number, number];
difficulty?: DifficultyLevel;
mode?: string;
previewBg?: string;
previewText?: string;
}
/** 内置兜底 + 模板引擎字段（本地 core/data/worksheets） */
export interface WorksheetDefinition extends WorksheetType {
subcategory: string;
ageMin: number;
ageMax: number;
/** 1–4，对应云 worksheets.difficulty */
difficultyLevel: 1 | 2 | 3 | 4;
previewImage: string;
tags: string[];
isNew: boolean;
isHot: boolean;
sortOrder: number;
downloadCount: number;
status: WorksheetStatus;
template: TemplateType;
generator: GeneratorType;
generatorConfig: Record<string, unknown>;
layoutConfig: LayoutConfig;
userConfigurable?: UserConfigField[] | null;
legacyPage?: string | null;
}
/** 写入云库时的 category：focus 归为 puzzle，子类区分 */
export function toCloudCategory(
category: WorksheetCategory,
): WorksheetCloudCategory {
if (category === 'focus') return 'puzzle';
return category;
}
/** 由内置定义生成云侧 worksheets 文档形状（不含 _id/时间，供同步层补全） */
export function worksheetDefinitionToConfig(
def: WorksheetDefinition,
): Omit<WorksheetRecord, '_id' | 'createdAt' | 'updatedAt'> {
return {
id: def.id,
title: def.title,
desc: def.desc,
category: toCloudCategory(def.category),
subcategory: def.subcategory,
ageMin: def.ageMin,
ageMax: def.ageMax,
difficulty: def.difficultyLevel,
previewImage: def.previewImage,
tags: def.tags,
isNew: def.isNew,
isHot: def.isHot,
sortOrder: def.sortOrder,
downloadCount: def.downloadCount,
status: def.status,
template: def.template,
generator: def.generator,
generatorConfig: def.generatorConfig,
layoutConfig: def.layoutConfig,
userConfigurable: def.userConfigurable ?? null,
legacyPage: def.legacyPage ?? null,
};
}