手册总览 · 系统地图与阅读顺序

潜龙元创由「一个账号 + 三套系统」组成：官网商城负责卖货与收款，ERP 负责企业内部进销存与财务，协同办公套件（元语消息 / 人事考勤 / 财务记账 / 零售 POS / VibeTalking / 应用矩阵）负责把人和流程连起来。三者共用同一套基础账号。

一、系统地图

二、手册目录

三、阅读约定

四、开始之前

1. 一个可用的基础账号：在 sign-up.html 注册，密码至少 8 位。它是所有系统的通用身份证。
2. 若要用 ERP：一张以 01127 开头的企业券码，以及营业执照图片（不超过 5MB）。
3. 若要在商城买东西：先开一张 HDCard 并完成充值（1 元 = 1 元余额，积分 1 分 = 1 元可抵扣）。
4. 若要卖东西：用二类户 HDCard 完成商户入驻，再发布商品。

快速开始：从注册到第一单

这一章把「第一天要做的事」串成一条线。按顺序做完，你会拥有：一个能登录全站的基础账号、一个开通好的 ERP 企业、一套基础档案、一张确认入库的采购单、一张确认出库的销售单，以及一笔能核对的收款。

第 1 步：注册基础账号

打开 sign-up.html，填写下表后提交。

第 2 步：开通 ERP 企业

1. 先确认浏览器里已是基础账号登录状态（未登录会被拦下，提示「请先登录潜龙基础账号」）。
2. 打开 erp/register.html，页面会自动读取你的基础账号。
3. 填写企业资料：企业名称（至少 2 字）、统一社会信用代码（18 位数字/大写字母）、法人身份证（18 位）、联系电话、登录密码（至少 6 位）、企业券码、营业执照图片。
4. 提交后自动跳转 ERP 首页，你的企业就建好了。

关键校验规则：

第 3 步：按顺序建立基础档案

顺序很重要：仓库和分类要先有，商品才能建档；商品有了，采购销售才能选到货。

第 4 步：跑通第一张采购单

1. 采购 → 采购订单 → 新建采购单。
2. 选择供应商、入库仓库，添加明细行（商品 + 数量 + 单价）。
3. 点「保存」，单据状态为草稿/待处理。
4. 点「确认」——状态变为已入库，系统同时在「库存流水」写入一条采购入库记录，库存数量增加。

验证：库存 → 库存查询，刚采购的商品数量应该已经增加。

第 5 步：跑通第一张销售单与收款

1. 销售 → 销售订单 → 新建销售单，选择客户、出库仓库，添加明细。
2. 点「保存」，再点「确认」——状态变为已出库，库存流水写入销售出库，库存减少。
3. 财务 → 收付款 → 收款，选择往来单位（客户）、填写金额，可关联上面那张销售单。
4. 对账：客户 → 客户对账单 选择客户与期间，能看到期初、本期明细、期末应收。

第 6 步：上线后的第一批核对

1. 报表 → 经营看板 看销售额、毛利、回款与库存资金占用是否合理。
2. 客户 → 客户对账单 与 报表 → 供应商对账单 核对期初、本期明细、期末是否一致。
3. 库存 → 库存流水 按类型筛选，确认采购入库、销售出库、盘点调整的记录都对得上。

上线检查清单

• 基础账号可登录 mine.html，消息中心能收到系统通知
• ERP 能用基础账号免密进入，也能用 ERP 账号密码登录
• 仓库、分类、商品、供应商、客户、资金账户都已建立
• 采购单确认后库存增加、销售单确认后库存减少
• 收款登记后客户对账单金额与预期一致
• 员工账号已建立并分配了正确角色（不是所有人都给 admin）
• 如需商城：商户已绑定、商品已导入、库存已同步

账号与登录：一套身份，处处通行

潜龙元创所有系统的身份只有一个源头：基础账号。ERP 账号、商户账号、员工档案都挂在它下面，因此只要基础账号是登录状态，多数系统可以免密进入。

