# 古建修复SaaS

**Repository Path**: monologue47/ancient-building

## Basic Information

- **Project Name**: 古建修复SaaS
- **Description**: No description available
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-24
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 古建AI防护平台 (Ancient Architecture AI Protection Platform)

面向古建筑巡检、AI 分析、报告生成与多级评审/保险/项目申请的一体化平台。

## 项目结构
- `backend/`: FastAPI 后端（REST API + 静态资源 + AI 任务派发）
- `frontend/`: Vue 3 + Vite 前端（Web 管理端）
- `mobile-app/`: 移动端/AR 相关工程（Android）
- `ai-engine/`: AI 模型/服务相关目录（按需对接）
- `database/`: 数据库初始化脚本与迁移/辅助工具
- `simulation/`: UE5 仿真/数据生成目录（可选）

## 快速开始

### 1) 数据库（MySQL 8.0+）
1. 创建数据库（名称与 `backend/.env` 中 `MYSQL_DB` 一致）。
2. 初始化表结构：执行 `database/init.sql`。

### 2) 后端（FastAPI）
1. 复制配置文件：`backend/.env.example` → `backend/.env`，按需修改。
2. 安装依赖并启动：
   ```bash
   cd backend
   python -m venv venv
   # Windows
   .\\venv\\Scripts\\activate
   # macOS/Linux
   # source venv/bin/activate

   pip install -r requirements.txt
   uvicorn app.main:app --reload
   ```
3. 访问 API 文档：`http://localhost:8000/docs`

#### AI 任务模式
后端支持两种 AI 队列模式：
- `AI_QUEUE_MODE=local`：本进程内执行（适合开发/演示）。
- `AI_QUEUE_MODE=celery`：Celery + Redis（适合并发与异步任务）。

### 3) 前端（Vue 3）
1. 安装并启动：
   ```bash
   cd frontend
   npm install
   npm run dev
   ```
2. 访问地址：`http://localhost:5173`

#### 地图与二维码配置（高德）
编辑 `frontend/public/config.js`，填入高德 Key 与安全密钥：
```js
window.__APP_CONFIG__ = {
  AMAP_KEY: "你的高德Key",
  AMAP_SECURITY_CODE: "你的安全密钥",
  AMAP_SERVICE_HOST: "http://127.0.0.1/_AMapService",
  APP_BASE_URL: "http://localhost:5173"
}
```

## 常见问题
- 表结构未初始化：请确认已执行 `database/init.sql`，并且 `backend/.env` 中 `MYSQL_DB` 指向同一个数据库。
- 上传文件路径：后端会挂载 `backend/static` 到 `/static`（默认用于上传与静态资源访问）。