How jkhamanishi/odometer-app works
This is an odometer-reading capture and submission app. A user selects a photo, adjusts a crop around the digits, and the frontend processes the image and recognizes digits; the user can review and submit the reading with date, time, and record type. The backend accepts a payload, saves an optional image to Drive, and appends reading metadata and its image link to a Sheet. The excerpts support the frontend processing and backend storage stages, but do not show the API transport wiring between them.
Main entry points: index.ts File Handlers · fileSelection.ts File Selection · fileAnalysis.ts File Analysis · formSubmitHandler.ts Submission Workflow
Components 22
Photo Capture
- App Startup
frontend/src/main.ts - File Handlers
frontend/src/fileHandler/index.ts - File Selection
frontend/src/fileHandler/fileSelection.ts - File Analysis
frontend/src/fileHandler/fileAnalysis.ts - Selected File State
frontend/src/fileHandler/fileState.ts - File Date Time
frontend/src/fileHandler/fileDateTime.ts
Image Recognition
- Crop Selection
frontend/src/imageProcessing/cropperManager.ts - Image Previews
frontend/src/fileHandler/filePreviewRendering.ts - Preview Hiding
frontend/src/fileHandler/filePreviewHiding.ts - Image Processing
frontend/src/imageProcessing/processImage.ts - Processor Framework
frontend/src/imageProcessing/processors/processor.ts - Image Processors
frontend/src/imageProcessing/processors - Digit Recognition
frontend/src/imageProcessing/ocr/sevenSegmentOcr.ts
Reading Submission
- Form Handlers
frontend/src/formHandler/index.ts - Submission Workflow
frontend/src/formHandler/formSubmitHandler.ts - Image Encoding
frontend/src/formHandler/fileToBase64.ts - API Client
frontend/src/formHandler/api.ts
Recording Backend
- Request Dispatcher
backend/src/index.ts - Record Handler
backend/src/doPost.ts - Google Drive
- Google Sheets
Other components
- User
Connections 24
- User → App Startup: uses
frontend/src/main.ts - App Startup → File Handlers: initializes
frontend/src/main.ts - App Startup → Form Handlers: initializes
frontend/src/main.ts - File Handlers → File Selection: initializes
frontend/src/fileHandler/index.ts - File Handlers → File Analysis: initializes
frontend/src/fileHandler/index.ts - File Handlers → Selected File State: uses
frontend/src/fileHandler/index.ts - File Handlers → Selected File State: resets
frontend/src/fileHandler/index.ts - File Selection → Selected File State: updates
frontend/src/fileHandler/fileSelection.ts - File Selection → File Date Time: uses
frontend/src/fileHandler/fileSelection.ts - File Selection → Image Processing: uses
frontend/src/fileHandler/fileSelection.ts - File Analysis → Image Processing: uses
frontend/src/fileHandler/fileAnalysis.ts - File Analysis → Image Previews: renders
frontend/src/fileHandler/fileAnalysis.ts - File Analysis → Preview Hiding: hides
frontend/src/fileHandler/fileAnalysis.ts - Image Processing → Processor Framework: creates processors
frontend/src/imageProcessing/processImage.ts - Image Processing → Image Processors: runs pipeline
frontend/src/imageProcessing/processImage.ts - Image Processors → Processor Framework: extends
frontend/src/imageProcessing/processors/noiseReduction.ts - Form Handlers → Submission Workflow: registers
frontend/src/formHandler/index.ts - Submission Workflow → API Client: calls
frontend/src/formHandler/formSubmitHandler.ts - Submission Workflow → Image Encoding: encodes image
frontend/src/formHandler/formSubmitHandler.ts - Submission Workflow → File Handlers: reads and resets
frontend/src/formHandler/formSubmitHandler.ts - API Client → Request Dispatcher: sends request
- Request Dispatcher → Record Handler: dispatches
backend/src/index.ts - Record Handler → Google Drive: writes image
backend/src/doPost.ts - Record Handler → Google Sheets: appends reading
backend/src/doPost.ts