40b3ee147f
This commit introduces a comprehensive engineering audit report for the Tootaio Studio project. The report is structured into documents covering architecture, code quality, performance, security, CI/CD, and observability. It also includes a phased improvement roadmap and a set of `.patch` files to apply immediate fixes for content schemas, package scripts, and CI configuration.
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# 分阶段工程化改进路线图
|
||
|
||
## 阶段一：基础规范化（1–2 天）
|
||
- 目标：消除 Critical/High 风险，建立最小工程基线。
|
||
- 动作：
|
||
- 应用补丁 0001/0002；
|
||
- 启用 `pnpm check` 在本地与 CI；
|
||
- 修复内容与 Schema 校验。
|
||
- 验证：`pnpm check` 全绿；手测多语言与内容渲染。
|
||
|
||
## 阶段二：模块解耦（2–3 天）
|
||
- 目标：清晰分层，降低耦合与心智成本。
|
||
- 动作：
|
||
- 统一 composables 命名为 `useXxx.ts`；
|
||
- 将硬编码外链迁到 `runtimeConfig.public.assetBase`；
|
||
- 视需要引入 Pinia 拆分跨页状态。
|
||
- 验证：路由与数据流稳定；影响面与回归点有测试用例（增量引入 Vitest）。
|
||
|
||
## 阶段三：自动化部署（1–2 天）
|
||
- 目标：PR 即可验证、主干可随时发布。
|
||
- 动作：
|
||
- 应用补丁 0003（GitHub Actions）；
|
||
- 配置 Vercel/自建 Docker 部署；
|
||
- 产出构建产物与环境变量清单。
|
||
- 验证：PR 触发 CI，产物可预览。
|
||
|
||
## 阶段四：性能与监控（2–4 天）
|
||
- 目标：稳定响应、端到端可观测。
|
||
- 动作：
|
||
- 应用补丁 0004（Route Rules/SWR）；
|
||
- 引入 Sentry（DSN + 插件）；
|
||
- 图片与静态资源走 CDN 与长缓存。
|
||
- 验证：关键页面首屏数据、错误率与 Web Vitals。
|
||
|