一、五种身份的区别

二、注册与登录

基础账号

1. sign-up.html 填用户名、密码（≥8 位）、邮箱、验证码，勾选协议后提交。
2. 注册成功即自动登录，登录态默认保留 45 天。
3. 之后在 login.html 用「用户名 + 密码 + 图形验证码」登录。

ERP

三、员工端（人事考勤）绑定

员工打开 hr/portal.html 时，必须先登录基础账号，否则只能看到「请先登录潜龙基础账号」的门禁页。管理员在 hr/index.html → 员工管理 → 新增员工 时提供三种建档方式：

员工首次用 ERP 账号进入员工端时，系统还会自动为该企业开通人事系统、建好员工档案，并把同事之间的关注关系打通，可直接在元语消息里私聊。

四、商户账号

1. 在 mine.html → 商户入驻 填写：商户姓名、身份证号、商户账号名、商户登录密码（≥6 位）、商户简介，并选择一张二类户 HDCard 作为收款卡。
2. 提交即生效（无人工审核），之后在 merchant.html 用「商户账号 + 商户密码」登录。
3. 商户账号与基础账号是两套凭据：商户密码只在商户工作台与券码核销时使用。

五、平台后台（admin.html）

平台方使用，与商户、企业数据分开。主要能力：

六、会话、退出与安全

• 各系统的登录态独立保存，但基础账号登录态是打通其余系统的钥匙。
• 基础账号登录失败次数过多会被限流，提示「该账号尝试过于频繁，请 N 秒后再试」；ERP 登录连续失败会提示「登录失败次数过多，请 5 分钟后再试」。
• 共享电脑上离开前，请依次退出 ERP（右上角账号 → 退出登录）与基础账号（mine.html 退出）。

七、账号相关报错对照

ERP 基础档案：商品、仓库、供应商、客户

基础档案是所有单据的地基。档案建错，后面每一张单据都会跟着错，所以第一个月请把这一章走三遍再开始录业务。

一、商品分类与计量单位

建议分类不超过两层（如「原材料 / 包装材料」），层级太深会让报表难以阅读。

二、商品档案

商品 → 商品档案 → 新增商品，字段如下：

三、仓库与库位

四、供应商档案

• 采购 → 供应商档案 → 新增供应商：供应商编码 + 名称必填，可补联系人、电话、结算方式。
• 采购 → 供应商分类：把供应商分组（如「包材」「外协」），用于采购报表筛选与限价策略。

五、客户档案与客户运营

客户档案建议填写等级与授信额度：等级用于差异化价格，授信额度用于控制赊销风险。

六、价格策略

商品 → 价格策略（入口为 CRM 客户中心 → 价格体系）用于按客户等级或商品批量设定销售价。设置后新建销售单会自动带出新价格，避免业务员手工改价。

七、档案页的通用操作

所有档案页顶部与行内操作保持一致：

• 搜索框：按名称/编码模糊查找。
• 筛选：下拉筛选（客户页支持按等级筛选）。
• 新增XX：弹出表单，必填项标红星。
• 行内 编辑 / 删除：删除会被已有单据引用的档案将失败，此时请改为「停用」。
• 导出：导出当前筛选结果为 CSV，可直接用 Excel 打开。

八、常见问题

ERP 采购与销售：单据怎么走、钱怎么收

ERP 的交易单据遵循同一个骨架：建单 → 保存 → 确认（过账）→ 收付款 → 对账。保存只是草稿，确认才会动库存。

一、采购全流程

采购侧的辅助工具：

二、销售全流程

退货与换货：

• 销售 → 销售退货：新建退货单并确认，库存回补、应收冲减。
• 销售 → 销售换货：一退一换同时处理，避免出现「先退货再下单」的两次库存波动。
• 采购 → 采购退货：把货退回供应商，库存减少。

