共享企业治理,但业务项目 100% 独立
常见困境:大平台或全量脚手架把所有公共模块与业务混在同一工程,升级底座怕覆盖业务,改业务又反向拖住平台。
Kaiwu 理念:统一网关、单点登录、成员角色、字典、国际化与待办由平台集中承载;每个业务应用只由项目工厂生成或纳管一次,交付为独立前后端 Git 仓 + 独立数据库,随时可独立演进、独立部署。
Kaiwu · 开物载道 v0.3.0 · Apache-2.0 开源
产品即前端,后端接完联调上线;独立业务仓与随仓门禁,换人换工具都能接手,企业能力由平台承载。
Kaiwu 解决企业 AI 开发的两个核心难题:一是产品即前端,产品经理无需先装平台或后端,直接用 AI 在 kaiwu-web-starter 或生成前端仓做出带模拟身份与规则验收的正式 React 前端,经 project adopt 纳管与 Git 交接后,后端接上 Spring Boot 接口即可上线,不再重敲前端;二是开发可控,每个业务交付为独立前后端仓,自带 AGENTS.md、模块契约、规则场景与 verify 门禁,换人或换 AI 工具都能稳定接手。
开源仓库 · Gitee · GitHub · 起步仓 · 10 分钟读懂运作机制
企业开发多个业务后台时,往往困在两个极端:要么背负沉重的单体大平台与低代码黑盒,要么靠复制脚手架和 AI 自由发挥导致每个项目各自漂移。Kaiwu 用三条明确的边界化解这一矛盾。
常见困境:大平台或全量脚手架把所有公共模块与业务混在同一工程,升级底座怕覆盖业务,改业务又反向拖住平台。
Kaiwu 理念:统一网关、单点登录、成员角色、字典、国际化与待办由平台集中承载;每个业务应用只由项目工厂生成或纳管一次,交付为独立前后端 Git 仓 + 独立数据库,随时可独立演进、独立部署。
常见困境:让大模型直接从零写整套工程,虽然能跑通页面,却常漏掉权限校验、Flyway 迁移、安全审计与发布契约。
Kaiwu 理念:把 AI 放在前端交互、受校验蓝图或单仓功能迭代上,而工程目录、@/kaiwu 接入层、鉴权校验与 CI 骨架由版本化模板确定性渲染。不用 AI 也可一键生成标准空脚手架。
常见困境:巨型仓库超出 AI 上下文窗口,检索面过大导致改一处漏一处;口头约定在换人或换模型后迅速失效。
Kaiwu 理念:每个业务仓聚焦单一业务域,并内置 AGENTS.md、verify:mock 与 verify.sh 门禁。后端注解、前端校验与 menus.yml 权限码三端同码,规则与场景双向绑定,缺失即报错。
产品经理无需先装平台或后端,直接用 AI 在前端起步仓做出可切角色试用的正式页面;确认后通过 Git 交接并纳管生成配套后端,全程留在同一个前端仓库。
用 AI 拉取前端起步仓直接生成页面或双人预约示例,本机启动即可切换不同身份点开试用并随时重置演示数据,不依赖平台、容器或数据库。
在同一个前端仓库保存页面、接口类型、菜单权限清单、规则编号与验收场景,验收后发起交接合并请求,不靠口头传达和截图对齐。
后端执行一条纳管命令登记项目并生成配套服务;接口写完后连本地网关复验全部验收场景,生产构建自动剔除模拟路由与假数据。
内置开发态拦截与角色切换面板,未注册接口会明确提示兜底;产品本机只装基础前端环境即可运行,且不会混入生产构建包。
登录、权限校验、字典与请求封装收拢在带完整性保护的接入层中;只换组件库或整套视觉皮肤,完全不伤业务逻辑与鉴权链路。
提交前自动核对规则文档、菜单权限清单、模拟实现与自动化场景测试是否一致,防止后端接手时漏掉边界阈值或越权检查。
纳管时自动登记前端并同步菜单、角色与配套后端仓;研发保留已验收界面仅微调联调,上线后的交互修正也可顺畅回流产品分支。
根据当前角色选择一条起步提示词,复制给能使用本机终端的 AI 编码工具(Claude Code、Codex、Cursor、Trae 等)。
从 https://github.com/kaiwuzaidao/kaiwu-web-starter 获取 Kaiwu 前端起步仓最新稳定版(如 v0.3.0),按仓库内 AGENTS.md 初始化我的业务前端项目,帮我做一个设备预约前端:让员工能看到会议室投影仪的空闲时段,选时间预约或取消自己的预约,两个人选到同一时段时让后提交的人看得懂出了什么问题。用内置 Mock 跑起来给我本地可点的地址。AGENTS.md 初始化从 https://github.com/kaiwuzaidao/kaiwu 获取 Kaiwu 最新稳定版,按 AGENTS.md 在本机启动。问我想开发什么项目,再按我的回答准备前后端。AGENTS.md 在本机检查环境并启动 Kaiwu已经有项目了?使用已有项目的开发提示词 →
左栏为产品先做前端再纳管生成后端,右栏为从已运行平台直接创建并同步双仓:
产品先在 kaiwu-web-starter 初始化项目并演示;开发在入口仓登录,预览并纳管前端,同步清单后只取回配套后端,再用 pnpm dev:real 联调。
node scripts/kaiwu-init.mjs --code booking --name 设备预约
cd ../booking-web && pnpm install --frozen-lockfile && pnpm dev
# 交接后在入口仓纳管:
./kaiwu login --client "project-development"
./kaiwu project adopt ../booking-web
./kaiwu project adopt ../booking-web --apply已在入口仓启动平台时,可直接生成基础双仓并挂载到本机工作台;日常维护菜单、字典与参数先预览再加 --apply 写入。
./kaiwu login --client "project-development"
./kaiwu project new inventory --name "库存管理"
./kaiwu project status inventory --wait
./kaiwu project pull inventory
./kaiwu project-up ../business/inventory-service ../business/inventory-web
./kaiwu project sync ../business/inventory-service从上往下看,工作台和业务前端的 API 请求都经过同一个网关。蓝色虚线标出新接入的库存项目,它与设备预约项目并列,拥有自己的前端仓、后端仓和数据库。
kaiwu-system-webbooking-webinventory-webkaiwu-gateway-servicekaiwu-system-service成员、权限、项目工厂Spring Boot · MyBatis-Plusbooking-service设备预约与取消Spring Boot · MyBatis-Plus接入 SDK · kaiwu-system-starterinventory-service入库与盘点Spring Boot · MyBatis-Plus接入 SDK · kaiwu-system-starterkaiwu 入口与 CLI · 启动平台与纳管同步kaiwu-web-starter 产品前端起步仓 · 无平台直出 Mockkaiwu-deploy 可选部署仓 · Kubernetes / Argo CDproject_code=system)运行,无特权旁路kaiwu-data-scope 按角色 × 部门在 SQL 层自动过滤,为已声明的表补上 AI 开发容易漏掉的行级过滤kaiwu/*.yml 随仓同步;测试到生产导出 6 类配置快照,三方基线比对 diff 预览,授权按组确认、删除逐项勾选、新建定时任务默认停用bizKey 幂等待办(或签/会签/逾期置顶)、可抢占租约调度;平台首次安装原生可选 MySQL 或达梦 DM8以设备预约和库存为例,两者共用员工身份,再按项目分别授予角色与数据范围。组件随业务需要按需引入,团队自行决定每个服务如何部署。 查看请求与授权完整链路 →
假设设备预约系统已经上线,现在要为同一批员工开发库存系统。员工沿用原账号,库存的盘点规则由业务团队自己定:
| 开发方式 | 前端如何从原型到上线 | 员工怎样进入库存系统 | 盘点规则改在哪里、如何维护 |
|---|---|---|---|
| 推荐范式Kaiwu + AI 工具 | 产品与 AI 先在 kaiwu-web-starter 或生成前端仓用内置 Mock 完成多角色演示与规则验收,经 project adopt 与 Git 交接后,后端接入 Spring Boot API 与 dev:real 联调上线,UI 库可换且生产剥离 Mock。 | 库存接入同一网关,直接给已有员工分配库存项目的角色与行级数据范围(本人/部门),工作台自动出现新入口与统一待办。 | Agent 在库存项目独立的前后端仓库改代码,随仓校验通过后用 project sync 预览清单差异;测试到生产用跨环境移交包三方比对同步字典、菜单、角色与任务。 |
| 低代码平台 | 在拖拽设计器里配置表单并直接发布,但复杂交互、自定义 UI 与跨系统前端代码复用受限于平台扩展边界。 | 在同一平台建应用,通常可以沿用平台的账号和角色模型。 | 在设计器里调整表单和流程。遇到复杂盘点逻辑、跨环境配置 diff 审计或深度定制时,受限于平台边界。 |
| 传统后台脚手架 | 产品先画静态原型,专职前端再照图在复制工程里重敲一遍,接口字段与交互往往需反复对齐。 | 复制一份新工程虽有登录代码,但两套系统要共用账号、待办与 STS 存储,仍需自行改造统一身份与凭证中心。 | 在复制出的工程里改源码。第 1 个项目与第 5 个项目逐渐漂移,测试到生产的菜单、字典与角色变更常靠手工 SQL 对齐。 |
| 单独使用 AI 工具 | AI 能快速生成一次性前端 Demo,但缺少统一鉴权、权限/字典接入层与 Mock 隔离,交给后端后常需推倒重写。 | 每次都要把已有的身份接口、令牌协议、行级数据权限和存储规则重新喂给 AI,或从头设计。 | AI 可以直接改源码,但权限三端一致性、行级 SQL 隔离、多环境配置移交和发布契约需要团队自行兜底。 |
AI 写代码很快,但工程长期可维护需要可控边界。Kaiwu 把约定、规则与检查脚本放进业务仓库本身,让任何人、任何 AI 编码工具都能基于同一份事实接手开发、定位问题并通过门禁。
项目工厂和起步仓交付独立的业务前后端。修改某个业务功能时,AI 编码工具只需读取该项目自己的页面、接口与迁移脚本,不会被无关项目干扰。
模块边界、AGENTS.md、business-rules.md、acceptance-scenarios.md 与清单全部保存在 Git 仓库里。换工程师或切换大模型,从当前提交就能读到同一份事实依据。
前端 pnpm verify:mock 校验规则编号、场景、@/kaiwu 接入层与生产构建隔离;联调后 pnpm verify 与 verify.sh 核对三端权限与清单一致。
按实际开发任务组织的实操指南,每章包含前置条件、执行命令、预期结果与排错方法,同时向人类开发者与 AI 编码工具开放。
从起步仓直出 Mock 再纳管后端,或从项目工厂取回双仓打开后台。
开发业务功能落地规则场景、@/kaiwu 接入、数据库迁移、权限三端校验与联调。
设置角色和数据范围分配项目成员,授予角色,验证用户能看到哪些记录。
同步与移交配置预览前端或后端清单变更,在不同环境间移交项目配置。
处理文件与 Excel绑定对象存储,给订单列表加 Excel 导入导出。
接入待办和调度发起审批待办、发送站内信,让业务服务执行定时任务。
限定项目助手的读写范围让助手按成员权限查数据。写入前先预览将修改的字段,由用户确认后执行。
管理平台从工作台查项目、处理通知、管理成员和会话。
部署和排错选择数据库,在单机或 Kubernetes 上部署,定位启动问题。