ColoringStore 正在迁移到 TanStack Start

ColoringStore 正在从旧的 Next.js App Router 代码库迁移到 TanStack Start 应用壳。产品方向不变：通过提示词、照片、草图、练习纸、贴纸和姓名生成可打印 AI 涂色页。变化的是运行时基础，让路由、server handlers、国际化、认证、积分、计费、存储和管理设置统一进入 TanStack 结构。

改了什么

• src/routes/ 负责 TanStack 文件路由和 API handlers。
• src/components/coloring/ 承载生成器、图库、在线涂色和用户作品库 UI。
• src/modules/coloring/ 承载生成与图库共享服务。
• messages/ 是当前英文和中文的 Paraglide 文案来源。
• 旧目录 如 app/、根目录 components/、models/、services/ 会继续作为迁移素材保留，直到每个流程完成迁移。

为什么选择 TanStack Start

upstream 技术栈能让 ColoringStore 更清楚地区分产品代码和 SaaS 底座。TanStack Router 处理文件路由，TanStack Query 管理客户端数据状态，server routes 让 API 逻辑贴近路由树。认证、支付、积分、RBAC、存储和管理模块继续可用，但不会迫使涂色产品界面变成通用 SaaS 模板。

数据库安全

迁移只把 Drizzle schema 文件作为源码映射保留，让 TypeScript 和服务层理解当前业务表。真正对数据库应用 schema 变化是另一件事，必须显式执行。框架迁移检查不应该自动 push、migrate 或 generate 数据库变更。

当前重点

第一轮迁移先建立 TanStack 壳、产品路由、生成端点、图库端点、用户作品路线和 ColoringStore 品牌内容。运行时验证和 route tree 重新生成会在允许执行验证命令后单独处理。