查询雇员列表#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

按条件读取雇员列表。

使用位置#

页面/功能	角色或空间分支
查询雇员列表（XLSX 导出）	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

POST /main-service/main-api/basedata/employee/list — 按条件读取雇员列表。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 basedata · employee 员工；业务语义（wire 惯例、限频、租户声明等）见基础数据业务 · employee 员工。

动线与完成判据#

status=200 且 data 数组可消费表示读取结束；[] 是成功空结果。

错误与边界#

错误出口与四类映射见错误响应差异。读取可按网络策略重试。

调用关系与资源清理#

无长连接资源；读取操作完成后无需客户端释放服务端资源。变更后的列表或详情需由调用方重新读取。

已知缺口#

选择器错误地发送 name 而非 DTO 的 fullName；服务端搜索不应依赖该字段，当前组件随后只在已取回集合中本地过滤。无已知关键缺口；未执行真实联调。