促销与价格：销售 → 促销规则 可配置满减、折扣、赠品等规则，下单前可用「试算」验证效果。

三、收付款登记

财务 → 收付款 是同一条流水账的正反两面：

相关的还有：财务 → 资金账户（账户与期初余额）、财务 → 资金转账（账户间互转）、财务 → 费用报销（走审批）、财务 → 借款还款、财务 → 银行对账（标记勾兑）、财务 → 往来调账（红冲/调整）。

四、对账单怎么读

对账单输出三列：期初余额 → 本期明细 → 期末余额。

• 应收对账：客户 → 客户对账单，期末为正表示客户还欠你钱。
• 应付对账：报表 → 供应商对账单，期末为正表示你还欠供应商。
• 数字对不上时，先看是否漏登记收付款，再看是否有未确认的单据（未确认单据不进对账）。

五、和审批流的配合

管理员可在 系统 → 系统设置 → 审批流程 为单据类型配置多级审批（报价、销售订单、销货单、销售退货、收款单、采购订单、采购入库、采购退货、调拨、报损、工单、委外等）。

配置后，单据提交会进入「待审批」，审批人在 协同 → 审批中心 处理，通过后才允许确认过账。

六、单据通用操作

七、常见问题

ERP 库存与仓储：让账面数量等于实物数量

库存只由「单据确认」和「盘点」改变。只要所有人遵守这一条，账实就能长期对得上。

一、库存中心

库存 → 库存中心 内按页签切换，每个页签就是一页独立功能：

二、仓内作业

三、盘点标准动作

1. 库存 → 库存中心 → 库存查询，用仓库筛选出要盘的仓。
2. 点 库存盘点，列表会带出账面数量。
3. 逐条录入实盘数量，差异会实时显示。
4. 点 提交盘点，系统生成盘点调整记录：盘盈加库存、盘亏减库存，并写库存流水。
5. 复核：在 库存流水 按「盘点调整」筛选，确认调整条数与金额。

四、库存预警

商品档案里的「安全库存」（默认 10）决定预警线。

• 库存查询 勾选 仅看预警 只显示低于安全库存的商品。
• 报表 → 库存呆滞 帮你看长期不动的库存，两者结合可用于补货与清仓决策。

五、批次与序列号

六、常见问题

ERP 财务、发票与报表

ERP 的财务是「业务驱动」的：销售出库产生应收、采购入库产生应付、收付款登记完成核销。你不需要手工做分录，但需要知道钱和账在哪里对齐。

一、日常收付款

二、总账

建账顺序：会计科目 → 资金账户 → 期初余额 → 日常凭证。

三、财务中心报表

总账 → 财务中心 提供四张常用表：

四、发票管理

从电子税务局取票

发票台账右上角 电税导入 支持把电子税务局的数据直接倒进台账，不用逐张手工敲：

1. 登录电子税务局 → 我要办税 → 税务数字账户 → 发票查询统计 → 全量发票查询，选好期间与票种后点 导出；
2. 导出文件另存为 CSV（或直接在表格里框选复制），回到系统点 电税导入，粘贴或选文件；
3. 点 解析预览 确认列识别无误，再点 导入台账。

系统会自动按列名识别发票号码、开票日期、销方/购方、金额、税额、票种与状态，并按 发票号码 + 方向 幂等入库：重复导入只更新金额与状态，不会重复记账。方向判定优先用 发票 → 开票设置 里的本企业纳税人识别号：本企业是销方记销项，是购方记进项。红字发票自动标为作废，不计入税额统计。

服务商接口直连（免手工导出）

发票 → 开票设置 页下方「发票采集服务商」可配置渠道，配好后 发票台账 的 服务商拉取 直接按期间把票取进台账：

字段映射已兼容常见英文键（invoiceNo / invoiceDate / sellerName / buyerName / totalAmount / taxAmount / invoiceStatus 等），服务商若返回「分」为单位可在渠道里选「分（自动 ÷100）」。厂商接口字段差异较大时，优先在渠道里改 base_url、进出项 method 与扩展参数，不必改代码。

五、经营报表与看板

报表 → 经营看板 是老板每天看的一页：销售额、毛利、回款、库存资金占用。更细的分析在 报表 → 报表中心：

六、月结建议流程

1. 停止开新单，确认所有单据都已「确认」（不留草稿）。
2. 做一次全仓盘点，处理差异。
3. 登记所有收付款，核对 客户对账单 与 供应商对账单。
4. 审核当月凭证，核对 利润表 与 应付账龄。
5. 导出 报表中心 各表归档，生成 经营日报 留档。

七、常见问题

ERP 生产与委外：从 BOM 到完工入库

制造业客户才会用到本章。如果你只做贸易，可以跳过，直接看 库存与仓储。

一、BOM（物料清单）

生产 → BOM → 新建 BOM：

1. 选择产出成品与生产数量（如 1 个成品）。
2. 添加用料明细：原材料 + 用量 + 损耗率。
3. 保存后 BOM 可用于工单领料与 MRP 运算。

二、生产工单

三、MRP 运算

生产 → MRP：按销售订单、库存、BOM 与在途量算出「该生产什么、该采购什么」。

1. 选择运算范围（期间 / 产品）。
2. 执行运算，系统给出建议生产与建议采购清单。
3. 点 生成工单 把建议生产转为生产工单，采购需求可转到 采购 → 采购订单。

四、委外加工

五、成本与差异

• 生产领料按原材料成本计入工单成本。
• 完工入库按工单归集成本，形成成品成本价。
• 若采购价格波动大，可用 采购 → 暂估成本 先入账，后续调整差异。

六、常见问题

ERP 系统设置：账号、权限、审批与自动化

这一章决定「谁能做什么」。花十分钟配好，可以省掉后面三个月的越权事故。

一、账号管理

系统 → 系统设置 → 账号管理 → 新增账号：

• 新建、修改、停用账号仅 admin 可操作，且不能停用或删除自己。
• manager 可以查看账号列表，但不能改密码或改角色。

套餐与续费（券码生命周期）

企业开通与续期都靠商城订单里发出的券码，规则如下：

• 所有券码都必须能在主站 订单表 的「物流单号/券码」里查到，且一张券码只能核销一次；订单状态含「退款/取消」的券码不可用。
• 续费入口有两个：系统设置 → 套餐与续费（正常使用时），以及账号到期后登录时出现的续费面板（此时其它功能全部不可用）。
• 未过期续费在原有效期上顺延；已过期续费从续费时刻重新起算。
• 01128 企业到期前 3 天会收到站内通知（元语消息中心），到期后系统自动注销并清空该企业所有 ERP 业务数据，台账里保留一条 purge 记录便于追溯。
• 平台内部企业（id=1）标记为 internal，不受有效期与续费规则约束。

二、角色与权限

内置四个角色可直接用；需要更细的边界时，在 系统设置 → 角色与权限 新建自定义角色，勾选权限组并设置数据范围：

默认权限矩阵（写操作）：

三、审批流程

系统设置 → 审批流程（仅 admin）按单据类型配置层级：报价单、销售订单、销货单、销售退货、收款单、采购订单、采购入库、采购退货、调拨、报损、生产工单、委外单。

配置后：提交单据 → 待审批 → 审批人在 协同 → 审批中心 处理 → 通过后才可确认过账。没配置审批的单据，确认即生效。

四、单据编号规则

系统设置 → 单据编号 可改每类单据的前缀与流水位数，例如把销售订单改为 XS + 8 位。修改只影响新单据，历史单号不变。

五、打印模板

系统设置 → 打印模板 维护单据打印样式（可设默认模板）。销售单、采购单等页面点「打印」时使用对应模板。

六、操作日志

