📝 docs(architecture): update project documentation and configuration

- 修改本地开发环境端口从3000统一为8080，确保内外网访问一致性
- 更新技术栈信息，添加Redis 7.0.4和MinIO存储服务配置
- 完善环境变量配置，增加MinIO和Redis连接参数
- 更新文档最后更新日期和下次评审日期为2025-09-24和2025-12-24
- 修正数据库类型说明，明确为MySQL 8.0.36
- 更新测试命令文档，将npm替换为pnpm包管理器
- 细化项目状态描述，明确为生产就绪的管理后台启动模板

docs/architecture.md

@@ -520,7 +520,7 @@ info:
   version: 1.0.0
   description: D8D Starter项目RESTful API文档
 servers:
-  - url: http://localhost:3000/api/v1
+  - url: http://localhost:8080/api/v1
     description: 本地开发环境
   - url: https://api.example.com/api/v1
     description: 生产环境

docs/architecture/api-design-integration.md

@@ -19,7 +19,7 @@ info:
   version: 1.0.0
   description: D8D Starter项目RESTful API文档
 servers:
-  - url: http://localhost:3000/api/v1
+  - url: http://localhost:8080/api/v1
     description: 本地开发环境
   - url: https://api.example.com/api/v1
     description: 生产环境

docs/architecture/appendix.md

@@ -22,9 +22,9 @@
 
 ## 联系方式
 - 架构师: Winston 🏗️
-- 最后更新: 2025-09-20
+- 最后更新: 2025-09-24
 
 ---
 
 **文档状态**: 正式版
-**下次评审**: 2025-12-20
+**下次评审**: 2025-12-24

docs/architecture/development-workflow.md

@@ -43,9 +43,9 @@ pnpm db:reset                  # 重置数据库
 ## 环境配置
 ```bash
 # 前端环境变量 (Vite)
-VITE_API_BASE_URL=http://localhost:3000/api
+VITE_API_BASE_URL=http://localhost:8080/api
 
-# 后端环境变量
+# 后端环境变量 (多八多云端开发容器环境)
 DB_HOST=localhost
 DB_PORT=3306
 DB_DATABASE=d8dai
@@ -53,4 +53,16 @@ DB_USERNAME=root
 DB_PASSWORD=
 JWT_SECRET=your-jwt-secret-key
 NODE_ENV=development
+
+# MinIO配置
+MINIO_HOST=localhost
+MINIO_PORT=9000
+MINIO_ACCESS_KEY=minioadmin
+MINIO_SECRET_KEY=minioadmin
+MINIO_BUCKET_NAME=d8dai
+MINIO_USE_SSL=false
+
+# Redis配置
+REDIS_HOST=localhost
+REDIS_PORT=6379
 ```

docs/architecture/existing-project-analysis.md

@@ -7,28 +7,30 @@
 | 2.5 | 2025-09-24 | 更新技术栈信息，修正数据库类型 | Winston |
 
 ## 当前项目状态
-- **主要用途**: 现代化的全栈Web应用启动模板，专注于开发者体验
-- **技术栈总结**: Node.js 20.19.2 + Hono 4.8.5 + React 19.1.0 + TypeORM 0.3.25 + MySQL 8.0.36
-- **架构风格**: 分层架构，前后端分离但统一仓库管理
-- **部署方式**: Docker Compose本地开发，Node.js生产部署
+- **主要用途**: 生产就绪的现代化全栈管理后台启动模板，AI驱动开发的首选起点
+- **技术栈总结**: Node.js 20.19.2 + Hono 4.8.5 + React 19.1.0 + TypeORM 0.3.25 + MySQL 8.0.36 + Redis 7.0.4 + MinIO
+- **架构风格**: 分层架构，前后端分离但统一仓库管理，模块化业务组织
+- **部署方式**: Docker Compose本地开发，多八多云端开发容器环境
 
 ## 可用文档分析
 ✅ **技术文档完整**:
