docs: add Carousel dashboard implementation plan

2026-02-17 17:00:46 -05:00
parent fce16b53f7
commit 96730d9475
407 changed files with 10834 additions and 10983 deletions
@@ -0,0 +1,49 @@
+info:
+  name: Bulk Dismiss Conflicts
+  type: http
+  seq: 1
+http:
+  method: POST
+  url: '{{base_url}}/api/conflicts/bulk-dismiss'
+  auth: inherit
+  body:
+    type: json
+    jsonBody: "{\n    \"conflict_ids\": [\n      \"{{conflictId1"
+  headers:
+  - key: Content-Type
+    value: application/json
+  - key: Authorization
+    value: Bearer {{authToken
+
+docs: |-
+  ## Bulk Dismiss Conflicts
+  
+    Dismisses multiple sync conflicts without resolving them. This removes them from the conflict list while leaving the data unchanged.
+  
+    **Method:** POST
+  
+    **Endpoint:** /api/conflicts/bulk-dismiss
+  
+    **Authentication:** Bearer token
+  
+    **Request Body:**
+    - `conflict_ids` (array): Array of conflict UUIDs to dismiss
+  
+    **Response:**
+    - `results` (array): Results for each dismissal
+    - `total` (number): Total number of conflicts processed
+    - `success` (number): Number of successfully dismissed conflicts
+    - `failed` (number): Number of failed dismissals
+  
+    **Status Codes:**
+    - 200: Success
+    - 400: Invalid request data
+    - 401: Unauthorized
+    - 403: Forbidden
+    - 404: One or more conflicts not found
+    - 500: Internal server error
+  
+    **Example:**
+    ```json
+    {
+      "conflict_ids": ["uuid-1", "uuid-2"]
@@ -0,0 +1,55 @@
+info:
+  name: Bulk Resolve Conflicts
+  type: http
+  seq: 1
+http:
+  method: POST
+  url: '{{base_url}}/api/conflicts/bulk-resolve'
+  auth: inherit
+  body:
+    type: json
+    jsonBody: "{\n    \"conflict_ids\": [\n      \"{{conflictId1"
+  headers:
+  - key: Content-Type
+    value: application/json
+  - key: Authorization
+    value: Bearer {{authToken
+
+docs: |-
+  ## Bulk Resolve Conflicts
+  
+    Resolves multiple sync conflicts in a single request using a specified resolution strategy.
+  
+    **Method:** POST
+  
+    **Endpoint:** /api/conflicts/bulk-resolve
+  
+    **Authentication:** Bearer token
+  
+    **Request Body:**
+    - `conflict_ids` (array): Array of conflict UUIDs to resolve
+    - `strategy` (string): Resolution strategy
+      - `most_recent`: Use the most recently updated progress
+      - `highest_progress`: Use the reading progress with the highest percent read
+      - `server`: Always prefer server-side data
+      - `device`: Always prefer device-side data
+  
+    **Response:**
+    - `results` (array): Results for each conflict resolution
+    - `total` (number): Total number of conflicts processed
+    - `success` (number): Number of successfully resolved conflicts
+    - `failed` (number): Number of failed resolutions
+  
+    **Status Codes:**
+    - 200: Success (with partial results if some failed)
+    - 400: Invalid request data
+    - 401: Unauthorized
+    - 403: Forbidden
+    - 404: One or more conflicts not found
+    - 500: Internal server error
+  
+    **Example:**
+    ```json
+    {
+      "conflict_ids": ["uuid-1", "uuid-2", "uuid-3"],
+      "strategy": "most_recent"
@@ -0,0 +1,46 @@
+info:
+  name: Bulk Resolve with Highest Progress Strategy
+  type: http
+  seq: 1
+http:
+  method: POST
+  url: '{{base_url}}/api/conflicts/bulk-resolve'
+  auth: inherit
+  body:
+    type: json
+    jsonBody: "{\n    \"conflict_ids\": [\n      \"{{conflictId1"
+  headers:
+  - key: Content-Type
+    value: application/json
+  - key: Authorization
+    value: Bearer {{authToken
+
+docs: |-
+  ## Bulk Resolve with Highest Progress Strategy
+  
+    Resolves multiple sync conflicts using the "highest_progress" strategy, which keeps the reading progress with the highest percentage read.
+  
+    **Method:** POST
+  
+    **Endpoint:** /api/conflicts/bulk-resolve
+  
+    **Authentication:** Bearer token
+  
+    **Request Body:**
+    - `conflict_ids` (array): Array of conflict UUIDs to resolve
+    - `strategy` (string): Must be "highest_progress"
+  
+    **Response:**
+    - `results` (array): Results for each conflict resolution
+    - `total` (number): Total number of conflicts processed
+    - `success` (number): Number of successfully resolved conflicts
+    - `failed` (number): Number of failed resolutions
+  
+    **Status Codes:**
+    - 200: Success
+    - 400: Invalid request data
+    - 401: Unauthorized
+    - 403: Forbidden
+    - 500: Internal server error
+  
+    **Note:** The highest progress strategy is ideal when you want to preserve the most reading progress across devices. Use this when you've been reading on multiple devices and want to keep the furthest position.