# kaiwu **Repository Path**: wujm12138/kaiwu ## Basic Information - **Project Name**: kaiwu - **Description**: Kaiwu · 开物载道,面向 AI 时代的企业应用开发与交付平台。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: http://kaiwu.shengzhiweilai.online/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-15 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# Kaiwu · 开物载道 **产品用 AI 直出正式前端,后端接手同一套页面联调与发布;独立业务仓与随仓门禁,让多应用共享企业底座。** [English](README.en.md) · [v0.3.0 发布说明](https://github.com/kaiwuzaidao/kaiwu/releases/tag/v0.3.0) · [产品前端起步仓](https://github.com/kaiwuzaidao/kaiwu-web-starter/tree/v0.3.0) · [AI 协作开发指南](docs/AI-DEVELOPMENT.md) · [10 分钟看懂机制](docs/HOW-IT-WORKS.md)
> **Kaiwu 解决什么问题?** > 企业同时开发多个内部系统(库存、设备预约、订单、审批等)时,常卡在两件事:**产品原型要前端重敲一遍**,以及 **AI 写完跨仓改漏、换人换模型就漂移**。Kaiwu 用 **「产品即前端 + 随仓门禁 + 共享薄底座」** 一次性解决。 | 产品即前端(沿用验收前端) | 开发可控(代码和规则随仓) | 薄平台(多应用共享企业底座) | | --- | --- | --- | | 产品经理用 AI 在起步仓直接做出带多角色 `/__mock/` 演示的 **React 正式前端**;确认后 `project adopt` 纳管生成后端,同一套页面直接联调上线。 | 每个业务交付为 **独立前后端 Git 仓 + 独立库**,内置 `AGENTS.md`、编号业务规则、`acceptance-scenarios.md` 与 `verify` 门禁,提交前自动抓出漏项。 | 统一网关、单点登录、成员/角色/行级数据范围、受管字典、多语言、对象存储、统一待办与项目助手集中治理,业务代码 100% 独立演进。 | --- ## 30 秒看懂从 Mock 到生产的全链路 ```mermaid flowchart LR subgraph A["路线 A · 产品先出前端(无需启动平台)"] A1["1. 克隆 kaiwu-web-starter\n初始化空白仓或 --example booking"] A2["2. pnpm dev 本地演示\n/__mock/ 切换角色 · 固化规则与场景"] A3["3. product -> handoff/* MR\n连同页面、类型、kaiwu/*.yml 交接"] A1 --> A2 --> A3 end subgraph B["路线 B · 平台直出双仓"] B1["./kaiwu up 启动底座\nproject new + project pull"] B2["生成独立 *-web 与 *-service"] B1 --> B2 end A3 -->|"./kaiwu project adopt --apply\n登记项目并只生成配套后端"| C B2 --> C["4. 真实联调与三端门禁\n后端实现 API · 前端 pnpm dev:real\nverify.sh + pnpm verify"] C --> D["5. 生产交付\n镜像剥离 Mock(/__mock/ 返回 404)\n独立部署 · 接入同一平台工作台"] ``` ![工作台展示业务入口、待办事项与跨应用统一导航](docs/assets/workbench.png) --- ## 为什么选 Kaiwu? | 对比维度 | Kaiwu + AI 编码工具 | 低代码平台 | 传统后台脚手架 | 单独使用 AI 工具 | | --- | --- | --- | --- | --- | | **前端如何到上线** | 产品直出正式 React 前端 + Mock 验收,纳管后后端直接接 API 上线,沿用已验收页面;UI 库可换 | 拖拽表单直接发布,但复杂交互与自定义前端受限于平台扩展边界 | 产品画原型,专职前端照图重敲一遍,接口与交互反复对齐 | 很快生成一次性 Demo,但缺少鉴权、权限接入与 Mock 隔离,常需推倒重来 | | **多系统如何共享** | 新应用接入同一网关,已有员工按项目分配角色与数据范围,工作台自动出现入口 | 同平台应用通常可复用账号与角色体系 | 复制工程后各自一套登录表,跨系统共用账号与待办需自行改造 | 每次都要把登录协议、令牌与权限表结构重新喂给 AI | | **规则如何长期可控** | 独立小上下文仓库 + 规则/场景/Mock 绑定 + 权限三端同码门禁,便于换人或更换工具后接手 | 依赖设计器配置,复杂逻辑调试与代码化协作受限 | 复制多个工程后各自修改,公共能力修复靠人工逐仓同步 | 权限一致性、数据库迁移、敏感日志与发布契约全靠团队手工兜底 | --- ## 快速上手:按场景选一条路线 ### 产品先出前端演示 > **路线 A(推荐先试)· 无需 Docker、MySQL 或 JDK,只需要 Git、Node 22 和 pnpm 10**,按以下步骤在本地跑起带角色切换与规则校验的双人设备预约演示:
复制这句话给你的 AI 编码工具(Claude Code / Codex / Cursor 等)直接开工 ```text 从 https://github.com/kaiwuzaidao/kaiwu-web-starter 的 v0.3.0 标签帮我初始化一个设备预约演示项目,按仓库 AGENTS.md 运行本地 Mock,交付我能点击测试的 /__mock/ 角色切换地址。 ```
或者自己在终端执行(体验内置示例加 `--example booking`,自建空白业务去掉该参数): ```bash git clone --branch v0.3.0 --depth 1 https://github.com/kaiwuzaidao/kaiwu-web-starter.git cd kaiwu-web-starter node scripts/kaiwu-init.mjs --code equipment-booking --name 设备预约 --example booking cd ../equipment-booking-web pnpm install --frozen-lockfile pnpm dev ``` 1. **多角色交互演示**:打开终端打印地址的 `/__mock/`,分别用不同浏览器会话选择员工甲、乙,测试预约、冲突提示、取消释放和重置内存数据。 2. **规则与 UI 解耦**:业务页面通过只读接入层 `@/kaiwu`(`useCan`、`useDict`、`useProjectConfig`、`kaiwuRequest`)对接平台,可随时更换 UI 组件库;`pnpm verify:mock` 自动校验 `docs/business-rules.md`、`docs/acceptance-scenarios.md`、`mock-support/` 与 `kaiwu/*.yml` 一致性。 3. **交接并纳管生成后端**:在 `product` 分支验收后通过 `handoff/*` 移交;开发者在已启动的平台入口仓登录执行: ```bash ./kaiwu project adopt ../equipment-booking-web ./kaiwu project adopt ../equipment-booking-web --apply ``` - 首次运行不带 `--apply` 仅预览零写入;加 `--apply` 自动登记项目、同步清单与 `roles.yml` 初始角色,并在同级目录生成配套后端 `../equipment-booking-service`(`ADOPT_FRONTEND` 模式)。 - 后端实现 API 后,在**同一个前端仓**执行 `pnpm dev:real`(同时代理 `/api`、`/{code}-api`、`/{code}-svc` 到 Gateway)联调;后续清单维护运行 `./kaiwu project sync ../equipment-booking-web`,可选 Workflow 项目运行 `./kaiwu workflow sync ../equipment-booking-web`。 --- ### 启动完整平台 > **路线 B(v0.3.0)· 需要 Git、Docker(含 Compose v2)、OpenSSL 和 curl**。本机 MySQL 体验直接拉取 GHCR `amd64 / arm64` 预构建镜像:
复制这句话给你的 AI 编码工具,自动检查环境并引导生成双仓 ```text 从 https://github.com/kaiwuzaidao/kaiwu 获取 Kaiwu v0.3.0,按 AGENTS.md 在本机启动。问我想开发什么项目,再按我的回答准备前后端。 ```
```bash git clone --branch v0.3.0 --depth 1 https://github.com/kaiwuzaidao/kaiwu.git cd kaiwu ./kaiwu doctor KAIWU_DB_TYPE=mysql ./kaiwu up ``` - 打开 ****,使用 `admin` 和终端打印的随机初始密码登录并按提示改密(`./kaiwu credentials` 可随时重看初始凭据,`./kaiwu down` 停止并保留数据)。 - 已部署平台数据库需升级到 `v0.3.0` 或使用达梦 DM8:见 [升级说明(V128)](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/UPGRADING.md) · [数据库配置](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/DATABASES.md) · [MySQL / DM8 初始化 SQL](https://github.com/kaiwuzaidao/kaiwu-system-service/releases/tag/v0.3.0)。 #### 生成第一个业务双仓 以 `order-center` 为例,在网页「项目管理 → 开通项目」操作,或直接用 CLI: ```bash ./kaiwu login --client "kaiwu-demo" ./kaiwu project new order-center --name "订单中心" ./kaiwu project status order-center --wait ./kaiwu project pull order-center ./kaiwu project-up ../business/order-center-service ../business/order-center-web ``` ![项目工厂交付结果,支持同时下载独立前后端制品](docs/assets/project-factory.png)
查看更多真实界面截图(项目管理、权限中心、全局字典、配置移交、模型路由) - **项目管理**:内置 `system` 项目与业务项目统一管理入口与生成状态 ![项目管理中的 Kaiwu System 与订单中心](docs/assets/projects.png) - **项目权限中心**:菜单树与三段式权限码,与后端 `@RequirePermission` / `kaiwu/menus.yml` 三端同码 ![内置项目权限中心,展示平台菜单、按钮和权限码](docs/assets/permissions.png) - **受管字典与数据范围**:业务保存稳定值,前端按语言下发标签 ![字典管理中显示数据范围类型及其字典值](docs/assets/dictionary.png) - **跨环境配置移交**:导出与导入前预览新增、变更、删除和角色授权 ![订单中心的配置移交面板,提供导出、导入预览和移交记录](docs/assets/handover.png) - **大模型路由配置**:PLAN 与 ANSWER 阶段模型分离绑定 ![大模型配置中独立的任务识别模型和回答模型选择器](docs/assets/model-routing.png)
--- ## 平台内置的企业级能力 | 能力领域 | 能做什么 | 技术文档 | | --- | --- | --- | | **身份、角色与行级数据范围** | 统一登录 + Gateway 60 秒签名 Context;业务端接入 MyBatis-Plus 行级过滤(本人/本部门/指定部门) | [项目接入](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/PROJECT_ACCESS.md) · [数据范围](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/DATA_SCOPE.md) | | **前端纳管与清单移交** | `project adopt` 纳管产品前端、`project sync` 预览同步 `kaiwu/*.yml`、管理端跨环境配置移交 | [ADR 0048 前端纳管](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/adr/0048-adopt-existing-frontend.md) · [项目工厂](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/PROJECT_FACTORY.md) | | **统一待办与站内通知** | 业务服务按 `bizKey` 推送、更新或关闭待办,处理人统一从工作台进入办理 | [统一待办契约](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/UNIFIED_TODO.md) | | **对象存储 (STS) 与 Excel** | 项目绑定存储账号并领取限定前缀临时凭据;单独引入开箱即用的 XLSX 导入导出与模板校验 | [Starter 与组件库](https://github.com/kaiwuzaidao/kaiwu-system-starter/tree/v0.3.0) | | **受控项目 AI 助手** | PLAN / ANSWER 双阶段模型路由;按当前成员权限与数据范围只读查询,写操作先预览后确认 | [模型路由 ADR](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/adr/0043-agent-multi-model-routing.md) · [跨项目能力](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/adr/0030-agent-cross-project-capabilities.md) | > **Java SDK 坐标(Maven Central)**:`v0.3.0` 平台沿用已发布的 `com.kaiwuzaidao` `0.2.0` 组件:`kaiwu-system-starter`、`kaiwu-data-scope`、`kaiwu-excel`。 --- ## 仓库地图与延伸阅读 | 仓库 | 定位 | | --- | --- | | [kaiwu](https://github.com/kaiwuzaidao/kaiwu) | 统一开源入口与 CLI 编排 | | [kaiwu-web-starter](https://github.com/kaiwuzaidao/kaiwu-web-starter/tree/v0.3.0) | 产品前端起步仓(内置 `/__mock/`、规则场景检查与 `@/kaiwu` 无头接入层) | | [kaiwu-system-service](https://github.com/kaiwuzaidao/kaiwu-system-service/tree/v0.3.0) | 控制面后端、项目工厂、前端纳管、Flyway 与 Helm Chart | | [kaiwu-gateway-service](https://github.com/kaiwuzaidao/kaiwu-gateway-service/tree/v0.3.0) | 统一外部入口、JWT/Redis 会话校验与签名 Context 转发 | | [kaiwu-system-web](https://github.com/kaiwuzaidao/kaiwu-system-web/tree/v0.3.0) | 平台工作台、权限中心、字典/配置/多语言与项目工厂界面 | | [kaiwu-system-starter](https://github.com/kaiwuzaidao/kaiwu-system-starter/tree/v0.3.0) | 业务后端 SDK、行级数据范围与 Excel 工具 | | [kaiwu-deploy](https://github.com/kaiwuzaidao/kaiwu-deploy/tree/v0.3.0) | 可选 Kubernetes / Argo CD GitOps 部署声明(`./kaiwu deploy-init`) | - **实战与部署**:[AI 协作开发指南](docs/AI-DEVELOPMENT.md) · [10 分钟运作机制](docs/HOW-IT-WORKS.md) · [仓库与 Fork 说明](docs/REPOSITORIES.md) · [单机服务器部署](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/SERVER-DEPLOYMENT.md) · [Kubernetes 部署](https://github.com/kaiwuzaidao/kaiwu-system-service/blob/v0.3.0/docs/KUBERNETES.md) - **维护与规范**:[Agent 入口规范](AGENTS.md) · [版本变更](CHANGELOG.md) · [参与贡献](CONTRIBUTING.md) · [Apache-2.0](LICENSE) · [商标政策](TRADEMARKS.md)