Skip to content

About

绩效报告生成平台

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

EvalFlow Pro · 云海睿评

EvalFlow Pro 吉祥物「睿睿」

一个用于生成 AI 辅助绩效评估报告 的 Web 系统。核心流程:用户登录 → 创建项目 → 上传材料 → 逐步执行工作流 → 生成内容 → 支持多模型对比、人工复核、版本历史,并导出为 Word / PDF。后台管理台可管理 Prompt、知识库与模型配置。

✨ 功能特性

  • 多步骤工作流:step1–step14 分步生成评估报告,支持多轮人工复核与确认提交
  • 多模型对比:同一环节并行对比多个模型输出,择优采纳
  • 双层短期记忆:后端 LangGraph MemorySaver + 前端 localStorage 双保险,未确认前不落业务表
  • 版本历史:每次确认提交生成版本快照,可回溯
  • 导出:一键导出 Word / PDF
  • 管理台:用户管理、模型注册、Prompt / 知识库管理、审计日志、用量分析

🧱 技术栈

层 技术
前端 Vue 3 + TypeScript + Vite + Element Plus + Tailwind CSS + Pinia
后端 FastAPI + LangGraph(agentic workflow)
数据 PostgreSQL(主库)+ Redis(缓存 / 任务)
存储 本地文件(data/uploads 上传、data/outputs 产出)

📁 项目结构

/f/AgentSystem/
├── frontend/                # Vue 3 应用
│   ├── src/
│   │   ├── pages/           # 页面组件
│   │   ├── components/      # 可复用组件
│   │   ├── layouts/         # 布局模板
│   │   ├── router/          # 路由
│   │   ├── stores/          # Pinia 状态
│   │   ├── services/        # axios API 客户端
│   │   ├── styles/          # Tailwind + CSS
│   │   └── assets/
│   └── package.json
├── Backend/
│   ├── app/                 # FastAPI 应用
│   │   ├── api/v1/routes/   # 路由(auth/chat/projects/files/steps…)
│   │   ├── core/            # 配置、异常、依赖注入
│   │   ├── services/        # 业务逻辑层
│   │   ├── models/          # SQLAlchemy ORM
│   │   ├── schemas/         # Pydantic 请求/响应
│   │   └── main.py          # FastAPI 实例
│   ├── agent/               # LangGraph 项目(user_graphs / admin_graphs)
│   ├── database_schema.sql  # PostgreSQL schema
│   └── pyproject.toml       # 依赖(uv 管理)
└── docs/                    # 设计文档中心

🚀 快速开始

前置条件

  • Node.js 20+ / pnpm
  • Python 3.11+ / uv
  • PostgreSQL(默认连接 postgres:123456@localhost:5432/postgres)
  • Redis(使用异步 worker 时需要)

1. 初始化数据库

cd Backend
uv sync
uv run python init_db.py   # 或直接把 database_schema.sql 导入 PostgreSQL

2. 启动后端

cd Backend
uv run uvicorn app.main:app --reload   # http://localhost:8000

3. 启动前端

cd frontend
pnpm install
pnpm dev                                # http://localhost:5173

4.(可选)LangGraph 调试

cd Backend/agent
pip install -e ".[dev]"
langgraph dev                           # LangGraph Studio: http://localhost:2024

🌐 在线访问(GitHub Pages)

前端已配置通过 GitHub Actions 自动构建并部署到 GitHub Pages,推送到 main 分支即触发部署。

访问地址:https://linnanjun007-crypto.github.io/EvalFlow-Pro/

说明:GitHub Pages 只能托管静态前端,后端(FastAPI + PostgreSQL + Redis)无法一起部署。当前为静态占位部署——页面(首页 / 登录页等 UI)可正常打开,登录、项目等需要后端的交互功能需另接远程后端后可用。若你已有远程后端,在 frontend/.env.production 中配置 VITE_API_BASE_URL 指向它,重新构建即可接通。

部署配置要点

  • frontend/vite.config.ts:生产构建 base = '/EvalFlow-Pro/'(Pages 子路径);开发仍为 /
  • frontend/src/router/index.ts:路由使用 hash 模式(createWebHashHistory),避免刷新子页面 404
  • .github/workflows/deploy-pages.yml:push 到 main 自动构建并部署到 Pages。由于项目存在历史 TS 类型错误,CI 用 vite build 跳过 vue-tsc 类型检查(本地 pnpm build 会因类型检查失败,属已知问题,建议后续单独清理)

首次使用需在 GitHub 仓库 Settings → Pages → Source 选择 GitHub Actions。

🇨🇳 国内加速访问

GitHub 直接访问可能较慢,可用镜像代理加速 clone / 下载。以下前缀任选其一(失效时换另一个):

# 加速 clone
git clone https://ghfast.top/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git
git clone https://gh-proxy.com/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git
git clone https://ghproxy.net/https://github.com/linnanjun007-crypto/EvalFlow-Pro.git

📚 文档

设计文档集中在 docs/(系统设计 / 架构图 / 模块拆分 / 技术方案 / 数据库设计 / API 契约 / 任务 DAG),索引见 docs/README.md。本地启动步骤见 GETTING-STARTED.md。ECC 工具使用见 ECC-GUIDE.md。

About

绩效报告生成平台

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages