@things-factory/auth-ui 10.1.254 → 10.1.257

package/helps/auth/roles.en.md

@@ -1,59 +1,23 @@
-# Roles
+# Role management
 
-![flowchart_role_management](./images/flowchart-role-management.jpg)
+Roles define the access privileges granted to users. The list shows each role's privilege count and user count. Assign roles to users through user management.
 
-Operato has roles for users’ access rights. Each role confers a different set of privileges for a given user of Operato. For example, users who have **Admin** rights can restrict other users’ access rights so that they cannot view or modify internal information.
+## Add and edit roles
 
-### Properties
+Use **Add role** to choose a template or create a role without privileges. Edit names and descriptions in the role list and save. Use **Edit privileges** to review and edit a role's tasks and individual privileges.
 
-- **Roles**: job (title) or role name
-- **Privileges**: privileges to access the system
+Inherited roles are read-only. Edit them in the domain that owns them.
 
-### Role List
+## Compare with a template
 
-You can search the roles registered by domain.
-![registered_role](./images/registered-role.png)
+The **Vs template** column shows both missing and extra privilege counts against the base template. Comparisons use saved privileges. Extra privileges may be intentional.
 
-### Type of Roles
+- **Add** shows the missing privileges and asks for confirmation before adding them.
+- **Review extras** opens the role's template comparison to review privileges outside the template.
+- **Remove extra privileges** shows the privileges and impact before confirmation. Confirming removes the displayed extras; cancelling keeps them. Other roles remain unchanged.
 
-1. Main role
+Save or cancel pending edits before adding or removing privileges through template comparison. Changing the base template does not automatically add or remove privileges.
 
-- It has privilege to access Operato.
+## Delete roles
 
-| ROLES             | PRIVILEGE                                                                                                                                                   |
-| :---------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Admin             | Can invite users to Operato Hub, have full privilege in WMS                                                                                                 |
-| Customer          | Can create Goods Arrival Notice (GAN) and Release Order (RO), and view reports                                                                              |
-| Office admin      | Can receive or approve the request of Goods Arrival Notice (GAN), Release Order (RO), activate worksheets and generate reports in Operato WMS for customers |
-| Warehouse manager | Execute unloading, putaway, returning, picking, batch picking and loading                                                                                   |
-| Warehouse staff   | Execute unloading, putaway, returning, picking, batch picking and loading                                                                                   |
-
----
-
-2. Shared role
-
-- It is used to assign menus in the Operato WMS.
-
-## <ins>Create Role</ins>
-
-**Admins** can add any role they want.
-![create_role](./images/create-role.png)
-
-1. Enter the name and description according to the form format.
-2. Click ![create_button](./images/create-button2.png)
-
-## <ins>Update Role</ins>
-
-Click on a role name to edit the role's name, description and privileges.
-
-### Role Privilages
-
-Below the role name, a list of access rights for functions is displayed. After checking the desired authority, click ![save_button](./images/save-button2.png)
-
-![role_privilage](./images/role-privilage.png)
-
-You can grant roles to users in a bizplace through the **User Management** menu which is accessible through the **Users** tab in the sidebar.
-
-## <ins>Delete Role</ins>
-
-You can delete unused roles. Please note that if a partner is using a role, it cannot be deleted.
+Select unused roles and choose **Delete**. Roles assigned to users and inherited roles cannot be deleted here.

package/helps/auth/roles.ko.md

@@ -1,42 +1,23 @@
-# roles
+# 역할 관리
 
-operato는 사용자들의 접근 권한을 위한 역할들이 존재합니다. 각각의 역할에 따라 operato system을 사용하는 기능들에 대한 접근 권한을 둘 수 있습니다.<br>
-예를 들어, 관리자 권한이 없는 일반 사용자의 경우 내부 정보를 조회하거나 수정할 수 없도록 읽기, 편집 등의 접근 권한을 제한할 수 있습니다.<br>
+역할은 사용자에게 부여할 접근 권한을 정의합니다. 역할별 권한 수와 해당 역할이 부여된 사용자 수를 목록에서 확인할 수 있습니다. 역할을 사용자에게 부여하려면 사용자 관리에서 설정합니다.
 
-## porperties
+## 역할 추가와 수정
 
-- **roles**
-  : 직업(직책)이나 역할 이름
+**역할 추가**에서 템플릿을 선택하거나 권한 없는 새 역할을 생성합니다. 이름과 설명은 역할 목록에서 수정하고 저장합니다. **권한 편집**을 누르면 역할의 업무와 개별 권한을 확인하고 수정할 수 있습니다.
 
-- **privileges**
-  : 시스템에 접근할 수 있는 권한
+부모 도메인에서 상속된 역할은 조회만 가능합니다. 수정하려면 해당 역할을 관리하는 도메인에서 작업해야 합니다.
 
