Documentation cleanup for substrate v2

README.md:
- Drop the 'real-time page updates for Number Tags Webpage' qualifier on Turbo
- Rename 'Number Tags (ItemTags)' to 'Item Tags' in the features list

CLAUDE.md:
- Correct the ItemTag description: name has no uniqueness constraint;
  describe the columns (name/description/position) and binary state instead

docs/openapi.yaml (-90/+31):
- ItemTag schema: drop queue_number/scan_state/customer_read_at/already_completed,
  add name (required)/description/position
- Shop schema: drop scanned_item_tags_count and display_shop_server_path
- /permissions meta: drop maximum_queue_number_length
- Roles: drop senior_manager/junior_manager/senior_member/junior_member/guest,
  add member (5 sites: AccountsShopkeeper attrs/update, AccountsInvitation
  attrs/create/update)
- Endpoints: remove DELETE /shops/{shopId}/reset; rename
  PATCH /item_tags/{itemTagId}/reset → /idle (resetItemTag → idleItemTag)
- ItemTag create/update request bodies switched to name+description+position+state

Also delete:
- docs/pagination-item-tags.md (pre-implementation notes; pagy is now wired in
  the controller, doc is stale)
- app/views/layouts/display.html.erb (orphaned after Step 3 display
  namespace removal — no controllers reference this layout)

Author: dadachi

CLAUDE.md

@@ -70,7 +70,7 @@ bin/rails dbconsole           # Database console
 - `Account` - Top-level tenant/organization
 - `Shopkeeper` - Main user type (belongs to Account)
 - `Shop` - Core business entity (belongs to Account)
-- `ItemTag` - Belongs to Shop with unique name constraint
+- `ItemTag` - Belongs to Shop; has name/description/position and a binary state (idled/completed)
 - `Role` & `Permission` - Authorization system
 - State machines implemented with AASM gem
 

README.md

