心源 · 录入端 前置脚本开发文档
录入端「究竟化」
55 题字段级抽取规范
工单 XY-015 | 上游究竟 → 施工图才究竟 | 编制:小心同学(总协调)
v1.2 · 已与摸底表 v1.3 咬合(表二已补齐)42 题全部字段级究竟
本版关键升级:v1.1 曾把表二标为「仅到菜单级」;本轮已按「脚本四要素」补齐表二 10 个模块的字段级摸排(摸底表 v1.3),42 道题全部字段级究竟。下方每道题的「对齐」列 + 「柒」两张咬合总表,全部锚定银豹真实字段。
壹 · 这张文档为什么在施工图之前
因果链(双向锁死,两份文档咬合):
中游【摸底表 v1.2】=银豹每个字段的现状(A 事实),已经摸到字段 ID 级 | 上游【本文档 XY-015】=55 题每句该抽成什么字段(B 目标),对齐 A 事实 → 下游【施工图 TZ-001/TZ-002】=A+B 合成点哪个按钮、改哪个字段 → AI 员工执行才不返工。
现在的问题不在界面,在抽取逻辑:后端让 AI "自由发挥"地抽字段,字段名不统一、值无规范、不校验能否落地银豹,含糊答案也放行。
结论:给 55 题每一题预先定死"抽什么字段、值长什么样、对进银豹哪个真实字段、含糊就拦"——这就是"脚本深度决定录入究竟度",也是"摸排不白摸、录入不白录"。
贰 · 现状诊断(3 个不究竟的缺口)
| 缺口 | 现状 | 后果 |
| ① 字段自由 | AI 自己起字段名,同一含义两题两个叫法 | 无法拼成统一施工底稿 |
| ② 值无规范 | 金额/时间/枚举没有统一格式 | 填进银豹要人工再翻译一遍 |
| ③ 含糊放行 | "都开了""再说吧"被当成要素齐了 | 录了等于没录,施工时返工 |
叁 · 优化方案(三块,一块都不能少)
A. 55 题字段 Schema(本份文档主体)
每道题定死:必抽字段 + 值规范(枚举/格式)+ 银豹真实字段对齐 + 含糊拦截。对齐锚点全部取自摸底表 v1.2。
B. 抽取逻辑升级(后端 /api/extract)
把"泛化抽取"改成"按本题 Schema 对齐抽取":题目带上 schema 进提示词,AI 只许在 schema 内填空,字段名用预设名(对齐银豹字段),值必须符合枚举/格式。
C. 究竟判定 + 含糊拦截(前端)
抽完字段后逐项校验:值没落进枚举、金额没数字、时间没格式、关键字段空缺 → 判定"不究竟",绿色变黄提示"还差 X",拦下追问重说,不自动前进。
肆 · 55 题字段级抽取规范(主体)
约定:档案已定不抽取;工匠排程不语音;待你开口每题按 Schema 抽取。
三色标注:【值规范】 · 【对齐银豹·真实字段】 · 【含糊拦截】。
对齐锚点 = 摸底表 v1.2 摸到的真实字段(含字段 ID / 路由 / 现状)。
01概览
1-4营业时间(几点开门、几点打烊)
字段营业开始 · 营业结束 · 休息日
值规范时间 HH:MM;休息日枚举{周一闭店/无固定休息日/具体星期}
对齐门店信息 → 营业时间起止(摸底表·模块 12 设置/门店(4),字段级待补)
拦截只说"早九晚十"没给分钟、或没说有没有休息日 → 追问休息日
1-5高德/腾讯地图定位建了没有
字段定位状态 · 平台
值规范状态{已建/未建};平台{高德/腾讯/其他}
对齐门店信息 → 地图定位(未建则派浏览器工匠)
拦截说"建了"但没说哪家 → 追问平台
02收银★
2-2「来宾成员 T0000」怎么定性
字段处置
值规范枚举{正式编制/临时号/删除},只能一个
对齐收银层 → 员工/收银员名单(摸底表·模块 07 员工中心,字段级待补)
拦截没落进三选一、或说"随便/你定" → 拦截
2-3支付方式开通了哪些
字段支付方式(逐个开/关)
值规范枚举{银豹付-被扫/现金/会员储值卡/预付卡/折扣卡/支付宝/微信支付/银联卡},逐个说清
对齐/SettingExt/PayMethod 支付方式表 + 编辑弹窗「支付可用于{收款/会员充值/门店收支}」;A事实:支付宝/微信两行「操作」="-"纯占位、未接商户号
拦截只说"都开了"没逐个 → 追问逐个;支付宝/微信要区分「占位未接商户号」
2-4小票抬头和尾语
字段抬头 · 尾语
值规范两段文本,分开给
对齐收银层 → 小票模板(模块 02 收银台,字段级待补)
拦截只给一句(抬头或尾语缺一)→ 追问缺的那半
2-5收款码用哪个户
字段账户类型 · 渠道
值规范类型{个人/对公};渠道{微信/支付宝/银行}
对齐/SettingExt/PayMethod「支付可用于」三开关 + 商户号接入(A事实:直连走银豹付聚合或单独商户号)
拦截没说个人还是对公 → 追问
03销售
3-1开单流程口径
字段流程步骤(有序列表)
值规范≥2 步,每步一个动词短语
对齐收银层 → 开单 SOP(模块 03 销售/订单中心,字段级待补)
拦截只有一步或没顺序 → 追问完整步骤
3-2折扣权限(谁可打折、最低几折)
字段角色 · 最低折扣
值规范折扣纯数字(如 0.7 或 7 折)
对齐收银/员工 → 折扣权限(字段级待补)
拦截没说下限数字 → 追问最低几折
3-3免单/抹零权限给谁
字段免单角色 · 抹零单位
值规范抹零单位{角/分/元}
对齐收银 → 权限设置(字段级待补)
拦截免单角色和抹零单位缺一 → 追问
3-411-10 两笔测试单怎么处理
字段处置
值规范枚举{留档/删除}
对齐收银 → 订单中心(模块 03,字段级待补)
拦截没落进二选一 → 拦截
04商品★
4-4旧 SKU 清理(成本异常 + 倒挂)
字段处置
值规范枚举{批次改价/下架重录}
对齐/Product/Manage 编辑弹窗 edit_buyPrice(进货价)/edit_sellPrice(销售价)/edit_sellPrice2(批发价)/会员价/会员折扣;A事实:所有商品「进货价=销售价=批发价」、毛利率全 0.00%
拦截没选哪个方案 → 拦截
4-512 SKU 之外要不要加洗剪吹/护理
字段新增项目 · 价格
值规范项目名 + 价格纯数字;不加则枚举{不加}
对齐/Product/Manage 商品建档(edit_productName/edit_sellPrice/edit_buyPrice)
拦截说"加"但没给价格 → 追问价格
4-6成本价回填口径
字段口径 · 金额
值规范口径{等物理账/给数字};给数字则金额纯数字
对齐/Product/Manage edit_buyPrice;A事实:进货价当前=销售价,成本未单独回填
拦截口径不明 → 追问"等账还是给数"
4-7「染亚麻冷棕同款发色」¥298 怎么处置
字段处置
值规范枚举{改299/下架}
对齐/Product/Manage edit_sellPrice(销售价改 299 或下架)
拦截没落进二选一 → 拦截
05会员★
5-2等级体系:几级、叫什么、门槛多少
字段等级数 · 每级{名称,折扣,门槛}
值规范门槛金额纯数字(如 300/1000);折扣纯数字
对齐/Customer/CategoryV2 编辑弹窗 edit_name(等级名称)/edit_discount(折扣)/edit_remark(权益说明) + 升级规则;A事实:已建 2 级(普通13人/VIP5人),折扣全 100、门槛 2000/4000 是银豹默认值
拦截没说几级、或某级没门槛/折扣 → 追问补齐;要区分「银豹默认值」和「古老师拍板值」
5-3会员价是否全 SKU 挂 ×1.8
字段是否全挂 · 例外 SKU
值规范{是/否};否则列例外
对齐/Product/Manage 会员价/会员折扣列(A事实:会员价"-"、会员折扣"是")
拦截说"否"但没列例外 → 追问哪些不挂
5-4储值规则(充多少送多少)
字段档位列表{充,送}
值规范金额纯数字,可多档;赠送形态{余额/次卡/积分}
对齐/Recharge/Rule 编辑弹窗 edit_ruleName/edit_requireAmount(充值) + 赠送 + 适用范围;A事实:已建 3 卡(染发优惠卡充3000送次卡×2、产品卡5000、真心卡2000)
拦截有"充"无"送"或反过来 → 追问补全
06营销
6-1开业活动(首单礼/充值赠)
字段活动类型 · 内容
值规范类型{首单礼/充值赠},内容一句话
对齐营销层 → 营销活动(模块 06,字段级待补)
拦截有类型无内容 → 追问内容
6-2优惠券:面额/张数/有效期
字段面额 · 张数 · 有效期
值规范金额/数量纯数字;有效期天数或起止
对齐营销层 → 优惠券(模块 06,字段级待补)
拦截三个里缺一个 → 追问补齐
6-3活动周期几天
字段开始日 · 结束日(或天数)
值规范日期 YYYY-MM-DD 或纯数字天数
对齐营销层 → 活动周期(模块 06,字段级待补)
拦截没起止也没天数 → 追问
07员工★
7-2手工提成方案(按项目还是按业绩档)
字段模式 · 比例/档位
值规范模式{按项目/按业绩档};比例百分比或档位表
对齐/CommissionPlan/Manage 提成规则 + 应用的员工;A事实:当前「提成规则=未设置、应用员工=0名」——唯一无默认值的一块,纯靠古老师拍板
拦截没说按项目还是按档 → 拦截;说了模式但没给比例 → 追问
7-3角色权限(店长/技师/收银各能干什么)
字段店长权限 · 技师权限 · 收银权限
值规范每角色一句,权限动词短语
对齐员工层 → 角色权限(模块 07 员工中心(4),字段级待补;权限 ID 见摸底表·壹 data-authuid)
拦截三个角色没说全 → 追问缺的
08数据★
8-1日结口径:几点结算、看哪几个数
字段结算时间 · 指标列表
值规范时间 HH:MM;指标{流水/单数/客流}
对齐数据层 → 日结(模块 08 六类报表,字段级待补)
拦截没给结算时间 → 追问几点
8-2看板指标(流水/客流/客单/复购)
字段指标(多选)
值规范枚举{流水/客流/客单/复购},可多选
对齐数据层 → 看板(模块 08,字段级待补)
拦截一个都没点 → 拦截
8-3低库存预警线:梅花K 剩多少报警
字段预警数
值规范纯数字(支)
对齐库存 → edit_minStock/edit_maxStock(/Product/Manage 弹窗里的库存阈值字段)
拦截没给数字 → 拦截
09财务★
9-1结算方式:日结还是周结
字段周期
值规范枚举{日结/周结}
对齐财务层 → 结算(模块 09 商家结算/分账,字段级待补)
拦截没落进二选一 → 拦截
9-2股东对账口径
字段口径 · 频率
值规范口径短语 + 频率{日/周/月}
对齐财务层 → 对账(模块 09,字段级待补)
拦截口径和频率缺一 → 追问
9-3成本毛利表多久出一次
字段频率
值规范枚举{周报/月报}
对齐财务层 → 报表(A事实:毛利率 0% 为待修重点)
拦截没落进二选一 → 拦截
10CDP
10-1加客动线:收款后弹渠道码吗
字段是否弹码
值规范枚举{弹/不弹}
对齐CDP/企微层(模块 11 CDP,A事实:当前未开通,字段级待补)
拦截没落进二选一 → 拦截
10-2入群欢迎语说什么
字段文案
值规范一句话文本
对齐企微运营(模块 06 企微运营(13),字段级待补)
拦截没给文案 → 拦截
10-3染后 6-8 周召回入口
字段周数 · 内容
值规范周数纯数字;内容一句话
对齐企微定时任务(模块 06 企微运营,字段级待补)
拦截没给第几周或没内容 → 追问
11设置
11-1账户权限矩阵:谁能动价格/会员
字段价格权限角色 · 会员权限角色
值规范每项角色名(如 店长/古老师)
对齐设置 → 账户权限(模块 12 设置/系统(8),字段级待补;权限体系见 data-authuid)
拦截价格和会员两项没分别说清 → 追问
11-2打印机/小票纸规格
字段规格 · 台数
值规范规格{58mm/80mm};台数纯数字
对齐设置 → 打印设备(模块 12,字段级待补)
拦截没给规格或台数 → 追问
12合伙人
12-1股东结构与分红方案
字段股东结构 · 分红周期 · 推广比例 · 邀请比例
值规范结构含"李景源 15% 投 50 万进不进系统"(枚举{进/不进});分红比例百分比;周期{月/季}
对齐/Partner/BonusRule 分红比例 + 邀请分红比例(两级分佣)+ /Partner/Manage 股东字段;A事实:15 分类全「比例分红 0%」、等级分红「未查询到记录」、股东 0 人且新增=从会员转
拦截李景源口径没表态 → 追问进不进系统;分红比例/周期没给 → 追问
12-2老带新佣金比例
字段比例
值规范百分比纯数字(如 5)
对齐/Partner/BonusRule 推广分红比例(A事实:15 分类全 0%,等古老师定 5%/10%)
拦截没给数字 → 拦截
13定制
13-2专属流程:染前拍照/染后回访打卡要不要
字段染前拍照 · 染后回访
值规范每项枚举{要/不要}
对齐定制 → 专属流程(模块 14 定制,字段级待补)
拦截两项没分别表态 → 追问
14应用★
14-3三方团购(美团/抖音)开不开
字段美团 · 抖音(各自开/关)
值规范每项枚举{开/关}
对齐应用中心/三方团购(模块 06 三方团购(11)、模块 15 应用中心,字段级待补)
拦截两个平台没逐个表态 → 追问
14-4商品头图/轮播图 10-20 张
字段张数 · 交付时间
值规范张数纯数字(10-20);交付日期
对齐/Eshop/Wxminiapp 小程序装修(A事实:模板已开通,发布上架+微信支付要联系专员 0592-2230720)
拦截没说大概张数或何时给 → 追问(此项排工匠等料)
15配置★
15-1梅花K 染膏录库(¥33/¥37 成本异常一并修)
字段成本价
值规范枚举{33/37}
对齐/Product/Manage edit_buyPrice(A事实:进价=售价异常,成本要单独回填)
拦截没落进 33/37 二选一 → 拦截
15-2供应商建档
字段名称 · 品类
值规范两个文本
对齐供应链层 → 供应商(/Product/Manage 供货商列,字段级待补)
拦截名称或品类缺一 → 追问
15-3耗材字典(染膏/双氧/锡纸…)
字段是否建
值规范枚举{建/不建}
对齐供应链层 → 耗材字典(模块 16 配置,字段级待补)
拦截没落进二选一 → 拦截
15-4配方扣库存比例:7:2:1 映射到哪些 SKU
字段SKU 映射列表
值规范SKU 名列表,≥1 个
对齐供应链层 → 配方扣库存映射(模块 16 配置,字段级待补)
拦截没说映射到哪个 SKU → 追问
伍 · 验收标准(开发完成才算过)
| 验收项 | 标准 |
| 字段统一 | 同题重复录 3 次,抽出的字段名 100% 一致(预设名,不飘) |
| 值合规 | 枚举题落进枚举;金额/时间/日期/百分比全部规范化 |
| 含糊拦截 | 故意说"都开了""再说吧""随便",一律不自动前进,绿色变黄提示"还差 X" |
| 银豹对齐 | 每题的抽出字段,能 1:1 对上「摸底表 v1.2」里银豹真实字段名/字段 ID/枚举 |
| 不返工 | 录完 55 题导出的语料包,可直接拼进施工图底稿右半,无需人工二次翻译 |
陆 · 边界(这次不做什么)
① 不改界面皮肤、不动 scroll-snap 手势、不动录音按钮状态机(v3.0.1 已定型)。
② 不改 55 题题面与抽屉引导语(那是下一轮"题面校准"的事,本轮只动抽取层)。
③ 不新开站点、不换链接——原地升级 /lu/ 与后端 /api/extract。
④ 不碰"提成设置"那最后一格摸排(那是 A 事实侧补完,与本轮 B 目标侧抽取不冲突,可并行)。
柒 · 字段级映射总表(两份文档咬合点)
下表把「摸底表 v1.2 摸到的银豹真实字段(A 事实)」和「录入端题号(B 目标)」一一对上。这也是实事求是:已摸到字段级的,精确对齐;只摸到菜单级的,诚实标"待补",不假装摸到底。
表一 · 已到字段级(8 组银豹页面,摸底表 v1.2 已摸到真实字段/ID/枚举/现状)
| 银豹页面(摸底表路由) | 真实字段 / A 事实 | 录入端题号 | 归属 |
| 支付方式 /SettingExt/PayMethod | 支付方式枚举 8 行;编辑弹窗「支付名称 + 支付可用于{收款/会员充值/门店收支}」;支付宝/微信「操作」="-"纯占位未接商户号 | 2-3、2-5 | 古拍板接口 |
| 商品资料 /Product/Manage | edit_buyPrice / edit_sellPrice / edit_sellPrice2 / 会员价 / 会员折扣;进价=售价=批发价、毛利率全 0% | 4-4、4-5、4-6、4-7、15-1 | 小明整理→古确认 |
| 会员等级 /Customer/CategoryV2 | edit_name / edit_discount / edit_remark + 升级规则;已建 2 级、折扣全 100、门槛 2000/4000 默认值 | 5-2、5-3 | 古拍板 |
| 充值规则 /Recharge/Rule | edit_ruleName / edit_requireAmount + 赠送/适用范围;已建 3 卡(充3000送次卡×2 等) | 5-4 | 古拍板 |
| 提成方案 /CommissionPlan/Manage | 提成规则 + 应用的员工;规则=未设置、0 员工(唯一无默认值) | 7-2 | 古拍板 |
| 分红方案 /Partner/BonusRule | 分红比例 + 邀请分红比例(两级)+ 分红方式{固定|比例};15 分类全 0%、等级分红空 | 12-1、12-2 | 古拍板接口 |
| 股东管理 /Partner/Manage | 股东姓名/手机/等级/会员号/绑定好友数/同级好友数/累计收益/提现/未提现/加入时间/到期日期;0 位股东、新增=从会员转 | 12-1 | 接口 |
| 小程序装修 /Eshop/Wxminiapp | 模板 + 高级装修;模板已开通、发布+微信支付要联系专员 0592-2230720 | 14-3、14-4 | 浏览器 |
表二 · 已到字段级(本轮补齐,摸底表 v1.3)
| 银豹页面(摸底表路由) | 真实字段 / A 事实 | 录入端题号 | 归属 |
| 员工资料 /Employee/Manage | 工号/姓名/角色/手机/标签/进入商户端/状态 + 角色管理 | 2-2、7-3 | 古拍板 |
| 基础设置 /EShop/NewInfo | 营业时间段(7:00~12:00 / 12:00~18:00 / 18:00~22:00)/地名/联系电话/大额充值 | 1-4、1-5 | 古拍板 |
| 票据模板 /Setting/TemplateSetting | 模板名称/宽度/高度/字号/前缀/后缀/联系电话 | 2-4、11-2 | 古拍板 |
| 账户管理 /Setting/Info | 门店账号/登录密码/店铺名称/所属行业/所在省市/联系电话/邮箱/门店源/子门店账户/开启提醒 | 11-1 | 古拍板 |
| 系统设置 /Setting/BaseSystemSetting | 收银规则开关:折扣卡支付不使用促销/储值卡支付密码/会员身份消费限制/退货打印小票/盲交打印小票/合并商品/导购员查看利润权限 | 3-2、3-3、11-2 | 古拍板 |
| 供货商 /Supplier/Manage | 编号/名称/经营方式/联系人/电话/邮箱/授权状态/地址/供货商账号/备注 | 15-2 | 接口 |
| 耗材管理 /Product/Tastes | 耗材组名称/是否必选/参与打折/单选多选/选项/口味项/图片 | 15-3 | 接口 |
| 原材料配置 /Product/RawMeterial | 配置/原材料/档口/数量/单位(BOM 配方 = 7:2:1 落点) | 15-4 | 接口 |
| 促销活动 /Promotion/Manage | 促销名称/促销类型/适用范围/开始日期/结束日期/状态 | 6-1、6-3 | 古拍板 |
| 优惠券 /Promotion/Coupon | 优惠券名称/优惠券类型/适用范围/领券开始/领券结束/券收入 | 6-2 | 古拍板 |
| 门店渠道码 /Setting/StoreWecomConfig | 组别名称/适用门店/企微成员名称/创建时间 | 10-1 | 浏览器 |
| 入群欢迎语 /CDP/CDPWeWork/WeWorkWelcomeTemplate | 群欢迎语文本/附加多媒体类型/素材ID | 10-2、10-3 | 浏览器 |
| 日结/交班 /Report/CashierDailySummaryLogs | 开始/结束时间/收银员/总单数/净销售额/收银总额/现金/银联/储值卡/次卡/备用金/实缴金额 | 8-1、8-2 | 接口 |
结论(已更新):表二 10 个模块已全部摸到字段级。至此,录入端 42 道题(表一 18 道 + 表二 24 道)全部字段级究竟,每一句都能抽成「能填进银豹真实字段」的究竟字段。下一棒:进入开发(后端 /api/extract 按 schema 抽取 + 前端含糊拦截)。