Skip to content

Commit 4b49621

Browse files
wesmclaude
andcommitted
docs: Simplify Amazon mode guide by removing developer-focused sections
**Removed:** - Data Model section (developer-focused, not needed for users) - Database section (developer-focused SQL inspection commands) - Future Enhancements section (speculative, not user-focused) - Limitations section (didn't add value for users) - Detailed UI Navigation subsections (redundant with main keyboard shortcuts) **Simplified:** - UI Navigation section now just notes view name mappings: - Item (instead of Merchant) - Category (same) - Order ID (instead of Group) - Account not available - Links to full keyboard shortcuts guide - Notes that all other shortcuts work the same as Monarch mode **Retained:** - All user-facing features and workflows - Getting started instructions - Import process - Troubleshooting (including "start fresh" command) - Tips section **Why:** - More focused on user needs (importing and using Amazon mode) - Removed 60+ lines of developer-focused content - Cleaner, more maintainable - View name mappings are clear and concise - Users don't need to know about database schema or internal data structures 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
1 parent 6be9365 commit 4b49621

File tree

1 file changed

+8
-91
lines changed

1 file changed

+8
-91
lines changed

docs/guide/amazon-mode.md

Lines changed: 8 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -141,100 +141,17 @@ moneyflow amazon --db-path ~/custom.db status
141141

142142
## UI Navigation
143143

144-
Amazon mode uses the same keyboard shortcuts as Monarch mode:
144+
Amazon mode uses the same keyboard shortcuts as Monarch mode. See [Keyboard Shortcuts](keyboard-shortcuts.md) for the complete reference.
145145

146-
### View Modes
147-
- `g` - Cycle between Item and Category views
148-
- `d` - View all transactions (detail view)
146+
**View name mappings:**
149147

150-
### Time Navigation
151-
- `y` - Current year
152-
- `t` - Current month
153-
- `a` - All time
154-
- `←/→` - Previous/next period
148+
In Amazon mode, views reflect Amazon purchase data:
149+
- **Item** (instead of Merchant) - Product names
150+
- **Category** - Product categories
151+
- **Order ID** (instead of Group) - Group by Amazon order
152+
- Account view is not available
155153

156-
### Editing
157-
- `m` - Edit item name
158-
- `c` - Edit category
159-
- `h` - Hide/unhide from reports
160-
- `Space` - Multi-select for bulk operations
161-
- `u` - Undo most recent pending edit
162-
- `w` - Review and commit changes
163-
164-
### Other
165-
- `?` - Show help
166-
- `q` - Quit
167-
168-
See [Keyboard Shortcuts](keyboard-shortcuts.md) for the complete list.
169-
170-
## Data Model
171-
172-
### Transactions
173-
174-
Each Amazon purchase is stored as a transaction with:
175-
176-
- **ID**: Generated from ASIN + Order ID (for deduplication)
177-
- **Date**: Order date
178-
- **Merchant**: Product name (displayed as "Merchant" in UI)
179-
- **Category**: Automatically assigned from category mappings (editable)
180-
- **Amount**: Total Owed (negative, like expenses)
181-
- **Quantity**: Number of items ordered
182-
- **ASIN**: Amazon product identifier
183-
- **Order ID**: Amazon order number
184-
- **Order Status**: Order state (Closed, New, etc.)
185-
- **Shipment Status**: Shipping state (Shipped, Delivered, etc.)
186-
- **Notes**: Additional info (e.g., order details)
187-
- **Hide from Reports**: Toggle visibility
188-
189-
### Categories
190-
191-
Categories are assigned automatically using moneyflow's centralized category module (shared with Monarch mode). You can:
192-
- Edit category assignments in the UI
193-
- View spending by category
194-
- Categories are NOT stored in the database - they come from `categories.py`
195-
196-
## Database
197-
198-
Amazon data is stored in a local SQLite database (default: `~/.moneyflow/amazon.db`).
199-
200-
**Tables:**
201-
- `transactions` - Order records (one row per item)
202-
- `import_history` - Audit trail of imports
203-
204-
**To inspect directly:**
205-
```bash
206-
sqlite3 ~/.moneyflow/amazon.db
207-
.tables
208-
SELECT * FROM import_history;
209-
SELECT COUNT(*) FROM transactions WHERE order_status = 'Closed';
210-
.quit
211-
```
212-
213-
**To start fresh:**
214-
```bash
215-
# Delete database
216-
rm ~/.moneyflow/amazon.db
217-
218-
# Re-import
219-
moneyflow amazon import ~/Downloads/"Your Orders"
220-
```
221-
222-
## Limitations
223-
224-
- **Read-only**: No sync back to Amazon (local edits only)
225-
- **Manual data export**: Requires requesting "Your Orders" export from Amazon
226-
- **No live updates**: Must re-request data from Amazon to get new orders
227-
- **Item-level only**: Each item in an order is a separate transaction (no order grouping)
228-
229-
## Future Enhancements
230-
231-
Planned improvements:
232-
- Order-level grouping (link items from same order)
233-
- Seller name extraction and filtering
234-
- Returns and refunds tracking
235-
- Subscription detection
236-
- Amazon category to moneyflow category mapping improvements
237-
- Custom category rules
154+
All other navigation, editing, and search shortcuts work the same as in Monarch mode.
238155

239156
## Troubleshooting
240157

0 commit comments

Comments
 (0)