Just a whole lot of crap

docs/tui-operations-guide.md

@@ -0,0 +1,146 @@
+# TUI Operations Guide
+
+## Overview
+
+The TUI Operations screen provides an interactive interface for executing Shopify price update operations directly from the terminal interface.
+
+## How to Access
+
+1. Run the TUI: `node src/tui-entry.js` or `npm run tui`
+2. Navigate to "🔧 Operations" from the main menu
+3. Use arrow keys to select operations and press Enter to execute
+
+## Available Operations
+
+### 💰 Update Prices
+
+- **Purpose**: Apply percentage adjustment to product prices
+- **Requirements**: Full configuration (domain, token, tag, adjustment %)
+- **What it does**:
+  - Fetches products with the target tag
+  - Applies the configured price adjustment
+  - Sets compare-at prices for rollback capability
+  - Updates prices in Shopify
+
+### ↩️ Rollback Prices
+
+- **Purpose**: Revert prices to their compare-at values
+- **Requirements**: Full configuration + previous price update
+- **What it does**:
+  - Finds products with compare-at prices
+  - Reverts current prices to compare-at prices
+  - Clears compare-at prices after rollback
+
+### 🔗 Test Connection
+
+- **Purpose**: Verify Shopify API access and credentials
+- **Requirements**: Domain and access token only
+- **What it does**:
+  - Tests connection to Shopify API
+  - Verifies access token permissions
+  - Confirms store domain is accessible
+  - **Note**: Can be run even without full configuration
+
+### 📊 Analyze Products
+
+- **Purpose**: Preview products that will be affected by operations
+- **Requirements**: Full configuration
+- **What it does**:
+  - Fetches products with the target tag
+  - Counts total products and variants
+  - Shows how many variants have prices
+  - Displays what the price adjustment will be
+  - **Note**: Read-only operation, makes no changes
+
+## Operation Status & Progress
+
+### Progress Tracking
+
+- Real-time progress bar during operations
+- Status messages showing current step
+- Percentage completion indicator
+
+### Results Display
+
+- ✅ Success: Green border with success message and details
+- ❌ Error: Red border with error message and troubleshooting tips
+- 🚀 In Progress: Yellow border with progress information
+
+### Result Details
+
+Each operation shows:
+
+- Success/failure status
+- Number of products/variants processed
+- Specific error messages if applicable
+- Helpful troubleshooting suggestions
+
+## Navigation
+
+### Keyboard Controls
+
+- **↑/↓ Arrow Keys**: Navigate between operations
+- **Enter**: Execute selected operation
+- **Esc**: Return to main menu
+
+### Operation States
+
+- **Enabled**: White text - operation can be executed
+- **Disabled**: Gray text - missing required configuration
+- **Selected**: Blue background - currently highlighted operation
+
+## Configuration Requirements
+
+### Minimum for Test Connection
+
+- Shopify Shop Domain
+- Shopify Access Token
+
+### Full Configuration Required
+
+- Shopify Shop Domain
+- Shopify Access Token
+- Target Product Tag
+- Price Adjustment Percentage
+- Operation Mode (update/rollback)
+
+## Error Handling
+
+### Common Issues
+
+1. **Connection Failed**: Check domain and access token
+2. **No Products Found**: Verify target tag exists on products
+3. **Permission Denied**: Ensure access token has required permissions
+4. **Network Error**: Check internet connection
+
+### Troubleshooting Tips
+
+- Use "Test Connection" first to verify basic setup
+- Use "Analyze Products" to preview before making changes
+- Check the main console output for detailed error logs
+- Verify your .env file has all required variables
+
+## Safety Features
+
+### Preview Before Action
+
+- "Analyze Products" shows exactly what will be affected
+- Configuration status clearly displayed before operations
+- Confirmation required for destructive operations
+
+### Rollback Capability
+
+- Update operations automatically set compare-at prices
+- Rollback operation can revert changes
+- Clear status messages about what can/cannot be rolled back
+
+## Integration with Main App
+
+The TUI operations use the same underlying services as the command-line version:
+
+- Same ShopifyService for API calls
+- Same ProductService for business logic
+- Same error handling and retry mechanisms
+- Same logging and progress tracking
+
+This ensures consistency between TUI and CLI operations.