功能与参数
伊尔萨，参数。
只写能被验证的数字与边界。现役版本、三端技术栈、AI / 支付 / 报表口径、安全约束与未交付项，都在这一页。
口径：以仓库与 2026-10 生产记录为准；截图与演示数据不计入参数。
Core
核心
一套面向连锁洗衣门店的经营系统：总部管理、店员作业、会员自助、经营分析，共用一套订单与资金口径。
- 产品形态
- 私有部署的连锁洗衣门店经营系统当前为一套 Linux 生产栈 + 多端，不提供 ARM / X86 / Cloud 三形态产品线
- 产品版本
- v0.9（2026-10）ClerkPad 0.9.1 / Uniapp 1.0.1（101）/ MCP 0.1.0 / Admin vab admin-plus 10.2.0
- 在役规模
- 3 家门店 · 25 个品类 · 278 个服务2026-10 生产数据；不公开单店经营额与会员明细
- 后端
- .NET 10 LTS · Furion · SqlSugar2026-10-20 完成 Linux + .NET 10 生产切换
- 数据库
- SQL Server 2022 Express生产容器；订单、会员、支付、退款、审计同库
- 缓存
- Redis缓存与登录态辅助
- 接入
- Nginx + HTTPS · JWT管理后台同源反代；店员端独立静态站；会员端微信小程序
- 支付
- 余额结算 / 二维码 / 现金 / 微信 / 支付宝微信支付 v3、支付宝当面付；回调验签、幂等入账、扫码对账 Job
- AI
- 阿里云百炼 qwen3-vl-plus单图多件、归一化 bbox（0–999）、逐件识别；失败可手动补选
- 报表
- 日报 / 周报 / 月报 · schemaVersion 5支付时间归属；现金对账；员工业绩/提成；TXT / HTML / XLSX；邮件 + OSS
- 只读 MCP
- 订单 / 会员 / 统计 / 现金 / 业绩 / 周期报表零写接口；手机号打码；JSONL 审计；36 项离线测试
- 测试
- 报表 44 项 · MCP 36 项 · ClerkPad 构建通过报表测试使用合成快照，不触网；MCP 离线测试不依赖生产登录态
ClerkPad
店员 Pad
门店高频作业端，浏览器运行，手机与平板双端适配；核心是“收衣快、核验准、按件可追”。
- 版本
- 0.9.1
- 技术栈
- Vue 3.5 · Vite 6 · Pinia · Vue Router · Axios · qrcode
- 页面
- 刷脸登录 / 密码登录 / 工作台 / AI 收衣开单 / 订单列表 / 订单详情 / 会员确认 / 个人中心
- AI 收衣
- 单图多件 · bbox 定位 · 逐件裁剪留证 · 逐件编辑服务/规格/颜色识别失败降级手动开单；风险告知与顾客告知可留档
- 分类
- 大类 / 品类 / 项目 / 规格四级联动项目默认规格；开单与订单详情共用同一套目录
- 订单动作
- 核验 · 改价 · 改服务 · 补拍 · 备注 · 回滚核验 · 取消 · 退款
- 逐件流转
- 逐件上挂 / 取走 / 送达 · 部分完成支持整单动作与按件动作；明细写 CompletedNumber / RackedNumber
- 收款
- 扫码收款 · 会员充值 · 储值扫码支付回调自动推进订单；跨店账号按当前门店落账
- 格架
- 按类别优先 · 通用回退 · 剩余容量排序同一订单多类别共享已占容量，避免超占
- 设备
- 手机 / 平板浏览器 · 390px 起适配iOS Safari 触屏输入统一 16px，避免聚焦放大
- 安全
- 120 秒自动锁定 · 密码登录 · 刷脸登录（灰度）系统锁屏/切后台/刷新按策略锁定；本地清 token
Admin
总部后台
总部配置与运营管理面；当前工程基于 vab admin-plus 二次开发，业务页面源码不随仓库分发。
- 框架
- Vue 3 · Element Plus · Pinia · Vue Router · EChartsvab admin-plus 10.2.0
- 门店
- 多门店建档 · 门店状态 · 门店列表
- 服务
- 服务项目 · 分类 · 规格 · 价格 · 会员价25 个分类、278 个服务（2026-10）
- 会员
- 会员检索 · 等级 · 折扣 · 余额 · 充值 · 退卡 · 地址 · 发票
- 订单
- 查询 · 状态 · 退款 · 退款状态 · 操作日志
- 资金
- 储值 · 支付 · 扫码对账 · 现金流水 · 统计
- 权限
- 角色 · 菜单 · 账号 · 门店数据范围默认本店；跨店/轮岗角色可看全连锁
- 审计
- 登录日志 · 订单操作日志 · 打印日志
Member
会员小程序
会员自助触点：拍照下单、订单与照片、储值、地址、发票、优惠券和积分；不替代门店端，和门店共用会员账。
- 版本
- 1.0.1 / versionCode 101
- 技术栈
- uni-app 3 · Vue 3.4 · Vite 5 · Pinia
- 构建目标
- 微信小程序（主）· 支付宝小程序构建脚本保留
- 下单
- 拍照 AI 识别 · 服务/规格选择 · 门店选择 · 收衣/送还信息
- 订单
- 订单列表 · 订单详情 · 状态 · 洗前照片
- 会员
- 登录 · 个人中心 · 储值充值 · 充值/消费记录 · 积分 · 优惠券
- 资料
- 地址管理 · 发票抬头 · 开票申请 · 开票记录 · 换绑手机 · 注销
- 门店
- 门店列表 · 服务/商品浏览
Data
数据与 MCP
报表负责“把账对上”，MCP 负责“把数查出来”。两者都从同一套生产数据出发，但权限边界不同。
- 报表周期
- 日报 · 周报 · 月报 · 当日速报定时生成；输出 TXT / HTML / XLSX；邮件 + OSS 归档
- 金额归属
- 按支付时间归属余额扣款单列，不重复计入现金；订单创建日口径只作后台对照
- 现金公式
- 净现金 = 新增储值 + 扫码类 + 现金 − 现金流出退款扫码类含二维码 / 微信 / 支付宝；余额退回不是现金流出
- 对账守门
- 退款双源互校 · 跨店勾稽 · 未归因残差 = 0.00快照过期、字段缺失、完整性校验失败时拒绝出报
- 员工业绩
- 储值业绩 · 流水业绩 · 月报提成储值 10% + 流水 5%（以实际配置为准）；退卡 LIFO 冲减
- 快照
- 只读采集 · HMAC-SHA256 · 批次幂等采集器与报表服务分离；失败不产出半份报表
- MCP
- 只读查询工具集订单搜索/详情、会员搜索/详情、经营统计、现金流水、员工业绩、周期报表
- MCP 安全
- 零写接口 · 手机号打码 · JSONL 审计密码只存本机 Keychain；令牌文件 0600；工具调用与 API 请求均留痕
- 测试
- 报表 44 项 · MCP 36 项报表使用合成快照；MCP 离线测试不触网
净现金 = 新增储值 + 二维码 + 现金 + 微信 + 支付宝 − 现金流出退款
余额扣款单列 · 退款以退款流水为准 · 未归因残差必须 0.00
余额扣款单列 · 退款以退款流水为准 · 未归因残差必须 0.00
Security
安全
支付、会员余额与经营数据是系统的核心资产。以下控制项来自现役实现与部署记录。
- 身份
- JWT · 图形验证码 · 登录日志刷脸登录为灰度能力，密码登录保留兜底
- 权限
- 角色 / 菜单 / 账号 · 角色级门店数据范围默认本店；跨店角色显式开启；门店账号不是超管
- 支付
- 微信 / 支付宝回调验签 · 金额服务端取值 · 幂等入账支付单条件抢占；失败整体回滚；扫码对账 Job 防回调丢失
- 报表链路
- HMAC-SHA256 · 快照新鲜度 · 批次幂等文件权限 0600 / UMASK 0077；经营数据不进 Git
- 只读 MCP
- 仅 GET · 手机号打码 · 审计 JSONL写接口零封装；令牌 0600；密码只存 Keychain
- 密钥
- 配置与密钥不入库部署密钥、支付密钥、OSS AK 仅存生产环境
- 本站
- 无统计脚本 · 无外部 CDN · 无外部字体所有资源本地相对路径；不收集访问者信息
Boundaries
边界
以下内容要么尚未交付，要么不属于当前产品范围。官网不把规划写成现役。
| 项目 | 状态 | 说明 |
|---|---|---|
| 洗后寄存（U衣库） | 规划 | 方案、系统改造与经营测算完成；尚未排期实施，不作为现役能力承诺。 |
| 被扫收款 | 规划 | 顾客出示付款码、店员扫码收款；可行性调研与交互演示完成，尚未排期。 |
| 刷脸登录 | 灰度 | 已在部分门店/人员灰度，密码登录保留；不宣称全员可用。 |
| ARM / X86 / Cloud 多形态 | 不适用 | 伊尔萨当前只有一套 Linux 生产栈；没有多形态产品线，官网不硬写。 |
| 开源许可 | 私有 | 仓库为私有商业系统，未附开源许可证；官网只做产品介绍，不提供源码下载。 |
“规划”不代表交付时间；“灰度”不代表全员可用。需要明确时间表时，以项目排期为准。