FAN-CE 是一个面向组学数据管理、查询与展示的开源平台。
| 目录 | 说明 |
|---|---|
backend |
后台 API 服务（FastAPI + PostgreSQL） |
frontend/admin-web |
管理端前端（monorepo：Antd + Element + Naive） |
frontend/admin-web/apps/web-antd |
管理后台（Ant Design Vue，端口 5666） |
frontend/admin-web/apps/web-public |
公开门户（Element Plus，端口 5677） |
plugin/ |
分析工具插件（.whl） |
scripts/ |
安装、升级、开发脚本 |
| 服务 | 端口 |
|---|---|
| 后端 API | 8002 |
| Admin 管理后台 (web-antd) | 5666 |
| Public 公开门户 (web-public) | 5677 |
| PostgreSQL | 5433 |
| 依赖 | 用途 | 安装方式 |
|---|---|---|
| pixi | 生信工具 + Python 解释器 + uv 包管理器 | curl -fsSL https://pixi.sh/install.sh | bash |
| uv | Python 虚拟环境与依赖管理（由 pixi 提供） | pixi 自动安装 |
| pnpm | 前端包管理 | npm install -g pnpm |
| Node.js >= 20 | 前端构建 | 随 pnpm 环境 |
| Docker | PostgreSQL 容器（自动启动） | curl -fsSL https://get.docker.com | bash |
pixi 管理生信工具（BLAST+、samtools、bcftools、bedtools、primer3、mafft、FastTree 等）和 Python 解释器。uv 管理 Python 依赖（FastAPI、SQLAlchemy 等 97 个包），两者职责分离，互不干扰。PostgreSQL 通过 Docker 容器运行，安装脚本自动拉取并启动。
# 1. 克隆仓库
git clone <repo-url> && cd fan-ce
# 2. 创建配置文件（修改数据库连接等）
cp backend/conf/config.example.yaml backend/conf/config.dev.yaml
# 3. 运行安装脚本
bash scripts/install.sh安装脚本自动完成：Docker 启动 PostgreSQL → pixi 安装生信工具 + Python + uv → uv 安装 Python 依赖 → 创建数据库表 → 导入植物 taxonomy 数据 → 前端构建。安装完成后 taxonomy 数据已预加载，首次登录即可使用。
bash scripts/upgrade.sh升级脚本自动完成：停止服务 → 拉取最新代码 → pixi + uv 更新依赖 → 数据库迁移 → 更新插件 → 重建前端 → 检查 taxonomy 状态。
升级不会影响数据：PostgreSQL 数据库、数据集文件、BLAST 索引、配置文件均独立于代码仓库，升级过程不会覆盖或删除。
# 启动（交互式选择模式）
bash scripts/start.sh
# 停止所有服务
bash scripts/stop.shstart.sh 提供三种运行模式：
| 模式 | 绑定地址 | 热重载 | 端口 | 适用场景 |
|---|---|---|---|---|
开发模式 [1] |
127.0.0.1 | ✅ | 8002/5666/5677 | 本地开发，仅本机访问 |
调试模式 [2] |
0.0.0.0 | ✅ | 8002/5666/5677 | 远程调试，改代码即时生效 |
生产模式 [3] |
0.0.0.0 | ❌ | 可自定义 | 对外部署，需预构建前端 |
生产模式如果选择 <1024 端口，会自动提示 nginx 反向代理配置（模板：templates/nginx-fance.conf）。
- API 文档：http://localhost:8002/docs
- 管理后台：http://localhost:5666（默认账号：admin / Admin123456）
- 公开门户：http://localhost:5677