License

Domain Transaction Flow Monitor

前后端分离的域名流水监控项目。

架构

• 前端: TypeScript + React + Vite (port 5173)
• 后端: FastAPI + Python (port 8000)
• 数据库: PostgreSQL

项目结构

├── frontend/                  # 前端代码
│   ├── src/
│   │   ├── api/               # Axios 请求封装
│   │   ├── types/             # TypeScript 类型定义
│   │   ├── App.tsx
│   │   └── main.tsx
│   └── .env                   # 前端环境变量
├── backend/                   # 后端代码
│   ├── app/
│   │   ├── main.py            # FastAPI 入口
│   │   ├── config.py          # 环境变量配置
│   │   ├── database.py        # 数据库连接
│   │   ├── models/            # SQLAlchemy 模型
│   │   ├── schemas/           # Pydantic 请求/响应
│   │   ├── routers/           # API 路由
│   │   └── services/          # 业务逻辑
│   ├── migrations/            # SQL 迁移文件
│   └── .env                   # 后端环境变量
└── README.md

环境配置

后端

复制 backend/.env.example 为 backend/.env，修改数据库连接：

DB_HOST=47.109.147.74
DB_PORT=5432
DB_USER=aigc_space_test
DB_PASSWORD=WxczAIGC
DB_NAME=AigcSpace-test

前端

frontend/.env 已默认配置 VITE_API_BASE_URL=http://localhost:8000。

启动方式

后端

cd backend
uv sync

# 执行数据库迁移（手动执行 SQL）
psql -h $DB_HOST -p $DB_PORT -U $DB_USER -d $DB_NAME -f migrations/001_initial.sql

# 启动服务
uv run uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Swagger 文档: http://localhost:8000/docs

前端

cd frontend
npm install
npm run dev

API 端点

域名管理

方法	路径	说明
GET	/health	健康检查
GET	/api/domains/	查询已监控的域名列表
POST	/api/domains/	添加需要监控的域名
DELETE	/api/domains/{id}	移除监控的域名
GET	/api/domains/{id}/transactions	获取流水数据（占位符）

监控大屏

方法	路径	说明
GET	/api/admin/monitoring/dashboard	获取监控大屏数据（树状层级汇总）

请求参数：

• start_date（可选）：查询开始日期，格式 YYYY-MM-DD
• end_date（可选）：查询结束日期，格式 YYYY-MM-DD
• super_admin_id（可选）：指定超级管理员ID

响应结构：

• overview：平台汇总（管理员数量、租户数、用户数、总消费、总收取额、总余额）
• super_admins：超级管理员列表，每个包含管辖的租户、用户、模型消费明细
• 层级：平台 → 超级管理员 → 租户 → 用户

说明

• /transactions 接口当前返回占位数据，外部 API 响应格式确定后会更新
• 数据库迁移文件存放在 backend/migrations/，通过 SQL 文件手动执行
• 前后端环境变量各自独立，互不影响