01 quick start for all users

全用户快速入门

适用对象

• 首次登录系统的所有角色（检测员、样品管理员、报告编制人、质量负责人、系统管理员等）。
• 需要「最小路径」完成一次从登录到理解菜单结构的用户。

前置条件

• 已获得账号，或由管理员在 /system/users 创建用户并在 /system/roles 分配角色与权限。
• 浏览器可访问系统地址；推荐使用现代浏览器（Chromium / Firefox / Safari 新版本）。

页面入口

目的	路由	侧栏位置
登录	/login	—
首页看板	/dashboard	首页
业务主线	/project、/entrustment、/sample	业务管理
检测与记录	/testing/tasks、/testing/records、/testing/results	检测管理
报告	/reports	报告管理
质量与配置	/quality/foundation 等	质量体系
系统维护	/system/users、/system/roles、/system/audit-logs	系统管理

登录成功后默认进入 /dashboard。若直接访问无权限路由，系统提示「无权访问该页面」并返回首页。

字段说明

本页为通览，不涉及具体业务表字段；各模块字段见对应用户指南。

与登录相关的概念：

• JWT：登录成功后令牌存储于本地，后续请求自动带 Authorization。
• 权限码：与路由 meta.permission 对应，如 project:list、entrustment:create；超级权限可能为 *。

标准操作步骤（SOP）

第一次登录

1. 打开 /login，输入用户名、密码。
2. 登录成功后进入 /dashboard，浏览本月委托、待检任务、本月报告、设备预警等卡片与图表。
3. 展开左侧菜单，确认自己可见的模块（由权限过滤，看不到即无权限）。

理解菜单与路由的对应关系

• 业务管理：工程项目 → /project；委托 → /entrustment；样品 → /sample。
• 检测管理：检测任务 → /testing/tasks；原始记录 → /testing/records；检测结果 → /testing/results（与任务列表共用页面，便于切换视角）。
• 报告管理：报告列表 → /reports。
• 质量体系：从「检测基础配置」/quality/foundation 可进入标准、参数库、记录模板、报告模板等子功能。

典型日操作路径（举例）

角色	建议路径
接样岗	/sample/register → /sample
调度/组长	/testing/tasks（分配、跟踪）
检测员	/testing/tasks → /testing/tasks/:id → /testing/records
报告岗	/reports → /reports/:id
质量岗	/quality/audit 或 /quality/nonconformity

常见错误

现象	原因	处理
点击菜单无反应或空白	权限不足被重定向	联系管理员分配 meta.permission
登录后立即退出	Token 失效或 401	重新登录；检查服务器时间与时区
接口报错但无明确提示	非标准信封或网络	查看浏览器控制台与 Network 响应体
找不到「标准」菜单	旧书签 /standard	使用 /quality/foundation 或 /quality/standards

数据核对清单

• 登录后 /dashboard 能加载统计（若后端有数据）。
• 侧栏仅显示有权限的菜单项。
• 直接输入 URL 访问业务页时，权限与菜单一致（无菜单但有 URL 时仍以权限为准）。

与上下游模块关系

• 首页 聚合统计模块数据，依赖委托、任务、报告、设备等后端服务。
• 权限 贯穿所有路由；无权限则无法进入对应 上游 数据维护或 下游 审批环节。
• 详细流程衔接见 03-business-process-map.md 与各模块用户指南。