open-mercato

让 AI 编码助手直接产出生产级架构，不用反复改代码

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 490 🐛 待处理 1881 👀 关注 15

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1913

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队open-mercato

官网地址https://www.openmercato.com

GitHubhttps://github.com/open-mercato/open-mercato

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型admin-panel,agentic,ai-agents,ai-coding,crm,erp,framework,nextjs,open-source,self-hosted,typescript

GitHub 星标★ 1913

上线时间2025-09-10 00:00:00

代码更新2026-11-09

仓库体积952.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

open-mercato 是一个面向 AI 编程时代的应用基础框架，用 TypeScript 和 Next.js 构建。它解决的核心问题是：当使用 Cursor、Claude Code 等 AI 编程工具开发复杂业务系统时，架构决策往往重复且易出错。该项目将多租户、RBAC 权限、事件流、定价计费、销售管道、CRM/ERP 流程等数百个架构和领域决策，预先固化为约定和规范。AI 代理在编码时可直接遵循这些内置约定，无需重新设计轮子，从而大幅提升开发效率和代码质量。它本质上是把资深架构师的经验编译成 AI 可读的规则集，让 AI 生成的代码天然具备生产级水准，支持自托管和后台管理面板，适合需要快速构建复杂业务系统的团队。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1913

技术标签

agentic ai-agents ai-coding crm framework

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 30 分钟部署方式：本地安装 7 步

环境要求

Node.js 24（官方要求 24 版本）
Git
PostgreSQL 与 Redis（最简单的方式是用 Docker Desktop 启动）
Docker Desktop（提供 docker compose 命令）

安装与启动步骤

1安装前置依赖

先装 Node.js 24、Git 和 Docker Desktop，装完重开一个终端，确保 node、git、docker 命令可用。
2启用 Corepack 与 Yarn

Windows 需先放开执行策略，再用 Corepack 激活 README 指定的 Yarn 4.12.0 版本。
```
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
corepack enable; corepack prepare yarn@4.12.0 --activate
```
3克隆仓库并切分支

拉取 open-mercato 源码，进入目录后切到 develop 分支（README 的快速开始就是这个分支）。
```
git clone https://github.com/open-mercato/open-mercato.git
cd open-mercato
git checkout develop
```
4启动数据库与缓存

用仓库自带的 docker compose 一键拉起 PostgreSQL 和 Redis，也可改用本机原生安装。
```
docker compose up -d
```
5复制环境变量文件

把示例环境文件复制成实际使用的 .env，后续配置项都改在这个文件里。
```
Copy-Item apps\mercato\.env.example apps\mercato\.env
```
6启动开发服务

在仓库根目录运行开发模式，它会监听各 workspace 包并在启动时打印当前监听模式。
```
yarn dev
```
7可选：新建独立应用

不想改 monorepo 的话，可用脚手架生成自己的应用目录，再单独起容器和开发服务。
```
npx create-mercato-app my-app
cd my-app
docker compose up -d
```

关键配置

配置项	必填	说明	示例
`apps/mercato/.env`	是	应用运行环境变量，由仓库自带的 .env.example 复制而来	`apps/mercato/.env`
`--database-name`	否	给 yarn dev/setup 传数据库名覆盖值，用于多个本地实例共用同一 PostgreSQL	`review_1720`
`--no-update-env`	否	单次运行时不写入 .env，只对当前子进程生效	`--no-update-env`

如何确认成功

docker compose ps 显示 PostgreSQL、Redis 容器正常运行，且 yarn dev 启动后终端无报错。

常见问题

Q：必须自己装 PostgreSQL 和 Redis 吗？

A：不是。README 推荐用 Docker Desktop 配合 docker compose up -d 一键启动，也可以用原生 PostgreSQL + pgAdmin 自行安装。

Q：对 Node.js 版本有要求吗？

A：有，README 明确要求 Node.js 24；同时 Yarn 需通过 Corepack 激活到 4.12.0 版本。

Q：想同时跑两个长期运行的本地实例怎么办？

A：给 yarn dev、yarn dev:greenfield 或 yarn setup 加 --database-name 覆盖数据库名，例如 yarn dev --database-name=review_1720 --no-update-env，不会改动 .env。

Q：开发模式内存占用偏高怎么缓解？

A：yarn dev 默认监听所有 workspace 包，包越多内存越高，可以缩小监听范围只保留常改的包，当前模式启动时会带 emoji 打印出来。

注意事项

README 的快速开始命令是 Windows PowerShell 写法（Copy-Item、Set-ExecutionPolicy），macOS/Linux 需换成对应的 cp 等命令。
Docker 开发环境、VPS 生产部署、Dev Container、Railway 一键云部署均有独立文档，见 docs.openmercato.com 对应安装章节。
仓库分为 monorepo（核心开发/完整示例）与 create-mercato-app 脚手架两条路径，按需选择其一。
不要使用 README 未给出的端口、路径或包名，遇到问题优先查官网安装文档。