reqmango:基于 Go 和 Vue 3 生态的现代化项目管理平台

自建项目管理:新需求先 Intake 分诊再进待办;可自定义工作项类型 / 工作流 / 自动化;AI 嵌在 Issue·Intake·Cycle,数据在自己机器上。

分支7Tags1
文件最后提交记录最后更新时间
4 个月前
6 天前
11 天前
6 天前
11 天前
12 天前
1 个月前
25 天前
4 个月前
12 天前
1 个月前
12 天前
1 个月前
11 天前
6 天前
12 天前
11 天前
11 天前
4 个月前
1 个月前
11 天前
11 天前
12 天前
12 天前
12 天前
12 天前
11 天前
12 天前

Reqmango

CI Release License: MIT 容器镜像

自建项目管理:新需求先分诊,再进待办。
提交后先给出类型、优先级与疑似重复建议,拿不准的才由人决定。

English · 文档站 · 贡献指南 · GitCode 国内主场 · GitHub 国际镜像


快速试用

预构建多架构镜像(linux/amd64、linux/arm64),最快:

# 国内推荐 GitCode 主场
git clone https://gitcode.com/yongfeng9m-/reqmanpy.git reqmango
# 国际镜像: git clone https://github.com/vinthuy/reqmango.git
cd reqmango
cp .env.example .env
docker compose pull
docker compose up -d

或者在本地构建两个镜像(冷缓存需要几分钟):

docker compose up --build

首次启动: 请等两个服务都就绪后再打开页面;前端镜像启动期间页面短暂空白 并不代表启动失败。curl localhost/version 可以确认当前运行的版本。

浏览器打开 http://localhost,登录:

邮箱 demo@example.com
密码 demo1234

可选 AI(Intake 分诊 / 分析 / 标签建议):在 .env 中设置 AI_API_KEY 后重启。

需求分诊队列

需求提交表单
需求入口 — 一个公开链接,收没有账号的人提的需求
工作项列表
工作项 — 列表 / 看板 / 树形 / 日历 / 甘特,共用同一套筛选
工作项详情
工作项详情 — 属性、关联、动态与 AI 面板在一屏内
周期
周期 — Sprint 范围、进度和延期项一目了然
分析
分析 — 优先级分布、工作量与完成趋势
工作空间
工作空间 — 多个项目、一个团队、一次登录

界面首次访问会跟随浏览器语言(中文 / English),任何页面右上角都能切换。

一分钟走查

  1. 使用演示账号登录。
  2. 打开 Demo 项目 → 项目设置 → 请求分诊(Intake)。
  3. 打开 Intake 表单链接,提交一条简短需求(例如「手机端登录偶尔失败」)。
  4. 回到分诊队列:接受 / 拒绝;配置了 AI_API_KEY 时可对工作项做 AI 分析与标签建议。

能力一览

方向 能力
工作流里的 AI Intake 分诊、Issue 分析、标签建议、Cycle / Sprint 总结、Ask / Build Copilot(写入前先预览)
工作项 列表 + 看板、状态流转、最多 6 层层级
自定义字段与模板 文本 / 数字 / 下拉 / 布尔 / 日期 / 成员 / URL;工作区类型蓝图;项目模板
工作流与自动化 状态转换、审批、角色限制;触发器 → 条件 → 动作
关联与搜索 Blocks / Relates / Duplicates;RQL 与多字段筛选
通知与安全 未读计数;XSS 清洗(bluemonday);JWT + RBAC
API 100+ REST 接口

AI 是项目管理上的一层能力,默认叙事不是独立的 Agent 控制台。代码里可能仍有高级 Agent 路由;日常路径是 Issue、Cycle、Intake 与 Pages。


环境要求

方式 需要
Docker(推荐) Docker + Docker Compose
本地开发 Go 1.25+、PostgreSQL 16+、Node.js 24+

版本与 CI、docker-compose.yml 一致(postgres:16,Go 1.25 / Node 24 构建镜像)。


本地开发(不用 Docker)

# 数据库
psql -U postgres -c "CREATE DATABASE reqmango;"

# 后端
cd backend
cat > .env << EOF
DATABASE_URL=postgres://postgres:postgres@localhost:5432/reqmango?sslmode=disable
SECRET_KEY=$(openssl rand -hex 32)
ACCESS_TOKEN_EXPIRE_MINUTES=10080
PORT=8000
DEBUG=true
SEED_DEMO=true
EOF
go run ./cmd/server/

服务启动时会自动迁移并写入种子数据,因此新建环境只需这一步。SEED_DEMO=true 会创建演示账号;不需要演示数据时删掉这一行,首次启动会创建一个管理员并把随机密码打印在日志里(见生产部署)。

数据库迁移

若希望把建表作为一个独立、可审阅的步骤,用 cmd/migrate:

cd backend
go run ./cmd/migrate up      # 应用基线
go run ./cmd/migrate version # 1, dirty=false

migrations/000001_baseline.up.sql 是单一幂等基线,空库和「已由服务 AutoMigrate 建好的库」都能直接跑。压缩基线之前建好的旧库需要一次性 go run ./cmd/migrate force 1,详见债务说明。

种子数据含 demo@example.com / demo1234、工作区 reqmango-dev(项目 CORE / MOBILE / AI / OPENAPI),以及示例 Sprint / 模块 / 工作项。演示账号的密码是公开的,只适合本地试用。

# 前端(API 在 :8000)
cd frontend
npm install
npm run dev

打开 http://localhost:5173。

本地生产构建

cd backend && go build -o server ./cmd/server/
cd frontend && npm run build

目录结构

reqmango/
├── backend/     # Go + Gin + GORM API
├── frontend/    # Vue 3 + TypeScript + Vite
├── sdk/         # MCP / CLI(可选,非默认产品叙事)
├── docs/        # API、架构、产品规格
└── docker-compose.yml

文档

同样的内容有在线站点:vinthuy.github.io/reqmango(English),由 MkDocs 从 docs/ 构建。


贡献

欢迎提交 Issue 与 Pull Request,尤其是小而清晰的改动。

License

MIT

项目介绍

自建项目管理:新需求先 Intake 分诊再进待办;可自定义工作项类型 / 工作流 / 自动化;AI 嵌在 Issue·Intake·Cycle,数据在自己机器上。

定制我的领域