How enkhbold0519/omnicave works
OmniCave is a multi-device wine-cellar management product: users manage cellars and bottles, inspect physical locations and conditions, and access AI assistance through a display and companion apps. The primary visible flow is display interaction through its API client to backend routes, which dispatch to inventory, vision, and service logic backed by a database. Separate capability branches cover environmental monitoring, recommendations, critic dialogue, briefings, and collection valuation. The README documents the broader ecosystem; some subsystem links are therefore documented rather than verified in sampled implementation.
Main entry points: routes.py Route dispatch · services.py Account and business services · main.py HTTP API · App.tsx Display interface
Components 21
Integrated display
- Display interface
webos/wine-cellar-display/src/App.tsx - Display API client
webos/wine-cellar-display/src/api.ts - Detection review
webos/wine-cellar-display/src/components/ReviewDetection.tsx
Cellar backend
- HTTP API
backend/app/main.py - Route dispatch
backend/app/routes.py - Cellars and bottles
backend/app/inventory.py - Cellar geometry
backend/app/geometry.py - Cellar database
backend/app/db.py - Bottle recognition
backend/app/vision.py - Devices and sensors
backend/app/devices.py - Environmental monitoring
backend/app/simulator.py - Account and business services
backend/app/services.py
AI and insights
- Wine recommendations
backend/app/services.py - Critic dialogue
backend/app/tasting.py - LLM client
backend/app/llm.py - LLM provider
- Wine briefing
backend/app/news.py - Market valuation
backend/app/market.py
Companion clients
- iOS companion
Mobile/ios/OmniCave/Views.swift
Other components
- Cellar user
- Mobile user
Connections 25
- Cellar user → Display interface: uses
README.md - Display interface → Display API client: calls
webos/wine-cellar-display/src/App.tsx - Display API client → HTTP API: requests
README.md - Display interface → Detection review: presents
webos/wine-cellar-display/src/App.tsx - Detection review → Display API client: confirms detection
webos/wine-cellar-display/src/components/ReviewDetection.tsx - HTTP API → Route dispatch: dispatches
backend/app/main.py - Route dispatch → Cellars and bottles: routes cellar requests
backend/app/routes.py - Route dispatch → Account and business services: routes service requests
backend/app/routes.py - Route dispatch → Bottle recognition: routes vision requests
backend/app/routes.py - Cellars and bottles → Cellar database: reads and writes
backend/app/inventory.py - Cellars and bottles → Cellar geometry: uses placement logic
backend/app/inventory.py - Route dispatch → Devices and sensors: routes device requests
backend/app/routes.py - HTTP API → Cellar database: initializes
backend/app/main.py - HTTP API → Environmental monitoring: starts and stops
backend/app/main.py - Account and business services → Cellar database: uses persistence
backend/app/services.py - Account and business services → LLM client: requests generation
backend/app/services.py - Account and business services → Wine recommendations: provides
README.md - Route dispatch → Critic dialogue: routes dialogue
backend/app/routes.py - Critic dialogue → LLM client: generates dialogue
README.md - LLM client → LLM provider: streams completions
backend/app/llm.py - Account and business services → Wine briefing: aggregates news
backend/app/services.py - Account and business services → Market valuation: uses market data
backend/app/services.py - Mobile user → iOS companion: uses
README.md - iOS companion → HTTP API: synchronizes with
README.md - Devices and sensors → Environmental monitoring: provides monitoring
README.md