From ded7ea12288ebbbe73e8ed42a9ca51751a9f50d9 Mon Sep 17 00:00:00 2001
From: Karlcarlo <karlcarlo@163.com>
Date: Thu, 21 May 2026 20:56:22 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E5=8F=AF=E9=85=8D?=
 =?UTF-8?q?=E7=BD=AE=E7=9A=84=E8=B7=AF=E5=BE=84=E5=89=8D=E7=BC=80=E4=BB=A5?=
 =?UTF-8?q?=E6=94=AF=E6=8C=81=E5=AD=90=E8=B7=AF=E5=BE=84=E9=83=A8=E7=BD=B2?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

添加前后端环境变量配置示例，新增后端路径前缀配置项，更新后端路由与静态文件挂载逻辑，调整前端代理配置与 API 调用代码，适配子路径部署场景。
---
 backend/.env.example             | 30 ++++++++-----
 backend/app/config.py            |  4 ++
 backend/app/main.py              | 30 ++++++++-----
 backend/app/static/index.html    |  4 +-
 frontend/.env.example            |  3 ++
 frontend/package.json            |  1 +
 frontend/src/app/services/api.ts | 74 +++++++++++++++++++-------------
 frontend/vite.config.ts          | 68 ++++++++++++++++-------------
 8 files changed, 130 insertions(+), 84 deletions(-)
 create mode 100644 frontend/.env.example

diff --git a/backend/.env.example b/backend/.env.example
index 3827963..c013366 100644
--- a/backend/.env.example
+++ b/backend/.env.example
@@ -1,29 +1,37 @@
-# MongoDB
-MONGODB_URL=mongodb://localhost:27017
-MONGODB_DB_NAME=pregnancy_report
+# Path Prefix
+API_PREFIX=/app_03/api
+UPLOADS_PREFIX=/uploads
+
+# MongoDB (通过 SSH 隧道连接到服务器)
+# MONGODB_URL=mongodb+srv://shutiaozhao127_db_user:YEJzZUi0nbEuFYL3@cluster0.bkztgqx.mongodb.net/?appName=Cluster0
+# MONGODB_DB_NAME=pregnancy_report
+MONGODB_URL=mongodb://root:mgdb4link@localhost:27017/?authSource=admin
+MONGODB_DB_NAME=app_03_dev
 
 # JWT
-JWT_SECRET_KEY=your-secret-key-change-this
+JWT_SECRET_KEY=pregnancy_ai_demo_666888
 JWT_ALGORITHM=HS256
 JWT_EXPIRE_MINUTES=10080
 
 # WeChat Mini Program
-WECHAT_APP_ID=your-wechat-app-id
-WECHAT_APP_SECRET=your-wechat-app-secret
+WECHAT_APP_ID=
+WECHAT_APP_SECRET=
 
-# Claude AI
-ANTHROPIC_API_KEY=your-anthropic-api-key
-ANTHROPIC_BASE_URL=
-AI_MODEL_NAME=claude-sonnet-4-20250514
+# AI API (硅基流动 - OpenAI 兼容接口)
+AI_API_KEY=sk-pnbkufcvwbnmzcwdhwzecdgpiqqsumtsnfojtozmmrfqiuil
+AI_BASE_URL=https://api.siliconflow.cn/v1
+AI_VISION_MODEL=Qwen/Qwen2.5-VL-72B-Instruct
+AI_TEXT_MODEL=Qwen/Qwen3-235B-A22B-Instruct-2507
 
 # CORS（多个域名逗号分隔，* 表示允许所有）
 CORS_ORIGINS=*
 
+
 # File Upload
 UPLOAD_DIR=./uploads
 MAX_FILE_SIZE=10485760
 
 # Server
 HOST=0.0.0.0
-PORT=8000
+PORT=8030
 DEBUG=true
