Add mileage tracking automation plan
https://claude.ai/code/session_015myTTMs6yDsAGarATe5ePZ
This commit is contained in:
commit
2b5a39a550
1 changed files with 69 additions and 0 deletions
69
PLAN.md
Normal file
69
PLAN.md
Normal file
|
|
@ -0,0 +1,69 @@
|
|||
# Mileage Tracking Automation — Plan
|
||||
|
||||
## How it works
|
||||
|
||||
1. Open the web app on your phone
|
||||
2. Take a photo of the odometer
|
||||
3. Claude Vision API reads the number automatically
|
||||
4. The km driven is calculated and saved to an Excel sheet
|
||||
5. Download the sheet anytime
|
||||
|
||||
---
|
||||
|
||||
## Stack
|
||||
|
||||
| Layer | Technology |
|
||||
|-------------|-----------------------------|
|
||||
| Backend | Python + Flask |
|
||||
| AI / OCR | Claude API (vision) |
|
||||
| Spreadsheet | openpyxl (Excel .xlsx) |
|
||||
| Frontend | Mobile-friendly HTML |
|
||||
|
||||
---
|
||||
|
||||
## Excel sheet columns
|
||||
|
||||
| Date | Time | Odometer (km) | Trip (km) | Notes |
|
||||
|------------|-------|---------------|-----------|-------|
|
||||
| 2026-03-18 | 08:14 | 84 320 | 47 | Work |
|
||||
|
||||
---
|
||||
|
||||
## Files to create
|
||||
|
||||
```
|
||||
Driverthing/
|
||||
├── app.py # Flask server + Claude API call
|
||||
├── mileage.py # Excel read/write logic
|
||||
├── templates/
|
||||
│ └── index.html # Mobile camera upload page
|
||||
├── requirements.txt
|
||||
└── mileage_log.xlsx # Generated, gitignored
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Flow
|
||||
|
||||
```
|
||||
Phone camera → upload photo
|
||||
→ Flask receives image
|
||||
→ Claude Vision: "What is the odometer reading?"
|
||||
→ Extract number
|
||||
→ Calculate delta from last reading
|
||||
→ Append row to Excel
|
||||
→ Show confirmation on screen
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Implementation steps
|
||||
|
||||
1. Set up Flask app with a file upload endpoint
|
||||
2. Send uploaded image to Claude API with a vision prompt
|
||||
3. Parse the odometer number from the response
|
||||
4. Read the last recorded odometer value from the Excel file
|
||||
5. Calculate the difference (km driven)
|
||||
6. Append a new row (date, time, odometer, trip km, notes) to the sheet
|
||||
7. Return confirmation to the browser
|
||||
8. Add a download button for the Excel file
|
||||
Loading…
Add table
Reference in a new issue