ttpos-staff

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ttpos-staff

ttpos-staff

先读
ttpos-shared
。本版不提供
staff search
(按邮箱或手机号跨商户查人);只能在当前商户内用
staff list --keyword
查。
First read
ttpos-shared
. This version does not provide
staff search
(searching for people across merchants by email or phone number); you can only search within the current merchant using
staff list --keyword
.

能回答的问题

Questions this can answer

问题命令
有哪些员工、什么角色
ttpos staff list
某个员工的完整联系方式
ttpos staff get <uuid>
某个角色有哪些权限
ttpos staff role get <uuid>
QuestionCommand
What employees are there and what roles do they have
ttpos staff list
Full contact information for a specific employee
ttpos staff get <uuid>
What permissions a specific role has
ttpos staff role get <uuid>

联系方式

Contact information

staff list
的手机号、邮箱打码;
staff get <uuid>
按 uuid 查单条,完整显示。被问某个员工的联系方式时,先用
staff list --keyword
找到 uuid,再
staff get
。不要用
--reveal
(agent 调用会被拒)。
Phone numbers and email addresses are masked in
staff list
, while
staff get <uuid>
retrieves a single record by UUID and displays its contact information in full. When asked for an employee's contact information, first use
staff list --keyword
to find the UUID, then use
staff get
. Do not use
--reveal
(the agent invocation will be rejected).

命令

Commands

bash
ttpos staff list --keyword <用户名/姓名/手机>
ttpos staff get <uuid>
ttpos staff role list
ttpos staff role get <uuid>
ttpos staff permission-group | jq '.data'
查询上限:
staff list
、
staff role list
每页最多 100 条。
bash
ttpos staff list --keyword <username/name/phone>
ttpos staff get <uuid>
ttpos staff role list
ttpos staff role get <uuid>
ttpos staff permission-group | jq '.data'
Query limits:
staff list
and
staff role list
support a maximum of 100 records per page.

读输出

Reading the output

  • is_super
    、
    is_disable
    是整数
    0/1
    ,不是 bool,用
    == 1
    判断。
  • staff list
    的
    uuid
    是字符串;
    --keyword
    不能用打码后的手机号。
  • staff get
    的
    data
    是未建模的原始详情,
    --format table
    也输出 JSON。
  • staff role get
    返回
    uuid
    access_uuids
    name
    staff_count
    staff_uuids
    selected_leaf_count
    total_leaf_count
    。
    staff_uuids
    、
    access_uuids
    是 number 数组,可能超过 2^53,不要转 double。
  • staff permission-group
    只输出 JSON,数据量大。节点结构
    {id,uuid,name,path,parent_id,is_route,is_menu,is_show,children:[...]}
    递归嵌套,
    uuid
    是大整数。
  • 只覆盖账号基础信息、角色和权限树,不含登录日志和操作日志。
退出码见
ttpos help exit-codes
。
  • is_super
    and
    is_disable
    are integer
    0/1
    values, not booleans; test them with
    == 1
    .
  • The
    uuid
    in
    staff list
    is a string;
    --keyword
    cannot be used with a masked phone number.
  • The
    data
    in
    staff get
    contains raw, unmodeled details;
    --format table
    also outputs JSON.
  • staff role get
    returns
    uuid
    ,
    access_uuids
    ,
    name
    ,
    staff_count
    ,
    staff_uuids
    ,
    selected_leaf_count
    , and
    total_leaf_count
    .
    staff_uuids
    and
    access_uuids
    are arrays of numbers that may exceed 2^53, so do not convert them to double.
  • staff permission-group
    outputs JSON only and may return a large amount of data. Its node structure,
    {id,uuid,name,path,parent_id,is_route,is_menu,is_show,children:[...]}
    , is recursively nested, and
    uuid
    is a large integer.
  • This covers basic account information, roles, and the permission tree only; it does not include login logs or operation logs.
See
ttpos help exit-codes
for exit codes.