diff --git a/backend/app/config.py b/backend/app/config.py
index 5a84d39..8626fea 100644
--- a/backend/app/config.py
+++ b/backend/app/config.py
@@ -2,6 +2,10 @@ from pydantic_settings import BaseSettings
 
 
 class Settings(BaseSettings):
+    # Path Prefix
+    api_prefix: str = "/api"
+    uploads_prefix: str = "/uploads"
+
     # MongoDB
     mongodb_url: str = "mongodb://localhost:27017"
     mongodb_db_name: str = "pregnancy_report"
diff --git a/backend/app/main.py b/backend/app/main.py
index b60d3c6..221cb06 100644
--- a/backend/app/main.py
+++ b/backend/app/main.py
@@ -48,6 +48,14 @@ app = FastAPI(
     lifespan=lifespan,
 )
 
+api_prefix = settings.api_prefix.rstrip("/") or ""
+if api_prefix and not api_prefix.startswith("/"):
+    api_prefix = f"/{api_prefix}"
+
+uploads_prefix = settings.uploads_prefix.rstrip("/") or ""
+if uploads_prefix and not uploads_prefix.startswith("/"):
+    uploads_prefix = f"/{uploads_prefix}"
+
 # CORS 配置
 cors_origins = (
     ["*"]
@@ -88,20 +96,20 @@ async def global_exception_handler(request: Request, exc: Exception):
         content={"detail": "服务器内部错误，请稍后重试"},
     )
 
-app.mount("/uploads", StaticFiles(directory=settings.upload_dir), name="uploads")
+app.mount(uploads_prefix or "/uploads", StaticFiles(directory=settings.upload_dir), name="uploads")
 
-app.include_router(auth.router, prefix="/api/auth", tags=["认证"])
-app.include_router(user.router, prefix="/api/user", tags=["用户"])
-app.include_router(report.router, prefix="/api/report", tags=["报告"])
-app.include_router(analysis.router, prefix="/api/analysis", tags=["AI解读"])
-app.include_router(chat.router, prefix="/api/chat", tags=["AI对话"])
-app.include_router(health_records.router, prefix="/api/health-records", tags=["健康档案"])
-app.include_router(calendar.router, prefix="/api/calendar", tags=["产检日历"])
-app.include_router(doctor.router, prefix="/api/doctor", tags=["专家咨询"])
-app.include_router(share.router, prefix="/api/share", tags=["分享"])
+app.include_router(auth.router, prefix=f"{api_prefix}/auth", tags=["认证"])
+app.include_router(user.router, prefix=f"{api_prefix}/user", tags=["用户"])
+app.include_router(report.router, prefix=f"{api_prefix}/report", tags=["报告"])
+app.include_router(analysis.router, prefix=f"{api_prefix}/analysis", tags=["AI解读"])
+app.include_router(chat.router, prefix=f"{api_prefix}/chat", tags=["AI对话"])
+app.include_router(health_records.router, prefix=f"{api_prefix}/health-records", tags=["健康档案"])
+app.include_router(calendar.router, prefix=f"{api_prefix}/calendar", tags=["产检日历"])
+app.include_router(doctor.router, prefix=f"{api_prefix}/doctor", tags=["专家咨询"])
+app.include_router(share.router, prefix=f"{api_prefix}/share", tags=["分享"])
 
 
-@app.get("/api/health")
+@app.get(f"{api_prefix}/health")
 async def health_check():
     return {"status": "ok", "service": "孕育无忧 API"}
 
