# yingzao **Repository Path**: chinamd5/yingzao ## Basic Information - **Project Name**: yingzao - **Description**: 现代装修企业的营造法式——装修行业开源 ERP:客源/报价/合同/施工/材料/结算全链条。核心开源+一切皆插件(Odoo 式三层:平台内核/行业插件套件/商业插件)。Java 17 + Spring Boot 3.3 + Vue 3 + uni-app。 - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 2 - **Created**: 2026-11-13 - **Last Updated**: 2026-11-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# 营造 Yingzao **现代装修企业的营造法式** *The Open-Source ERP for the Renovation Industry* [![License](https://img.shields.io/badge/License-AGPL--3.0%20%2B%20商业双授权-blue.svg)](#license) [![Java](https://img.shields.io/badge/Java-17-orange.svg)]() [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.3.x-green.svg)]() [![MySQL](https://img.shields.io/badge/MySQL-8.0-4479A1.svg)]() [![Flyway](https://img.shields.io/badge/Flyway-管理%20Schema-red.svg)]() [![Vue](https://img.shields.io/badge/Vue-3.x%20%2B%20Element%20Plus-brightgreen.svg)]() [![uni-app](https://img.shields.io/badge/uni--app-小程序%20%2F%20APP-2B993D.svg)]() [![Addons](https://img.shields.io/badge/插件-15%20业务%20%2B%20驾驶舱%20%2B%20C%20端%20%2B%20示范-8A2BE2.svg)]() [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-ff69b4.svg)]() **客源 · 报价 · 合同 · 施工 · 材料 · 结算 —— 装修行业全链条,一个系统管完** [快速开始](#快速开始) · [架构](#架构三层皆插件) · [业务全景](#业务全景行业插件套件) · [界面预览](#界面预览) · [双端形态](#双端形态内部员工端--外部客户端) · [路线图](#路线图) · [文档](#文档)
--- ## 这是什么 **营造(Yingzao)** 是一套面向装修行业(家装/整装/局装)的开源 ERP:从**客源线索**进来,到**报价、合同、施工、材料、结算**出去,行业全价值链一个项目覆盖。 它不是"通用 ERP 加几个装修字段",而是把装修行业二十年被验证过的业务模型——报价定额库、施工节点排期、主材销售、选材结算——以干净的架构重新建造一遍。 ### 为什么叫"营造" 名字取自宋代李诫的**《营造法式》**——中国第一部建筑设计与施工标准。它发明的**材分模数制**:构件按标准模数在作坊预制、到现场拼装,宫殿与民居用同一套模数体系——这正是一千年前的**插件化架构**。 本项目以同样的思想构建: > **核心只做平台与插件框架,一切业务皆插件,一切公司特性皆插件。** > 装哪套插件,它就是谁家的系统。 ### 它解决什么问题 - 装修行业数字化碎片化:获客一个 SaaS、报价一个工具、施工一个 App、财务一套金蝶,数据割裂,对不上账; - 现有装修软件多为黑盒闭源,装企被供应商绑定,想改一个审批流都要等排期; - 通用开源 ERP(Odoo/ERPNext 等)缺少装修行业深度:没有施工节点、定额报价、选材结算这些行业心脏。 营造的答案:**行业深度开源**——核心开源 + 行业插件套件开源,装企可自部署、可二开、可贡献回社区。 ## 架构:三层皆插件 ![营造架构:三层皆插件](docs/screenshots/architecture.png)
文字版架构图(无图环境 / 可搜索) ```text ┌─ 商业插件(闭源)────────────────────────────────────┐ │ 金蝶对接 / 电子签 / 聚合支付 / 工资社保 / 工地监控 / … │ ├─ 行业插件套件(开源,随核心发布)────────────────────────┤ │ 营销获客 / 客源 / 客户档案 / 楼盘 / 报价 / 合同 / │ │ 施工 / 主材销售 / 库存 / 材料 / 结算 / 款项 / 供应链 / │ │ 会员营销 │ ├─ 平台内核 yingzao-core(开源)──────────────────────────┤ │ 插件框架 + RBAC / 组织 / 字典 / 文件 / 通知 / 审批 / │ │ 报表 / 任务调度 / 导入导出 / 企微钉钉适配 / i18n │ └─ 端 ────────────────────────────────────────────────┘ Web 后台(Vue3) · uni-app(小程序 + APP) · 企微 / 钉钉 H5 免登 ```
| 层 | 开源 | 职责 | |---|:---:|---| | 平台内核 `yingzao-core` | ✅ | 插件框架(扩展点/领域事件/前端槽位)、组织账号、RBAC、字典、文件存储(FileStorageProvider 可插后端,local 首发)、通知、审批、i18n 等通用设施。**内核永不出现任何公司判断** | | 行业插件套件 `addons/*` | ✅ | 装修行业业务域,随核心一起发布,是本项目的主体价值 | | 商业插件 | ❌ | 财务对接、电子签、支付渠道等敏感/重运维能力,闭源变现,支撑项目长期投入 | 插件之间**禁止互相依赖实现**,只通过 `yingzao-addons-api`(领域事件与共享契约)协作;插件自有表以 `{addonId}_` 前缀隔离,核心表结构永不因插件变更。 ## 界面预览 视觉方向:**东方纸墨极简**(纸白暖底 / 墨黑 / 朱印红唯一点缀 / 宋体 display / 方角 / 8px 材分模数),Web 与移动端同源同构。 **Web 管理后台**(Vue3 + Element Plus,插件菜单动态注册)

