docs: 架构设计文档和Agents.md增加前端部署路径设计

1. 架构设计文档 v1.6 -> v1.7
   新增 6.1 前端部署路径设计章节：
   - 6.1.1 部署路径规划表
   - 6.1.2 Nginx配置示例
   - 6.1.3 前端构建配置（VITE_BASE等）
   - 6.1.4 API请求路径规范
   - 原有章节编号顺延（6.1->6.3, 6.2->6.4）

2. Agents.md v1.1 -> v1.2
   15.2 访问地址 改为 15.2 前端部署路径：
   - 新增前端部署路径规划表
   - 补充移动端H5开发环境访问地址

Agents.md

@@ -1,8 +1,8 @@
 # 资金服务平台 (FundPlatform) - 开发规范
 
-> **文档版本**: v1.1  
+> **文档版本**: v1.2  
 > **创建日期**: 2026-02-20  
-> **更新日期**: 2026-02-13  
+> **更新日期**: 2026-02-23  
 > **适用范围**: 本项目所有开发人员
 
 ---
@@ -911,11 +911,22 @@ public class TokenAuthFilter implements GlobalFilter {
 | `TENANT_ID` | 租户标识 | 空值=共享实例，有值=VIP实例 |
 | `SERVER_PORT` | 服务端口 | 可选，覆盖application.yml |
 
-### 15.2 访问地址
+### 15.2 前端部署路径
+
+前端项目采用 **Nginx 子路径部署** 模式：
+
+| 前端项目 | 部署路径 | 访问地址 | 说明 |
+|----------|----------|----------|------|
+| fund-admin | `/fadmin/` | `http://host/fadmin/` | 管理后台 |
+| fund-mobile | `/fmobile/` | `http://host/fmobile/` | 移动端H5 |
+| API网关 | `/fund/` | `http://host/fund/` | 后端API统一前缀 |
+
+**开发环境访问地址**：
 
 | 服务 | 地址 |
 |------|------|
 | 管理后台 | http://localhost:3000 |
+| 移动端H5 | http://localhost:8080 |
 | API网关 | http://localhost:8000 |
 | Nacos控制台 | http://localhost:8048/nacos |
 

doc/资金服务平台 FundPlatform 架构设计文档.md

@@ -1,8 +1,8 @@
 # 资金服务平台 (FundPlatform) - 架构设计文档
 
-> **文档版本**: v1.6  
+> **文档版本**: v1.7  
 > **创建日期**: 2026-02-13  
-> **更新日期**: 2026-02-13  
+> **更新日期**: 2026-02-23  
 > **项目名称**: 资金服务平台  
 > **项目代号**: fundplatform
 
@@ -3460,7 +3460,98 @@ public class UserController {
 
 ## 六、部署架构
 
-### 6.1 生产环境部署
+### 6.1 前端部署路径设计
+
+前端项目采用 **Nginx 子路径部署** 模式，通过统一的 Nginx 入口提供静态资源服务。
+
+#### 6.1.1 部署路径规划
+
+| 前端项目 | 部署路径 | 访问地址 | 说明 |
+|----------|----------|----------|------|
+| fund-admin | `/fadmin/` | `http://host/fadmin/` | 管理后台 |
+| fund-mobile | `/fmobile/` | `http://host/fmobile/` | 移动端H5 |
+| API网关 | `/fund/` | `http://host/fund/` | 后端API统一前缀 |
+
+#### 6.1.2 Nginx 配置示例
+
+```nginx
+server {
+    listen 80;
+    server_name localhost;
+    
+    # 管理后台前端 (部署路径: /fadmin/)
+    location /fadmin/ {
+        alias /opt/fundplatform/web/admin/;
+        try_files $uri $uri/ /fadmin/index.html;
+    }
+    
+    # 移动端H5 (部署路径: /fmobile/)
+    location /fmobile/ {
+        alias /opt/fundplatform/web/mobile/;
+        try_files $uri $uri/ /fmobile/index.html;
+    }
+    
+    # API代理 (网关前缀: /fund)
+    location /fund/ {
+        proxy_pass http://127.0.0.1:8000/;
+        proxy_set_header Host $host;
+        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;
+    }
+}
+```
+
+#### 6.1.3 前端构建配置
+
+前端项目需配置 `VITE_BASE` 环境变量以支持子路径部署：
+
+**fund-admin/.env.production**:
+```properties
+VITE_BASE=/fadmin/
+VITE_API_BASE_URL=/fund
+```
+
+**fund-mobile/.env.production**:
+```properties
+VITE_BASE=/fmobile/
+VITE_API_BASE_URL=/fund
+```
+
+**vite.config.ts** 配置动态 base 路径：
+```typescript
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd())
+  const base = env.VITE_BASE || '/'
+  return {
+    base,
+    // ...其他配置
+  }
+})
+```
+
+**Vue Router** 配置动态 base 路径：
+```typescript
+const router = createRouter({
+  history: createWebHistory(import.meta.env.BASE_URL),
+  routes
+})
+```
+
+#### 6.1.4 API请求路径规范
+
+前端所有API请求统一使用网关前缀 `/fund`，由Gateway转发到后端服务：
+
+```
+前端请求                          Gateway转发                    后端服务
+/fund/auth/login        ->       /api/v1/auth/login      ->    fund-sys
+/fund/customer/page     ->       /api/v1/customer/page   ->    fund-cust
+/fund/project/page      ->       /api/v1/project/page    ->    fund-proj
+/fund/exp/expense       ->       /api/v1/exp/expense     ->    fund-exp
+/fund/receipt/receivable ->      /api/v1/receipt/receivable -> fund-receipt
+```
+
+### 6.3 生产环境部署
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
@@ -3511,9 +3602,9 @@ public class UserController {
 └─────────────────────────────────────────────────────────────────┘
 ```
 
-### 6.2 容器化部署
+### 6.4 容器化部署
 
-#### 6.2.1 Docker Compose 配置
+#### 6.4.1 Docker Compose 配置
 
 ```yaml
 version: '3.8'
@@ -3978,6 +4069,7 @@ public class GlobalExceptionHandler {
 | v1.4 | 2026-02-13 | 补充统一全局上下文 GlobalContext，统筹 tid/uid/uname 获取和异步传递 | zhangjf |
 | v1.5 | 2026-02-13 | 补充模块通信与 OpenFeign 参数对象管理策略、分层架构职责说明、MyBatis-Plus 使用规范、Controller 与参数校验规范、事务与测试规范及开发规则总览 | zhangjf |
 | v1.6 | 2026-02-13 | 补充单机部署配置：配置文件分离架构（env.properties+service.properties）、打包目录结构、多租户部署配置、日志配置集中化、脚本加载逻辑 | zhangjf |
+| v1.7 | 2026-02-23 | 新增6.1前端部署路径设计：Nginx子路径部署、部署路径规划、Nginx配置示例、前端构建配置、API请求路径规范 | zhangjf |
 
 ---