齿科 3D 打印 · 综合成本对比计算器
后台配置 · 操作手册

面向配置管理员：逐板块说明每个按钮的作用、每个字段的含义，以及它们如何进入 CPP 计算公式。

适用版本 v2.9（2026-09，含区域人工口径 v2.8）配套文档：《销售前台与报告操作手册》截图为演示环境（暗色主题），以实际环境为准

第 1 章进入后台

入口前台右上角 ⚙️ 后台配置，或直接访问 `/admin/`

后台登录页：账号 + 密码（口令与云端口令一致，服务器可用 ADMIN_PWD 覆盖）

事项	说明
账号体系	账号由「账号权限」板块维护（仅管理员角色可见）。默认账号 `admin`。上线前务必在「改密码」中修改默认弱口令。
登录有效期	Cookie 会话，过期后自动跳回登录页。
顶部状态栏	登录后常驻显示：云端版本号 · 最后保存人 · 时间 · 实时同步状态（SSE 长连接，同事保存后 1~2 秒内自动推送到你页面），以及导出 JSON / 导入 JSON / 恢复示例 / 改密码 / 退出 / 前往前台。

第 2 章后台总览与保存机制

导航结构

左侧边栏分两组：

分组	板块
全局	🏭 品牌列表 · 📋 应用库 · ⚙️ 全局设置 · 🌍 区域与价格 · 🛡 备份与恢复 · 📝 变更日志 · 📊 使用数据 · 👤 账号权限（管理员）
品牌内	点进某个品牌后出现：前处理软件 / 打印设备 / 清洗设备 / 固化设备 / 分拣步骤 / 材料库 / 工艺包 / 🧩 应用配置 / 🔍 应用检查

「改完即存」与多人协作

没有任何「保存」按钮——后台每次修改后 0.9 秒自动推送云端（版本号 +1，自动备份旧版）。服务器通过 SSE 向所有在线页面即时广播：同事 A 改完，同事 B 的页面 1~2 秒内自动刷新为最新配置。两人同时改动时，后保存者会收到「云端已被他人更新」提示，可选择强制覆盖或拉取云端。每 60 秒还有一次轮询兜底。
操作者署名：全局设置里填写的名字会记录进版本历史（「谁在什么时候改了什么」可在变更日志追溯）。

改数据前先强刷一次页面

后台脚本更新上线后，旧页面可能仍跑着旧逻辑。维护数据前按 Ctrl+Shift+R 强制刷新一次，确保拿到最新脚本与云端最新配置，避免「旧值覆盖新值」。

两套价格口径的关系

配置体系里价格出现两次，职责不同：

位置	职责
品牌卡里的设备页 / 材料库	只维护参数（型号、规格、步骤、密度等）。价格列仅只读回显。
🌍 区域与价格	价格的唯一录入入口。四类报价（材料 / 设备 / 前处理软件 / 设备耗材与清洗液）按区域分列维护。

第 3 章品牌列表

元素	作用
＋新增品牌	新建一个品牌（本公司或竞品）。新品牌从空库开始，需逐步配齐设备/材料/应用。
品牌卡	显示 ID、设备总数、材料数、耗材条目、启用卡片数与五类设备分布——一眼看清配置完成度。
本公司标记	品牌编辑里有「标记为本公司」勾选：本公司品牌在前台默认第一列、报告中标星高亮。建议只标一个。
编辑 / 删除	改品牌名称（中/英文）等基本信息；删除不可恢复（先靠备份兜底）。
顶部黄框「N 项提示」	配置体检警告：如某组合步骤没有基准耗时、某应用未配置打印成功率。逐条处理后提示自动消失；不处理的项按提示中的兜底规则计算。
品牌卡内的进入方式	点击品牌卡或侧边栏品牌名，展开品牌内板块（设备五类、材料、工艺包、应用配置、应用检查）。

品牌之间的隔离逻辑

每个品牌拥有独立的设备、材料、耗材与应用卡片，互不串用。全局「应用库」定义应用是什么；「应用配置」决定本品牌怎么做这个应用（用哪台设备、哪个组合）。因此竞品 B 可以用同一种应用、完全不同的设备组合参与对比。

第 4 章应用库（全局）

位置侧边栏「📋 应用库」。这里定义「有哪些应用」及其全局默认口径。

应用编辑卡 — 应用库编辑卡：基本信息 + 全局默认计算参数；页内黄字提示「还需到品牌应用配置启用」

字段	含义与计算逻辑
应用名称（中/英）	前台与报告显示名；英文用于英文界面。
应用 ID	全局唯一英文标识（如 `app_half_implant`），建后不改。
应用大类	模型类 / Class 1 / Class 2 三类平行分组，前后台列表与卡片按同色标识。前台应用下拉按大类分组。
单件净重 g	一件成品的净克重。全局默认值：是材料用量与支撑/表面废料的换算基准（详见第 13 章损耗链）。
后备良品率	品牌卡片未配置良品率时的兜底值。

新增应用的两步走

在应用库建档≠前台可用。还必须到具体品牌的「🧩 应用配置」中启用它，并在卡片上配齐：打印设备 / 材料 / 每板件数 / 良品率等。卡片不完整的应用无法启用，前台也算不了它的成本。

第 5 章区域与价格

位置侧边栏「🌍 区域与价格」。全系统价格的唯一录入入口。

板块报价区域

字段 / 按钮	作用与逻辑
区域名称	显示在前台「区域」下拉。名称随意（中国大区、北美大区…），ID 自动生成。
币种	币种跟区域绑定：同一区域内所有价格都按该币种计价；前台切到该区域时币种自动跟随。
＋新增区域	新增区域时会自动复制首个区域的价格作为起点——系统没有「默认区域/基准价」概念，每个区域都是一套完整报价，请务必按当地情况逐项核对修改。
删除	删除区域及其整套价格。前台已选该区域的浏览器会自动退回跟随。

板块报价区域的人工口径 `v2.8`

人工成本按区域各自维护——前台哪一列选了哪个区域，就用该区域时薪折算人工成本；前台人工栏的默认值也取自这里。

字段	含义与计算逻辑
计薪方式	时薪制：直接录时薪。月薪制：录月薪 + 月标准工时，系统折算时薪。
月薪 / 月标准工时	折算公式：时薪 = 月薪 ÷ 月标准工时 ×（1 + 用工附加率）。月标准工时必须 > 0（作除数），常见值 176h（22 天 × 8h）。
用工附加率	社保、公积金等用工附加成本的比例加成，如 25% 填 0.25。
复制其他区域	把别的人工口径整套复制过来再微调，适合多个区域人力成本相近的场景。
折算时薪（卡头）	实时回显按当前输入折算出的时薪，用于目检。

前台如何消费这些值

前台每列默认「跟随区域」：选了哪个区域，人工参数即用该区域口径；销售手工改过则该列锁定为手工值（详见前台手册第 6 章）。这里改了某区域口径，所有「跟随」该区域的列即刻生效。

板块四类价格表

页面下方按品牌 tab 切换，四张表：① 材料价格 · ② 设备价格 · ③ 前处理软件价格 · ④ 设备耗材与清洗液价格。列 = 报价区域（每个区域一列），行 = 具体条目。

表	每行录什么
① 材料价格	每种材料的单价（按 kg 计，材料费 = 单件克重 × 单价 ÷ 1000）。
② 设备价格	每台设备一格：获取方式（买断 / 租赁-月租 / 租赁-年租）→ 设备价格 → 装机费 → 年度维护 → 折旧年限。品牌设备页的价格列只读回显这里的值。
③ 前处理软件价格	每款软件：计费方式（按月 / 按年 / 按件）+ 金额。按件计费直接进单件成本，按月/按年进月固定成本（按年自动 ÷12）。
④ 设备耗材与清洗液	每台设备的随机耗材（料盘、滤芯等，含计量单位与单价）和清洗液单价（元/L）。清洗液费 = 每件耗液(L) × 单价；耗材按驱动因子（按板次/按件数/按材料量/按机时）摊进成本。

区域与价格全页：人工口径 7 卡 + 材料价格表 + 设备价格表 + 软件价格 + 耗材与清洗液表（每区域一列）

价格为 0 的后果（重要）

哪个格子里是 0，哪部分成本就完全不进 CPP。例如某清洗机价格为 0 时，用它清洗的应用 CPP 会偏低。录入时注意逐列核对；临时占位的价格（如新采购设备未定机型价）应尽快替换为真机价。

板块固化氛围价格 `v2.9`

氛围	含义与计价逻辑
大气环境 atm_std	常规空气固化，通常只有电费级成本。
水氧抑制 atm_water	水下/水浴固化方式。
惰性气体 atm_g_agent	惰气置换（如二氧化碳等），按气源单价。
氮气 atm_n2	按工业气瓶折算：一瓶约 400 元 ÷ 放气约 7000L ≈ 0.057 元/L。⚠ 不要按液氮零售价（约 0.25 元/L）填——那会让氮气成本虚高 3~5 倍。

氛围成本怎么进 CPP

应用卡片的固化组合里填了固化消耗 L/件，前端按「所选氛围单价 × L/件」计入耗材。两者任一缺失（空白/未配氛围），氛围成本按 0 计——即不给固化配氛围不影响计算，只是不收这笔钱。

第 6 章全局设置

板块 / 字段	作用与逻辑
汇率维护	后台参数以 CNY 为基准存储。服务器每 12 小时自动拉取国际汇率（主源 open.er-api.com，备用源自动切换），状态条显示最近同步时间与币种数。表内标 `自动` 的条目由服务器维护，手工改值即转为人工锁定（自动同步跳过它）；点「跟随自动」恢复。＋新增汇率添加币种对；⟳ 立即同步手动触发一次拉取。前台与报告页不显示汇率——汇率是内部换算口径（v2.8 起有意下线展示）。
人工口径迁移说明	v2.8 起人工口径不再是全局设置，改为「区域与价格」按区域维护。本板块仅展示一张只读汇总表（各区域折算时薪）+ 跳转按钮；下方 `labor_defaults` 是历史全局值，仅作新增区域的初始值与引擎最后兜底，不直接参与计算。
数据收集与安全	使用数据采集开关与说明（配合「使用数据」板块）。
操作者名字	填你的名字（如「张三」），云端状态栏与变更日志显示「v N · 张三 · 时间」，多人协作时定位谁改的。

第 7 章备份与恢复 · 变更日志 · 使用数据 · 账号权限

板块	作用
🛡 备份与恢复	每次保存自动把旧版本写入服务器备份目录（保留最近 30 份）；本板块可浏览备份列表、下载、一键恢复。另提供「恢复示例」按钮（顶部栏）重置为出厂示例库。误操作后第一时间来这里。
📝 变更日志	每次保存的结构化记录：谁、什么时候、改了哪个品牌/板块/字段、旧值 → 新值。多人口令管理的审计依据。
📊 使用数据	前台匿名使用统计（场景数、应用选择分布等），用于了解销售端实际在测什么。受全局设置「数据收集」开关控制。
👤 账号权限	仅管理员角色可见。维护后台账号（新增/禁用），分「管理员 / 普通成员」两类角色：管理员可进账号权限与恢复示例等敏感操作。

第 8 章设备五类

位置品牌内侧边栏：前处理软件 / 打印设备 / 清洗设备 / 固化设备 / 分拣步骤。五类共用同一套列表布局（v2.9 起列宽跨分类统一，切换分类不再左右跳动）。

列表列含义（以打印设备为例）

列	含义
⋮（拖拽）	拖动调整顺序——前台下拉与该品牌内的展示顺序随之变化。
型号	设备名 + ID。型号不做应用限定：任何应用都可以选任何设备，用哪台在「应用配置」卡片上决定。
幅面 / 规格	成型尺寸等规格信息，纯展示。
步骤构成	徽章显示 `自动 N` / `人工 M`——该设备工艺步骤中自动/人工的数量。标注为自动的步骤人工投入自动归零；占用设备时间的步骤参与台数计算。
自动化能力	如「可无人值守」——影响人工与排产口径的标签。
耗材	该设备挂的随机耗材条目数（在耗材价格表里录价格）。
当前方式价款	只读回显当前获取方式下的价格（真正的价格在「区域与价格」维护）。
操作	编辑弹出编辑卡 · 复制克隆一台改型号 · 删除。
批量导入	按模板粘贴表格批量建设备。

编辑卡打印设备

打印设备编辑卡：型号/幅面 → 步骤构成（自动/人工 + 耗时）→ 自动化能力 → 价格只读回显

字段	含义与计算逻辑
型号 / 幅面	名称与规格（中英文）。
步骤构成	加材料 → 打印 → 取件 → 上平台等步骤，每个步骤设方式（自动 / 人工）与耗时（分钟）。人工步骤耗时 = 人工工时来源（× 时薪 → 人工成本）；自动步骤工时为 0 但占用机时（参与台数/节拍）。步骤集可随机型定制（应用卡片上还能按应用覆盖耗时）。
具备无人值守能力	勾选后可计入夜间排产口径（产能上限计算放宽到 24h 档）。
价格区	只读——修改请前往「🌍 区域与价格」② 设备价格表。

编辑卡清洗设备

字段	含义与计算逻辑
步骤矩阵	清洗的工序步骤（粗洗/精洗/漂洗/烘干等）与耗时。灰框表示该值由应用卡片按应用提供（应用级覆盖），此处为机型默认。
液槽容量 L	清洗机液槽容积，用于换液成本折算与「每板件数换液」口径提示。
换液间隔（个）`新口径`	每清洗多少件换一次液。换液成本 = 液槽容量(L) × 清洗液单价 ÷ 换液间隔(件)，摊到每一件上。与「每件耗液」二选一/配合使用：后台组合里填了清洗液 L/件则按件计耗，未填则走换液折算。
批容量（个/批）+ 稼动率	一次能洗几件、有效利用率多少——决定清洗环节的节拍与台数。
随机耗材	滤芯等，条目在此挂接、价格在「区域与价格」④ 表维护，按驱动因子（按板次/按件数…）摊入。

编辑卡固化设备

字段	含义与计算逻辑
氛围配置	勾选这台固化机支持哪些氛围（大气 / 水氧 / 惰气 / 氮气）。前台该设备的固化组合下拉会带出氛围选项；氛围单价在「区域与价格」维护，成本 = 氛围单价 × 应用卡的固化消耗(L/件)。
默认无固化	勾选后：应用没显式选固化方式时按「无固化」处理（不产生固化成本，仍计入节拍则视机型而定）。
批容量 / 稼动率	同清洗：每批几件、有效利用率，决定固化环节节拍与台数。

编辑卡分拣步骤

字段	含义与计算逻辑
这是设备	取消勾选表示纯人工工位（如人工分拣台）：不产生设备费，只计人工工时。勾选则作为设备参与（自动分拣线）。
步骤耗时	人工分拣的每件/每板耗时 → 人工成本的主要来源之一。

编辑卡前处理软件

字段	含义与计算逻辑
计费方式	按月 / 按年（自动 ÷12）/ 按件三种。月/年费进月固定成本被产量摊薄；按件费直接加到每件成本（不进月固定）。价格在「区域与价格」③ 表录入。
每件处理耗时	软件处理单件模型的人工工时（模型处理占大头），进人工成本。
无装机费	软件只涉及计费方式与金额，不涉及装机费（区别于硬件设备）。

第 9 章材料库

字段	含义与计算逻辑
名称（中/英）+ 类型	显示与分组（模型树脂 / 正畸树脂等）。
密度 g/ml	全链条换算枢纽：净重(g) ÷ 密度(g/ml) = 单件用料(ml)；支撑/表面废料(g) 同样经密度换算回体积。密度填错会整体扭曲材料成本。
单价	只读回显——在「区域与价格」① 材料价格表按区域维护（元/kg）。

为什么材料费看起来是「克重逻辑」

应用卡片填的是克（单件净重、支撑废料 g、表面废料 g），因为天平称的是克；材料按 kg 买。中间靠密度换算：材料费/件 = (净重 + 支撑废料 + 表面废料) ÷ 良率 ÷ 成功率 × 单价 ÷ 1000（完整损耗链见第 13 章）。

第 10 章工艺包

字段	含义与计算逻辑
名称	如「标准工艺包」，前台打印组合下拉显示「标准工艺包 · 50μm」。
层厚	打印层厚（μm）。影响打印时长（间接进节拍），也是客户可感知的精度档位。
摆放方式	平放/立放等摆板策略，影响单板件数上限与打印稳定性。

工艺包本身不直接产生成本，它是「打印组合」三维（打印机 × 材料 × 工艺包）中的一维：应用卡片把三维绑定成组合，前台按三维下拉切换。

第 11 章应用配置（品牌内）

位置品牌内侧边栏「🧩 应用配置」。这是成本数据的核心板块：每个应用在本品牌「怎么做、用多少料、走哪条产线」都在这里。

卡片口径区

字段	含义与计算逻辑
单件净重 g	覆盖应用库的全局默认；材料用量与废料换算的基准。
良品率	打印良品比例。需求件数 ÷ 良品率 = 需要打印的件数（良品率越低，打印越多，材料与机时越多）。
支撑废料 g / 表面废料 g	每件打印支撑与表面后处理的材料损耗（克），并入材料用量。
打印成功率（板级）	整板打印成功率。未配置按 100% 计；成功率 95% 意味着平均每板要打 1/0.95 次。失败重来消耗的是整板材料与机时。
启用开关	启用且卡片完整才会在前台出现。卡片不完整时开关被拦下并提示缺什么。

卡片五段组合

每个应用可配 5 段组合：前处理 → 打印 → 清洗 → 固化 → 分拣（打印段绑定打印机 × 材料 × 工艺包）。每段可以有多个组合（如清洗段同时配超声波机与手动清洗），其中一个是推荐组合（标 ✓，前台默认用它）。

组合配置项	含义与计算逻辑
每板件数	一块打印板摆几件。决定板数（板/日 = 需求 ÷ 每板件数），进而决定打印机台数与整板成功率的影响面。
单件用料 ml/件	显式指定单件材料用量；留空则按净重 ÷ 密度自动折算（与引擎同源）。填了以填的为准。
清洗液 L/件	每件消耗清洗液升数 × 清洗液单价 = 清洗液成本/件；留空走清洗机「换液间隔」折算。
固化消耗 L/件 + 氛围	固化环节每件消耗的保护气体/介质升数 × 所选氛围单价 = 氛围成本/件。选「无固化」则两皆为零。
批容量 / 稼动率覆盖	按应用覆盖设备的批容量与稼动率（如小件可一次固化更多）。
步骤覆盖	按应用覆盖设备步骤耗时（同一台清洗机，精密件洗更久）。列表里灰框的就是被覆盖值。

批量启用/停用

列表页顶部提供批量勾选（「全选（两组）」等），一次性启用/停用多个应用——适合新品牌初始配置或整体下线某类应用。

第 12 章应用检查

状态	含义与处理
完整	卡片配齐，前台可正常计算。绿色。
有提示	可算但有兜底项（如成功率未配置按 100%）。建议点开逐项补齐。
不可算	缺关键项（打印机 / 材料 / 每板件数等）。前台不可见、不可算。点击直接跳到对应卡片补齐。

推荐节奏

每次批量改完配置（新增应用、换设备、调组合），先来这里做一次体检再收工——「不可算」的应用销售端是静默消失的，体检是唯一能主动发现它们的入口。

第 13 章计算逻辑详解

前台展示的 CPP 由四个分项构成（与报告四色一致）：

CPP = 材料 + 耗材 + 人工 + 费用
材料 = material · 耗材 = consumable（清洗液/随机耗材/固化氛围）· 人工 = labor · 费用 = fee（设备获取+软件+其他月固定）

① 损耗链：需求 → 打印件数

打印件数 = 需求件数 ÷ 良品率 ÷ 成功率 + 支撑废料 + 表面废料
支撑/表面废料按克计，随净重一起参与材料量换算；成功率是板级概率（1/0.95 = 平均重打 5%）

② 材料分项