系统设置 → 操作日志 记录谁在什么时间做了什么（登录、确认单据、删除、改价等）。排查「库存为什么少了」「价格谁改的」先看这里。

七、AI 功能工厂（低代码）

系统 → AI 功能工厂（#/lowcode）可以在不改代码的前提下新建自定义模块：定义字段、列表、表单，然后生成菜单（路由形如 #/lc/你的模块 key）。适合审批台账、设备清单、合同管理等「ERP 没有但需要录」的数据。

八、我的偏好

系统设置 → 我的偏好：设置默认仓库、列表每页条数、语言与主题等个人习惯，只影响自己。

九、常见问题

商城买家指南：从下单到退款

商城只有一条购买路径：浏览 → 立即购买 → HDCard 支付 →（实物等收货 / 电子券看券码）→ 确认收货 → 拿返积分。全程用基础账号 + HDCard 完成，不涉及银行卡与第三方支付。

一、找货与收藏

1. 打开 store.html，用顶部搜索框或分类按钮筛选。
2. 商品卡上点 了解详情 进入 product-detail.html，可查看完整介绍。
3. 点星标 收藏 加入收藏，去 favorites.html 统一查看与取消。

二、下单

1. 商品卡点 立即购买，弹出「商品名 — 选择规格」。
2. 选择具体规格（对应一条细商品），点 立即购买。
3. 系统创建订单，状态为未支付，库存立即扣减，并提示订单号。
4. 页面跳到 orders.html，订单卡上出现 HDCard支付 按钮。

三、用 HDCard 支付

1. 订单卡点 HDCard支付，弹窗列出你名下的 HDCard（显示卡尾号与余额）。
2. 选择一张卡，输入 6 位 HDCard 支付密码。
3. 填写收货信息：
• 实物（A 类）：收货人 + 收货地址 + 联系电话。
• 电子券（B 类）：只需联系电话，无需地址。
4. 点确认支付，成功后：
• 实物订单状态变待审核（等商户审核发货）。
• 电子券订单直接生成 15 位券码，可在订单里查看。

没有卡时会提示「暂无 HDCard」，点击引导去 HDCard/index.html 开卡并充值。

四、积分抵扣规则

• 1 积分 = 1 元，在支付时选择抵扣金额。
• 抵扣上限 = min（当前积分, 订单总额），也就是最多可以把订单抵到 0 元。
• 实付金额 = 订单总额 − 抵扣金额，从 HDCard 扣除。
• 若支付时积分已被其他订单用掉，系统会按最新积分修正抵扣额。

积分从哪来：

五、订单状态一览

六、订单动态会通知你

支付后不用一直刷页面，订单有变化系统会推通知（元语「通知」、VibeTalking 消息页、我的订单页都能看到）：

七、确认收货与返积分

实物订单在 orders.html 点 确认收货，成功后提示「已确认收货，返积分：X」。返积分同时会推一条「返积分到账」通知。

电子券订单不需要确认收货：商户在核销系统扫码核销后，订单自动变更为已完成。

八、电子券（B 类）怎么用

1. 支付成功后订单里会显示 15 位券码与条形码。
2. 到店出示券码（或条形码），商户在 verification.html 核销。
3. 核销成功后订单完成、积分返还。

九、申请退款

1. orders.html 找到订单（状态为 待收货 或 已完成），点 申请退款。
2. 填写退款原因（必填，最多 200 字），点 提交申请。
3. 订单卡上出现退款进度：退款单号、金额、原因、状态、商户回复。
4. 商户同意后，系统自动完成：
• 退款原路退回支付用的 HDCard（流水类型「退款」）
• 积分抵扣部分退回积分账户
• 已完成订单扣回已返积分
• 商品库存回补
• 订单状态置为已退款，并推送「退款已到账」通知

被拒绝时会显示商户给出的原因，可修改说明后点 重新申请退款。

十、消息与通知

• mine.html 首页「消息通知」卡片显示最近 4 条，点 查看全部 打开消息中心。
• 商城事件会推送：下单成功、付款成功、退款申请已提交、退款申请未通过、退款已到账、返积分到账。
• 元语消息（im/index.html）的通知中心能看到同一批通知，打工卡/审批等企业内部通知也汇总在这里。

十一、常见问题

商城商户指南：入驻、上架、发货、退款审批

商户侧只有三个工作区：merchant.html（商品与退款）、verification.html（审核发货与券码核销）、mine.html（入驻）。订单货款直接进入你绑定的收款 HDCard，没有单独的提现流程。

一、商户入驻

1. 登录基础账号后进入 mine.html，点 商户入驻。
2. 填写：

1. 勾选同意《免责声明》，点 提交入驻，提示「商户入驻成功！」即生效（无人工审核）。

二、登录商户工作台

打开 merchant.html，选择「商户登录」，输入商户账号名 + 商户登录密码。常见报错：

商户账号登录后，merchant.html 与 verification.html（核销台）都只显示本商户自己的订单与退款申请，看不到其他商户的数据；从平台管理端（admin.php）登录或管理员会话进入时才是全量视图。

三、发布商品：先粗后细

商城的商品是两级结构，必须先建粗商品（大类），再在下面挂细商品（具体规格）。

粗商品

商户商品管理 → 发布商品：填写商品名称、简介、分类等，提交时会自动进行 AI 合规检测：

• 通过：商品上架。
• 不通过：提示「AI 合规检测未通过，商品未上架」，并列出违规类别，修改文案后重新提交。

细商品

商户商品管理 → 粗商品管理 → 管理细商品 或 细商品管理：

四、订单审核与发货

订单审核与券码核销都在 verification.html（券码核销系统）里完成：

1. 打开 verification.html，选择 商户登录 并输入商户账号密码。
2. 在订单列表找到状态为待审核的订单。
3. 点 审核通过，在弹窗中填写物流公司 + 物流单号，确认后订单变待收货。
4. 需要时可用 查物流 查看单号，或 看券码 查看电子券信息。

五、券码核销

1. 买家到店出示 15 位券码或条形码。
2. 在 verification.html 点 扫码核销（用扫码枪）或 批量核销（手工输入券码）。
3. 确认后订单置为已完成，系统自动给买家返 3% 积分并推送通知。

六、退款审批

merchant.html → 经营工具 → 退款审核，四个页签：待审核 / 已退款 / 已拒绝 / 全部。

列表字段：退款单号、订单与商品、申请用户、退款金额、原因、状态、申请时间、操作。

同意退款

点 同意退款，确认后系统自动完成：

1. 退款金额原路退回买家的 HDCard，写一条「退款」流水。
2. 买家被抵扣的积分退回。
3. 若订单已完成，扣回此前返还的 3% 积分。
4. 商品库存回补。
5. 订单与申请状态置为已退款，通知买家「退款已到账」。

拒绝退款

点 拒绝，必须填写拒绝原因（否则提示「请填写拒绝原因」）。买家会收到「退款申请未通过」通知，并可补充说明后重新申请。

七、货款与结算

• 买家支付的款项进入你入驻时绑定的收款 HDCard 余额，可在 HDCard/record.html 查看「消费」类流水。
• 商城没有商户提现/结算台，资金在卡内可直接用于消费、转账或提现（按 HDCard 规则）。
• 退款时从该卡扣回，请保持卡内余额充足，否则退款会失败。

八、常见问题

HDCard 使用手册：开卡、充值、转账、查流水

HDCard 是潜龙元创内部的电子账户，商城的每一笔支付都从它扣款，商户的货款也收到它里面。可以把它理解成「平台内的银行卡」。

一、开卡

入口：HDCard/index.html（未登录会引导先登录或注册）。

HDCard/build.html 需要填写：

规则：