@@ -22,7 +22,7 @@ For more information, visit [nativeapptemplate.com](https://nativeapptemplate.co
 - **[pundit](https://github.com/varvet/pundit)**
 - **[acts_as_tenant](https://github.com/ErwinM/acts_as_tenant)**
 - **[pagy](https://github.com/ddnexus/pagy)**
-- **[Turbo](https://turbo.hotwired.dev/)** (real-time page updates for Number Tags Webpage)
+- **[Turbo](https://turbo.hotwired.dev/)**
 - **Test** (Minitest)
 
 ### Included Features
@@ -31,7 +31,7 @@ For more information, visit [nativeapptemplate.com](https://nativeapptemplate.co
 - Email Confirmation
 - Forgot Password
 - CRUD Operations for Shops (Create/Read/Update/Delete)
-- CRUD Operations for Shops' Nested Resource, Number Tags (ItemTags) (Create/Read/Update/Delete)
+- CRUD Operations for Shops' Nested Resource, Item Tags (Create/Read/Update/Delete)
 - URL Path-Based Multitenancy (prepends `/:account_id/` to URLs)
 - User Invitation to Organizations
 - Role-Based Permissions and Access Control

app/views/layouts/display.html.erb

@@ -45,12 +45,8 @@ components:
           type: string
         item_tags_count:
           type: integer
-        scanned_item_tags_count:
-          type: integer
         completed_item_tags_count:
           type: integer
-        display_shop_server_path:
-          type: string
 
     Shop:
       type: object
@@ -85,22 +81,18 @@ components:
         shop_id:
           type: string
           format: uuid
-        queue_number:
+        name:
           type: string
+        description:
+          type: ['string', 'null']
+        position:
+          type: ['integer', 'null']
         state:
           type: string
           enum: [idled, completed]
-        scan_state:
-          type: string
-          enum: [unscanned, scanned]
-        customer_read_at:
-          type: ['string', 'null']
-          format: date-time
         completed_at:
           type: ['string', 'null']
           format: date-time
-        already_completed:
-          type: boolean
         created_at:
           type: string
           format: date-time
@@ -249,15 +241,7 @@ components:
           format: uuid
         admin:
           type: boolean
-        senior_manager:
-          type: boolean
-        junior_manager:
-          type: boolean
-        senior_member:
-          type: boolean
-        junior_member:
-          type: boolean
-        guest:
+        member:
           type: boolean
 
     AccountsShopkeeper:
@@ -317,15 +301,7 @@ components:
           format: email
         admin:
           type: boolean
-        senior_manager:
-          type: boolean
-        junior_manager:
-          type: boolean
-        senior_member:
-          type: boolean
-        junior_member:
-          type: boolean
-        guest:
+        member:
           type: boolean
 
     AccountsInvitation:
@@ -465,10 +441,17 @@ components:
       properties:
         item_tag:
           type: object
-          required: [queue_number]
+          required: [name]
           properties:
-            queue_number:
+            name:
+              type: string
+            description:
+              type: string
+            position:
+              type: integer
+            state:
               type: string
+              enum: [idled, completed]
 
     ItemTagUpdateRequest:
       type: object
@@ -477,8 +460,15 @@ components:
         item_tag:
           type: object
           properties:
-            queue_number:
+            name:
+              type: string
+            description:
+              type: string
+            position:
+              type: integer
+            state:
               type: string
+              enum: [idled, completed]
 
     AccountCreateRequest:
       type: object
@@ -510,15 +500,7 @@ components:
           properties:
             admin:
               type: boolean
-            senior_manager:
-              type: boolean
-            junior_manager:
-              type: boolean
-            senior_member:
-              type: boolean
-            junior_member:
-              type: boolean
-            guest:
+            member:
               type: boolean
 
     AccountsInvitationCreateRequest:
@@ -536,15 +518,7 @@ components:
               format: email
             admin:
               type: boolean
-            senior_manager:
-              type: boolean
-            junior_manager:
-              type: boolean
-            senior_member:
-              type: boolean
-            junior_member:
-              type: boolean
-            guest:
+            member:
               type: boolean
 
     AccountsInvitationUpdateRequest:
@@ -558,15 +532,7 @@ components:
               type: string
             admin:
               type: boolean
-            senior_manager:
-              type: boolean
-            junior_manager:
-              type: boolean
-            senior_member:
-              type: boolean
-            junior_member:
-              type: boolean
-            guest:
+            member:
               type: boolean
 
     SignUpRequest:
@@ -1054,8 +1020,6 @@ paths:
                         type: boolean
                       should_update_terms:
                         type: boolean
-                      maximum_queue_number_length:
-                        type: integer
                       shop_limit_count:
                         type: integer
                       account_limit_count:
@@ -1238,29 +1202,6 @@ paths:
         '401':
           $ref: '#/components/responses/Unauthorized'
 
-  /shops/{shopId}/reset:
-    parameters:
-      - name: shopId
-        in: path
-        required: true
-        schema:
-          type: string
-          format: uuid
-
-    delete:
-      operationId: resetShop
-      summary: Reset all item tags in a shop
-      tags: [Shops]
-      responses:
-        '200':
-          description: Shop reset
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SuccessResponse'
-        '401':
-          $ref: '#/components/responses/Unauthorized'
-
   # ──────────────── Item Tags ────────────────
   /shops/{shopId}/item_tags:
     parameters:
@@ -1441,7 +1382,7 @@ paths:
         '404':
           $ref: '#/components/responses/NotFound'
 
-  /item_tags/{itemTagId}/reset:
+  /item_tags/{itemTagId}/idle:
     parameters:
       - name: itemTagId
         in: path
@@ -1451,12 +1392,12 @@ paths:
           format: uuid
 
     patch:
-      operationId: resetItemTag
-      summary: Reset an item tag to initial state
+      operationId: idleItemTag
+      summary: Reset an item tag to idled state
       tags: [Item Tags]
       responses:
         '200':
-          description: Item tag reset
+          description: Item tag idled
           content:
             application/json:
               schema: