diff --git a/docs/README.md b/docs/README.md
index 6ada5f5..12634c4 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,45 +1,98 @@
 # Novalon Website 文档
 
-欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。
+欢迎来到 Novalon Website 项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。
 
-## 文档导航
+## 📚 文档导航
+
+### 架构文档 (architecture/)
 
-### 📚 架构文档
 - [系统设计](architecture/system-design.md) - 系统整体架构设计
-- [数据库架构](architecture/database-schema.md) - 数据库表结构和关系
-- [API架构](architecture/api-architecture.md) - API设计规范和接口说明
+- [架构概述](architecture/architecture.md) - 架构设计原则和模式
+- [结构规划](architecture/STRUCTURE_PLAN.md) - 项目结构规划文档
+
+### 开发文档 (development/)
 
-### 💻 开发文档
 - [快速开始](development/getting-started.md) - 项目快速开始指南
-- [编码规范](development/coding-standards.md) - 代码编写规范和最佳实践
-- [组件开发指南](development/component-guide.md) - React组件开发指南
-- [调试指南](development/debugging-guide.md) - 开发调试技巧和工具
+- [API 文档](development/api.md) - API 接口文档
+- [API 版本控制指南](development/api-versioning-guide.md) - API 版本控制最佳实践
+- [组件开发指南](development/components.md) - React 组件开发指南
+- [OpenAPI 指南](development/openapi-guide.md) - OpenAPI 规范和使用
+- [联系方式配置](development/CONTACT_CONFIGURATION.md) - 联系表单配置说明
+- [实施报告](development/IMPLEMENTATION-REPORT.md) - 功能实施报告
+- [质量门禁](development/quality-gates.md) - 代码质量门禁配置
 
-### 🚀 部署文档
-- [生产环境部署](deployment/production.md) - 生产环境部署流程
-- [Docker部署](deployment/docker.md) - Docker容器化部署
-- [监控配置](deployment/monitoring.md) - 系统监控和告警配置
+### 部署文档 (deployment/)
 
-### 🧪 测试文档
-- [测试策略](testing/testing-strategy.md) - 测试策略和分层测试
-- [E2E测试](testing/e2e-testing.md) - 端到端测试指南
-- [单元测试](testing/unit-testing.md) - 单元测试编写指南
-- [性能测试](testing/performance-testing.md) - 性能测试和优化
+- [部署指南](deployment/DEPLOYMENT.md) - 部署流程和步骤
+- [生产环境部署](deployment/PRODUCTION_DEPLOYMENT.md) - 生产环境部署指南
+- [轻量级生产部署](deployment/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md) - 轻量级部署方案
+- [生产发布报告](deployment/PRODUCTION_RELEASE_REPORT.md) - 生产发布记录
+- [CDN 配置](deployment/CDN_CONFIGURATION.md) - CDN 配置指南
+- [CDN 快速开始](deployment/CDN_QUICK_START.md) - CDN 快速配置
+- [CI/CD 快速开始](deployment/CICD_QUICK_START.md) - CI/CD 流程快速指南
+- [CI/CD 预防指南](deployment/CICD_PREVENTION_GUIDE.md) - CI/CD 问题预防
+- [CI/CD 验证清单](deployment/CICD_VERIFICATION_CHECKLIST.md) - CI/CD 验证检查清单
+- [质量门禁 CI](deployment/quality-gates-ci.md) - CI 质量门禁配置
+- [回滚流程](deployment/rollback-procedure.md) - 部署回滚操作流程
+- [阶段一部署指南](deployment/phase1-deployment-guide.md) - 第一阶段部署指南
+- [阶段一部署日志](deployment/phase1-deployment-log.md) - 第一阶段部署记录
+- [Google Analytics 设置](deployment/GOOGLE_ANALYTICS_SETUP.md) - Google Analytics 配置
+- [监控设置](deployment/MONITORING_SETUP.md) - 系统监控配置
+- [监控快速开始](deployment/MONITORING_QUICKSTART.md) - 监控快速配置
+- [轻量级监控](deployment/MONITORING_LIGHTWEIGHT.md) - 轻量级监控方案
+- [轻量级监控](deployment/LIGHTWEIGHT_MONITORING.md) - 监控方案说明
+- [优化报告](deployment/OPTIMIZATION_REPORT.md) - 性能优化报告
+- [性能优化](deployment/PERFORMANCE_OPTIMIZATION.md) - 性能优化指南
 
-### 🔌 API文档
-- [REST API](api/rest-api.md) - REST API接口文档
-- [管理API](api/admin-api.md) - 管理后台API文档
+### 测试文档 (testing/)
 
-### 📖 使用指南
-- [CMS使用指南](guides/cms-guide.md) - 内容管理系统使用指南
-- [认证指南](guides/authentication.md) - 用户认证和授权
-- [故障排查](guides/troubleshooting.md) - 常见问题排查和解决方案
+- [测试指南](testing/testing-guide.md) - 测试编写指南
+- [测试概述](testing/testing.md) - 测试策略和方法
+- [分层测试](testing/README-TIERED-TESTING.md) - 分层测试策略
+- [测试报告](testing/TESTING_REPORT.md) - 测试执行报告
+- [Allure 报告指南](testing/allure-report-guide.md) - Allure 测试报告使用
+- [Lighthouse CI 指南](testing/lighthouse-ci-guide.md) - Lighthouse CI 配置
+- [测试覆盖率改进计划](testing/test-coverage-improvement-plan.md) - 测试覆盖率提升计划
+- [测试优化指南](testing/test-optimization-guide.md) - 测试优化策略
+- [测试分层最佳实践](testing/test-tiering-best-practices.md) - 测试分层最佳实践
+- [用户旅程覆盖矩阵](testing/user-journey-coverage-matrix.md) - 用户旅程测试覆盖
+- [用户旅程测试指南](testing/user-journey-testing-guide.md) - 用户旅程测试编写
 
-## 项目概述
+### 安全文档 (security/)
 