diff --git a/backend/app/static/index.html b/backend/app/static/index.html
index 59d4eda..cd4f6be 100644
--- a/backend/app/static/index.html
+++ b/backend/app/static/index.html
@@ -225,6 +225,7 @@ textarea{width:100%;padding:10px;border:1px solid #ddd;border-radius:8px;font-si
 
 <script>
 const API = '';
+const API_PREFIX = window.location.pathname.startsWith('/app_03') ? '/app_03/api' : '/api';
 let TOKEN = '';
 let currentReportId = '';
 let ocrDataItems = [];
@@ -237,6 +238,7 @@ function showLoading(text='加载中...'){
 function hideLoading(){document.getElementById('globalLoading').style.display='none'}
 
 async function api(path,opts={}){
+  if(path.startsWith('/api/')) path = API_PREFIX + path.slice(4);
   const headers = {'Authorization':'Bearer '+TOKEN, ...(opts.headers||{})};
   if(opts.body && !(opts.body instanceof FormData)){
     headers['Content-Type']='application/json';
@@ -270,7 +272,7 @@ function badgeHtml(status){
 async function demoLogin(){
   showLoading('正在登录...');
   try{
-    const data = await fetch(API+'/api/auth/demo-login',{method:'POST'}).then(r=>r.json());
+    const data = await api('/api/auth/demo-login',{method:'POST'});
     TOKEN = data.access_token;
     hideLoading();
   }catch(e){
diff --git a/frontend/.env.example b/frontend/.env.example
new file mode 100644
index 0000000..1eb9564
--- /dev/null
+++ b/frontend/.env.example
@@ -0,0 +1,3 @@
+VITE_API_PREFIX=/app_03/api
+VITE_UPLOADS_PREFIX=/uploads
+
diff --git a/frontend/package.json b/frontend/package.json
index c0274d2..3ce98e9 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -65,6 +65,7 @@
     "vaul": "1.1.2"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "@tailwindcss/vite": "4.1.12",
     "@vitejs/plugin-basic-ssl": "^2.2.0",
     "@vitejs/plugin-react": "4.7.0",
diff --git a/frontend/src/app/services/api.ts b/frontend/src/app/services/api.ts
index 9627390..3df9a7e 100644
--- a/frontend/src/app/services/api.ts
+++ b/frontend/src/app/services/api.ts
@@ -1,5 +1,19 @@
 const TOKEN_KEY = "auth_token";
 
+const env = (import.meta as any).env || {};
+const API_PREFIX: string = (env.VITE_API_PREFIX as string) || "/api";
+const APP_BASE_URL: string = (env.BASE_URL as string) || "/";
+
+function joinPrefix(prefix: string, path: string) {
+  const p = prefix.endsWith("/") ? prefix.slice(0, -1) : prefix;
+  const s = path.startsWith("/") ? path : `/${path}`;
+  return `${p}${s}`;
+}
+
+function apiPath(path: string) {
+  return joinPrefix(API_PREFIX, path);
+}
+
 export function getToken(): string | null {
   return localStorage.getItem(TOKEN_KEY);
 }
@@ -22,11 +36,11 @@ async function fetchApi<T>(path: string, options: RequestInit = {}): Promise<T>
     headers["Authorization"] = `Bearer ${token}`;
   }
 
-  const res = await fetch(path, { ...options, headers });
+  const res = await fetch(apiPath(path), { ...options, headers });
 
   if (res.status === 401) {
     clearToken();
-    window.location.href = "/";
+    window.location.href = APP_BASE_URL;
     throw new Error("登录已过期，请重新登录");
   }
 
@@ -48,21 +62,21 @@ interface LoginResponse {
 }
 
 export async function loginByPhone(phone: string, smsCode: string): Promise<LoginResponse> {
-  return fetchApi<LoginResponse>("/api/auth/phone-login", {
+  return fetchApi<LoginResponse>("/auth/phone-login", {
     method: "POST",
     body: JSON.stringify({ phone, sms_code: smsCode }),
   });
 }
 
 export async function loginByWechat(code: string): Promise<LoginResponse> {
-  return fetchApi<LoginResponse>("/api/auth/wechat-login", {
+  return fetchApi<LoginResponse>("/auth/wechat-login", {
     method: "POST",
     body: JSON.stringify({ code }),
   });
 }
 
 export async function loginByDemo(): Promise<LoginResponse> {
-  return fetchApi<LoginResponse>("/api/auth/demo-login", {
+  return fetchApi<LoginResponse>("/auth/demo-login", {
     method: "POST",
   });
 }
@@ -91,7 +105,7 @@ export interface UserProfileDTO {
 }
 
 export async function getUserProfile(): Promise<UserProfileDTO> {
-  return fetchApi<UserProfileDTO>("/api/user/profile");
+  return fetchApi<UserProfileDTO>("/user/profile");
 }
 
 export interface OnboardingData {
@@ -109,14 +123,14 @@ export interface OnboardingData {
 }
 
 export async function submitOnboarding(data: OnboardingData): Promise<UserProfileDTO> {
-  return fetchApi<UserProfileDTO>("/api/user/onboarding", {
+  return fetchApi<UserProfileDTO>("/user/onboarding", {
     method: "POST",
     body: JSON.stringify(data),
   });
 }
 
 export async function updateUserProfile(data: Record<string, unknown>): Promise<UserProfileDTO> {
-  return fetchApi<UserProfileDTO>("/api/user/profile", {
+  return fetchApi<UserProfileDTO>("/user/profile", {
     method: "PUT",
     body: JSON.stringify(data),
   });
@@ -151,7 +165,7 @@ export async function uploadReportImage(file: File): Promise<UploadReportRespons
   const headers: Record<string, string> = {};
   if (token) headers["Authorization"] = `Bearer ${token}`;
 
-  const res = await fetch("/api/report/upload", {
+  const res = await fetch(apiPath("/report/upload"), {
     method: "POST",
     headers,
     body: formData,
@@ -159,7 +173,7 @@ export async function uploadReportImage(file: File): Promise<UploadReportRespons
 
   if (res.status === 401) {
     clearToken();
-    window.location.href = "/";
+    window.location.href = APP_BASE_URL;
     throw new Error("登录已过期，请重新登录");
   }
   if (!res.ok) {
@@ -189,7 +203,7 @@ export async function addImageToReport(reportId: string, file: File): Promise<Ad
   const headers: Record<string, string> = {};
   if (token) headers["Authorization"] = `Bearer ${token}`;
 
-  const res = await fetch(`/api/report/${reportId}/add-image`, {
+  const res = await fetch(apiPath(`/report/${reportId}/add-image`), {
     method: "POST",
     headers,
     body: formData,
@@ -197,7 +211,7 @@ export async function addImageToReport(reportId: string, file: File): Promise<Ad
 
   if (res.status === 401) {
     clearToken();
-    window.location.href = "/";
+    window.location.href = APP_BASE_URL;
     throw new Error("登录已过期，请重新登录");
   }
   if (!res.ok) {
@@ -237,7 +251,7 @@ export interface ReportResponse {
 }
 
 export async function verifyReport(reportId: string, data: ReportVerifyRequest): Promise<ReportResponse> {
-  return fetchApi<ReportResponse>(`/api/report/${reportId}/verify`, {
+  return fetchApi<ReportResponse>(`/report/${reportId}/verify`, {
     method: "PUT",
     body: JSON.stringify(data),
   });
@@ -254,11 +268,11 @@ export interface ReportListItem {
 }
 
 export async function getReportList(limit = 50): Promise<ReportListItem[]> {
-  return fetchApi<ReportListItem[]>(`/api/report/list?limit=${limit}`);
+  return fetchApi<ReportListItem[]>(`/report/list?limit=${limit}`);
 }
 
 export async function getReport(reportId: string): Promise<ReportResponse> {
-  return fetchApi<ReportResponse>(`/api/report/${reportId}`);
+  return fetchApi<ReportResponse>(`/report/${reportId}`);
 }
 
 // ─── Analysis ───
@@ -297,13 +311,13 @@ export interface AnalysisResponse {
 }
 
 export async function generateAnalysis(reportId: string): Promise<AnalysisResponse> {
-  return fetchApi<AnalysisResponse>(`/api/analysis/${reportId}/generate`, {
+  return fetchApi<AnalysisResponse>(`/analysis/${reportId}/generate`, {
     method: "POST",
   });
 }
 
 export async function getAnalysis(reportId: string): Promise<AnalysisResponse> {
-  return fetchApi<AnalysisResponse>(`/api/analysis/${reportId}`);
+  return fetchApi<AnalysisResponse>(`/analysis/${reportId}`);
 }
 
 // ─── Chat ───
@@ -319,14 +333,14 @@ export interface ChatHistoryResponse {
 }
 
 export async function sendChatMessage(reportId: string, content: string): Promise<ChatMessageResponse> {
-  return fetchApi<ChatMessageResponse>(`/api/chat/${reportId}/message`, {
+  return fetchApi<ChatMessageResponse>(`/chat/${reportId}/message`, {
     method: "POST",
     body: JSON.stringify({ content }),
   });
 }
 
 export async function getChatHistory(reportId: string): Promise<ChatHistoryResponse> {
-  return fetchApi<ChatHistoryResponse>(`/api/chat/${reportId}/history`);
+  return fetchApi<ChatHistoryResponse>(`/chat/${reportId}/history`);
 }
 
 // ─── Health Records ───
@@ -337,7 +351,7 @@ export interface HealthOverviewResponse {
 }
 
 export async function getHealthOverview(): Promise<HealthOverviewResponse> {
-  return fetchApi<HealthOverviewResponse>("/api/health-records/overview");
+  return fetchApi<HealthOverviewResponse>("/health-records/overview");
 }
 
 export interface GrowthCurveResponse {
@@ -345,7 +359,7 @@ export interface GrowthCurveResponse {
 }
 
 export async function getGrowthCurve(): Promise<GrowthCurveResponse> {
-  return fetchApi<GrowthCurveResponse>("/api/health-records/growth-curve");
+  return fetchApi<GrowthCurveResponse>("/health-records/growth-curve");
 }
 
 export interface TimelineResponse {
@@ -361,7 +375,7 @@ export interface TimelineResponse {
 }
 
 export async function getTimeline(): Promise<TimelineResponse> {
-  return fetchApi<TimelineResponse>("/api/health-records/timeline");
+  return fetchApi<TimelineResponse>("/health-records/timeline");
 }
 
 export interface IndicatorTrendPoint {
@@ -385,7 +399,7 @@ export interface IndicatorTrendsResponse {
 }
 
 export async function getIndicatorTrends(): Promise<IndicatorTrendsResponse> {
-  return fetchApi<IndicatorTrendsResponse>("/api/health-records/indicator-trends");
+  return fetchApi<IndicatorTrendsResponse>("/health-records/indicator-trends");
 }
 
 export interface ReportTypeTrendPoint {
@@ -414,7 +428,7 @@ export interface ReportTypeTrendsResponse {
 }
 
 export async function getReportTypeTrends(): Promise<ReportTypeTrendsResponse> {
-  return fetchApi<ReportTypeTrendsResponse>("/api/health-records/report-type-trends");
+  return fetchApi<ReportTypeTrendsResponse>("/health-records/report-type-trends");
 }
 
 // ─── Calendar ───
@@ -437,11 +451,11 @@ export interface CheckupPlanResponse {
 }
 
 export async function getCheckupPlan(): Promise<CheckupPlanResponse> {
-  return fetchApi<CheckupPlanResponse>("/api/calendar/plan");
+  return fetchApi<CheckupPlanResponse>("/calendar/plan");
 }
 
 export async function completeCheckup(week: number): Promise<{ message: string }> {
-  return fetchApi<{ message: string }>(`/api/calendar/plan/${week}/complete`, {
+  return fetchApi<{ message: string }>(`/calendar/plan/${week}/complete`, {
     method: "PUT",
   });
 }
@@ -454,7 +468,7 @@ export interface DoctorQuestionsResponse {
 }
 
 export async function getDoctorQuestions(reportId: string): Promise<DoctorQuestionsResponse> {
-  return fetchApi<DoctorQuestionsResponse>(`/api/doctor/questions/${reportId}`);
+  return fetchApi<DoctorQuestionsResponse>(`/doctor/questions/${reportId}`);
 }
 
 export interface Doctor {
@@ -473,11 +487,11 @@ export interface Doctor {
 }
 
 export async function getExperts(): Promise<{ doctors: Doctor[] }> {
-  return fetchApi<{ doctors: Doctor[] }>("/api/doctor/experts");
+  return fetchApi<{ doctors: Doctor[] }>("/doctor/experts");
 }
 
 export async function getExpertDetail(doctorId: string): Promise<Doctor> {
-  return fetchApi<Doctor>(`/api/doctor/experts/${doctorId}`);
+  return fetchApi<Doctor>(`/doctor/experts/${doctorId}`);
 }
 
 // ─── Share ───
@@ -503,7 +517,7 @@ export async function generateShareData(
   reportId: string,
   options: { privacy_mode?: boolean; include_details?: boolean } = {}
 ): Promise<ShareDataResponse> {
-  return fetchApi<ShareDataResponse>(`/api/share/${reportId}/generate`, {
+  return fetchApi<ShareDataResponse>(`/share/${reportId}/generate`, {
     method: "POST",
     body: JSON.stringify({ privacy_mode: true, include_details: false, ...options }),
   });
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index b009173..fcac799 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -1,40 +1,46 @@
-import { defineConfig } from 'vite'
+import { defineConfig, loadEnv } from 'vite'
 import path from 'path'
 import tailwindcss from '@tailwindcss/vite'
 import react from '@vitejs/plugin-react'
 import basicSsl from '@vitejs/plugin-basic-ssl'
 
-export default defineConfig({
-  base: '/app_03/',
-  plugins: [
-    // The React and Tailwind plugins are both required for Make, even if
-    // Tailwind is not being actively used – do not remove them
-    react(),
-    tailwindcss(),
-    // basicSsl(), // disabled for cloudflare tunnel compatibility
-  ],
-  resolve: {
-    alias: {
-      // Alias @ to the src directory
-      '@': path.resolve(__dirname, './src'),
-    },
-  },
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd(), '')
+  const apiPrefix = env.VITE_API_PREFIX || '/api'
+  const uploadsPrefix = env.VITE_UPLOADS_PREFIX || '/uploads'
 
-  // File types to support raw imports. Never add .css, .tsx, or .ts files to this.
-  assetsInclude: ['**/*.svg', '**/*.csv'],
-
-  server: {
-    host: '0.0.0.0',
-    allowedHosts: ['.trycloudflare.com', '.loca.lt'],
-    proxy: {
-      '/api': {
-        target: 'http://localhost:8000',
-        changeOrigin: true,
-      },
-      '/uploads': {
-        target: 'http://localhost:8000',
-        changeOrigin: true,
+  return {
+    base: '/app_03/',
+    plugins: [
+      // The React and Tailwind plugins are both required for Make, even if
+      // Tailwind is not being actively used – do not remove them
+      react(),
+      tailwindcss(),
+      // basicSsl(), // disabled for cloudflare tunnel compatibility
+    ],
+    resolve: {
+      alias: {
+        // Alias @ to the src directory
+        '@': path.resolve(__dirname, './src'),
       },
     },
-  },
+
+    // File types to support raw imports. Never add .css, .tsx, or .ts files to this.
+    assetsInclude: ['**/*.svg', '**/*.csv'],
+
+    server: {
+      host: '0.0.0.0',
+      allowedHosts: ['.trycloudflare.com', '.loca.lt'],
+      proxy: {
+        [apiPrefix]: {
+          target: 'http://localhost:8000',
+          changeOrigin: true,
+        },
+        [uploadsPrefix]: {
+          target: 'http://localhost:8000',
+          changeOrigin: true,
+        },
+      },
+    },
+  }
 })