-## role list
+## 템플릿과 비교
 
-도메인별로 등록된 role을 조회할 수 있습니다.<br>
+목록의 **템플릿 대비** 열은 기준 템플릿보다 부족한 권한 수와 추가된 권한 수를 표시합니다. 이 비교는 저장된 권한을 기준으로 하며, 추가 권한이 있다는 사실만으로 설정 오류를 뜻하지는 않습니다.
 
-![role_list](./images/role-list.png)
-<br>
+- **추가**: 부족한 권한 목록을 확인한 뒤 역할에 추가합니다.
+- **추가 권한 검토**: 해당 역할의 템플릿 비교 화면을 엽니다. 기준 템플릿에 없는 권한 목록을 검토할 수 있습니다.
+- **추가 권한 삭제**: 삭제할 권한과 영향을 확인한 뒤 승인하면 표시된 추가 권한을 삭제합니다. 취소하면 유지합니다. 다른 역할의 권한은 변경하지 않습니다.
 
-## create role
+저장하지 않은 편집 내용이 있으면 먼저 저장하거나 취소한 뒤 템플릿 권한을 추가·삭제해야 합니다. 템플릿 변경만으로 현재 권한이 자동 추가되거나 삭제되지는 않습니다.
 
-관리자는 원하는 role을 추가할 수 있습니다.<br>
-![create_role](./images/create-role.png)
-form 형식에 맞게 name, description을 입력 후 'create' 버튼을 클릭하여 생성합니다.<br>
-(role의 privileges는 role을 추가한 후 추가된 role을 클릭하여 수정할 수 있습니다.)
+## 역할 삭제
 
-## update role
-
-role 이름을 클릭하면 해당 role의 이름, 설명과 privileges를 수정할 수 있습니다.
-
-### role privileges
-
-role name아래에는 기능들에 대한 접근 권한 리스트가 보여지며, 원하는 권한을 체크한 후 'save'버튼을 클릭하여 저장합니다.
-![role_privileges](./images/role-privileges.png)
-
-_<u>사용자에게 role을 부여하려면 user 관리 메뉴에서 도메인에 속한 사용자들의 role을 설정할 수 있습니다.</u>_
-
-## delete role
-
-사용하지 않는 role을 삭제할 수 있습니다.<br>
-<u>\* partner에서 role을 사용하고 있을 경우 삭제가 되지 않습니다.</u>
+사용하지 않는 역할을 선택하고 **삭제**를 누릅니다. 사용자에게 부여된 역할과 상속된 역할은 이 화면에서 삭제할 수 없습니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/auth-ui",
-  "version": "10.1.254",
+  "version": "10.1.257",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -29,25 +29,26 @@
   "dependencies": {
     "@material/web": "^2.0.0",
     "@operato/attribute": "^10.29.39",
-    "@operato/data-grist": "^10.29.39",
+    "@operato/data-grist": "^10.29.69",
+    "@operato/graphql": "^10.29.69",
     "@operato/i18n": "^10.0.0",
     "@operato/input": "^10.29.39",
-    "@operato/layout": "^10.29.39",
+    "@operato/layout": "^10.29.69",
     "@operato/list-state": "^10.29.39",
     "@operato/lottie-player": "^10.0.0",
     "@operato/moment-timezone-es": "^10.0.0",
     "@operato/oops": "^10.29.49",
     "@operato/p13n": "^10.29.39",
     "@operato/popup": "^10.29.39",
-    "@operato/shell": "^10.29.39",
+    "@operato/shell": "^10.29.69",
     "@operato/styles": "^10.0.0",
-    "@operato/utils": "^10.29.39",
+    "@operato/utils": "^10.29.69",
     "@things-factory/apptool-base": "^10.1.254",
-    "@things-factory/auth-base": "^10.1.254",
-    "@things-factory/component-ui": "^10.1.254",
+    "@things-factory/auth-base": "^10.1.257",
+    "@things-factory/component-ui": "^10.1.257",
     "@things-factory/more-base": "^10.1.254",
     "base64url": "^3.0.1",
     "clipboard": "^2.0.6"
   },
-  "gitHead": "793e2fd617db5bb917ec892e64956fb690f7e7b0"
+  "gitHead": "885b594299601ca4936f4f39701d6713273bbf1e"
 }

package/tests/page-state.test.ts

@@ -23,7 +23,8 @@ describe('role privileges says what happened', () => {
   })
 
   it('★ keeps what the server said, and offers to read it again', () => {
-    expect(source).toMatch(/this\.loadError = response\.errors/)
+    /* What the server said, or what was thrown - the declared read keeps either as its error (ADR-0190). */
+    expect(source).toMatch(/this\.loadError = read\.error/)
     expect(source).toMatch(/\.error=\$\{this\.loadError\}/)
     expect(source).toMatch(/@retry=\$\{\(\) => this\.fetch\(\)\}/)
   })

