-
Notifications
You must be signed in to change notification settings - Fork 0
SYSTEM_USER_MANUAL
github-actions[bot] edited this page Apr 1, 2026
·
1 revision
适用对象：实验室全体用户（接待、样品、检测、审核、报告、质量、设备、管理员）
版本基线：当前仓库主业务实现（Django + Vue3）
目标：提供可直接落地执行的“从登录到全流程业务闭环”操作指南，并附扩展用法与故障预判
结构化索引：按分类共 42 篇的 Wiki 目录与阅读路径见 Wiki 首页（README）。
LIMIS 是面向实验室业务的综合管理系统，覆盖以下核心流程：
- 工程项目管理
- 委托受理与评审
- 样品登记、流转与追踪
- 检测任务、原始记录、结果管理
- 报告编制与审批
- 设备、人员、环境、耗材管理
- 质量体系（审核、评审、不符合项等）
- 用户、角色、权限、审计日志
系统采用前后端分离架构，统一接口前缀为 /api/v1/，前端菜单按权限动态显示。
以下为推荐职责边界，可按单位组织架构调整：
- 系统管理员
- 维护用户、角色、权限、操作日志
- 处理权限、账号、会话安全相关问题
- 接待/业务受理人员
- 新建委托、维护委托基础信息、触发评审流程
- 样品管理员
- 样品登记、样品状态维护、样品追踪
- 检测人员
- 执行检测任务、填写原始记录、提交结果
- 审核人员/技术负责人/授权签字人
- 对任务结果、报告进行审核/批准
- 质量负责人
- 内审、管理评审、不符合项管理、质量追踪
- 设备管理员
- 设备档案、检定/校准、期间核查、维护保养
- 前端地址：
/login - 账号密码由管理员分配
系统已启用以下安全策略：
- JWT 认证
- 登录失败限次（按
用户名 + IP） - 密码修改频率限制
- 会话版本控制（多设备踢出机制）
- 同一账号每次重新登录会更新会话版本，旧会话令牌将失效
- 管理员可在“用户管理”中对指定账号执行“踢下线”
- 被踢下线用户再次操作会收到“会话失效，请重新登录”
- 初始密码首次登录后立即修改
- 密码建议至少 8 位并包含大小写、数字、特殊字符
- 避免与旧密码重复
登录后默认进入“首页（Dashboard）”，左侧菜单包含：
- 业务管理：工程项目、委托、样品
- 检测管理：任务、记录、结果
- 报告管理：报告列表
- 资源管理：设备、人员、耗材
- 监控管理：环境
- 质量体系：基础配置、标准、参数库、模板、内审、评审、不符合项
- 系统管理：用户、角色、操作日志
注意：
- 菜单项按权限动态过滤，无权限时不显示
- 直达 URL 时也会经过路由权限校验
适用角色：管理员、业务管理人员、项目相关角色
常见操作：
- 新建项目：录入项目名称、参建单位、合同信息、见证单位等
- 查看项目详情：确认项目基础信息完整性
- 维护项目状态：按项目阶段更新
使用建议：
- 项目编号、名称应与纸质/合同台账一致
- 尽量避免同名项目造成后续委托归属歧义
适用角色：接待、审核相关角色、管理员
常见操作：
- 新建委托：填写委托单位、工程关联、检测需求、时效要求
- 编辑委托：补充缺失信息或纠错
- 评审流转：提交评审、审核通过后进入后续样品/检测流程
关键检查点：
- 委托信息必须与客户单据一致
- 检测项目/参数描述应明确，避免后续任务拆分偏差
适用角色：样品管理员、检测人员
常见操作：
- 样品登记：从委托关联样品，自动生成样品编号
- 样品详情：查看来源、状态、流转记录
- 样品追踪：根据状态定位当前节点
关键检查点：
- 登记时关联正确委托与项目
- 样品标识（编号/二维码）与实物一致
适用角色：检测人员、任务分配人员、审核人员
常见操作：
- 查看任务列表：按状态筛选待执行任务
- 打开任务详情：确认样品、检测项、时限、责任人
- 结果录入前检查：方法、参数、标准版本一致
关键检查点：
- 避免在任务信息不完整时直接录入结果
- 超期任务需在系统内备注原因
适用角色：检测人员、审核人员
常见操作：
- 新建原始记录：按任务关联模板填写数据
- 编辑记录：补充原始值、计算过程、结论项
- 复核记录：检查逻辑一致性、数值范围、单位
模板机制说明：
- 系统支持模板库与参数级 schema 合并能力
- 使用前应确认模板版本与检测方法匹配
适用角色：检测人员、审核角色
常见操作：
- 查看检测结果列表
- 对照原始记录核验结果准确性
- 进入审核/确认流程
关键检查点：
- 结果状态与报告状态应保持一致
- 修改结果属于敏感操作，建议建立严格审批
适用角色：编制、审核、批准、签发角色
常见操作：
- 报告列表查看与筛选
- 报告详情查看：来源任务、结论、状态、流转
- 提交审核/审批（按当前权限）
当前建议：
- 报告模板与审批链应先在测试环境走通再用于生产
- 报告对外发放前必须二次校对样品与结论一致性
适用角色：设备管理员、检测人员、管理员
设备列表常见操作：
- 新增设备
- 编辑设备
- 查看设备详情
- 删除设备（需谨慎）
设备详情常见操作：
- 新增检定/校准记录
- 新增期间核查记录
- 新增维护保养记录
关键检查点：
- 设备管理编号、型号、校准到期日必须完整
- 到期设备应及时预警并限制用于关键任务
适用角色：管理员、人事/质量负责人
常见操作：
- 人员信息维护
- 人员详情查看
- 与岗位、能力、授权信息进行对照
适用角色：库房管理、检测人员、管理员
常见操作：
- 耗材台账维护
- 入库/出库记录（按系统能力）
- 库存预警追踪（若启用）
适用角色：环境管理员、质量负责人、管理员
常见操作：
- 录入/查看环境监测数据
- 根据温湿度等指标判断检测环境合规性
质量体系入口：/quality/*
包括：
- 检测基础配置：
/quality/foundation - 标准规范：
/quality/standards - 项目参数库：
/quality/parameter-library - 原始记录模板：
/quality/record-templates - 报告模板：
/quality/report-templates - 资质管理：
/quality/qualification-profiles - 内部审核：
/quality/audit - 管理评审：
/quality/review - 不符合项：
/quality/nonconformity
常见操作：
- 新增/编辑标准
- 从工标网抓取标准元数据（如已配置）
- 删除历史无效标准
关键检查点：
- 标准号、发布日期、实施日期、状态信息需准确
- 标准替代关系（被替代/替代）应完整记录
常见操作：
- 参数库维护：统一检测参数口径
- 原始记录模板维护：字段、计算项、显示规则
- 模板与任务联动预览：确认填报结构正确
关键检查点：
- 参数名、单位、范围统一
- 模板变更需评估对在途任务的影响
常见操作：
- 内审计划与记录
- 管理评审事项闭环
- 不符合项登记、整改、验证、关闭
关键检查点：
- 每个问题必须有责任人和期限
- 闭环必须可追溯
管理员操作：
- 新增用户
- 编辑用户
- 重置密码
- 启用/禁用账号
- 踢下线（会话失效）
- 删除用户
建议流程：
- 新建账号并分配角色
- 用户首次登录后强制改密（组织制度层面）
- 离职/调岗账号及时禁用或删除
管理员操作：
- 新增角色
- 编辑角色权限
- 删除角色（确认无人使用）
建议：
- 使用“最小权限原则”
- 先在测试账号验证权限后再大规模分配
可筛选字段（当前已支持）：
- 用户名
- 方法（GET/POST/PUT/PATCH/DELETE）
- 路径（模糊）
- 状态码
- 时间范围
- 幂等键/是否重放
使用场景：
- 排查误操作
- 审计合规取证
- 排查接口异常高发路径
系统采用两层控制：
- 后端模块权限（RBAC + 模块动作）
- 前端菜单/路由/按钮权限（
v-permission+ 路由meta.permission）
常见现象：
- 看不到菜单：通常是无查看权限
- 能看列表但无新增按钮：通常缺创建权限
- 点击报无权限：后端权限校验拒绝
排查建议（管理员）：
- 检查用户角色是否正确
- 检查角色绑定权限码是否齐全
- 用户重新登录后再验证（权限缓存刷新）
以下为“可扩展/推荐扩展”的能力方向与使用建议。
建议能力：
- 站内消息 + 邮件 + 企业微信
- 事件触发（待评审、待审批、设备到期、不符合项临期）
使用方式建议：
- 仅推送“待你处理”事件
- 允许用户自定义通知频率和渠道
建议能力：
- Word/PDF 导出
- 电子签章、数字签名、二维码验真
使用方式建议：
- 发放前自动校验签章状态
- 归档报告不可随意修改
建议能力：
- 检测量趋势
- 合格率分析
- 按项目/检测项/时间维度分析
使用方式建议：
- 设定统一口径，避免不同部门“统计口径不一致”
建议能力：
- 样品扫码查询
- 报告二维码验真
- 移动端任务处理
- 任何流程开始前先确认权限和角色
- 录入信息必须对照原始单据
- 对“删除、禁用、踢下线、改结果”等敏感操作先二次确认
- 编号唯一、命名统一
- 日期格式统一（建议 YYYY-MM-DD）
- 数值字段使用标准单位
- 不共享账号
- 不在聊天工具明文发送密码
- 离岗及时锁屏/退出系统
- 先测试后上线
- 每次变更记录“目的、范围、回滚方案”
- 重大变更前做数据备份
以下是基于当前系统实现的“预计问题清单”。
现象：
- 登录失败提示过多、暂时无法登录
- 登录后很快被要求重新登录
可能原因：
- 触发登录失败限次
- 账号在其他设备重新登录导致旧会话失效
- 管理员执行了“踢下线”
处理建议：
- 等待锁定时间结束后重试
- 管理员确认是否执行踢下线
- 清理浏览器旧 token 后重新登录
现象：
- 菜单不显示
- 页面能打开但按钮缺失
- 接口返回无权限
可能原因：
- 角色未分配或权限不完整
- 前端按钮已开启
v-permission控制 - 路由权限与角色权限不匹配
处理建议：
- 管理员检查用户角色
- 角色补齐对应权限码
- 用户退出并重新登录
现象：
- 日志页面数据为空或筛选无结果
可能原因：
- 时间筛选范围过窄
- 用户名/路径筛选条件不匹配
- 当前账号无查看日志权限
处理建议：
- 重置筛选条件
- 放宽时间范围
- 由管理员确认权限
现象：
- 编辑保存失败
- 新增记录按钮不可见
可能原因：
- 缺少
equipment:create/edit/delete权限 - 关键字段为空（管理编号、型号、日期）
处理建议：
- 补齐必填项
- 检查权限并重新登录
现象：
- 工标网抓取只返回部分字段
- 标准号/日期缺失
可能原因：
- 外部站点页面结构变化
- 网络问题或响应结构层级变化
- 字段命名差异（snake/camel）造成映射丢失
处理建议：
- 先手工保存关键字段，保证业务不中断
- 记录抓取请求参数与返回体供技术排查
- 技术侧优先核对抓取接口与解包逻辑
现象：
- 原始记录、结果、报告状态不一致
可能原因：
- 业务流程跨模块操作顺序不一致
- 中途改动了模板或参数
处理建议：
- 先锁定主记录作为“事实来源”
- 按“委托 -> 样品 -> 任务 -> 记录 -> 结果 -> 报告”逐步核对
- 必要时由管理员审计日志回溯操作路径
- 检查新增用户是否已正确分配角色
- 检查高风险操作日志（删除/重置密码/踢下线）
- 检查设备到期记录与任务冲突
- 检查质量模块待办是否积压
- 检查数据库备份、Redis、对象存储状态
- 登录并修改初始密码
- 熟悉与自己岗位相关的 1-2 个菜单
- 完成一次“查数据 -> 新建 -> 编辑 -> 提交”的完整练习
- 学会使用筛选、分页、详情回溯
- 了解无权限提示与申请流程
- 本手册与当前系统实现保持对齐
- 新增模块/权限策略后，应同步更新本手册
- 建议由“系统管理员 + 质量负责人”共同维护
- 登录：
/login - 首页：
/dashboard - 工程项目：
/project - 委托管理：
/entrustment - 样品管理：
/sample - 检测任务：
/testing/tasks - 原始记录：
/testing/records - 报告：
/reports - 设备：
/equipment - 人员：
/staff - 环境：
/environment - 耗材：
/consumable - 质量体系：
/quality/* - 用户管理：
/system/users - 角色管理：
/system/roles - 操作日志：
/system/audit-logs
如需，我可以继续在 wiki/ 下拆分为多份子手册（按角色独立文档）：
wiki/01-普通用户手册.mdwiki/02-检测人员手册.mdwiki/03-质量负责人手册.mdwiki/04-系统管理员手册.mdwiki/05-故障排查SOP.md