• 每人最多 3 张卡。
• 第 2 张起的姓名与身份证必须与一类户一致，不能开给别人。
• 卡号形如 HD + 时间戳 + 随机串，开卡后自动生成。
• 只有二类户可以作为商户收款卡。

二、充值

入口：HDCard/recharge.html。

1. 页面显示当前卡号与余额。
2. 输入充值金额，或点快捷金额 ¥50 / ¥100 / ¥200 / ¥500。
3. 输入 HDCard 密码，点 确认充值。
4. 成功后余额立即增加，流水记一条「充值」。

三、转账

在 HDCard 页面选择转账：

1. 选择转出卡并输入 6 位密码。
2. 输入收款卡号与收款人姓名，姓名必须与收款卡实名一致。
3. 提交后，转出卡记「转账」，收款卡记「转入」。

转错卡且对方拒绝退回时，平台无法强制划扣，转账前请核对卡号与姓名。

四、查流水

入口：HDCard/record.html，筛选按钮 全部 / 收入 / 支出。

每条流水包含流水号、交易金额、对方与备注，备注里通常带订单号，便于对账。

五、改密与注销

• 改密：在卡片管理里输入原密码与新 6 位数字密码。
• 注销：卡内余额必须为 0 才能注销，否则提示「请先将余额转出后再注销」。注销后不可恢复，历史上仍可查询该卡的流水。

六、与商城的关系

七、常见问题

应用矩阵：20 个开箱即用的 SaaS 应用

应用矩阵是挂在企业账号下的一批轻量业务应用。不需要单独注册，用 ERP 账号直接进入，数据按企业隔离。

一、进入方式

1. 登录 ERP 后，左侧导航 → 应用矩阵（或直接打开 apps/index.html）。
2. 首页按分组卡片展示全部应用，顶部搜索框可按名称过滤。
3. 点击卡片进入应用，地址形如 apps/index.html#/app/mes，可收藏或分享给同事。

二、生产工厂配套（6 个）

三、行业垂直（7 个）

四、工具型（7 个）

五、应用内的通用操作

所有应用的界面结构一致，学会一个就会用全部：

六、三个典型场景

场景 A：车间从派工到报工

1. MES 生产执行 → 生产工单 → 新增，填工单号、产品、计划数量、工作中心。
2. 在工单下建「工序任务」，逐道工序写明工序名称与作业员。
3. 生产完成后在「报工记录」新增：数量、合格数、不良数。
4. 回工单看「已完成」累计，配合 车间报工 统计计件工资。

场景 B：来料检验不合格怎么走

1. 质检 QMS → 检验单 → 新增，检验类型选「来料检验」，填送检数量与检验员。
2. 录合格数/不良数，结论选「不合格」。
3. 在「不合格处理」新增：缺陷类型、原因、处理方式（返工/让步接收/退货）、损失金额。
4. 需追溯时到 产品追溯 按批次反查同批原料还流向了哪些成品。

场景 C：物业月度收费

1. 物业收费 SaaS → 房屋档案 建好房间与业主。
2. 生成当月账单（物业费/水电费）。
3. 业主缴费后登记收款；未缴的在欠费列表发起催缴。
4. 月底看经营报表核对收缴率。

七、常见问题

元语消息与人事考勤

这两个系统解决「人找人」和「人到岗」两件事。它们与 ERP 共用企业数据：员工在 ERP 建档后，人事系统与元语消息里会自动出现这个人。

一、元语消息（im）

入口：im/index.html，用基础账号登录（与 VibeTalking、商城同一套身份）。

系统通知与商城、人事共用一张通知表（im_notify）。也就是说：在商城看到的消息，在元语的「通知」里也能看到，不会漏。

通知类型一览

二、人事考勤：管理端

入口：hr/index.html，用 ERP 账号登录。左侧共七个模块：

新增员工（三种绑定方式）

员工管理 → 新增员工，核心是「这个人怎么认领自己的档案」：

三、人事考勤：员工端

