docs(engineering): add project audit report and improvement plan

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.
This commit is contained in:
xiaomai
2025-11-06 10:15:00 +08:00
parent 8cc04b7f59
commit 40b3ee147f
14 changed files with 744 additions and 0 deletions

View File

@@ -0,0 +1,33 @@
# 性能诊断与优化建议
## 现状与影响
- SSR/CSRMedium默认 SSR未针对首页静态化或增量缓存配置变化不频繁的内容可降本提速。
- 资源缓存Medium未设置构建产物`/_nuxt/**`)的长期缓存与 immutable重复访问浪费带宽。
- 图片与外链LowOG 图与背景图使用外部域名,建议统一通过 CDN 域名与缓存规则管理。
## Nuxt 4 定向优化
1) Route Rules 与 SWRMedium
- 预渲染首页并启用 SWR降低首屏 TTFB。
- 长缓存构建产物:
```ts
export default defineNuxtConfig({
routeRules: {
'/': { prerender: true, swr: 3600 },
'/_nuxt/**': { headers: { 'cache-control': 'public, max-age=31536000, immutable' } },
},
})
```
- 参见补丁:`0004-nuxt-route-rules.patch`。
2) 代码分割与懒加载Low
- 仅在首屏需要时挂载大型组件(如轮播);通过 `v-if` 配合 `onMounted` 或 `client-only` 降低 SSR 负载。
3) 构建与依赖Low
- 保持 `pnpm-lock.yaml` 锁定CI 使用 `pnpm i --frozen-lockfile` 保证可重复构建。
4) 图片与静态资源Medium
- 将站点图片统一迁到自有 CDN如 Cloudflare/Vercel Assets配置缓存与压缩。
- 如未来引入 `@nuxt/image`,优先使用自动格式与尺寸。
## 部署建议
- Node/Nitro通用适合 SSR + SWR 与渐进更新。
- Edge部份路由静态资源 + 首页可下放至边缘,注意依赖兼容性。
- Static/Generate若大部分页面静态可考虑 `pnpm generate` 并配合 CDN。