-Novalon Website是四川睿新致远科技有限公司的企业官网，采用现代化的技术栈构建。
+- [管理员凭证](security/ADMIN-CREDENTIALS.md) - 管理员账户信息
+- [Jenkins 安全加固指南](security/JENKINS_SECURITY_HARDENING_GUIDE.md) - Jenkins 安全配置
+
+### 故障排查 (troubleshooting/)
+
+- [HMR 错误解决方案](troubleshooting/HMR-ERROR-SOLUTIONS.md) - 热更新错误排查
+- [修复计划 A 指南](troubleshooting/fix-plan-a-guide.md) - 问题修复流程
+- [生产环境超时排查](troubleshooting/production-timeout-troubleshooting.md) - 生产环境超时问题排查
+
+### 指南文档 (guides/)
+
+- [安全指南](guides/SECURITY.md) - 安全最佳实践
+
+### 计划文档 (plans/)
+
+包含各种技术改进和功能开发的计划文档，按日期命名。
+
+### Superpowers 文档 (superpowers/)
+
+- **plans/** - 实施计划
+  - [项目重组计划](superpowers/plans/2026-04-12-project-reorganization-plan.md)
+- **reports/** - 实施报告
+  - [用户旅程测试实施总结](superpowers/reports/2026-04-09-user-journey-testing-implementation-summary.md)
+- **specs/** - 设计规范
+  - [测试质量改进设计](superpowers/specs/2026-04-09-test-quality-improvement-design.md)
+  - [项目重组设计](superpowers/specs/2026-04-12-project-reorganization-design.md)
+
+## 🎯 项目概述
+
+Novalon Website 是四川睿新致远科技有限公司的企业官网，采用现代化的技术栈构建。
 
 ### 技术栈
+
 - **框架**: Next.js 16 + React 19
 - **语言**: TypeScript
 - **样式**: Tailwind CSS
@@ -48,46 +101,24 @@ Novalon Website是四川睿新致远科技有限公司的企业官网，采用
 - **测试**: Playwright + Jest
 
 ### 核心功能
-- 企业展示和产品服务介绍
-- 成功案例和新闻动态
-- 在线咨询和联系表单
-- CMS内容管理后台
-- 响应式设计和SEO优化
 
-## 快速链接
+- 📝 内容管理系统 (CMS)
+- 🔐 用户认证和授权
+- 📊 数据分析和监控
+- 🚀 高性能和 SEO 优化
+- 🔄 CI/CD 自动化部署
 
-- [项目README](../README.md) - 项目主文档
-- [测试框架整合说明](../e2e/MIGRATION.md) - 测试框架迁移说明
-- [目录结构规划](STRUCTURE_PLAN.md) - 项目目录结构说明
-- [优化报告](OPTIMIZATION_REPORT.md) - 项目优化总结报告
+## 📖 快速链接
 
-## 贡献指南
+- [快速开始](development/getting-started.md) - 开始开发
+- [部署指南](deployment/DEPLOYMENT.md) - 部署到生产环境
+- [测试指南](testing/testing-guide.md) - 编写测试
+- [故障排查](troubleshooting/HMR-ERROR-SOLUTIONS.md) - 解决问题
 
-### 文档更新
-1. 确保文档内容准确、清晰
-2. 使用Markdown格式编写
-3. 添加必要的代码示例
-4. 更新相关链接和引用
+## 🤝 贡献指南
 
-### 文档审查
-- 技术准确性
-- 内容完整性
-- 格式规范性
-- 链接有效性
+请参阅 [开发文档](development/getting-started.md) 了解如何为项目做出贡献。
 
-## 获取帮助
+## 📄 许可证
 
-如果在使用过程中遇到问题，可以：
-1. 查看相关文档
-2. 搜索[故障排查指南](guides/troubleshooting.md)
-3. 联系开发团队
-
-## 文档版本
-
-- **版本**: 1.0.0
-- **更新日期**: 2026-03-24
-- **维护者**: 开发团队
-
----
-
-© 2026 四川睿新致远科技有限公司
+本项目采用 MIT 许可证。
diff --git a/docs/STRUCTURE_PLAN.md b/docs/architecture/STRUCTURE_PLAN.md
similarity index 100%
rename from docs/STRUCTURE_PLAN.md
rename to docs/architecture/STRUCTURE_PLAN.md
diff --git a/docs/architecture.md b/docs/architecture/architecture.md
similarity index 100%
rename from docs/architecture.md
rename to docs/architecture/architecture.md
diff --git a/docs/deployment.md b/docs/deployment.md
deleted file mode 100644
index ebc9066..0000000
--- a/docs/deployment.md
+++ /dev/null
@@ -1,475 +0,0 @@
-# 部署文档
-
-## 部署概述
-
-项目采用 Next.js 静态导出模式，构建生成纯静态 HTML 文件，可部署到任何静态文件服务器或 CDN。
-
-## 构建配置
-
-### Next.js 配置
-
-```typescript
-// next.config.ts
-const nextConfig: NextConfig = {
-  output: 'export',      // 静态导出模式
-  distDir: 'dist',       // 输出目录
-  images: {
-    unoptimized: true,   // 静态导出需要禁用图片优化
-  },
-  compress: true,
-  poweredByHeader: false,
-  reactStrictMode: true,
-};
-```
-
-### 构建命令
-
-```bash
-# 开发模式（不导出）
-npm run dev
-
-# 生产构建（静态导出）
-npm run build
-
-# 输出目录
-dist/
-```
-
-## 环境变量
-
-### 必需配置
-
-```env
-# .env.production
-RESEND_API_KEY=re_xxxxx
-COMPANY_EMAIL=contact@novalon.cn
-```
-
-### 可选配置
-
-```env
-NODE_ENV=production
-NEXT_PUBLIC_SITE_URL=https://www.novalon.cn
-```
-
-### 环境变量说明
-
-| 变量名 | 必需 | 描述 |
-|--------|------|------|
-| `RESEND_API_KEY` | 是 | Resend 邮件服务 API 密钥 |
-| `COMPANY_EMAIL` | 是 | 公司接收邮件的邮箱地址 |
-| `NODE_ENV` | 否 | 环境标识 |
-| `NEXT_PUBLIC_SITE_URL` | 否 | 网站公开 URL |
-
-## 部署平台
-
-### 1. Vercel 部署（推荐）
-
-**优势：**
-- 零配置部署
-- 自动 HTTPS
-- 全球 CDN
-- 预览部署
-- 边缘函数支持
-
-**部署步骤：**
-
-1. 连接 Git 仓库
-2. 配置环境变量
-3. 部署设置：
-   - Build Command: `npm run build`
-   - Output Directory: `dist`
-   - Install Command: `npm install`
-
-**vercel.json 配置：**
-
-```json
-{
-  "buildCommand": "npm run build",
-  "outputDirectory": "dist",
-  "framework": "nextjs",
-  "regions": ["hkg1"]
-}
-```
-
-### 2. 静态文件服务器部署
-
-**适用场景：**
-- Nginx
-- Apache
-- IIS
-- 云存储（阿里云 OSS、腾讯云 COS）
-
-**Nginx 配置示例：**
-
-```nginx
-server {
-    listen 80;
-    server_name www.novalon.cn novalon.cn;
-    root /var/www/novalon-website/dist;
-    index index.html;
-
-    # 强制 HTTPS
-    return 301 https://$server_name$request_uri;
-}
-
-server {
-    listen 443 ssl http2;
-    server_name www.novalon.cn novalon.cn;
-    root /var/www/novalon-website/dist;
-    index index.html;
-
-    # SSL 证书
-    ssl_certificate /etc/nginx/ssl/novalon.cn.pem;
-    ssl_certificate_key /etc/nginx/ssl/novalon.cn.key;
-    ssl_protocols TLSv1.2 TLSv1.3;
-    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
-    ssl_prefer_server_ciphers off;
-
-    # 安全头部
-    add_header X-Frame-Options "SAMEORIGIN" always;
-    add_header X-Content-Type-Options "nosniff" always;
-    add_header X-XSS-Protection "1; mode=block" always;
-    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
-    add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:;" always;
-
-    # Gzip 压缩
-    gzip on;
-    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
-    gzip_min_length 1000;
-
-    # 静态资源缓存
-    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
-        expires 1y;
-        add_header Cache-Control "public, immutable";
-    }
-
-    # HTML 不缓存
-    location ~* \.html$ {
-        expires -1;
-        add_header Cache-Control "no-store, no-cache, must-revalidate";
-    }
-
-    # SPA 路由支持
-    location / {
-        try_files $uri $uri.html $uri/ =404;
-    }
-
-    # 404 页面
-    error_page 404 /404.html;
-}
-```
-
-### 3. Docker 部署
-
-**Dockerfile:**
-
-```dockerfile
-# 构建阶段
-FROM node:18-alpine AS builder
-
-WORKDIR /app
-
-COPY package*.json ./
-RUN npm ci
-
-COPY . .
-RUN npm run build
-
-# 运行阶段
-FROM nginx:alpine
-
-# 复制构建产物
-COPY --from=builder /app/dist /usr/share/nginx/html
-
-# 复制 Nginx 配置
-COPY nginx.conf /etc/nginx/conf.d/default.conf
-
-EXPOSE 80
-
-CMD ["nginx", "-g", "daemon off;"]
-```
-
-**构建和运行：**
-
-```bash
-# 构建镜像
-docker build -t novalon-website .
-
-# 运行容器
-docker run -d -p 80:80 --name novalon novalon-website
-```
-
-### 4. 云存储部署
-
-**阿里云 OSS：**
-
-1. 创建 OSS Bucket
-2. 配置静态网站托管
-3. 上传 `dist/` 目录内容
-4. 配置自定义域名
-5. 配置 HTTPS 证书
-
-**腾讯云 COS：**
-
-1. 创建 COS Bucket
-2. 开启静态网站功能
-3. 上传构建产物
-4. 配置 CDN 加速
-
-## CI/CD 流水线
-
-### Woodpecker CI 配置
-
-```yaml
-# .woodpecker.yml
-pipeline:
-  install:
-    image: node:18-alpine
-    commands:
-      - npm ci
-    when:
-      event:
-        - push
-        - pull_request
-
-  lint:
-    image: node:18-alpine
-    commands:
-      - npm run lint
-    when:
-      event:
-        - push
-        - pull_request
-
-  build:
-    image: node:18-alpine
-    environment:
-      NODE_ENV: production
-    commands:
-      - npm run build
-    when:
-      event:
-        - push
-      branch:
-        - main
-
-  e2e-tests:
-    image: node:18-alpine
-    environment:
-      NODE_ENV: test
-      CI: true
-    commands:
-      - cd e2e
-      - npm ci
-      - npx playwright install --with-deps chromium
-      - npm run test:smoke
-    when:
-      event:
-        - push
-        - pull_request
-
-  deploy:
-    image: node:18-alpine
-    commands:
-      - npm install -g vercel
-      - vercel --prod --token=$VERCEL_TOKEN
-    secrets:
-      - vercel_token
-    when:
-      event:
-        - push
-      branch:
-        - main
-```
-
-## 部署检查清单
-
-### 部署前检查
-
-- [ ] 环境变量已配置
-- [ ] 构建成功无错误
-- [ ] E2E 测试通过
-- [ ] ESLint 检查通过
-- [ ] 图片资源已优化
-- [ ] 死链检查通过
-
-### 部署后验证
-
-- [ ] 首页正常加载
-- [ ] 所有页面可访问
-- [ ] 表单提交正常
-- [ ] 移动端适配正常
-- [ ] HTTPS 证书有效
-- [ ] 性能指标达标
-- [ ] SEO 元数据正确
-
-### 性能指标
-
-| 指标 | 目标值 |
-|------|--------|
-| LCP | < 2.5s |
-| FID | < 100ms |
-| CLS | < 0.1 |
-| TTFB | < 600ms |
-| 首屏加载 | < 3s |
-
-## 回滚策略
-
-### Vercel 回滚
-
-```bash
-# 列出部署历史
-vercel ls
-
-# 回滚到指定版本
-vercel rollback [deployment-url]
-```
-
-### 静态服务器回滚
-
-```bash
-# 保留历史版本
-/var/www/novalon-website/
-├── current -> releases/20260307-1
-├── releases/
-│   ├── 20260307-1/
-│   ├── 20260306-1/
-│   └── 20260305-1/
-└── shared/
-
-# 回滚操作
-ln -sfn releases/20260306-1 current
-```
-
-## 监控与告警
-
-### 推荐工具
-
-| 工具 | 用途 |
-|------|------|
-| Vercel Analytics | 性能监控 |
-| Sentry | 错误监控 |
-| Uptime Robot | 可用性监控 |
-| Google Search Console | SEO 监控 |
-
-### 告警配置
-
-```yaml
-# Uptime Robot 配置示例
-monitors:
-  - name: Novalon Website
-    url: https://www.novalon.cn
-    type: https
-    interval: 300
-    alert_contacts:
-      - email: admin@novalon.cn
-```
-
-## 安全配置
-
-### 安全头部
-
-```http
-Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
-X-Frame-Options: SAMEORIGIN
-X-Content-Type-Options: nosniff
-X-XSS-Protection: 1; mode=block
-Referrer-Policy: strict-origin-when-cross-origin
-Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:;
-Permissions-Policy: camera=(), microphone=(), geolocation=()
-```
-
-### HTTPS 配置
-
-- 使用 TLS 1.2 或更高版本
-- 配置 HSTS
-- 启用 OCSP Stapling
-- 使用强加密套件
-
-## 性能优化
-
-### 构建优化
-
-1. **代码分割**
-   - 动态导入非首屏组件
-   - 路由级别分割
-
-2. **资源优化**
-   - 图片压缩和格式转换
-   - CSS 压缩
-   - JavaScript 压缩
-
-3. **缓存策略**
-   - 静态资源长缓存
-   - HTML 不缓存
-   - API 响应适当缓存
-
-### CDN 配置
-
-```
-# CDN 缓存规则
-*.js, *.css    -> 缓存 1 年
-*.jpg, *.png   -> 缓存 1 年
-*.woff, *.woff2 -> 缓存 1 年
-*.html         -> 不缓存
-```
-
-## 故障排查
-
-### 常见问题
-
-**1. 页面 404 错误**
-- 检查静态文件是否正确上传
-- 检查 Nginx 配置的 root 路径
-- 检查 SPA 路由配置
-
-**2. 样式加载失败**
-- 检查 CSS 文件路径
-- 检查 Content-Security-Policy 配置
-- 清除浏览器缓存
-
-**3. 表单提交失败**
-- 检查 API 路由是否正常
-- 检查环境变量配置
-- 检查 CORS 配置
-
-**4. 性能问题**
-- 检查图片是否优化
-- 检查 CDN 是否生效
-- 检查服务器响应时间
-
-### 日志查看
-
-```bash
-# Nginx 访问日志
-tail -f /var/log/nginx/access.log
-
-# Nginx 错误日志
-tail -f /var/log/nginx/error.log
-
-# Vercel 日志
-vercel logs [deployment-url]
-```
-
-## 维护计划
-
-### 定期任务
-
-| 任务 | 频率 |
-|------|------|
-| 依赖更新 | 每月 |
-| 安全扫描 | 每周 |
-| 性能测试 | 每周 |
-| 备份验证 | 每月 |
-| SSL 证书更新 | 到期前 30 天 |
-
-### 更新流程
-
-1. 创建更新分支
-2. 执行依赖更新
-3. 运行测试套件
-4. 部署到预览环境
-5. 验证功能正常
-6. 合并到主分支
-7. 自动部署到生产环境
diff --git a/docs/CDN_CONFIGURATION.md b/docs/deployment/CDN_CONFIGURATION.md
similarity index 100%
rename from docs/CDN_CONFIGURATION.md
rename to docs/deployment/CDN_CONFIGURATION.md
diff --git a/docs/CDN_QUICK_START.md b/docs/deployment/CDN_QUICK_START.md
similarity index 100%
rename from docs/CDN_QUICK_START.md
rename to docs/deployment/CDN_QUICK_START.md
diff --git a/docs/CICD_QUICK_START.md b/docs/deployment/CICD_QUICK_START.md
similarity index 100%
rename from docs/CICD_QUICK_START.md
rename to docs/deployment/CICD_QUICK_START.md
diff --git a/docs/deployment/DEPLOYMENT.md b/docs/deployment/DEPLOYMENT.md
index 1fa02e3..ebc9066 100644
--- a/docs/deployment/DEPLOYMENT.md
+++ b/docs/deployment/DEPLOYMENT.md
@@ -1,732 +1,475 @@
-# 安全功能部署文档
+# 部署文档
 
-## 目录
+## 部署概述
 
-1. [部署前准备](#部署前准备)
-2. [环境配置](#环境配置)
-3. [部署步骤](#部署步骤)
-4. [部署后验证](#部署后验证)
-5. [监控和维护](#监控和维护)
-6. [故障排除](#故障排除)
-7. [回滚计划](#回滚计划)
+项目采用 Next.js 静态导出模式，构建生成纯静态 HTML 文件，可部署到任何静态文件服务器或 CDN。
 
-## 部署前准备
+## 构建配置
 
-### 系统要求
+### Next.js 配置
 
-- **Node.js**: 18.x 或更高版本
-- **npm**: 9.x 或更高版本
-- **数据库**: PostgreSQL 14+ 或 SQLite（开发环境）
-- **邮件服务**: Resend API 密钥
-- **操作系统**: Linux/macOS/Windows
-
-### 依赖检查
-
-在部署前，确保所有依赖都已正确安装：
-
-```bash
-# 检查 Node.js 版本
-node --version  # 应该 >= 18.x
-
-# 检查 npm 版本
-npm --version  # 应该 >= 9.x
-
-# 安装项目依赖
-npm install
+```typescript
+// next.config.ts
+const nextConfig: NextConfig = {
+  output: 'export',      // 静态导出模式
+  distDir: 'dist',       // 输出目录
+  images: {
+    unoptimized: true,   // 静态导出需要禁用图片优化
+  },
+  compress: true,
+  poweredByHeader: false,
+  reactStrictMode: true,
+};
 ```
 
-### 安全配置检查
-
-确保以下安全配置文件已正确设置：
+### 构建命令
 
 ```bash
-# 检查环境变量示例文件
-ls -la .env.example
+# 开发模式（不导出）
+npm run dev
 
-# 检查安全模块
-ls -la src/lib/security/
-```
-
-## 环境配置
-
-### 生产环境变量
-
-创建 `.env.production` 文件并配置以下变量：
-
-```bash
-# Resend API Configuration
-RESEND_API_KEY=re_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
-
-# Company Email
-COMPANY_EMAIL=contact@novalon.cn
-
-# Next.js Configuration
-NEXT_PUBLIC_SITE_URL=https://www.novalon.cn
-
-# Sentry Error Monitoring (可选)
-NEXT_PUBLIC_SENTRY_DSN=https://xxx@xxx.ingest.sentry.io/xxx
-
-# NextAuth Configuration
-NEXTAUTH_SECRET=your-very-secure-secret-key-here
-NEXTAUTH_URL=https://www.novalon.cn
-
-# Admin User
-ADMIN_EMAIL=admin@novalon.cn
-ADMIN_PASSWORD=your-very-secure-password-here
-
-# Database
-DATABASE_URL=postgresql://user:password@host:port/database
-
-# File Upload
-UPLOAD_DIR=/var/www/uploads
-MAX_FILE_SIZE=10485760
-
-# Security Configuration
-# Rate Limiting (每分钟最大请求数)
-RATE_LIMIT_MAX_REQUESTS=5
-RATE_LIMIT_WINDOW_MS=60000
-
-# Captcha Configuration
-CAPTCHA_EXPIRY_MS=180000
-CAPTCHA_MAX_ATTEMPTS=3
-
-# Security Logging
-SECURITY_LOG_RETENTION_DAYS=90
-SECURITY_LOG_MAX_ENTRIES=5000
-```
-
-### 安全配置说明
-
-#### 频率限制配置
-
-生产环境建议配置：
-- `RATE_LIMIT_MAX_REQUESTS`: 5（每分钟最多5次请求）
-- `RATE_LIMIT_WINDOW_MS`: 60000（60秒时间窗口）
-
-开发环境建议配置：
-- `RATE_LIMIT_MAX_REQUESTS`: 100（宽松限制）
-- `RATE_LIMIT_WINDOW_MS`: 60000
-
-#### 验证码配置
-
-生产环境建议配置：
-- `CAPTCHA_EXPIRY_MS`: 180000（3分钟过期）
-- `CAPTCHA_MAX_ATTEMPTS`: 3（最多3次尝试）
-
-#### 安全日志配置
-
-生产环境建议配置：
-- `SECURITY_LOG_RETENTION_DAYS`: 90（保留90天）
-- `SECURITY_LOG_MAX_ENTRIES`: 5000（最多5000条记录）
-
-## 部署步骤
-
-### 步骤 1: 代码构建
-
-```bash
-# 拉取最新代码
-git pull origin main
-
-# 安装依赖
-npm install
-
-# 运行测试
-npm run test:unit
-
-# 构建生产版本
+# 生产构建（静态导出）
 npm run build
+
+# 输出目录
+dist/
 ```
 
-### 步骤 2: 环境变量配置
+## 环境变量
 
-```bash
-# 复制环境变量模板
-cp .env.example .env.production
+### 必需配置
 
-# 编辑环境变量
-nano .env.production
+```env
+# .env.production
+RESEND_API_KEY=re_xxxxx
+COMPANY_EMAIL=contact@novalon.cn
 ```
 
-**重要提示**：
-- 确保 `NEXTAUTH_SECRET` 是一个强随机字符串
-- 确保 `ADMIN_PASSWORD` 是一个强密码
-- 确保 `RESEND_API_KEY` 是有效的 Resend API 密钥
+### 可选配置
 
-### 步骤 3: 数据库迁移
-
-```bash
-# 运行数据库迁移
-npm run db:migrate
-
-# 或者使用 Prisma
-npx prisma migrate deploy
+```env
+NODE_ENV=production
+NEXT_PUBLIC_SITE_URL=https://www.novalon.cn
 ```
 
-### 步骤 4: 启动应用
+### 环境变量说明
 
-#### 使用 PM2（推荐）
+| 变量名 | 必需 | 描述 |
+|--------|------|------|
+| `RESEND_API_KEY` | 是 | Resend 邮件服务 API 密钥 |
+| `COMPANY_EMAIL` | 是 | 公司接收邮件的邮箱地址 |
+| `NODE_ENV` | 否 | 环境标识 |
+| `NEXT_PUBLIC_SITE_URL` | 否 | 网站公开 URL |
 
-```bash
-# 安装 PM2
-npm install -g pm2
+## 部署平台
 
-# 启动应用
-pm2 start npm --name "novalon-website" -- start
+### 1. Vercel 部署（推荐）
 
-# 查看日志
-pm2 logs novalon-website
+**优势：**
+- 零配置部署
+- 自动 HTTPS
+- 全球 CDN
+- 预览部署
+- 边缘函数支持
 
-# 查看状态
-pm2 status
+**部署步骤：**
+
+1. 连接 Git 仓库
+2. 配置环境变量
+3. 部署设置：
+   - Build Command: `npm run build`
+   - Output Directory: `dist`
+   - Install Command: `npm install`
+
+**vercel.json 配置：**
+
+```json
+{
+  "buildCommand": "npm run build",
+  "outputDirectory": "dist",
+  "framework": "nextjs",
+  "regions": ["hkg1"]
+}
 ```
 
-#### 使用 Docker
+### 2. 静态文件服务器部署
 
-```bash
-# 构建镜像
-docker build -t novalon-website .
+**适用场景：**
+- Nginx
+- Apache
+- IIS
+- 云存储（阿里云 OSS、腾讯云 COS）
 
-# 运行容器
-docker run -d \
-  --name novalon-website \
-  -p 3000:3000 \
-  --env-file .env.production \
-  novalon-website
-```
-
-#### 使用 Systemd
-
-创建 `/etc/systemd/system/novalon-website.service` 文件：
-
-```ini
-[Unit]
-Description=Novalon Website
-After=network.target
-
-[Service]
-Type=simple
-User=www-data
-WorkingDirectory=/var/www/novalon-website
-ExecStart=/usr/bin/npm start
-Restart=on-failure
-RestartSec=10
-
-[Install]
-WantedBy=multi-user.target
-```
-
-启动服务：
-
-```bash
-# 重载 systemd
-sudo systemctl daemon-reload
-
-# 启动服务
-sudo systemctl start novalon-website
-
-# 设置开机自启
-sudo systemctl enable novalon-website
-
-# 查看状态
-sudo systemctl status novalon-website
-```
-
-### 步骤 5: 配置反向代理（Nginx）
-
-创建 Nginx 配置文件 `/etc/nginx/sites-available/novalon.cn`：
+**Nginx 配置示例：**
 
 ```nginx
 server {
     listen 80;
     server_name www.novalon.cn novalon.cn;
+    root /var/www/novalon-website/dist;
+    index index.html;
+
+    # 强制 HTTPS
     return 301 https://$server_name$request_uri;
 }
 
 server {
     listen 443 ssl http2;
     server_name www.novalon.cn novalon.cn;
-
-    ssl_certificate /etc/letsencrypt/live/novalon.cn/fullchain.pem;
-    ssl_certificate_key /etc/letsencrypt/live/novalon.cn/privkey.pem;
-    ssl_protocols TLSv1.2 TLSv1.3;
-    ssl_ciphers HIGH:!aNULL:!MD5;
-
-    root /var/www/novalon-website;
+    root /var/www/novalon-website/dist;
     index index.html;
 
-    location / {
-        proxy_pass http://localhost:3000;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
+    # SSL 证书
+    ssl_certificate /etc/nginx/ssl/novalon.cn.pem;
+    ssl_certificate_key /etc/nginx/ssl/novalon.cn.key;
+    ssl_protocols TLSv1.2 TLSv1.3;
+    ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
+    ssl_prefer_server_ciphers off;
+
+    # 安全头部
+    add_header X-Frame-Options "SAMEORIGIN" always;
+    add_header X-Content-Type-Options "nosniff" always;
+    add_header X-XSS-Protection "1; mode=block" always;
+    add_header Referrer-Policy "strict-origin-when-cross-origin" always;
+    add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:;" always;
+
+    # Gzip 压缩
+    gzip on;
+    gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
+    gzip_min_length 1000;
+
+    # 静态资源缓存
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
     }
 
-    location /api/admin/security {
-        # 限制访问安全监控端点
-        allow 192.168.1.0/24;
-        allow 10.0.0.0/8;
-        deny all;
-        
-        proxy_pass http://localhost:3000;
-        proxy_http_version 1.1;
-        proxy_set_header Host $host;
+    # HTML 不缓存
+    location ~* \.html$ {
+        expires -1;
+        add_header Cache-Control "no-store, no-cache, must-revalidate";
     }
+
+    # SPA 路由支持
+    location / {
+        try_files $uri $uri.html $uri/ =404;
+    }
+
+    # 404 页面
+    error_page 404 /404.html;
 }
 ```
 
-启用配置：
+### 3. Docker 部署
 
-```bash
-# 创建符号链接
-sudo ln -s /etc/nginx/sites-available/novalon.cn /etc/nginx/sites-enabled/
+**Dockerfile:**
 
-# 测试配置
-sudo nginx -t
+```dockerfile
+# 构建阶段
+FROM node:18-alpine AS builder
 
-# 重载 Nginx
-sudo systemctl reload nginx
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm ci
+
+COPY . .
+RUN npm run build
+
+# 运行阶段
+FROM nginx:alpine
+
+# 复制构建产物
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# 复制 Nginx 配置
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]
 ```
 
-### 步骤 6: 配置 SSL 证书
-
-使用 Let's Encrypt 获取免费 SSL 证书：
+**构建和运行：**
 
 ```bash
-# 安装 Certbot
-sudo apt-get install certbot python3-certbot-nginx
+# 构建镜像
+docker build -t novalon-website .
 
-# 获取证书
-sudo certbot --nginx -d www.novalon.cn -d novalon.cn
-
-# 自动续期
-sudo certbot renew --dry-run
+# 运行容器
+docker run -d -p 80:80 --name novalon novalon-website
 ```
 
-## 部署后验证
+### 4. 云存储部署
 
-### 功能验证
+**阿里云 OSS：**
 
-#### 1. 基本功能测试
+1. 创建 OSS Bucket
+2. 配置静态网站托管
+3. 上传 `dist/` 目录内容
+4. 配置自定义域名
+5. 配置 HTTPS 证书
 
-访问联系页面并测试基本功能：
+**腾讯云 COS：**
+
+1. 创建 COS Bucket
+2. 开启静态网站功能
+3. 上传构建产物
+4. 配置 CDN 加速
+
+## CI/CD 流水线
+
+### Woodpecker CI 配置
+
+```yaml
+# .woodpecker.yml
+pipeline:
+  install:
+    image: node:18-alpine
+    commands:
+      - npm ci
+    when:
+      event:
+        - push
+        - pull_request
+
+  lint:
+    image: node:18-alpine
+    commands:
+      - npm run lint
+    when:
+      event:
+        - push
+        - pull_request
+
+  build:
+    image: node:18-alpine
+    environment:
+      NODE_ENV: production
+    commands:
+      - npm run build
+    when:
+      event:
+        - push
+      branch:
+        - main
+
+  e2e-tests:
+    image: node:18-alpine
+    environment:
+      NODE_ENV: test
+      CI: true
+    commands:
+      - cd e2e
+      - npm ci
+      - npx playwright install --with-deps chromium
+      - npm run test:smoke
+    when:
+      event:
+        - push
+        - pull_request
+
+  deploy:
+    image: node:18-alpine
+    commands:
+      - npm install -g vercel
+      - vercel --prod --token=$VERCEL_TOKEN
+    secrets:
+      - vercel_token
+    when:
+      event:
+        - push
+      branch:
+        - main
+```
+
+## 部署检查清单
+
+### 部署前检查
+
+- [ ] 环境变量已配置
+- [ ] 构建成功无错误
+- [ ] E2E 测试通过
+- [ ] ESLint 检查通过
+- [ ] 图片资源已优化
+- [ ] 死链检查通过
+
+### 部署后验证
+
+- [ ] 首页正常加载
+- [ ] 所有页面可访问
+- [ ] 表单提交正常
+- [ ] 移动端适配正常
+- [ ] HTTPS 证书有效
+- [ ] 性能指标达标
+- [ ] SEO 元数据正确
+
+### 性能指标
+
+| 指标 | 目标值 |
+|------|--------|
+| LCP | < 2.5s |
+| FID | < 100ms |
+| CLS | < 0.1 |
+| TTFB | < 600ms |
+| 首屏加载 | < 3s |
+
+## 回滚策略
+
+### Vercel 回滚
 
 ```bash
-# 测试联系页面
-curl https://www.novalon.cn/contact
+# 列出部署历史
+vercel ls
 
-# 测试API端点
-curl -X POST https://www.novalon.cn/api/contact \
-  -H "Content-Type: application/json" \
-  -d '{"name":"Test","phone":"13800138000","email":"test@example.com","subject":"Test","message":"Test message"}'
+# 回滚到指定版本
+vercel rollback [deployment-url]
 ```
 
-#### 2. 安全功能测试
-
-验证安全功能是否正常工作：
+### 静态服务器回滚
 
 ```bash
-# 测试频率限制
-for i in {1..10}; do
-  curl -X POST https://www.novalon.cn/api/contact \
-    -H "Content-Type: application/json" \
-    -d '{"name":"Test","phone":"13800138000","email":"test@example.com","subject":"Test","message":"Test message"}'
-  echo "Request $i completed"
-done
+# 保留历史版本
+/var/www/novalon-website/
+├── current -> releases/20260307-1
+├── releases/
+│   ├── 20260307-1/
+│   ├── 20260306-1/
+│   └── 20260305-1/
+└── shared/
+
+# 回滚操作
+ln -sfn releases/20260306-1 current
 ```
 
-预期结果：前5个请求成功，后续请求被频率限制拦截。
+## 监控与告警
 
-#### 3. 安全监控仪表板测试
+### 推荐工具
 
-访问安全监控仪表板：
-
-```bash
-# 访问安全监控页面
-curl https://www.novalon.cn/admin/security
-```
-
-预期结果：显示安全统计信息和日志。
-
-### 性能验证
-
-#### 1. 响应时间测试
-
-```bash
-# 测试API响应时间
-time curl -X POST https://www.novalon.cn/api/contact \
-  -H "Content-Type: application/json" \
-  -d '{"name":"Test","phone":"13800138000","email":"test@example.com","subject":"Test","message":"Test message"}'
-```
-
-预期结果：响应时间 < 500ms
-
-#### 2. 并发测试
-
-使用 Apache Bench 进行并发测试：
-
-```bash
-# 安装 Apache Bench
-sudo apt-get install apache2-utils
-
-# 并发测试
-ab -n 100 -c 10 https://www.novalon.cn/contact
-```
-
-预期结果：无错误，响应时间合理
-
-### 安全验证
-
-#### 1. SSL/TLS 配置检查
-
-```bash
-# 检查 SSL 配置
-openssl s_client -connect www.novalon.cn:443 -tls1_2
-openssl s_client -connect www.novalon.cn:443 -tls1_3
-```
-
-预期结果：支持 TLS 1.2 和 TLS 1.3
-
-#### 2. 安全头检查
-
-```bash
-# 检查安全头
-curl -I https://www.novalon.cn/contact
-```
-
-预期结果：包含以下安全头：
-- `X-Frame-Options: DENY`
-- `X-Content-Type-Options: nosniff`
-- `X-XSS-Protection: 1; mode=block`
-- `Strict-Transport-Security: max-age=31536000; includeSubDomains`
-
-#### 3. 漏洞扫描
-
-使用 OWASP ZAP 或类似工具进行安全扫描：
-
-```bash
-# 安装 OWASP ZAP
-sudo apt-get install zaproxy
-
-# 运行扫描
-zap-cli quick-scan --self-contained \
-  --start-options '-config api.disablekey=true' \
-  https://www.novalon.cn/contact
-```
-
-## 监控和维护
-
-### 应用监控
-
-#### 1. PM2 监控
-
-```bash
-# 查看应用状态
-pm2 status
-
-# 查看实时日志
-pm2 logs novalon-website --lines 100
-
-# 查看资源使用
-pm2 monit
-```
-
-#### 2. 日志监控
-
-```bash
-# 查看应用日志
-tail -f /var/log/novalon-website/app.log
-
-# 查看错误日志
-tail -f /var/log/novalon-website/error.log
-
-# 查看 Nginx 日志
-tail -f /var/log/nginx/access.log
-tail -f /var/log/nginx/error.log
-```
-
-#### 3. 安全监控
-
-定期访问安全监控仪表板：
-
-```bash
-# 访问安全监控页面
-https://www.novalon.cn/admin/security
-```
-
-关注以下指标：
-- 总请求数
-- 已拦截请求数
-- 验证码尝试次数
-- 频率限制命中次数
-- 恶意内容检测次数
-- 成功率
-
-### 定期维护任务
-
-#### 每日任务
-
-- 检查应用日志，查找错误和异常
-- 查看安全监控仪表板，关注高危事件
-- 检查磁盘空间使用情况
-
-#### 每周任务
-
-- 审查安全日志，识别异常模式
-- 检查频率限制统计，调整配置
-- 备份数据库和应用配置
-- 更新依赖包：`npm update`
-
-#### 每月任务
-
-- 审查和更新安全配置
-- 进行安全漏洞扫描
-- 测试备份恢复流程
-- 审查用户访问日志
+| 工具 | 用途 |
+|------|------|
+| Vercel Analytics | 性能监控 |
+| Sentry | 错误监控 |
+| Uptime Robot | 可用性监控 |
+| Google Search Console | SEO 监控 |
 
 ### 告警配置
 
-配置告警通知，当检测到以下情况时发送通知：
+```yaml
+# Uptime Robot 配置示例
+monitors:
+  - name: Novalon Website
+    url: https://www.novalon.cn
+    type: https
+    interval: 300
+    alert_contacts:
+      - email: admin@novalon.cn
+```
 
-1. **高危安全事件**：XSS攻击、SQL注入等
-2. **频繁的频率限制**：短时间内大量请求被拦截
-3. **应用错误**：应用崩溃或响应时间过长
-4. **磁盘空间不足**：磁盘使用率超过 80%
+## 安全配置
 
-## 故障排除
+### 安全头部
+
+```http
+Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
+X-Frame-Options: SAMEORIGIN
+X-Content-Type-Options: nosniff
+X-XSS-Protection: 1; mode=block
+Referrer-Policy: strict-origin-when-cross-origin
+Content-Security-Policy: default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data: https:; font-src 'self' data:;
+Permissions-Policy: camera=(), microphone=(), geolocation=()
+```
+
+### HTTPS 配置
+
+- 使用 TLS 1.2 或更高版本
+- 配置 HSTS
+- 启用 OCSP Stapling
+- 使用强加密套件
+
+## 性能优化
+
+### 构建优化
+
+1. **代码分割**
+   - 动态导入非首屏组件
+   - 路由级别分割
+
+2. **资源优化**
+   - 图片压缩和格式转换
+   - CSS 压缩
+   - JavaScript 压缩
+
+3. **缓存策略**
+   - 静态资源长缓存
+   - HTML 不缓存
+   - API 响应适当缓存
+
+### CDN 配置
+
+```
+# CDN 缓存规则
+*.js, *.css    -> 缓存 1 年
+*.jpg, *.png   -> 缓存 1 年
+*.woff, *.woff2 -> 缓存 1 年
+*.html         -> 不缓存
+```
+
+## 故障排查
 
 ### 常见问题
 
-#### 问题 1: 验证码总是失败
+**1. 页面 404 错误**
+- 检查静态文件是否正确上传
+- 检查 Nginx 配置的 root 路径
+- 检查 SPA 路由配置
 
-**症状**：用户报告验证码总是验证失败
+**2. 样式加载失败**
+- 检查 CSS 文件路径
+- 检查 Content-Security-Policy 配置
+- 清除浏览器缓存
 
-**可能原因**：
-- 客户端和服务器时间不同步
-- 验证码过期时间设置过短
-- 浏览器缓存问题
+**3. 表单提交失败**
+- 检查 API 路由是否正常
+- 检查环境变量配置
+- 检查 CORS 配置
 
-**解决方案**：
-```bash
-# 检查服务器时间
-date
+**4. 性能问题**
+- 检查图片是否优化
+- 检查 CDN 是否生效
+- 检查服务器响应时间
 
-# 同步时间
-sudo ntpdate pool.ntp.org
-
-# 增加 CAPTCHA_EXPIRY_MS
-# 在 .env.production 中设置
-CAPTCHA_EXPIRY_MS=300000
-```
-
-#### 问题 2: 频率限制过于严格
-
-**症状**：正常用户被频率限制拦截
-
-**可能原因**：
-- RATE_LIMIT_MAX_REQUESTS 设置过低
-- 代理或负载均衡器导致IP识别问题
-- 时间窗口设置过短
-
-**解决方案**：
-```bash
-# 增加 RATE_LIMIT_MAX_REQUESTS
-# 在 .env.production 中设置
-RATE_LIMIT_MAX_REQUESTS=10
-
-# 增加 RATE_LIMIT_WINDOW_MS
-# 在 .env.production 中设置
-RATE_LIMIT_WINDOW_MS=120000
-```
-
-#### 问题 3: 安全监控仪表板无法访问
-
-**症状**：访问 `/admin/security` 返回 403 错误
-
-**可能原因**：
-- Nginx 配置限制了访问
-- 用户未登录
-- 权限配置问题
-
-**解决方案**：
-```bash
-# 检查 Nginx 配置
-sudo cat /etc/nginx/sites-available/novalon.cn
-
-# 更新允许的IP范围
-allow 192.168.1.0/24;
-allow 10.0.0.0/8;
-
-# 重载 Nginx
-sudo systemctl reload nginx
-```
-
-#### 问题 4: 应用启动失败
-
-**症状**：应用无法启动，PM2 显示错误
-
-**可能原因**：
-- 环境变量配置错误
-- 数据库连接失败
-- 端口被占用
-
-**解决方案**：
-```bash
-# 检查环境变量
-cat .env.production
-
-# 测试数据库连接
-psql -h host -U user -d database
-
-# 检查端口占用
-sudo lsof -i :3000
-
-# 查看详细错误日志
-pm2 logs novalon-website --err
-```
-
-### 日志分析
-
-#### 安全日志分析
+### 日志查看
 
 ```bash
-# 查看最近的安全事件
-tail -100 /var/log/novalon-website/security.log
+# Nginx 访问日志
+tail -f /var/log/nginx/access.log
 
-# 统计高危事件
-grep "HIGH" /var/log/novalon-website/security.log | wc -l
+# Nginx 错误日志
+tail -f /var/log/nginx/error.log
 
-# 查找特定IP的活动
-grep "192.168.1.100" /var/log/novalon-website/security.log
+# Vercel 日志
+vercel logs [deployment-url]
 ```
 
-#### 应用日志分析
+## 维护计划
 
-```bash
-# 查看错误日志
-grep "ERROR" /var/log/novalon-website/app.log
+### 定期任务
 
-# 查看慢请求
-grep "slow" /var/log/novalon-website/app.log
+| 任务 | 频率 |
+|------|------|
+| 依赖更新 | 每月 |
+| 安全扫描 | 每周 |
+| 性能测试 | 每周 |
+| 备份验证 | 每月 |
+| SSL 证书更新 | 到期前 30 天 |
 
-# 统计请求数
-wc -l /var/log/novalon-website/access.log
-```
+### 更新流程
 
-## 回滚计划
-
-### 回滚触发条件
-
-在以下情况下考虑回滚：
-
-1. **严重安全漏洞**：发现无法快速修复的严重安全漏洞
-2. **性能严重下降**：响应时间增加超过 50%
-3. **功能严重故障**：核心功能无法使用
-4. **数据损坏**：数据库或文件系统损坏
-
-### 回滚步骤
-
-#### 步骤 1: 备份当前状态
-
-```bash
-# 备份数据库
-pg_dump -U user -h host database > backup_$(date +%Y%m%d_%H%M%S).sql
-
-# 备份应用文件
-tar -czf app_backup_$(date +%Y%m%d_%H%M%S).tar.gz /var/www/novalon-website
-
-# 备份配置文件
-cp .env.production .env.production.backup_$(date +%Y%m%d_%H%M%S)
-```
-
-#### 步骤 2: 停止应用
-
-```bash
-# 停止 PM2 应用
-pm2 stop novalon-website
-
-# 或停止 Systemd 服务
-sudo systemctl stop novalon-website
-```
-
-#### 步骤 3: 恢复之前的版本
-
-```bash
-# 恢复到之前的 Git 提交
-git checkout <previous-commit-hash>
-
-# 重新构建
-npm run build
-```
-
-#### 步骤 4: 恢复数据库（如果需要）
-
-```bash
-# 恢复数据库备份
-psql -U user -h host database < backup_YYYYMMDD_HHMMSS.sql
-```
-
-#### 步骤 5: 重新启动应用
-
-```bash
-# 启动 PM2 应用
-pm2 start novalon-website
-
-# 或启动 Systemd 服务
-sudo systemctl start novalon-website
-```
-
-#### 步骤 6: 验证回滚
-
-```bash
-# 测试基本功能
-curl https://www.novalon.cn/contact
-
-# 检查应用状态
-pm2 status
-
-# 查看日志
-pm2 logs novalon-website
-```
-
-## 附录
-
-### A. 安全配置最佳实践
-
-1. **使用强密码**：所有密码至少包含12个字符，包括大小写字母、数字和特殊字符
-2. **定期更新密钥**：每季度更新 API 密钥和会话密钥
-3. **最小权限原则**：数据库用户只授予必要的权限
-4. **网络隔离**：数据库和应用服务器之间使用私有网络
-5. **定期备份**：每天备份数据库，每周备份应用文件
-
-### B. 性能优化建议
-
-1. **启用缓存**：使用 Redis 缓存频繁访问的数据
-2. **CDN 加速**：使用 CDN 加速静态资源
-3. **数据库优化**：定期优化数据库表和索引
-4. **负载均衡**：使用负载均衡器分发请求
-5. **监控和调优**：持续监控性能指标，及时调优
-
-### C. 相关文档
-
-- [SECURITY.md](SECURITY.md) - 安全配置文档
-- [TESTING_REPORT.md](TESTING_REPORT.md) - 测试验证报告
-- [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) - 实施计划
-
-### D. 联系方式
-
-如有部署相关问题，请联系：
-
-- 技术支持：tech@novalon.cn
-- 安全团队：security@novalon.cn
-- 紧急联系：+86-xxx-xxxx-xxxx
-
----
-
-**文档版本**: 1.0  
-**最后更新**: 2024-03-24  
-**维护者**: 技术团队
+1. 创建更新分支
+2. 执行依赖更新
+3. 运行测试套件
+4. 部署到预览环境
+5. 验证功能正常
+6. 合并到主分支
+7. 自动部署到生产环境
diff --git a/docs/GOOGLE_ANALYTICS_SETUP.md b/docs/deployment/GOOGLE_ANALYTICS_SETUP.md
similarity index 100%
rename from docs/GOOGLE_ANALYTICS_SETUP.md
rename to docs/deployment/GOOGLE_ANALYTICS_SETUP.md
diff --git a/docs/LIGHTWEIGHT_MONITORING.md b/docs/deployment/LIGHTWEIGHT_MONITORING.md
similarity index 100%
rename from docs/LIGHTWEIGHT_MONITORING.md
rename to docs/deployment/LIGHTWEIGHT_MONITORING.md
diff --git a/docs/MONITORING_LIGHTWEIGHT.md b/docs/deployment/MONITORING_LIGHTWEIGHT.md
similarity index 100%
rename from docs/MONITORING_LIGHTWEIGHT.md
rename to docs/deployment/MONITORING_LIGHTWEIGHT.md
diff --git a/docs/MONITORING_QUICKSTART.md b/docs/deployment/MONITORING_QUICKSTART.md
similarity index 100%
rename from docs/MONITORING_QUICKSTART.md
rename to docs/deployment/MONITORING_QUICKSTART.md
diff --git a/docs/MONITORING_SETUP.md b/docs/deployment/MONITORING_SETUP.md
similarity index 100%
rename from docs/MONITORING_SETUP.md
rename to docs/deployment/MONITORING_SETUP.md
diff --git a/docs/OPTIMIZATION_REPORT.md b/docs/deployment/OPTIMIZATION_REPORT.md
similarity index 100%
rename from docs/OPTIMIZATION_REPORT.md
rename to docs/deployment/OPTIMIZATION_REPORT.md
diff --git a/docs/PERFORMANCE_OPTIMIZATION.md b/docs/deployment/PERFORMANCE_OPTIMIZATION.md
similarity index 100%
rename from docs/PERFORMANCE_OPTIMIZATION.md
rename to docs/deployment/PERFORMANCE_OPTIMIZATION.md
diff --git a/docs/PRODUCTION_DEPLOYMENT.md b/docs/deployment/PRODUCTION_DEPLOYMENT.md
similarity index 100%
rename from docs/PRODUCTION_DEPLOYMENT.md
rename to docs/deployment/PRODUCTION_DEPLOYMENT.md
diff --git a/docs/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md b/docs/deployment/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md
similarity index 100%
rename from docs/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md
rename to docs/deployment/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md
diff --git a/docs/PRODUCTION_RELEASE_REPORT.md b/docs/deployment/PRODUCTION_RELEASE_REPORT.md
similarity index 100%
rename from docs/PRODUCTION_RELEASE_REPORT.md
rename to docs/deployment/PRODUCTION_RELEASE_REPORT.md
diff --git a/docs/CONTACT_CONFIGURATION.md b/docs/development/CONTACT_CONFIGURATION.md
similarity index 100%
rename from docs/CONTACT_CONFIGURATION.md
rename to docs/development/CONTACT_CONFIGURATION.md
diff --git a/docs/api-versioning-guide.md b/docs/development/api-versioning-guide.md
similarity index 100%
rename from docs/api-versioning-guide.md
rename to docs/development/api-versioning-guide.md
diff --git a/docs/api.md b/docs/development/api.md
similarity index 100%
rename from docs/api.md
rename to docs/development/api.md
diff --git a/docs/components.md b/docs/development/components.md
similarity index 100%
rename from docs/components.md
rename to docs/development/components.md
diff --git a/docs/openapi-guide.md b/docs/development/openapi-guide.md
similarity index 100%
rename from docs/openapi-guide.md
rename to docs/development/openapi-guide.md
diff --git a/docs/ADMIN-CREDENTIALS.md b/docs/security/ADMIN-CREDENTIALS.md
similarity index 100%
rename from docs/ADMIN-CREDENTIALS.md
rename to docs/security/ADMIN-CREDENTIALS.md
diff --git a/docs/superpowers/plans/2026-04-12-project-reorganization-plan.md b/docs/superpowers/plans/2026-04-12-project-reorganization-plan.md
new file mode 100644
index 0000000..56c695b
--- /dev/null
+++ b/docs/superpowers/plans/2026-04-12-project-reorganization-plan.md
@@ -0,0 +1,665 @@
+# Novalon Website 项目系统性整理实施计划
+
+**创建日期：** 2026-04-12  
+**基于设计：** [2026-04-12-project-reorganization-design.md](../specs/2026-04-12-project-reorganization-design.md)  
+**执行方式：** 内联执行（使用 executing-plans 技能）
+
+---
+
+## 执行概览
+
+**总预估时间：** 3.5 天  
+**执行策略：** 混合方案（方案 B + 方案 C）  
+**验收标准：** 参见设计文档第 1.3 节
+
+---
+
+## 阶段一：自动化预处理（方案 C）
+
+**预估时间：** 0.5 天  
+**执行方式：** 自动化工具 + 人工验证
+
+### 任务 1.1：代码格式化统一
+
+**文件**: 
+- 创建: `.prettierrc`
+- 修改: `config/lint/.eslintrc.json`
+
+**职责**: 统一代码风格和格式
+
+**测试**: 运行 `npm run lint` 验证无错误
+
+**步骤**:
+1. 创建 `.prettierrc` 配置文件
+   ```json
+   {
+     "semi": true,
+     "trailingComma": "es5",
+     "singleQuote": true,
+     "printWidth": 100,
+     "tabWidth": 2,
+     "useTabs": false,
+     "arrowParens": "always",
+     "endOfLine": "lf"
+   }
+   ```
+2. 更新 `config/lint/.eslintrc.json` 强化规则
+3. 运行 `npm run lint -- --fix` 自动修复代码格式
+4. 运行 `npm run lint` 验证无错误
+
+---
+
+### 任务 1.2：安全漏洞自动修复
+
+**文件**: `package.json`, `package-lock.json`
+
+**职责**: 修复安全漏洞
+
+**测试**: 运行 `npm audit` 验证无漏洞
+
+**步骤**:
+1. 运行 `npm audit fix` 自动修复安全漏洞
+2. 如自动修复失败，手动更新依赖：
+   ```bash
+   npm update drizzle-kit @lhci/cli
+   ```
+3. 运行 `npm audit` 验证漏洞已修复
+4. 运行 `npm test` 验证功能正常
+
+---
+
+### 任务 1.3：简单代码问题自动修复
+
+**文件**: 多个源代码文件
+
+**职责**: 自动修复简单的代码问题
+
+**测试**: 运行 `npm run lint` 和 `npm run type-check` 验证
+
+**步骤**:
+1. 运行 `npm run lint -- --fix` 自动修复代码问题
+2. 运行 `npm run type-check` 验证无类型错误
+3. 运行 `npm test` 验证功能正常
+
+---
+
+## 阶段二:项目结构重组（方案 B）
+
+**预估时间:** 0.5 天  
+**执行方式:** 人工处理 + 测试验证
+
+### 任务 2.1:脚本文件分类整理
+
+**文件**: 
+- 创建: `scripts/deployment/`, `scripts/monitoring/`, `scripts/diagnosis/`, `scripts/security/`, `scripts/maintenance/`, `scripts/tools/`, `scripts/README.md`
+- 移动: 根目录的 36 个脚本文件
+
+**职责**: 将根目录的 36 个脚本文件分类整理
+
+**测试**: 
+1. 检查 `package.json` 中的脚本路径是否已更新
+2. 运行 `npm run build` 验证构建成功
+3. 检查根目录脚本文件数量 ≤ 5
+
+**步骤**:
+1. 创建 `scripts/` 子目录结构
+   ```bash
+   mkdir -p scripts/deployment
+   mkdir -p scripts/monitoring
+   mkdir -p scripts/diagnosis
+   mkdir -p scripts/security
+   mkdir -p scripts/maintenance
+   mkdir -p scripts/tools
+   ```
+2. 移动部署脚本
+   ```bash
+   mv deploy.sh scripts/deployment/
+   mv deploy-production.sh scripts/deployment/
+   mv deploy-cdn.sh scripts/deployment/
+   mv refresh-cdn.sh scripts/deployment/
+   mv deploy-subdomain-ssl.sh scripts/deployment/
+   mv deploy-wildcard-domain.sh scripts/deployment/
+   ```
+3. 移动监控脚本
+   ```bash
+   mv monitor-pipeline.sh scripts/monitoring/
+   mv monitor-pipeline-32.sh scripts/monitoring/
+   mv monitor-pipeline-continuous.sh scripts/monitoring/
+   mv cicd-monitor.sh scripts/monitoring/
+   mv container-monitor.sh scripts/monitoring/
+   ```
+4. 移动诊断脚本
+   ```bash
+   mv diagnose-docker-ci.sh scripts/diagnosis/
+   mv diagnose-cicd-issues.sh scripts/diagnosis/
+   mv diagnose-webhook-detail.sh scripts/diagnosis/
+   mv diagnose-woodpecker.py scripts/diagnosis/
+   mv diagnose-auto-trigger.py scripts/diagnosis/
+   mv production-diagnosis.sh scripts/diagnosis/
+   mv remote-server-diagnosis.sh scripts/diagnosis/
+   mv network-diagnosis.sh scripts/diagnosis/
+   ```
+5. 移动安全脚本
+   ```bash
+   mv security-audit.sh scripts/security/
+   mv security-hardening.sh scripts/security/
+   mv security-verification.sh scripts/security/
+   ```
+6. 移动维护脚本
+   ```bash
+   mv auto-cleanup.sh scripts/maintenance/
+   mv disk-cleanup-immediate.sh scripts/maintenance/
+   mv disk-optimization-long-term.sh scripts/maintenance/
+   mv git-cleanup.sh scripts/maintenance/
+   mv git-filter-repo-cleanup.sh scripts/maintenance/
+   mv production-docker-cleanup.sh scripts/maintenance/
+   mv docker-cleanup.sh scripts/maintenance/
+   ```
+7. 移动工具脚本
+   ```bash
+   mv optimize-font.py scripts/tools/
+   mv analyze-test-coverage.ts scripts/tools/
+   mv capture-webhook.sh scripts/tools/
+   mv check-job-triggers.groovy scripts/tools/
+   mv check-woodpecker-logs.sh scripts/tools/
+   mv notify-wechat.sh scripts/tools/
+   mv set-woodpecker-trusted.sh scripts/tools/
+   mv setup-gitea-oauth2.sh scripts/tools/
+   mv setup-gitea-oauth2-auto.sh scripts/tools/
+   mv fix-service-restart.sh scripts/tools/
+   mv fix-jenkins-nginx.sh scripts/tools/
+   ```
+8. 更新 `package.json` 中的脚本路径引用
+9. 创建 `scripts/README.md` 说明脚本用途
+10. 运行测试验证路径正确
+
+---
+
+### 任务 2.2:Docker 文件整理
+
+**文件**: 
+- 创建: `docker/`, `docker/nginx/`
+- 移动: Docker 相关文件
+
+**职责**: 整理 Docker 配置文件
+
+**测试**: 
+1. 运行 `docker build -f docker/Dockerfile .` 验证构建成功
+2. 检查 CI/CD 配置文件中的 Docker 路径引用是否已更新
+
+**步骤**:
+1. 创建 `docker/` 目录
+   ```bash
+   mkdir -p docker/nginx
+   ```
+2. 移动 Dockerfile 文件
+   ```bash
+   mv Dockerfile docker/
+   mv Dockerfile.prod docker/
+   mv Dockerfile.tools docker/
+   ```
+3. 移动 docker-compose 文件
+   ```bash
+   mv docker-compose.yml docker/
+   mv docker-compose.prod.yml docker/
+   mv docker-compose.high-perf.yml docker/
+   mv docker-compose.server.yml docker/
+   ```
+4. 移动 nginx 配置
+   ```bash
+   mv nginx-woodpecker.conf docker/nginx/
+   mv nginx-woodpecker-fixed.conf docker/nginx/
+   ```
+5. 更新 CI/CD 配置中的 Docker 文件路径引用
+   - 检查 `.woodpecker-test.yml` 中的 Docker 路径
+   - 检查 `Jenkinsfile` 中的 Docker 路径
+   - 检查 `config/ci/*.yml` 中的 Docker 路径
+6. 运行 `docker build -f docker/Dockerfile .` 验证构建正常
+
+---
+
+### 任务 2.3:文档结构优化
+
+**文件**: 
+- 创建: `docs/archive/`, `docs/README.md`
+- 移动: 过时文档
+- 合并: 重复文档
+
+**职责**: 优化文档结构,建立索引
+
+**测试**: 
+1. 使用 `markdown-link-check` 工具验证所有 Markdown 文件中的链接
+2. 检查 `docs/README.md` 文档索引是否完整
+
+**步骤**:
+1. 创建 `docs/archive/` 目录
+   ```bash
+   mkdir -p docs/archive
+   ```
+2. 移动过时计划文档
+   ```bash
+   mv docs/plans/2026-03-*.md docs/archive/
+   ```
+3. 合并重复文档
+   - 合并 `docs/MONITORING_SETUP.md`, `docs/MONITORING_QUICKSTART.md`, `docs/MONITORING_LIGHTWEIGHT.md`, `docs/LIGHTWEIGHT_MONITORING.md` 为 `docs/guides/monitoring.md`
+   - 合并 `docs/PRODUCTION_DEPLOYMENT.md`, `docs/PRODUCTION_DEPLOYMENT_LIGHTWEIGHT.md` 为 `docs/deployment/production-deployment.md`
+4. 创建 `docs/README.md` 文档索引
+5. 验证所有文档链接有效
+
+---
+
+### 任务 2.4:配置文件统一管理
+
+**文件**: 检查 `config/` 目录
+
+**职责**: 确保配置文件集中管理
+
+**测试**: 
+1. 运行 `npm run build` 验证配置加载正确
+2. 检查 `config/` 目录结构是否完整
+
+**步骤**:
+1. 检查 `config/` 目录结构
+2. 确保所有配置文件都在 `config/` 目录下
+3. 验证配置文件加载正确
+
+---
+
+## 阶段三:代码质量深度优化（方案 B）
+
+**预估时间:** 1 天  
+**执行方式:** 人工处理 + 测试验证
+
+### 任务 3.1:创建统一日志工具
+
+**文件**: 
+- 创建: `src/lib/logger.ts`
+- 创建: `src/lib/logger.test.ts`
+
+**职责**: 提供统一的日志管理工具
+
+**测试**: `src/lib/logger.test.ts`
+
+**步骤**:
+1. 创建 `src/lib/logger.ts` 文件
+   ```typescript
+   type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+   class Logger {
+     private isDevelopment = process.env.NODE_ENV === 'development';
+     
+     debug(message: string, ...args: unknown[]) {
+       if (this.isDevelopment) {
+         console.debug(`[DEBUG] ${message}`, ...args);
+       }
+     }
+     
+     info(message: string, ...args: unknown[]) {
+       console.info(`[INFO] ${message}`, ...args);
+     }
+     
+     warn(message: string, ...args: unknown[]) {
+       console.warn(`[WARN] ${message}`, ...args);
+     }
+     
+     error(message: string, error?: Error, ...args: unknown[]) {
+       console.error(`[ERROR] ${message}`, error, ...args);
+     }
+   }
+
+   export const logger = new Logger();
+   ```
+2. 编写单元测试验证日志功能
+3. 运行测试确保通过
+
+---
+
+### 任务 3.2:console.log 清理
+
+**文件**: 修改所有包含 console.log 的生产代码文件
+
+**职责**: 清理 72 处 console.log,改用统一日志工具
+
+**测试**: 运行测试验证功能正常
+
+**步骤**:
+1. 扫描所有 console.log 出现的位置
+   ```bash
+   grep -r "console\.(log|debug|warn|error)" src/ --include="*.ts,*.tsx" --exclude="*.test.*"
+   ```
+2. 分类标记：
+   - 调试日志（删除）
+   - 错误日志（改用 logger.error）
+   - 信息日志（评估）
+3. 批量处理生产代码中的 console.log
+   - API 路由：改用 logger.error
+   - 页面组件：删除
+   - 客户端组件：删除
+   - 管理后台：改用 logger.info
+4. 保留测试文件和种子数据文件中的 console.log
+5. 运行测试验证功能正常
+
+---
+
+### 任务 3.3:TODO/FIXME 处理
+
+**文件**: 修改包含 TODO/FIXME 的文件
+
+**职责**: 处理 9 个 TODO/FIXME 注释
+
+**测试**: 运行测试验证功能正常
+
+**步骤**:
+1. 扫描所有 TODO/FIXME 出现的位置
+   ```bash
+   grep -r "TODO|FIXME|HACK|XXX" src/ --include="*.ts,*.tsx"
+   ```
+2. 评估每个 TODO/FIXME 的优先级
+3. 实现或修复相关功能
+4. 删除已处理的 TODO/FIXME 注释
+5. 运行测试验证功能正常
+
+---
+
+### 任务 3.4:代码逻辑优化
+
+**文件**: 优化代码结构和逻辑
+
+**职责**: 提升代码可读性和可维护性
+
+**测试**: 运行测试验证功能正常
+
+**步骤**:
+1. 识别需要优化的代码模块
+2. 重构代码结构
+3. 优化代码逻辑
+4. 运行测试验证功能正常
+
+---
+
+## 阶段四:依赖管理与测试（混合）
+
+**预估时间:** 1 天  
+**执行方式:** 自动化 + 人工评估 + 测试验证
+
+### 任务 4.1:依赖更新评估
+
+**文件**: `package.json`, `package-lock.json`
+
+**职责**: 评估并更新依赖包
+
+**测试**: 运行测试验证兼容性
+
+**步骤**:
+1. 运行 `npm outdated` 查看过时依赖
+2. 评估每个依赖的更新影响
+3. 更新 Patch 和 Minor 版本依赖
+   ```bash
+   npm update @playwright/test
+   npm update @sentry/nextjs
+   npm update @tiptap/extension-image @tiptap/extension-link @tiptap/pm @tiptap/react @tiptap/starter-kit
+   npm update drizzle-orm
+   npm update @typescript-eslint/eslint-plugin @typescript-eslint/parser
+   ```
+4. 运行测试验证兼容性
+
+---
+
+### 任务 4.2:API 路由测试补充
+
+**文件**: 创建测试文件
+
+**职责**: 补充 API 路由测试用例
+
+**测试**: 运行测试验证覆盖率提升
+
+**步骤**:
+1. 为 `src/app/api/admin/security/route.ts` 创建测试文件
+2. 为 `src/app/api/config/route.ts` 创建测试文件
+3. 为 `src/app/api/content/route.ts` 创建测试文件
+4. 为 `src/app/api/docs/route.ts` 创建测试文件
+5. 为 `src/app/api/v1/config/route.ts` 创建测试文件
+6. 编写关键路径测试用例
+7. 运行测试验证覆盖率提升
+
+---
+
+### 任务 4.3:管理后台测试补充
+
+**文件**: 创建/更新测试文件
+
+**职责**: 补充管理后台测试用例
+
+**测试**: 运行测试验证覆盖率提升
+
+**步骤**:
+1. 为 `src/app/admin/settings/page.tsx` 补充测试用例
+2. 为 `src/app/admin/users/page.tsx` 补充测试用例
+3. 为 `src/app/admin/content/[id]/page.tsx` 补充测试用例
+4. 编写用户交互测试用例
+5. 运行测试验证覆盖率提升
+
+---
+
+### 任务 4.4:页面组件测试补充
+
+**文件**: 创建测试文件
+
+**职责**: 补充页面组件测试用例
+
+**测试**: 运行测试验证覆盖率提升
+
+**步骤**:
+1. 为 `src/app/(marketing)/services/[id]/client.tsx` 创建测试文件
+2. 为 `src/app/(marketing)/solutions/page.tsx` 创建测试文件
+3. 为 `src/app/(marketing)/contact/actions.ts` 创建测试文件
+4. 编写用户交互测试用例
+5. 运行测试验证覆盖率提升
+
+---
+
+### 任务 4.5:性能优化
+
+**文件**: 
+- 修改: `next.config.ts`
+- 修改: `config/test/lighthouserc.json`
+
+**职责**: 优化构建和运行时性能
+
+**测试**: 运行 Lighthouse CI 验证性能指标
+
+**步骤**:
+1. 优化 `next.config.ts` 配置
+   ```typescript
+   const nextConfig = {
+     experimental: {
+       optimizePackageImports: ['lucide-react', 'framer-motion'],
+     },
+     images: {
+       formats: ['image/avif', 'image/webp'],
+       deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+       imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
+     },
+     compress: true,
+     poweredByHeader: false,
+     productionBrowserSourceMaps: false,
+   };
+   ```
+2. 配置 Lighthouse CI
+3. 运行 Lighthouse CI 验证性能指标
+
+---
+
+## 阶段五:文档与验收（方案 B）
+
+**预估时间:** 0.5 天  
+**执行方式:** 人工处理 + 自动化验证
+
+### 任务 5.1:README 更新
+
+**文件**: `README.md`
+
+**职责**: 更新项目主 README 文档
+
+**测试**: 验证文档内容准确
+
+**步骤**:
+1. 更新项目结构说明
+2. 更新技术栈版本信息
+3. 更新质量保障章节
+4. 更新文档导航链接
+5. 验证文档内容准确
+
+---
+
+### 任务 5.2:文档索引创建
+
+**文件**: `docs/README.md`
+
+**职责**: 创建文档中心索引
+
+**测试**: 验证文档链接有效
+
+**步骤**:
+1. 创建文档索引结构
+2. 添加快速导航链接
+3. 分类整理文档链接
+4. 验证所有链接有效
+
+---
+
+### 任务 5.3:全面回归测试
+
+**文件**: 运行所有测试
+
+**职责**: 确保所有功能正常
+
+**测试**: 运行完整测试套件
+
+**步骤**:
+1. 运行 `npm run lint` 验证代码质量
+2. 运行 `npm run type-check` 验证类型正确
+3. 运行 `npm run test:coverage` 验证测试覆盖率
+4. 运行 `npm run build` 验证构建成功
+5. 运行 `npm audit` 验证安全性
+6. 运行 `npm run test:e2e` 验证 E2E 测试
+
+---
+
+### 任务 5.4:验收报告生成
+
+**文件**: `docs/superpowers/reports/2026-04-12-project-reorganization-report.md`
+
+**职责**: 生成整理总结报告
+
+**测试**: 验证报告内容完整
+
+**步骤**:
+1. 收集测试覆盖率报告
+2. 收集 Lighthouse 报告
+3. 收集安全审计报告
+4. 生成整理总结报告
+5. 验证报告内容完整
+
+---
+
+## 验收标准
+
+### 代码质量
+- [ ] ESLint 错误: 0
+- [ ] TypeScript 错误: 0
+- [ ] console.log（生产代码）: 0
+- [ ] TODO/FIXME: 0
+
+### 测试覆盖率
+- [ ] Lines: ≥ 70%
+- [ ] Functions: ≥ 65%
+- [ ] Branches: ≥ 60%
+- [ ] Statements: ≥ 70%
+
+### 安全性
+- [ ] 高危漏洞: 0
+- [ ] 中危漏洞: 0
+- [ ] 低危漏洞: ≤ 2
+
+### 性能
+- [ ] Lighthouse 性能评分: ≥ 90
+- [ ] Lighthouse 可访问性评分: ≥ 95
+- [ ] Lighthouse 最佳实践评分: ≥ 95
+- [ ] Lighthouse SEO 评分: ≥ 95
+
+### 项目结构
+- [ ] 根目录脚本文件: ≤ 5
+- [ ] 文档索引已建立
+- [ ] 配置文件集中管理
+
+---
+
+## 风险应对
+
+### 风险 1:文件迁移导致引用路径错误
+- **应对**: 逐个验证引用路径，运行测试
+- **回滚**: Git 分支策略，每个阶段完成后提交
+
+### 风险 2:代码清理导致功能异常
+- **应对**: 边改边测，保留回滚点
+- **回滚**: 分阶段提交，便于回滚
+
+### 风险 3:依赖更新导致兼容性问题
+- **应对**: 逐个更新，充分测试
+- **回滚**: 保留 package-lock.json 备份
+
+### 风险 4:测试失败
+- **应对**: 修复代码或调整测试
+- **回滚**: 单独的测试分支
+
+---
+
+## 执行检查点
+
+### 检查点 1:阶段一完成后
+- 运行 `npm run lint` 无错误
+- 运行 `npm audit` 漏洞已修复
+- 运行 `npm test` 测试通过
+
+### 检查点 2:阶段二完成后
+- 验证所有脚本路径正确
+- 验证 Docker 构建正常
+- 验证文档链接有效
+
+### 检查点 3:阶段三完成后
+- 验证 console.log 已清理
+- 验证 TODO/FIXME 已处理
+- 运行测试功能正常
+
+### 检查点 4:阶段四完成后
+- 验证测试覆盖率达标
+- 验证性能指标达标
+- 验证依赖更新正常
+
+### 检查点 5:阶段五完成后
+- 验证文档更新完整
+- 运行完整测试套件通过
+- 验收报告已生成
+
+---
+
+## 后续建议
+
+### 短期（1-2 周）
+1. 监控整理后的项目运行状态
+2. 收集团队反馈，优化工作流程
+3. 补充遗漏的测试用例
+4. 完善文档细节
+
+### 中期（1-3 月）
+1. 评估 Major 版本依赖更新的可行性
+2. 引入更严格的代码质量门禁
+3. 优化 CI/CD 流程
+4. 提升测试覆盖率至 80%+
+
+### 长期（3-6 月）
+1. 建立持续的技术债务管理机制
+2. 定期进行代码审查和重构
+3. 引入更多自动化工具
+4. 建立知识库和最佳实践文档
diff --git a/docs/allure-report-guide.md b/docs/testing/allure-report-guide.md
similarity index 100%
rename from docs/allure-report-guide.md
rename to docs/testing/allure-report-guide.md
diff --git a/docs/lighthouse-ci-guide.md b/docs/testing/lighthouse-ci-guide.md
similarity index 100%
rename from docs/lighthouse-ci-guide.md
rename to docs/testing/lighthouse-ci-guide.md
diff --git a/docs/test-coverage-improvement-plan.md b/docs/testing/test-coverage-improvement-plan.md
similarity index 100%
rename from docs/test-coverage-improvement-plan.md
rename to docs/testing/test-coverage-improvement-plan.md
diff --git a/docs/test-optimization-guide.md b/docs/testing/test-optimization-guide.md
similarity index 100%
rename from docs/test-optimization-guide.md
rename to docs/testing/test-optimization-guide.md
diff --git a/docs/test-tiering-best-practices.md b/docs/testing/test-tiering-best-practices.md
similarity index 100%
rename from docs/test-tiering-best-practices.md
rename to docs/testing/test-tiering-best-practices.md
diff --git a/docs/testing-guide.md b/docs/testing/testing-guide.md
similarity index 100%
rename from docs/testing-guide.md
rename to docs/testing/testing-guide.md
diff --git a/docs/testing.md b/docs/testing/testing.md
similarity index 100%
rename from docs/testing.md
rename to docs/testing/testing.md
diff --git a/docs/HMR-ERROR-SOLUTIONS.md b/docs/troubleshooting/HMR-ERROR-SOLUTIONS.md
similarity index 100%
rename from docs/HMR-ERROR-SOLUTIONS.md
rename to docs/troubleshooting/HMR-ERROR-SOLUTIONS.md