@newpeak/barista-cli 0.1.10 → 0.1.12

package/docs/commands/liberica/uoms/update.md

@@ -1,148 +0,0 @@
-# barista liberica uoms update
-
-更新计量单位信息。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica uoms update <uom-id>` |
-| 功能描述 | 更新计量单位信息 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
-        └── MasterUomController.java
-            └── updateUom(@PostResource(path = "/edit"))
-                └── public ResponseData<MasterUomResponse> updateUom(
-                        @RequestBody @Validated MasterUomRequest request
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
-    ├── uomId: String (@NotBlank)
-    ├── uomCode: String (@NotBlank)
-    ├── uomName: String (@NotBlank)
-    ├── uomFractionPlaces: Integer (default: 2)
-    ├── statusFlag: Integer (1=启用, 2=禁用)
-    └── remark: String (optional)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
-    ├── uomId: String
-    ├── uomCode: String
-    ├── uomName: String
-    ├── uomFractionPlaces: Integer
-    ├── statusFlag: Integer
-    ├── remark: String
-    ├── createTime: String
-    └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica uoms update <uom-id> [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式 |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| uom-id | string | ✅ | 计量单位ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --uom-id | -i | string | ⬜ | - | 计量单位ID（与位置参数互斥） | uomId |
-| --code | -c | string | ✅ | - | 计量单位编码 | uomCode |
-| --name | -n | string | ✅ | - | 计量单位名称 | uomName |
-| --fraction-places | -f | number | ⬜ | 2 | 小数位数 | uomFractionPlaces |
-| --remark | -r | string | ⬜ | - | 备注 | remark |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| uom-id (位置参数) | uomId | string→String | @NotBlank |
-| --uom-id / -i | uomId | string→String | @NotBlank |
-| --code / -c | uomCode | string→String | @NotBlank, max=255 |
-| --name / -n | uomName | string→String | @NotBlank, max=255 |
-| --fraction-places / -f | uomFractionPlaces | number→Integer | >= 0, <= 10 |
-| --remark / -r | remark | string→String | max=500 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
-| UOM_CODE_DUPLICATE | 计量单位编码重复 | 编码重复 |
-| UOM_CODE_EMPTY | 计量单位编码不能为空 | 编码为空 |
-| UOM_NAME_EMPTY | 计量单位名称不能为空 | 名称为空 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | MasterUomController.java | 需要 `master_uom:edit` 权限 |
-
-## 2.7 实现要点
-
-1. **ID必填**：uomId为必填参数（位置参数或 --uom-id 选项）
-2. **必填字段**：uomCode 和 uomName 为必填参数（通常需要先获取现有值再修改）
-3. **dry-run 支持**：支持 `--dry-run` 预览模式，显示将要更新的字段变化
-4. **完整更新**：后端可能是完整更新模式，需要提供所有字段值
-5. **建议用法**：先执行 `barista liberica uoms get <id>` 获取当前值，再更新指定字段
-6. **API路径**：POST `/api/enterprise/sales/uom/edit`
-7. **成功响应**：返回更新后的UOM详情
-
-## 2.8 示例用法
-
-```bash
-# 更新计量单位（通过位置参数）
-barista liberica uoms update "1234567890123456789" --code "kg" --name "千克"
-
-# 更新计量单位（通过选项参数）
-barista liberica uoms update --uom-id "1234567890123456789" --code "kg" --name "千克"
-barista liberica uoms update -i "1234567890123456789" -c "kg" -n "千克"
-
-# 更新小数位数
-barista liberica uoms update "1234567890123456789" --code "m" --name "米" --fraction-places 3
-
-# 更新备注
-barista liberica uoms update "1234567890123456789" --code "pcs" --name "件" --remark "新的备注"
-
-# 预览模式（dry-run）
-barista liberica uoms update "1234567890123456789" --code "box" --name "箱" --dry-run
-
-# JSON 输出
-barista liberica uoms update "1234567890123456789" --code "kg" --name "千克" --json
-```

package/docs/commands/liberica/users/create.md

@@ -1,170 +0,0 @@
-# barista liberica users create
-
-创建新用户。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica users create` |
-| 功能描述 | 创建新用户 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/
-        └── EnterpriseSysUserController.java
-            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = ErpPermissionCodeConstants.ERP_ADD_USER))
-                └── public ResponseData add(
-                        @RequestBody @Validated(ErpSysUserRequest.add.class) ErpSysUserRequest sysUserRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/request/
-        └── ErpSysUserRequest.java
-            ├── userId: Long (@NotNull on edit/delete/detail/updateStatus/resetPassword)
-            ├── realName: String (@NotBlank on add/edit/updateInfo)
-            ├── account: String (@NotBlank on add/edit, unique validation)
-            ├── newPassword: String (@NotBlank on updatePwd)
-            ├── avatar: Long (@NotNull on updateAvatar)
-            ├── email: String (@Email validation)
-            ├── roleIdList: Set<Long> (@NotEmpty on add/edit)
-            ├── userIdList: Set<Long> (@NotEmpty on batchDelete)
-            └── employeeId: Long
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/
-        └── SysUserDto.java
-            ├── userId: Long
-            ├── realName: String
-            ├── account: String
-            ├── email: String
-            ├── employeeId: Long
-            ├── employeeNumber: String
-            ├── employeeName: String
-            ├── roleNameList: List<String>
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: Date
-            └── readOnly: Boolean
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica users create [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ✅ | - | 用户姓名 | realName |
-| --account | -a | string | ✅ | - | 用户账号(不包含@) | account |
-| --email | -e | string | ⬜ | - | 电子邮箱 | email |
-| --role-ids | -r | string | ✅ | - | 角色ID列表(逗号分隔) | roleIdList |
-| --employee-id | — | number | ⬜ | - | 关联职员ID | employeeId |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --name / -n | realName | 直接传递 | @NotBlank, max=255 |
-| --account / -a | account | 直接传递 | @NotBlank, 不包含@符号, 唯一性校验 |
-| --email / -e | email | 直接传递 | 邮箱格式验证 |
-| --role-ids / -r | roleIdList | string→Set<Long> | @NotEmpty, 逗号分隔 |
-| --employee-id | employeeId | string→Long | - |
-
-**自动填充字段（不通过CLI参数）：**
-| 字段 | 值 |
-|------|-----|
-| tenantId | 来自JWT token，无需显式传递 |
-| statusFlag | 默认 1 (启用) |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/enums/exception/
-        └── ErpUserExceptionEnum.java
-            ├── UPDATE_SELF_PSW_FORBIDDEN("010011510001", "不能重置自己的密码")
-            ├── DEL_SELF_FORBIDDEN("010011510002", "不能删除自己的账号")
-            ├── UPDATE_ADMIN_FORBIDDEN("010011510003", "不能更新管理员账号")
-            ├── UPDATE_SELF_ACCOUNT("010011510004", "不能更新自己的账号")
-            ├── WRONG_STATUS_FLAG("010011510005", "错误的statusFlag")
-            ├── WRONG_ACCOUNT("010011510006", "错误的账号")
-            ├── TOKEN_EXPIRED("010011510007", "链接已过期")
-            ├── EMAIL_INCONSISTENT("010011510008", "账号不一致")
-            ├── ACCOUNT_DUPLICATED("010011510009", "已存在相同账号")
-            ├── SEND_EMAIL_FAILED("010011510010", "发送邮件失败")
-            ├── BOUND_USER_DEL_FORBID("010011510011", "已绑定用户职员不能被删除")
-            └── ERP_NOT_EXIST("010011510012", "对应erp不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 010011510009 | 已存在相同账号 | account 已存在 |
-| 010011510008 | 账号不一致 | 邮件与账号不匹配 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `ErpPermissionCodeConstants.ERP_ADD_USER` | Controller层 `@PostResource(requirePermissionCode = ErpPermissionCodeConstants.ERP_ADD_USER)` |
-
-## 2.7 实现要点
-
-1. **必填字段**：--name, --account, --role-ids 必须提供
-2. **角色ID格式**：--role-ids 接受逗号分隔的ID列表，如 "1,2,3"
-3. **账号规则**：account 不能包含@符号，后端会自动拼接租户域名
-4. **Dry-run支持**：使用 --dry-run 时构造请求体但不发送，显示预览信息
-5. **默认statusFlag**：新建用户默认为启用状态(statusFlag=1)
-6. **tenantId来源**：来自JWT token，不通过请求体传递
-
-## 2.8 示例用法
-
-```bash
-# 交互式创建（引导输入必填字段）
-barista liberica users create
-
-# 指定姓名、账号和角色
-barista liberica users create --name "张三" --account "zhangsan" --role-ids "1,2"
-
-# 完整选项
-barista liberica users create \
-  --name "张三" \
-  --account "zhangsan" \
-  --email "zhangsan@example.com" \
-  --role-ids "1,2,3" \
-  --employee-id 1001
-
-# Dry-run 预览
-barista liberica users create --name "张三" --account "zhangsan" --role-ids "1" --dry-run
-
-# JSON 输出
-barista liberica users create --name "张三" --account "zhangsan" --role-ids "1" --json
-```

package/docs/commands/liberica/users/get.md

@@ -1,151 +0,0 @@
-# barista liberica users get
-
-获取单个用户详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica users get <id>` |
-| 功能描述 | 获取单个用户详情 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/
-        └── EnterpriseSysUserController.java
-            └── detail(@GetResource(name = "查看用户详情", path = "/detail"))
-                └── public ResponseData<SysUser> detail(
-                        @Validated(SysUserRequest.detail.class) ErpSysUserRequest sysUserRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/request/
-        └── ErpSysUserRequest.java
-            └── userId: Long (@NotNull on detail)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/
-        └── SysUserDto.java
-            ├── userId: Long
-            ├── realName: String
-            ├── account: String
-            ├── email: String
-            ├── employeeId: Long
-            ├── employeeNumber: String
-            ├── employeeName: String
-            ├── roleNameList: List<String>
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: Date
-            └── readOnly: Boolean
-```
-
-### Entity位置
-```
-cn.stylefeng.roses.kernel.sys.modular.user.entity.SysUser
-    ├── userId: Long
-    ├── realName: String
-    ├── account: String
-    ├── email: String
-    ├── statusFlag: Integer
-    └── createTime: Date
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica users get <id> [options]
-```
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| id | number | ✅ | 用户ID (userId) |
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 |
-|------|--------|------|------|--------|------|
-| — | — | — | — | — | 此命令无额外选项，ID 通过位置参数传入 |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <id> (位置参数) | userId | string→Long | @NotNull, 必须为正整数 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/enums/exception/
-        └── ErpUserExceptionEnum.java
-            ├── UPDATE_SELF_PSW_FORBIDDEN("010011510001", "不能重置自己的密码")
-            ├── DEL_SELF_FORBIDDEN("010011510002", "不能删除自己的账号")
-            ├── UPDATE_ADMIN_FORBIDDEN("010011510003", "不能更新管理员账号")
-            ├── UPDATE_SELF_ACCOUNT("010011510004", "不能更新自己的账号")
-            ├── WRONG_STATUS_FLAG("010011510005", "错误的statusFlag")
-            ├── WRONG_ACCOUNT("010011510006", "错误的账号")
-            ├── TOKEN_EXPIRED("010011510007", "链接已过期")
-            ├── EMAIL_INCONSISTENT("010011510008", "账号不一致")
-            ├── ACCOUNT_DUPLICATED("010011510009", "已存在相同账号")
-            ├── SEND_EMAIL_FAILED("010011510010", "发送邮件失败")
-            ├── BOUND_USER_DEL_FORBID("010011510011", "已绑定用户职员不能被删除")
-            └── ERP_NOT_EXIST("010011510012", "对应erp不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 010011510006 | 错误的账号 | userId 不存在或不属于当前租户 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/detail")` | 无 requiredPermission |
-
-## 2.7 实现要点
-
-1. **位置参数**：`get` 命令使用 `<id>` 位置参数指定用户ID
-2. **错误处理**：用户不存在时抛出错误，CLI 显示友好错误信息
-3. **tenantId来源**：来自JWT token，后端自动按租户隔离数据
-4. **返回字段**：包含用户基本信息、关联职员信息、角色列表等
-5. **角色显示**：roleNameList 以列表形式展示用户拥有的所有角色
-
-## 2.8 示例用法
-
-```bash
-# 获取用户详情
-barista liberica users get 12345
-
-# JSON 输出
-barista liberica users get 12345 --json
-
-# 用户不存在
-barista liberica users get 99999
-# 输出: Error: 用户不存在 (010011510006)
-```

package/docs/commands/liberica/users/list.md

@@ -1,175 +0,0 @@
-# barista liberica users list
-
-分页查询用户列表。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica users list` |
-| 功能描述 | 分页查询用户列表 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/
-        └── EnterpriseSysUserController.java
-            └── page(@GetResource(name = "分页查询-用户信息", path = "/page"))
-                └── public ResponseData<PageResult<SysUserDto>> page(
-                        ErpSysUserRequest erpSysUserRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/request/
-        └── ErpSysUserRequest.java
-            ├── userId: Long (@NotNull on edit/delete/detail/updateStatus/resetPassword)
-            ├── realName: String (@NotBlank on add/edit/updateInfo)
-            ├── account: String (@NotBlank on add/edit, unique validation)
-            ├── newPassword: String (@NotBlank on updatePwd)
-            ├── avatar: Long (@NotNull on updateAvatar)
-            ├── email: String (@Email validation)
-            ├── roleIdList: Set<Long> (@NotEmpty on add/edit)
-            ├── userIdList: Set<Long> (@NotEmpty on batchDelete)
-            └── employeeId: Long
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/pojo/
-        └── SysUserDto.java
-            ├── userId: Long
-            ├── realName: String
-            ├── account: String
-            ├── email: String
-            ├── employeeId: Long
-            ├── employeeNumber: String
-            ├── employeeName: String
-            ├── roleNameList: List<String>
-            ├── statusFlag: Integer (1=enable, 2=disable)
-            ├── createTime: Date
-            └── readOnly: Boolean
-```
-
-### 分页包装器
-```
-cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
-    ├── total: long
-    ├── size: long
-    ├── current: long
-    └── records: List<SysUserDto>
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica users list [options]
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --page | -p | number | ⬜ | 1 | 页码 | pageNo (0-based in API) |
-| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
-| --account | -a | string | ⬜ | - | 账号模糊查询 | account |
-| --name | -n | string | ⬜ | - | 姓名模糊查询 | realName |
-| --status | — | string | ⬜ | - | 状态(enable/disable) | statusFlag |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段/Query参数 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --page / -p | pageNo | number→Long, CLI page 1 → API page 0 | >= 1 |
-| --size / -s | pageSize | number→Long | 1-100 |
-| --account / -a | account | 直接传递 | 模糊查询 |
-| --name / -n | realName | 直接传递 | 模糊查询 |
-| --status | statusFlag | string→Integer | enable=1, disable=2 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-auth/
-    └── src/main/java/com/newpeak/liberica/business/auth/enums/exception/
-        └── ErpUserExceptionEnum.java
-            ├── UPDATE_SELF_PSW_FORBIDDEN("010011510001", "不能重置自己的密码")
-            ├── DEL_SELF_FORBIDDEN("010011510002", "不能删除自己的账号")
-            ├── UPDATE_ADMIN_FORBIDDEN("010011510003", "不能更新管理员账号")
-            ├── UPDATE_SELF_ACCOUNT("010011510004", "不能更新自己的账号")
-            ├── WRONG_STATUS_FLAG("010011510005", "错误的statusFlag")
-            ├── WRONG_ACCOUNT("010011510006", "错误的账号")
-            ├── TOKEN_EXPIRED("010011510007", "链接已过期")
-            ├── EMAIL_INCONSISTENT("010011510008", "账号不一致")
-            ├── ACCOUNT_DUPLICATED("010011510009", "已存在相同账号")
-            ├── SEND_EMAIL_FAILED("010011510010", "发送邮件失败")
-            ├── BOUND_USER_DEL_FORBID("010011510011", "已绑定用户职员不能被删除")
-            └── ERP_NOT_EXIST("010011510012", "对应erp不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 010011510005 | 错误的statusFlag | 状态参数无效 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| 注解 | `@GetResource(path = "/page")` | 无 requiredPermission（无需权限码） |
-
-**注意**：page 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
-
-## 2.7 实现要点
-
-1. **分页默认值**：page=1, size=20
-2. **分页转换**：CLI页码从1开始，API页码从0开始（CLI page 1 → API page 0）
-3. **模糊查询**：account 和 realName 支持模糊查询
-4. **状态映射**：statusFlag 1=启用(enable), 2=禁用(disable)
-5. **无结果处理**：返回空列表，不抛出异常
-6. **tenantId来源**：来自JWT token
-7. **输出格式**：表格形式展示，分页信息在底部显示
-
-## 2.8 示例用法
-
-```bash
-# 默认分页
-barista liberica users list
-
-# 指定页码和每页条数
-barista liberica users list --page 2 --size 50
-
-# 按账号模糊搜索
-barista liberica users list --account "zhang"
-
-# 按姓名模糊搜索
-barista liberica users list --name "张三"
-
-# 按状态筛选
-barista liberica users list --status enable
-
-# 组合筛选
-barista liberica users list --page 1 --size 10 --status enable --name "张"
-
-# JSON 输出（便于脚本处理）
-barista liberica users list --page 1 --size 20 --json
-```