package/tests/password-rule-shown.test.ts

@@ -15,8 +15,8 @@ const read = (file: string) => readFileSync(path.resolve(__dirname, '..', file),
 describe('the password rule shown is the server rule', () => {
   it('★ the profile hands over the rule, not the query answer', () => {
     const source = read('client/components/profile-component.ts')
-    expect(source).toMatch(/this\.passwordRule = response\.data\?\.passwordRule\b/)
-    expect(source).not.toMatch(/this\.passwordRule = response\.data\s*$/m)
+    expect(source).toMatch(/return this\.rule\.data\?\.passwordRule\b/)
+    expect(source).not.toMatch(/return this\.rule\.data\s*$/m)
   })
 
   it('★ the form draws the pattern and the help from the rule in render', () => {

package/tests/person-360-sections.test.ts

@@ -49,14 +49,17 @@ describe('the person 360 sections', () => {
     '★ %s shows its door answer through the shared section frame, never its own none',
     (_, one) => {
       const code = read(one.file)
-      expect(code).toMatch(/this\.answer = readEntity360Door\(response,/)
+      expect(code).toMatch(/return entity360Answer(<[^>]*>)?\(this\.\w+, /)
       expect(code).toMatch(/<ox-entity360-section[\s\S]*\.state=\$\{answer\?\.state \?\? 'loading'\}/)
       expect(code).toMatch(/\.message=\$\{answer\?\.message \?\? ''\}/)
     }
   )
 
-  it.each(Object.entries(SECTIONS))('%s drops an answer for a subject that is no longer shown', (_, one) => {
-    expect(read(one.file)).toMatch(/await client\.query[\s\S]*if \(this\.subject\?\.id !== id\) return\s*this\.answer =/)
+  it.each(Object.entries(SECTIONS))('%s reads for the subject shown, and nothing without one (ADR-0190)', (_, one) => {
+    const code = read(one.file)
+    expect(code).toMatch(/new QueryController\(/)
+    expect(code).toMatch(/variables: \(\) =>\s*\(?this\.subject\?\.id \?/)
+    expect(code).not.toMatch(/client\.query/)
   })
 
   it("★ roles are this site's - read through userRoles, never User.roles which answers every domain", () => {
@@ -74,7 +77,7 @@ describe('the person 360 sections', () => {
   })
 
   it('membership reads this person only', () => {
-    expect(read(SECTIONS.membership.file)).toMatch(/filters: \[\{ name: 'userId', operator: 'eq', value: id \}\]/)
+    expect(read(SECTIONS.membership.file)).toMatch(/filters: \[\{ name: 'userId', operator: 'eq', value: this\.subject\.id \}\]/)
   })
 
   it('the dock reads who they are, then what they hold, then their roles', () => {
@@ -87,6 +90,7 @@ describe('the person 360 sections', () => {
 describe('signing out', () => {
   it('★ takes this user\'s unsaved drafts out of the browser before the page leaves (ADR-0098)', () => {
     const bootstrap = read('auth-ui/client/bootstrap.ts')
-    expect(bootstrap).toMatch(/auth\.on\('presignout', async \(\) => \{\s*const user = \(auth\.credential as any\)\?\.id\s*if \(user\) await removeDraftsOf\(user\)/)
+    /* The drafts' owner is named in one place, @operato/shell draftOwner (ADR-0190). */
+    expect(bootstrap).toMatch(/auth\.on\('presignout', async \(\) => \{\s*const user = draftOwner\(\)\s*if \(user\) await removeDraftsOf\(user\)/)
   })
 })

package/translations/en.json

@@ -546,5 +546,9 @@
   "text.my roles none": "You hold no role. Ask for access on the screen you need.",
   "text.my roles owner": "As the owner of this site you open some screens without a role - not the facts only their own role opens, such as pay and bank accounts.",
   "text.my roles count": "My roles ({count})",
-  "text.my roles shared tasks": "Work every role of yours gives"
+  "text.my roles shared tasks": "Work every role of yours gives",
+  "text.extra against template": "{count} extra",
+  "button.review extra privileges": "Review extras",
+  "button.remove extra privileges": "Remove extra privileges",
+  "text.remove extra privileges": "Remove {count} privileges outside the {template} template from role {role}? This role will no longer grant these privileges. Other roles remain unchanged. Privileges to remove: {list}"
 }

package/translations/es.json

@@ -546,5 +546,9 @@
   "text.my roles none": "No tiene ningún rol. Solicite acceso en la pantalla que necesita.",
   "text.my roles owner": "Como propietario del sitio abre algunas pantallas sin un rol, salvo los datos que solo abre su propio rol, como nóminas y cuentas bancarias.",
   "text.my roles count": "Mis roles ({count})",
-  "text.my roles shared tasks": "Trabajo común a todos sus roles"
+  "text.my roles shared tasks": "Trabajo común a todos sus roles",
+  "text.extra against template": "{count} adicionales",
+  "button.review extra privileges": "Revisar adicionales",
+  "button.remove extra privileges": "Eliminar permisos adicionales",
+  "text.remove extra privileges": "¿Eliminar del rol {role} los {count} permisos que no están en la plantilla {template}? Este rol dejará de conceder esos permisos. Los permisos de otros roles se mantienen. Permisos que se eliminarán: {list}"
 }

package/translations/ja.json

@@ -546,5 +546,9 @@
   "text.my roles none": "付与されたロールがありません。必要な画面で権限を申請してください。",
   "text.my roles owner": "サイトの所有者なのでロールがなくても開ける画面があります。給与・口座のように担当ロールだけが開く情報は例外です。",
   "text.my roles count": "自分のロール {count}件",
-  "text.my roles shared tasks": "すべてのロールに共通の業務"
+  "text.my roles shared tasks": "すべてのロールに共通の業務",
+  "text.extra against template": "追加 {count}件",
+  "button.review extra privileges": "追加権限を確認",
+  "button.remove extra privileges": "追加権限を削除",
+  "text.remove extra privileges": "役割「{role}」からテンプレート「{template}」に含まれない権限{count}件を削除しますか？この役割では対象の権限が付与されなくなります。他の役割の権限は維持されます。削除対象: {list}"
 }

package/translations/ko.json

@@ -546,5 +546,9 @@
   "text.my roles none": "부여받은 역할이 없습니다. 필요한 화면에서 권한을 요청하세요.",
   "text.my roles owner": "사업장 소유자라 역할 밖에서도 열리는 화면이 있습니다. 급여·계좌처럼 담당 역할만 여는 정보는 예외입니다.",
   "text.my roles count": "내 역할 {count}개",
-  "text.my roles shared tasks": "모든 역할에 공통인 업무"
+  "text.my roles shared tasks": "모든 역할에 공통인 업무",
+  "text.extra against template": "추가 {count}개",
+  "button.review extra privileges": "추가 권한 검토",
+  "button.remove extra privileges": "추가 권한 삭제",
+  "text.remove extra privileges": "{role} 역할에서 {template} 템플릿에 포함되지 않은 권한 {count}개를 삭제하시겠습니까? 삭제하면 이 역할에 해당 권한이 부여되지 않습니다. 다른 역할의 권한은 유지됩니다. 삭제 대상: {list}"
 }

package/translations/ms.json

@@ -546,5 +546,9 @@
   "text.my roles none": "Anda tiada peranan. Mohon akses di skrin yang anda perlukan.",
   "text.my roles owner": "Sebagai pemilik tapak, anda boleh membuka sesetengah skrin tanpa peranan, kecuali maklumat yang hanya dibuka oleh peranannya sendiri seperti gaji dan akaun bank.",
   "text.my roles count": "Peranan saya ({count})",
-  "text.my roles shared tasks": "Kerja yang sama bagi semua peranan anda"
+  "text.my roles shared tasks": "Kerja yang sama bagi semua peranan anda",
+  "text.extra against template": "{count} tambahan",
+  "button.review extra privileges": "Semak kebenaran tambahan",
+  "button.remove extra privileges": "Padam kebenaran tambahan",
+  "text.remove extra privileges": "Padam {count} kebenaran di luar templat {template} daripada peranan {role}? Peranan ini tidak lagi memberikan kebenaran tersebut. Kebenaran peranan lain kekal. Kebenaran untuk dipadam: {list}"
 }

package/translations/zh.json

@@ -546,5 +546,9 @@
   "text.my roles none": "您没有任何角色。请在需要的画面申请权限。",
   "text.my roles owner": "作为站点所有者，您无需角色也能打开部分画面；工资、账户等只由其负责角色打开的信息除外。",
   "text.my roles count": "我的角色 {count} 个",
-  "text.my roles shared tasks": "所有角色共有的业务"
+  "text.my roles shared tasks": "所有角色共有的业务",
+  "text.extra against template": "额外 {count} 项",
+  "button.review extra privileges": "查看额外权限",
+  "button.remove extra privileges": "删除额外权限",
+  "text.remove extra privileges": "是否从角色 {role} 中删除模板 {template} 未包含的 {count} 项权限？此角色将不再授予这些权限。其他角色的权限保持不变。待删除权限：{list}"
 }