单件用料(ml) = 组合显式 ml/件（若填）否则 = (净重g + 支撑g + 表面g) ÷ 密度 g/ml
材料/件 = 单件用料(ml) × 密度(g/ml) × 材料单价(元/kg) ÷ 1000

③ 耗材分项

耗材/件 = 清洗液(L/件 × 单价) + 换液折算(槽容×单价÷换液间隔) + 随机耗材(按驱动因子) + 固化氛围(单价 × L/件)

④ 人工分项

时薪 = 区域口径（时薪制直取 / 月薪制 = 月薪 ÷ 月标准工时 ×(1+附加率)）
单件人工工时 = Σ 各环节人工步骤耗时 ÷ 每板件数（自动步骤 = 0）
人工/件 = 单件人工工时(h) × 时薪(元/h)

⑤ 费用分项（固定成本分摊）

月固定成本 = Σ 设备 [ 买断: (购置价+装机费)÷折旧年限÷12 ｜租赁: 月租(或年租÷12) ] + 年维护÷12
+ 软件按月费(或按年费÷12，按件费除外) + 其他月固定项
费用/件 ≈ 月固定成本 ÷ 月产量（月产量 = 波峰日产量 × 月工作天数）

⑥ 节拍与设备台数

板/日 = 需求 ÷ 每板件数 ÷ 良品率 ÷ 成功率
台数 = ceil( 日机时需求 ÷ (班次×班时 × 稼动率) ) （清洗/固化按批容量折算批次数）
人员 FTE = Σ 人工工时 ÷ 月标准工时

⑦ 汇率与币种

显示金额 = 基准金额(CNY) ÷ 汇率(外币→CNY) · 计算口径不变，仅显示换算

排查口径问题的固定顺序

① 材料不对 → 查卡片净重/废料与材料密度、单价表；② 耗材不对 → 查 L/件、换液间隔、耗材驱动因子、氛围单价；③ 人工不对 → 查区域人工口径与设备步骤「自动/人工」标注；④ 费用不对 → 查「区域与价格」该设备的获取方式、价格、折旧年限、年维护。最后用「应用检查」排除不可算兜底项。

第 14 章常见维护任务清单

新增一个应用

「📋 应用库」新增：名称（中英）、ID、大类、全局净重与后备良品率。
到目标品牌「🧩 应用配置」找到该卡：填品牌口径（净重/良品率/废料/成功率）。
逐段配组合：打印段绑定打印机 × 材料 × 工艺包；清洗/固化/分拣按需；标推荐组合。
填组合参数：每板件数、单件用料（可留空自动折算）、清洗 L/件、固化 L/件。
打开「启用」→ 到「🔍 应用检查」确认变为「完整」。

上架一台新设备

品牌内对应分类「＋新增」：型号、幅面、步骤构成（自动/人工 + 耗时）、自动化标志。
到「🌍 区域与价格」② 设备价格表：给每个区域录获取方式/价格/装机费/年维护/折旧年限。
有随机耗材的，到 ④ 耗材表录单价与驱动因子。
到用到它的应用卡片把组合指向新设备（或新增一个组合并设推荐）。
「应用检查」体检 + 前台实算一列验证。

新增一个报价区域

「🌍 区域与价格」＋新增区域：命名、绑币种（自动复制首列价格作起点）。
逐表核对四张价格表的新列——复制的值不是该区域真实价。
维护该区域人工口径卡（计薪方式/月薪/附加率/月标准工时）。
若新币种：到「全局设置 → 汇率维护」确认该币种汇率已同步。

年度例行：换价

只改「区域与价格」，不碰品牌参数页（那里只读）。
改完看顶部版本号 +1、变更日志有记录。
通知销售强刷前台页面（Ctrl+Shift+R）；在线页面 1~2 秒内会自动收到推送。

上线检查单

□ 默认口令已修改　□ 「区域与价格」无 0 占位价（或已知会偏低）　□ 「应用检查」无「不可算」　□ 各区域人工口径已按当地实况填写　□ 操作者名字已填写（审计可追溯）　□ 备份可用（恢复过一次演练）

齿科 3D 打印 · 综合成本对比计算器 — 后台配置操作手册 · v2.9 · 2026-09 ｜配套：《销售前台与报告操作手册》