实战：用烟花搭一套进销存（采购 → 入库 → 库存 → 看板）

这是烟花真实干过的一条活：文具进销存。我们不搭一个孤零零的表单，而是一条前后衔接的业务链——采购下单 → 入库 → 自动汇总库存 → 看板看全局。跟着走完，你会亲眼看到烟花的四种本事（建功能、装修、加交互、自写大屏）怎么在同一个系统里全用上。

动手前先跑通《烟花上手实操》：把环境搭好、把节奏摸熟（先出《行动计划》→ 一步步报进度 → 毛坯设计你签字才建）。这篇默认你已经会「说需求 → 看计划 → 审毛坯」这套基本动作。

我们要搭的四块

整条链就是四幕，每一幕用到烟花一种本事，难度层层叠加：

表里只列了每一幕的「主角本事」。🎨 装修不单算一幕——它内嵌在每一幕里：建完功能必先注数据，再对着真实数据精装列表和表单，是贯穿全程的「必修动作」。

第一幕 · 文具采购单（一张带明细、能审核的单据）

你这么说：

帮我做一个文具采购单：单头有采购单号（系统自动生成）、采购日期、供应商、经办人（从系统人员里选）、备注；下面带一张采购明细，每行有文具名称、类别（下拉：办公用品 / 耗材 / 设备）、计量单位（下拉：个 / 盒 / 包）、数量、单价、行金额。这张单要走审核。

烟花怎么做：

1. 逐字段判「值从哪来」——单号是系统生成、类别/单位是字典下拉、经办人是选系统人员、数量单价是手填……拿不准的它反过来问你，不自己猜。
2. 出一份毛坯设计：两个字典（文具类别、计量单位）、采购单主表 + 采购明细子表、单号规则、审核需要的字段、菜单挂哪。
3. 🛑 停下来等你签字——毛坯是整条流程唯一的硬关口。你扫一眼字段/字典/挂位，点头它才建。
4. 建完自己接着跑：注几行模拟数据 → 对着真实数据把列表和表单全面装修。

「走审核」是怎么落地的：烟花只预埋审核要用的字段，至于谁审、几级审，是你之后在灵象平台上画审批流——它不替你设计审批规则。详见《四大能力全景》。

再加一点交互（可选，但很提气）：让明细自动算钱。 这属于「加按钮 / 绑事件」，得你显式提烟花才动：

在采购明细上：每行「行金额 = 数量 × 单价」自动算；单头加个「合计金额」，把所有行加起来。

行金额逐行算、合计在明细变动时汇总——这俩放错地方会算不准甚至卡死，烟花照踩过坑的配方放对位置，你不用懂代码。配方见《JEAPI 事件配方》。

你看到： 一张能填的采购单，类别/单位是下拉，填完数量单价行金额自动跳出来，单头合计自动加总，并预留好走审核要用的字段（具体审批流之后由你在灵象里画，见上文说明）。

第二幕 · 文具入库单（选一张采购单，明细整单带过来）

这一幕是「业务链」的关键——让入库单接上采购单。

你这么说：

再做一个文具入库单，结构和采购单类似（入库单号、入库日期、经办人、入库明细），也走审核。关键是：入库时选一张采购单，它的明细自动带到入库明细里，我在带过来的基础上改实际入库数量。

烟花怎么做：

1. 像第一幕一样把入库主表 + 入库明细建好（6 分法、审核字段、菜单授权、注数据、装修一条龙）。
2. 在入库单上加一个「采购单」选择器（关联到采购单）。
3. 配「选单带入明细」交互：你选一张采购单 → 把它的明细整单带到入库明细；换一张单就整单替换。

⚠️ 一个被实测踩过、已修好的坑：删掉已经保存过的明细行，不能只在界面上抹掉——得真正从库里删、还要带上父单标识，否则删不干净（会报错）。烟花按踩过坑的配方处理；你要做的是：它加完这类交互后，上真机点一遍验证。坑与配方都在《JEAPI 事件配方》。

你看到： 新建入库单，选一张采购单，明细哗一下全带过来，改改实际数量就能入库。采购和入库串成一条链了。

第三幕 · 库存视图（按商品自动汇总入库数量）

你这么说：

做一个库存视图：把入库明细按文具汇总，每个文具显示累计入库数量和类别。这个只看、不录入。

烟花怎么做：

• 建一个聚合视图（只读）。它不是一张新表，而是把入库明细按商品分组、把数量加起来的「汇总查询」。
• 给视图配好只读列表 + 默认排序 + 只读表单。

这里要分清两种「合计」：单据内「把本单各行加起来」那种（就是第一幕做的单头合计），靠交互事件实时算、不用视图；而跨多张单据「按 X 汇总 Y」这类统计——按商品汇总库存、按部门汇总费用、按月汇总销量——烟花才用聚合视图来算。来源判断见《字段从哪来的 6 分法》。

你看到： 一张库存清单，每个文具一行，累计入库数量自动算好；入库明细一保存，这里的数字就跟着变——因为这张视图就是把入库明细按文具实时汇总出来的。

第四幕 · 采购看板（自写的实时大屏）

你这么说：

做个文具采购看板：顶部放几个关键指标（总采购额、采购单数……），下面用柱状图、饼图看各类别采购占比和走势，再带一张明细表。

先决条件： 看板属于「自写前端大屏」赛道，默认是关的，要先让工程师开「部署双门」（部署开关 + 看板文件落地目录），见《接入与部署》。开了烟花才动手，否则它会婉拒。

烟花怎么做：

• 自写一个 HTML 看板页，以内嵌网页（iframe）的方式挂成一个菜单。
• 借平台已登录的运行时实时取真实数据（不用你另搭后端），用图表库画 KPI + 柱 / 饼 / 折线 + 明细表。

看板这种「要好看、要贴品牌」的活，烟花常要改几轮才到位（配色太花、跟平台蓝不搭、日期显示成英文……都是真实出现过的）。这很正常——你直接说哪不对，它就改。

你看到： 一块打开就有实时数字和图表的采购看板，数据跟着采购单、入库单实时变。

收尾 · 你刚见证了什么

四幕走完，烟花把四种本事在一个系统里全用上了：

• 🏗️ 建功能：采购单、入库单、库存视图；
• 🎨 装修：每个列表、表单都精装过；
• 🖲️ 加交互：自动算金额、选单带明细；
• 🖥️ 自写大屏：采购看板。

这说明烟花不只是搭单个表单，能搭前后衔接、能跑业务的系统。

而你一路要守的节奏——先出计划、毛坯你签字才建、盯信号灯别让它停在毛坯——和《烟花上手实操》一脉相承，这里不再展开。

下一步

• 想照着自己的业务搭 → 先用《怎么对烟花开口：6 类任务 + 模板》挑准任务类型；
• 想看交互配方的细节 → 《给系统加交互：JEAPI 事件配方》；
• 想盯稳整个过程 → 《怎么盯着烟花干活：信号灯与保险丝》；
• 真要落到你的环境跑一套 → 预约工程师按你的真实业务现场演示；
• 配套实战视频会发布在 B 站官方频道。