-- 技术栈和版本信息准确 (Node.js 20.19.2 + MySQL 8.0.36)
-- 源码结构和模块组织清晰
-- 数据模型定义完整
-- API规范通过OpenAPI自动生成
-- 测试基础设施完整 (Vitest + Playwright)
+- 技术栈和版本信息准确 (Node.js 20.19.2 + MySQL 8.0.36 + Redis 7.0.4)
+- 源码结构和模块组织清晰 (10个业务模块，完整的API路由体系)
+- 数据模型定义完整 (用户、文件、支付、会员、模板、解决方案等实体)
+- API规范通过OpenAPI自动生成 (@hono/zod-openapi集成)
+- 测试基础设施完整 (Vitest + Testing Library + Playwright E2E测试)
+- 部署配置完整 (Docker Compose + 多八多云端开发容器环境)
 
 ✅ **项目状态**: 生产就绪
-- 所有核心功能已验证稳定
-- AI代理集成工作正常
-- 开发环境配置完整
-- 文档和规范齐全
+- 所有核心功能已验证稳定 (用户管理、文件系统、支付、模板等)
+- AI代理集成工作正常 (BMAD方法论完整集成)
+- 开发环境配置完整 (端口8080外网访问，默认数据库d8dai)
+- 文档和规范齐全 (CLAUDE.md + .roo/rules/开发规范)
 
 ## 识别出的约束
-- 必须保持与现有shadcn设计系统的兼容性
-- 需要支持MySQL 8.0.36关系型数据库
-- 前端构建基于Vite，后端基于Hono
-- 部署环境支持Docker容器化
-- 现有代码中存在一些`any`类型需要修复
+- 必须保持与现有shadcn设计系统的兼容性 (基于Radix UI的组件库)
+- 需要支持MySQL 8.0.36关系型数据库 (默认数据库d8dai)
+- 前端构建基于Vite 7.0.0，后端基于Hono 4.8.5
+- 部署环境支持Docker容器化 (多八多云端开发容器环境)
+- 端口8080为开发和生产的统一访问端口
+- 环境变量配置统一 (数据库、Redis、MinIO使用默认参数)

docs/architecture/introduction.md

@@ -16,3 +16,4 @@
 | 2025-09-19 | 2.2 | 更新测试策略文档引用 | Winston |
 | 2025-09-20 | 2.3 | 根据实际项目结构更新测试架构和共享目录 | Winston |
 | 2025-09-20 | 2.4 | 完善BMAD全栈架构规范，添加高层架构图、API规范、安全架构 | Winston |
+| 2025-09-24 | 2.5 | 根据项目实际情况更新技术栈信息，修正数据库类型为MySQL | Winston |

docs/architecture/testing-strategy.md

@@ -143,22 +143,22 @@ const inactiveUser = createTestUser({ active: false });
 ### 本地开发测试
 ```bash
 # 运行所有测试
-npm test
+pnpm test
 
 # 运行API测试
-npm run test:api
+pnpm test:api
 
 # 运行组件测试
-npm run test:components
+pnpm test:components
 
 # 运行集成测试
-npm run test:integration
+pnpm test:integration
 
 # 运行E2E测试
-npm run test:e2e:chromium
+pnpm test:e2e:chromium
 
 # 生成覆盖率报告
-npm run test:coverage
+pnpm test:coverage
 ```
 
 ### CI/CD流水线测试
@@ -272,9 +272,9 @@ describe('UserService', () => {
 - [API设计规范](./api-design-integration.md)
 
 ### 工具版本
-- **Vitest**: 3.2.4
-- **Testing Library**: 16.3.0
-- **Playwright**: 1.55.0
+- **Vitest**: 2.x (项目实际版本)
+- **Testing Library**: 13.x (项目实际版本)
+- **Playwright**: 最新版本 (项目实际版本)
 - **hono/testing**: 内置（Hono 4.8.5）
 
 ### 更新日志

docs/architecture/version-info.md

@@ -6,3 +6,4 @@
 | 2.2 | 2025-09-19 | 更新测试策略文档引用 | Winston |
 | 2.3 | 2025-09-20 | 根据实际项目结构更新测试架构和共享目录 | Winston |
 | 2.4 | 2025-09-20 | 完善BMAD全栈架构规范，添加高层架构图、API规范、安全架构 | Winston |
+| 2.5 | 2025-09-24 | 根据项目实际情况更新技术栈信息，修正数据库类型为MySQL | Winston |