入口：hr/portal.html，底部五个页签：

打卡

1. 打开 hr/portal.html，确认首页显示「上班打卡」按钮。
2. 点 上班打卡，系统记录时间；下班同理点 下班打卡。
3. 迟到/早退按 考勤设置 的规则自动标记，管理端「考勤记录」可见。

请假

1. 员工端 审批 → 新建申请，选择请假类型与起止时间，填写事由。
2. 提交后进入「待审批」，管理员在 hr/index.html → 审批处理 处理。
3. 结果会同时出现在员工端「审批」与元语通知中心。

四、员工端注册

hr/register.html 用于创建员工端账号（工号 + 密码方式）。若企业采用手机号或基础账号绑定，则不需要单独注册，直接用基础账号登录员工端即可。

五、常见问题

财务记账、零售 POS 与 VibeTalking

这三个系统定位不同：财务记账是 ERP 财务模块的独立入口，POS 是门店收银台，VibeTalking 是技术社区。

一、财务记账（finance）

入口：finance/index.html。

它本身是一个登录门户：用 ERP 账号登录后直接进入 ERP 的财务模块，日常操作全部在 ERP 内完成，包括收付款、资金账户、费用报销、凭证、发票与报表（详见 ERP 财务与报表）。

二、零售 POS（pos）

入口：pos/index.html。不需要另设账号，它直接继承当前浏览器的 ERP 登录态；未登录时会跳回 ERP 登录页。

界面分三块：左侧扫码区与商品搜索、右侧购物车、底部结算区。

开单收银

1. 扫码枪扫商品条码自动加入购物车；没有条码时在搜索框按名称模糊搜索后点选。
2. 购物车可改数量、删除单品。
3. 需要优惠时在「整单优惠」输入金额或折扣。
4. 老客户点 选择会员 绑定客户，便于累计与赊销；点「散客」切回散客。
5. 按 F2 或点结算，选择支付方式并确认。

与 ERP 的关系

• 商品与价格来自 ERP 商品档案（商品条码字段很关键）。
• 收银完成会生成零售出库，扣减 ERP 库存，并进入销售报表。
• 因此 POS 上的价格调整上限受「最低售价」约束。

交班与对账

每个班次结束前，核对当日收银笔数与金额，与 ERP → 财务 → 收付款 的收款记录比对，差异当天查清。

三、VibeTalking

入口：VibeTalking/index.html，用基础账号登录。

日常操作：

1. 发帖：首页编辑框输入内容，提交后出现在内容流。
2. 关注：进入对方主页点 关注，其动态会优先展示。
3. 私信：进入对方主页或消息页发起会话。

四、常见问题

常见问题与报错对照表

按「报错原文」检索最快。找不到时按最后一节的排查顺序走一遍。

一、账号与登录

二、商城与订单

三、HDCard

四、ERP 单据与库存

五、商城与 ERP 联动

六、通知与消息

七、通用排查顺序

遇到「数据不对」时，按这个顺序排查，90% 的问题在前三步就能定位：

1. 看单据状态：是否只是保存了草稿，没点「确认」。库存与账务只认已确认的单据。
2. 看权限：当前账号的角色是否允许查看/修改这条数据（数据范围 all/dept/self）。
3. 看时间范围：报表按单据确认时间统计，筛的期间是否覆盖。
4. 看操作日志：ERP → 系统设置 → 操作日志，谁在什么时候改了什么一目了然。
5. 看库存流水：库存 → 库存流水 用类型筛选，能追到每一笔变动的来源单据。
6. 核对来源：商城相关的数字，先确认商城侧状态，再执行联动同步/回写，避免两边各算一遍。

八、仍然解决不了

请准备三样信息再联系支持，能显著加快处理：

• 出错页面的完整地址（含 # 后面的部分）
• 报错原文截图与发生时间
• 涉及的单号（订单号 / 退款单号 / 采购销售单号 / 卡号）