营养接诊台(门店健康问卷 + 营养师方案 + 轻量分销结算 · 远山营养)
为母婴营养门店打造的双端技能:店员端分龄匿名录入,营养师端生成可交付方案,并带轻量分销统计与结算。零姓名/电话/微信,全程匿名合规。
何时使用
- 店员要录入客户健康问卷 → 店员录入模式
- 营养师要基于某编号生成方案 → 营养师方案模式
- 要查看某周/某月服务量与分销 → 统计子命令
- 要核算老师归属费与分享人结算 → 结算子命令
数据通道(v1 本地存储)
数据落在工作区 nutrition-intake-desk-data/(自动创建),跨会话持久化。脚本统一在 scripts/ 下,
运行环境用隔离 venv:C:/Users/86198/.workbuddy/binaries/python/envs/default/Scripts/python.exe。
未来可切换 wb_smartsheet(字段映射见 references/smartsheet-fields.md)。
模式一:店员录入(分龄、匿名、高效)
- 确认门店:问省/市/门店名(省从
references/province-list.md34 省清单选汉字全称)。 - 问客户年龄段 → 选
age_segment(12 类,见scripts/intake_wizard.py的 SEGMENTS)。 - 打印该段题目:
python scripts/intake_wizard.py --print-segment "<段>",逐题向店员提问(多为多选/量表,3–5 分钟录完)。 - 收集答案写成 JSON,务必含:
province/city/store_name/intake_channel/consent(=true)、age_segment/gender/age/height_cm/weight_kg、assessment{D1..D8}、婴幼儿/少儿深度字段、goal[]、served_by、shared_by(可空)。 - 脱敏与写入:
python scripts/intake_wizard.py --submit <answers.json>。脚本自动:校验知情同意 → PII 兜底扫描(命中拒写)→ 算 BMI → 生成anon_id=日期-序号→ 入库。 - 把
anon_id与门店留存告知店员(客户对应靠门店线下编号,系统不存个人信息)。
> 录入前必须口述知情同意要点(匿名化/用途/留存12个月/可删除),consent=true 才可写。详见 references/compliance.md。
模式二:营养师方案(结构化、专业、可交付)
- 取编号:
python scripts/intake_wizard.py无;用python scripts/distribution_stats.py --period month列出可生成编号,或营养师直接提供anon_id。 - 生成方案:
python scripts/plan_render.py --anon-id <id> --export。
- 自动分层(母婴核心/扩展)→ 套阶段红线 → 渲染 HTML → 强制合规扫描(禁词/红线/数据纪律)→ 导出 docx+pdf。 - 交付:docx(门店可改店名)+ pdf(直接发客户),文件在
nutrition-intake-desk-data/plans/。 - 方案板块:抬头(阶段标注+门店+anon_id) → 核心风险摘要 → 膳食建议 → 营养素目标 → 生活运动 → 就医边界 → 免责声明+落款。详见
references/plan-template.md与references/tier-rules.md。
统计子命令(需求②)
python scripts/distribution_stats.py --period month|week|<YYYY-MM>:展示每位老师服务列表+订单总数、每位分享人分销客户数。
结算子命令(需求③,不含抽成)
python scripts/settlement.py --period month|week:门店前 3 次免单(试用闸门)→ 老师门店费(谁服务归谁) → 分享人按带来客户数小额结算。单价在references/config.md。
后台权限控制(修改 / 补充 / 调整 仅授权账号)
- 受控操作仅三类:
modify(修改) /supplement(补充) /adjust(调整)。录入(--submit)、查询(统计/结算)、生成方案均不受限,属分布式正常使用。 - 授权账号:默认仅
吕丰专注营养培训(微信号/账号标识),名单在references/auth-config.json,可用config_tool.py --add-operator/--remove-operator调整(该操作本身也需授权)。 - 当前操作者身份解析优先级:环境变量
STORE_OPERATOR_WX(生产由平台注入真实登录微信号,终端用户无法伪造)> 本地会话文件.session_operator(auth.py login写入,仅授权账号可登)> 未设置(访客,受控操作一律拒绝)。 - 门禁已接入的入口(未授权者直接被拒,无操作入口):
- 修改问卷:
intake_wizard.py --edit <anon_id> --patch <patch.json>(MODIFY) - 补充问卷:
intake_wizard.py --supplement <anon_id> --addendum <add.json>(SUPPLEMENT) - 删除问卷:
datastore.delete_by_anon(MODIFY,内部守卫) - 后台调整(单价/开关/品牌/授权名单):
config_tool.py全部写命令(ADJUST) - 查看身份:
python scripts/auth.py或python scripts/config_tool.py --whoami。 - 生产部署提示:真正不可伪造的身份绑定需由平台/云后端在登录态注入
STORE_OPERATOR_WX;本地login仅用于本机调试,发布给他人时应删除会话态、关闭自登录,避免被仿冒。详见scripts/auth.py头部注释。
合规纪律(强制)
- 零 PII:只现门店标识+anon_id;写入前
bmi_desensitize.py扫手机/微信/身份证特征,命中拒写。 - 方案 ≠ 医疗诊断:末尾固定免责句;涉及宝宝问题提示问儿科医生(见
references/compliance.md)。 - 阶段红线:孕期/哺乳期禁减肥/生酮/控糖限能量;围绝经禁调理激素;老年禁排毒祛湿(见
references/tier-rules.md)。 - 数据纪律:方案中数字须有出处(膳食指南/DRIs),无出处不写。
可迭代(随时升级)
- 题库/红线/单价全外置(references/*.md + config.md 的 JSON 块),改配置不改码。
- 内置"提交改进建议":把反馈写进工作区
improvements.md(或口头告诉我),升级只加脚本+一行。 - 后续可加:跟进反馈闭环、跨账号云后端、网页问卷链接、多级分销链、自动提醒(见未来规划)。
收费(业务层 + 平台层)
- 业务层:门店前 3 次免费 → 基础按次 ¥39 → 套餐增购(轻享¥299/月·10份 / 标准¥599/月·10份含跟进 / 尊享¥1999/季·一对一)→ 高量门店月订阅¥999/月(50份封顶)。分享人每客小额¥5–10(非抽成)。
- 平台层(上架 WorkBuddy 市场):选买断或月订阅(平台仅支持这两种,模式过审后不可改,付费须一开始就选付费发布)。详见
references/config.md与计划 §16。