How kridha24/homemind-ai works
HomeMind AI is a multi-tenant household operating system. A household member uses the web or mobile app to manage finances, bills, groceries, tasks, and family coordination; the app calls the REST backend, which applies household and role controls and serves domain features. The product also includes analytics, an AI copilot, encrypted messaging and calling, and background processing. The README documents these capabilities; source excerpts confirm selected authentication, task-sync, storage, and AI-service behavior, but do not expose every domain’s internal call chain.
Main entry points: apiClient.ts API client · db.ts Household database · App.tsx Web and mobile app · main.py AI service
Components 23
Household clients
- Web and mobile app
apps/web/src/App.tsx - API client
apps/web/src/services/apiClient.ts - Household dashboard
apps/web/src/pages/Dashboard.tsx
API domains
- Authentication and RBAC
apps/api/src/middleware/auth.ts - Finance tracking
apps/api/src/modules/finance/transactions/transaction.service.ts - Bills management
apps/api/src/modules/bills/bill.service.ts - Household coordination
- Groceries and pantry
apps/web/src/features/groceries - Tasks and chores
apps/web/src/features/tasks/hooks/useTasks.ts
AI and analytics
- Financial analytics
apps/api/src/modules/analytics/analytics.service.ts - Natural-language copilot
apps/api/src/modules/copilot/copilot.service.ts - AI service
ai-service/app/main.py - Receipt and pantry OCR
ai-service/app/routers/ocr.py - Recipe suggestions
ai-service/app/routers/recipes.py - Forecasting and insights
ai-service/app/routers/forecasting.py
Platform operations
- Household database
apps/api/src/repositories/db.ts - Background workers
apps/worker/src/workers/index.ts - Object storage
apps/api/src/infrastructure/storage/objectStorageService.ts
Family connection
- Encrypted messaging
apps/api/src/modules/communication/secureMessagingService.ts - WebRTC calling
apps/api/src/services/webrtcSignalingService.ts - Realtime gateway
apps/api/src/services/realtimeGateway.ts
Other components
- Household member
- AI capabilities
Connections 27
- Household member → Web and mobile app: manages household
README.md - Web and mobile app → API client: requests data
apps/web/src/App.tsx - API client → Authentication and RBAC: sends bearer token
apps/web/src/services/apiClient.ts - API client → Finance tracking: calls REST API
- API client → Bills management: calls REST API
- API client → Tasks and chores: calls task API
apps/web/src/features/tasks/hooks/useTasks.ts - API client → Household coordination: calls REST API
- Authentication and RBAC → Household database: checks user
apps/api/src/middleware/auth.ts - Web and mobile app → Household dashboard: renders
apps/web/src/App.tsx - Household dashboard → API client: loads household view
- Finance tracking → Household database: reads and writes
- Bills management → Household database: reads and writes
- Tasks and chores → Household database: persists tasks
- Groceries and pantry → API client: uses API
- Financial analytics → Household database: analyzes records
- Natural-language copilot → Household database: uses household data
apps/api/src/modules/copilot/copilot.controller.ts - AI service → Receipt and pantry OCR: registers route
ai-service/app/main.py - AI service → Recipe suggestions: registers route
ai-service/app/main.py - AI service → Forecasting and insights: registers route
ai-service/app/main.py - Natural-language copilot → AI service: may request AI
- AI service → AI capabilities: uses intelligence
- Background workers → Household database: processes jobs
- Web and mobile app → Encrypted messaging: uses family chat
- Web and mobile app → WebRTC calling: starts calls
- Web and mobile app → Realtime gateway: syncs live updates
- Object storage → Household database: stores object references
- Household member → Encrypted messaging: exchanges messages