登录 · 古籍扉页 装修单 · 四线状态机

营销进线 · 承接结果可见 获客漏斗 · 按活动/渠道

主材销售 · 四轴状态机 结算 · 明细快照/双腿操作

施工 · 节点排期/验收 官网案例库 · 五件套

计划任务 · 死信可见可重跑

**员工端**(uni-app 一码三出:小程序 + APP + H5)

登录 · 朱印方章 工作台 客源登记

我的机会 我的审批 请假示例(多级审批)

通知中心 我的

**客户端门户**(web-mp,H5 已上线:案例匿名浏览 / 进度 / 积分 / 验证码登录)

客户端 · 案例库(匿名) 客户端 · 我的装修(登录墙) 客户端 · 我的积分

客户端 · 我的(登录态) 客户端 · 验证码登录

> 更多截图见 [docs/screenshots/](docs/screenshots)(客源/款项/审批中心/机会/请假等)。 ## 双端形态(内部员工端 × 外部客户端) 装修行业天然是两个世界:**内部员工**(客源/报价/施工/结算)与**外部客户**(业主看进度/案例/保修/积分)。营造采用**同一后端、双前端应用**的形态: - **员工端**(本仓库 `app/`,uni-app 一码三出):工作台/客源登记/机会跟进/审批/通知,走账号密码登录 + RBAC 权限;功能路线图(P0 工作台配置化宫格/审批动态表单/施工域页面族 → P1 客源补全/销售款项/辅料 → P2)见 [员工端 PRD](docs/prd/app-employee.md); - **客户端**(本仓库 `web-mp/`,独立 uni-app 工程,H5 已上线):案例匿名浏览、施工进度脱敏视图、会员积分、手机验证码登录(未注册手机号验证通过后自动建客户档案);V2 规划(P0 资金流水/工地相册 → P1 客户确认中心/分享海报 → P2 报修/会员码)见 [客户端门户 PRD](docs/prd/webmp-portal.md);小程序与 APP 待微信 appid / 短信凭证后发布; - 两侧共用同一套 `yingzao-addons-api` 契约与内核设施(通知中心/审批/加密盒),客户端匿名开放端点由 RBAC v2 匿名段统一鉴权——后端无需为"双端"做任何分叉。 ## 业务全景(行业插件套件) ![营造业务全景:四链](docs/screenshots/business-landscape.png)
文字版业务全景(无图环境 / 可搜索) ```text 获客链: 渠道/进线/归因(addon-market) ─→ 线索/跟进(addon-customer) ─→ 转化建档(addon-customerprofile) ─→ 会员复购(addon-member) 交付链: 报价定额(addon-quotation) ─→ 装修合同(addon-decoration) ─→ 施工节点/排期/验收(addon-construction) 供应链: 商品/材料档案(addon-basedata) ─→ 主材销售(addon-sales) ─→ 库存/材料(addon-inventory / addon-material) 资金链: 款项/收款(addon-payment) ─→ 结算(addon-balance) ─→ 厂商协同(addon-supplier) ```
| 插件 | 业务域 | 状态 | |---|---|---| | `addon-market` | 营销获客:活动×渠道→投放源(渠道码/二维码/UTM)、进线(幂等+手机密文+动态表单)、承接事件化、三级归因漏斗、官网案例库、电子名片(一人一卡/匿名留资/事件通知) | ✅ V1.1 | | `addon-customer` | 客源:线索登记、分配(手动/自动轮询)、机会状态机、撞单策略三档可配置、营销进线承接、甄别态+到店时间(漏斗前置)、盘客工作台(确认在管/节点盘点/盘客轮次/结束恢复,节点=W1 判定表+甄别段同源推导) | ✅ V2.0 | | `addon-customerprofile` | 客户档案:城市/楼盘/房屋、客户主档(手机加密+读取留痕)、收款账户 | ✅ V1.0 | | `addon-basedata` | 基础数据:品类/品牌/商品/SKU/价格体系/套餐/型号/定材包/辅材档案(aoods 归并)、Excel 导入器(商品/价格体系/型号) | ✅ V1.4 | | `addon-quotation` | 报价:版本费率、功能区分组明细、服务端金额聚合、锁定/审核双线、定材包挂包、增减差量线(含净退款)、报价项库+保价重算、定额子域(档案/生成引擎/附加确认线/NormApi 工费聚合)、选材候选写侧(候选池/挂接/价差闸/复制)、选材挂接契约面(SelectionApi)+回尺指标档案 | ✅ V1.9 | | `addon-decoration` | 装修单:登记七联动、四线状态机、签约拆款、量房/确认/终止审批、决算六项前置检查(组织级可配)、三口径表(半包配比/整装满减/包干增项) | ✅ V1.3 | | `addon-construction` | 施工:放线点火、节点排期、比例闸、团队留痕、验收竣工、辅料额度契约、节点工费/工日列+附加待审徽章(NormApi 消费方) | ✅ V1.4 | | `addon-material` | 材料域:1.x 代主材子订单(生产新增早已停),拆分归并裁决——主链不迁、结算并入 addon-sales/payment(见 rules/material.md);**四处归并第 149 次全清(档案 basedata/收款 payment/选材写侧 quotation/选材读侧 sales),议题彻底终结** | ✅ 归并关账 | | `addon-sales` | 主材销售:四轴状态机、服务端算价、配送四级、结算三段式、退货审批链、定金/尾款双轴+退定金、外销单(品牌厂商外销线:确认建款/利润结算就绪/退货跳态)、品牌配送流程模板+里程碑分批结算(B2 行业中性化:免人工链 auto_ 留痕/finish 恒人工/Σ=预结总额/末批补尾差)、选材单读侧(报价锁定出生+8 态跟单+推送完备闸) | ✅ V1.5 | | `addon-inventory` | 库存:单据即库存、12 类货单(含套合/套拆)、领料定材校验+额度双闸、领料审批线(审核中/通过出库/驳回回退)、外辅/采购厂商引用化 | ✅ V1.6 | | `addon-balance` | 结算:结算汇聚(事件快照吸附)、账户双腿、扣款池、完结唯一定义、毛利管理线(两线两主体×17 周期版本化发布) | ✅ V1.1 | | `addon-payment` | 款项:款项单、统一收据双人留痕、批量收款 N:1(一笔到账收 N 单)、预付款科目台账、退款走审批(整单/部分) | ✅ V1.3 | | `addon-supplier` | 厂商协同:厂商主数据(查重下沉 DB)、品牌关联、三层结算条款、ext_no 幂等同步 | ✅ V1.0 | | `addon-member` | 会员营销:活动/礼品库存/积分账户(事件驱动记账)/兑换单、发货登记、过期清算、签约自动核销、礼品采购流(父单链分批入库) | ✅ V1.3 | | `addon-portal` | C 端门户:手机验证码登录、案例库匿名浏览、施工进度脱敏视图、会员积分查询 | ✅ V1.0 | | `addon-target` | 经营目标:目标挂组织树任一节点(公司/分区/部门)、签约额/渠道进线双业绩线、阶段目标(月内切阶段)、调整留痕、子树实绩聚合;PK 对赌(赛事/四档锁档/奖金=PK金×档位码/归档快照 SHA256/手工实绩双轨);激励活动平台(目标阶梯/排行榜/周期名额三机制后端计算引擎、绑定目标计划达成率分母同源、定版快照 SHA256、发放留痕+人工核销) | ✅ V1.5 | | `addon-service` | 售后服务:投诉(三态+超期徽章+回访联动)/回访任务(三来源+草稿闭环+满意度)/保修登记(保修期=起点+月数查询期计算) | ✅ V1.0 | | `addon-dashboard` | 经营驾驶舱:指标目录(MetricProvider SPI/指标五要素)、聚合首页六维健康卡、获客漏斗五段+来源分布、主材/设计师/收款三工作台、盘客工作台、五维应用页(维度声明化) | ✅ V1.5 | > 完整的模块判定过程(老系统 41 模块逐一过堂)见 [docs/01-剔除保留清单.md](docs/01-剔除保留清单.md);各插件的实现口径(状态机/金额/字典)见 [docs/rules/](docs/rules),业务闭环见 [docs/prd/](docs/prd)。 ## 核心特性 - **插件化架构(自研)**——编译期装配的插件框架:`addon.yml` 清单、扩展点钩子、领域事件、前端槽位注册表、数据扩展约定。公司差异零侵入核心; - **事件总线(outbox 三件套 + exactly-once)**——同事务落箱、失败指数退避重试、死信可见可重放、消费登记消除常态重放;跨插件协作 = 领域事件 + addons-api 契约(如营销进线→客源承接→回写),无跨域 JOIN、无跨模块表直写; - **行业全链条**——获客 → 建档 → 报价 → 合同 → 施工 → 材料 → 结算,一条价值链贯通,十五个业务插件 + 驾驶舱 + 客户端门户 + 示范插件已落地,回归冒烟 2700+ 步持续全绿; - **一码多端**——Web 管理后台(Vue3 + Element Plus)+ 员工端 uni-app(小程序/APP/H5)+ 客户端门户 uni-app(H5 已上线)+ 企微/钉钉免登,一套账号体系收口;前端按 `GET /api/addons` 下发的插件清单动态注册路由/菜单/槽位,插件页面即插即显; - **干净的数据模型**——无历史包袱:业务状态机显式化(迁移表白名单)、金额统一最小单位(厘)、查重下沉 DB 唯一约束、PII 字段加密(AES-256-GCM)+ 读取留痕、错误码按插件分段、i18n 中英双语从第一行代码开始; - **组织与账号开箱即用**——组织树(公司→分区→部门,任意深度,子树数据范围)、用户管理(建号/停用踢会话/重置密码)、角色权限(菜单/功能点/端点三级)、计划任务管理页,管理后台自成体系; - **可审计的演进**——Flyway 全程管理 schema(内核与各插件独立版本分段),文档金字塔(需求规格书 / RFC / PRD / 规则清单)先于代码。 ## 技术栈 | 端 | 选型 | |---|---| | 后端 | Java 17 · Spring Boot 3.3.x · Maven 多模块 | | 数据 | MySQL 8 · Flyway(禁手工 SQL) · Redis(认证/会话) | | 前端 Web | Vue 3 · Element Plus | | 移动端 | uni-app(小程序 + APP 一码双出) · 企微/钉钉 H5 免登 | | 部署 | Docker · docker-compose | ## 仓库结构 ```text yingzao/ ├── yingzao-core # 平台内核:插件框架 + 事件总线 + RBAC + 通知 + 轻量审批 + 加密盒 ├── yingzao-addons-api # 插件间契约:领域事件 / 共享扩展点(插件协作唯一通道) ├── addons/ │ ├── addon-market # 营销获客(投放/进线/归因/案例库) │ ├── addon-customer # 客源(线索/机会/分配/营销承接) │ ├── addon-customerprofile # 客户档案(城市/楼盘/房屋/客户/账户) │ ├── addon-basedata # 基础数据(品类/品牌/商品/套餐/型号/定材包) │ ├── addon-quotation # 报价(版本费率/功能区分组明细) │ ├── addon-decoration # 装修单(四线状态机/签约拆款) │ ├── addon-construction # 施工(放线/节点排期/验收) │ ├── addon-sales # 主材销售(四轴状态机/结算三段式/退货) │ ├── addon-inventory # 库存(单据即库存/领料/外辅/采购) │ ├── addon-payment # 款项(款项单/收据/预付款科目) │ ├── addon-balance # 结算(结算汇聚/账户双腿/扣款池) │ ├── addon-supplier # 厂商协同(主数据/品牌关联/结算条款) │ ├── addon-member # 会员营销(活动/积分/礼品/兑换/采购流) │ ├── addon-portal # C 端门户(验证码登录/案例/进度/积分) │ ├── addon-target # 经营目标(组织树节点目标/双业绩线/阶段目标/PK 对赌/激励活动平台) │ ├── addon-service # 售后服务(投诉/回访任务/保修登记) │ └── addon-example # 示范插件(扩展点/事件/多级审批参考实现) ├── yingzao-app # 组装壳:打包所有启用的插件,单一可运行 jar ├── web # Web 管理后台(Vue3 + Element Plus,动态菜单) ├── app # uni-app 员工端(小程序 + APP 一码三出) ├── web-mp # uni-app 客户端门户(案例/进度/积分,H5 已上线) ├── docs/ │ ├── 01-剔除保留清单.md # 需求规格书:41 模块过堂终版 │ ├── 02-插件框架RFC.md # 插件机制设计 + spike 结论 │ ├── 03~05-*.md # RBAC 端点鉴权 / 客户端设计稿 / web-mp 工程设计 │ ├── prd/ # 各 addon 业务闭环 PRD │ ├── rules/ # 各 addon 实现口径(状态机/金额/字典) │ └── scripts/smoke/ # 一键冒烟回归(2700+ 步,可重复执行) ├── docker/docker-compose.yml # 一键启动(MySQL 8 + 应用) └── pom.xml ``` ## 快速开始 > 行业插件套件 V1 已可完整体验:后端 `mvn clean package` 后按上方环境变量启动,Flyway 自动建表;Web 后台在 `web/` 下 `npm install && npm run build`(或 `npm run dev`)。 **方式一:docker-compose 一键启动** ```bash git clone https://gitee.com/bty1987/yingzao.git cd yingzao/docker docker compose up -d # 应用: http://localhost:8080 (MySQL 同步启动,Flyway 自动建表) ``` > compose 部署缺省开启**演示数据**(环境变量 `YINGZAO_DEMO_ENABLED=false` 可关闭): > 自动灌入演示组织 + 一套完整装修单链路(客户档案/客源/报价/装修单/款项/施工/经营目标), > 用演示账号 **demo / yingzao123** 登录即可体验全部业务域。 **方式二:本地构建运行** ```bash # 仓库根目录 mvn clean package -DskipTests export YINGZAO_DB_URL="jdbc:mysql://:3306/yingzao?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai" export YINGZAO_DB_USER=root export YINGZAO_DB_PASSWORD= java -jar yingzao-app/target/yingzao-app-*.jar ``` > **上生产**:环境变量全清单 / HTTPS 反代 / 备份恢复 / 版本升级与 Flyway 纪律 / 插件启停运维, > 见 [docs/16-部署指南.md](docs/16-部署指南.md)。 **第三步:打开界面** ```bash # Web 管理后台(dev 模式,/api 代理到 8080) cd web && npm install && npm run dev # 打开 http://localhost:5173 (初始账号 admin / yingzao123) # 移动端 H5 — 员工端(uni-app) cd app && npm install && npm run dev:h5 # 打开 http://localhost:5174 # 客户端门户 H5(案例/施工进度/会员积分;手机验证码登录) cd web-mp && npm install && npm run dev:h5 # 打开 http://localhost:5175 ``` > 初始账号 admin / yingzao123 仅开发冒烟用;compose 部署另有演示账号 demo / yingzao123 > (`YINGZAO_DEMO_ENABLED=true` 时灌入演示组织数据)。正式使用请在「角色权限」页建立自己的账号体系, > 并以 `YINGZAO_DEMO_ENABLED=false` 部署(缺省即关)。 ## 路线图 | 阶段 | 内容 | 状态 | |---|---|:---:| | Phase 0 | 插件框架 spike + 客源→客户最小链路 + 全端骨架 | ✅ 完成 | | Phase 1 | 平台内核正式版:RBAC、事件总线(outbox 三件套)、通知中心、轻量审批流、加密盒、i18n | ✅ 完成 | | Phase 2 | 行业插件套件 V1:营销获客/客源/档案/基础数据/报价/装修单/施工/销售/库存/款项/结算(11 个插件端到端冒烟全绿) | ✅ V1 完成 | | Phase 2.5 | 插件 V1.x 增强:RBAC v2 端点鉴权、厂商/会员营销插件、C 端门户 H5、Excel 导入器(商品/价格体系/型号)、异步任务内核+管理页、插件零登记接入、组织树+数据范围基座、用户管理、决算六项检查、销售定金/退定金闭环、净退款(部分退原单不置终态)、经营目标插件(月目标+阶段目标+签约/渠道双业绩线)、售后服务插件(投诉/回访/保修)、批量收款 N:1、领料审批线——均已落地;余 C 端小程序/APP 发布(待微信 appid 与短信凭证,属部署清单) | ✅ 完成 | | Phase 2.9 | 插件 V2 批次:五份子域 PRD 已产出待业务拍板——报价定额(生成引擎/附加确认线)、毛利管理线(版本化发布)、外销精简版、电子名片(去 ISV 自托管)、战报 PK 对赌(五态状态机/归档快照) | 🚧 PRD 待拍板 | | Phase 3 | 商业插件与插件市场、托管版(插件开发指南 docs/10 已就绪,第三方接入路径文档化) | 规划中 | ## 文档 | 文档 | 内容 | |---|---| | [docs/01-剔除保留清单.md](docs/01-剔除保留清单.md) | 需求规格书:老系统 41 模块逐一过堂,判归内核/行业/商业/删除 | | [docs/02-插件框架RFC.md](docs/02-插件框架RFC.md) | 插件机制六点设计 + spike 结论(含三个工程坑) | | [docs/10-插件开发指南.md](docs/10-插件开发指南.md) | **第三方开发者从零到上架**:军规速览/抄作业路径表/验收清单(addon-example 示范工程配套) | | [docs/11-延后项开发计划.md](docs/11-延后项开发计划.md) | 延后项全台账(21 项四批次)+插件版本真实性核对表 | | [docs/15-完整开发计划.md](docs/15-完整开发计划.md) | **逐轮开发计划**:整体 review 漏项清单(文件存储/Redis 认证/审计日志/单测/CI/发布包)+E0~E5 六阶段 ≈41 轮排期 | | [docs/16-部署指南.md](docs/16-部署指南.md) | **生产部署**:环境变量全清单/HTTPS 反代示例/备份恢复/版本升级与 Flyway 纪律/插件启停运维/安全自查与已知坑 | | [docs/12-钉钉端内部应用盘点与员工端小程序开发需求反哺.md](docs/12-钉钉端内部应用盘点与员工端小程序开发需求反哺.md) | 方林钉钉端员工应用反哺归档:10 功能域盘点/判断法过堂/**员工端 app/ P0-P2 开发需求**/企微钉钉适配器设计输入(C4) | | [docs/13-微信端产品矩阵归纳PRD.md](docs/13-微信端产品矩阵归纳PRD.md) | 方林微信侧全家桶(4 小程序+公众号 H5)归纳 PRD:端矩阵/九大业务闭环/平台能力依赖/web-mp 客户端门户 V2 增补需求 | | [docs/prd/](docs/prd) | 各 addon 与端的 PRD(业务闭环),含模板;两端规划见 [app-employee](docs/prd/app-employee.md)(对内)/ [webmp-portal](docs/prd/webmp-portal.md)(对外) | | [docs/rules/](docs/rules) | 各 addon 的实现口径(状态机/金额口径/字典枚举) | | [AGENTS.md](AGENTS.md) | AI 协作开发指南(架构军规/文档金字塔/工作流) | | [CHANGELOG.md](CHANGELOG.md) | 版本演进与已知边界(语义化版本,0.x 阶段不承诺 API/schema 兼容) | | [CONTRIBUTING.md](CONTRIBUTING.md) | **参与贡献指南**:环境/必读文档/提 PR 自查清单/CI 说明 | ## 基本信息 | 项 | 值 | |---|---| | 主仓库 | (/issues 在此提) | | GitHub 镜像 | (自动同步,勿直推) | | 分支模型 | `master` 单主干直接提交 | | 开发语言 | Java 17(后端) / Vue 3 · uni-app(前端) | | 协议 | AGPL-3.0 + 商业双授权(见下) | | 当前状态 | **V1 功能完备,V2 迭代中**——18 个插件(15 业务域 + 驾驶舱 + C 端门户 + 示范)全量上线;回归冒烟 3000+ 步全绿 · 内核单测 128 用例 · 插件静态规则校验 109 条;历轮增强明细见下方折叠,版本演进见 [CHANGELOG](CHANGELOG.md) |
状态明细(历轮增强,点击展开) - **内核工程**——文件存储可插后端(local 首发)· 认证会话双后端(内存缺省,`yingzao.auth.store=redis` 一行切 Redis,支持多实例水平扩展)· 审计日志内核化(`@AuditLog` 注解切面 + 登录/踢出留痕 + 保留策略计划链)· 计划任务管理页(死信可见可重跑)· 单元测试 JUnit5+H2 内核高险面 128 用例随 `mvn package` 常跑; - **移动端(员工端)**——工作台宫格配置化(mobile 槽位段随 `GET /api/addons` 按权限下发)· 审批发起闭环(schema 驱动动态表单+选单预填+附件)· 基础组件五件(搜索联想/图片/时间轴/宫格/扫码)· 施工域页面族(我的工地/节点账册/稿纸日记/图纸图墙); - **C 端门户**——资金流水(票据卡)· 工地相册(九宫格)· 客户确认中心(验证码实名自助确认,免报码双轨)· 案例带参归因埋点; - **驾驶舱与工作台族**——经营看板首页(六维健康卡/结论条/签约回款双线/大区排名)· 获客漏斗五段+来源分布 · 主材销售/设计师/收款三工作台 · 盘客工作台(候选/在管/轮次留痕)· 五维应用页(业绩营销/经营管理/工程交付/供应链/财务); - **V2 子域已落地**——报价定额(生成引擎/附加确认线/NormApi)· 毛利管理线(17 周期版本化发布)· 外销精简版 · 电子名片(去 ISV 自托管)· PK 对赌 · 品牌配送流程+里程碑分批结算 · 报价项库+保价重算 · 批量收款 N:1 · 领料审批线 · 三口径表; - **部署待使用方凭证**——企微/钉钉免登 · 微信小程序/APP · 短信。
## 参与贡献 项目处于 V1 完备、V2 迭代阶段: - 🐛 **Issue**:Bug 报告、架构质疑、文档纠错,随时欢迎; - 💬 **行业需求反馈**:你是装企从业者?把你日常最痛/最离不开的流程告诉我们,这比代码更宝贵; - 🔧 **PR**:功能 PR 请先开 Issue 对齐(接口契约与架构军规见 [AGENTS.md](AGENTS.md));文档类 PR 可直接提。 ## License 本项目采用 **AGPL-3.0 + 商业双授权**: - 社区版以 **AGPL-3.0** 开源——你可以自由使用、修改、自部署,但基于它的二次开发对外提供服务时须同样开源; - 不接受 AGPL-3.0 的商业使用(如闭源二开、深度定制交付),可另行购买商业授权; - 商业插件族(财务对接/电子签/支付等)闭源,单独授权。 LICENSE(AGPL-3.0 全文)已随仓库发布;首个公开版本 **v0.1.0** 已发布演示数据与一键体验环境 (compose 缺省开启演示组织,详见[快速开始](#快速开始)),版本演进见 [CHANGELOG.md](CHANGELOG.md)。 ---
**一梁一柱,皆有法式。** ⭐ 如果这个项目对你有价值,欢迎 Star 支持