How sakshij2810/personal-ai-memory-action-assistant works
Memora AI is an early-stage personal-memory assistant; the implemented workflow is currently session authentication and image upload, storage, queued processing, and analysis retrieval. The README describes broader capabilities—people and event intelligence, connected memories, search, actions, and chat/voice—as progressive product goals; their implementation is not established by the sampled source, so they are not drawn as runtime components. Queue and worker links rely on SOURCE INDEX references where noted; unsampled behavior is not assumed.
Main entry points: db.ts PostgreSQL · App.tsx Application routes · media.helper.ts Media metadata and jobs · app.ts Express application
Components 26
Web client
- Application routes
frontend/src/App.tsx - Home and login
frontend/src/views/Home/Home.tsx - Image uploads
frontend/src/views/MediaUploads/UploadImages.tsx - Gallery data hook
frontend/src/hooks/useGallery.ts - Media API client
frontend/src/apis/media.api.ts
Backend API
- Express application
backend/app.ts - Auth routes
backend/routes/auth.routes.ts - Authentication
backend/controllers/auth.controller.ts - Session guard
backend/middleware/isAuth.ts - Session Redis
backend/shared/redis/redis.ts - Media routes
backend/routes/media.routes.ts - Upload validation
backend/middleware/multer.ts - Media operations
backend/controllers/media.controller.ts - PostgreSQL
backend/config/db.ts
Media processing
- Media metadata and jobs
backend/helpers/media.helper.ts - Media queue
backend/queues/media.queue.ts - Analysis queue
backend/queues/analysis.queue.ts - BullMQ Redis
backend/shared/redis/bullmq-connection.ts - Media worker
backend/workers/media.worker.ts
AI analysis
- Analysis worker
backend/workers/analysis.worker.ts - AI service
backend/services/ai/ai.service.ts - Provider registry
backend/services/ai/registry.ts - Provider registration
backend/services/ai/register.ts - Gemini provider
backend/services/ai/providers/gemini.provider.ts - Analysis repository
backend/services/ai/analysis.repository.ts
Other components
- User
Connections 30
- User → Application routes: uses
- Application routes → Home and login: routes to
frontend/src/App.tsx - Application routes → Image uploads: routes to
frontend/src/App.tsx - Application routes → Gallery data hook: loads data via
frontend/src/App.tsx - Gallery data hook → Media API client: calls
frontend/src/hooks/useGallery.ts - Express application → Auth routes: mounts
backend/app.ts - Express application → Media routes: mounts
backend/app.ts - Express application → Session guard: guards media with
backend/app.ts - Auth routes → Authentication: routes to
backend/routes/auth.routes.ts - Authentication → PostgreSQL: reads and writes
backend/controllers/auth.controller.ts - Authentication → Session Redis: stores sessions
backend/controllers/auth.controller.ts - Session guard → Session Redis: checks session
backend/middleware/isAuth.ts - Media routes → Upload validation: validates uploads
backend/routes/media.routes.ts - Media routes → Media operations: routes requests
backend/routes/media.routes.ts - Media operations → Media metadata and jobs: saves and enqueues
backend/controllers/media.controller.ts - Media operations → PostgreSQL: queries media
backend/controllers/media.controller.ts - Media metadata and jobs → PostgreSQL: writes metadata
backend/helpers/media.helper.ts - Media metadata and jobs → Media queue: enqueues processing
backend/helpers/media.helper.ts - Media metadata and jobs → Analysis queue: enqueues analysis
backend/helpers/media.helper.ts - Media queue → BullMQ Redis: uses connection
backend/queues/media.queue.ts - Analysis queue → BullMQ Redis: uses connection
backend/queues/analysis.queue.ts - Media worker → Media queue: consumes jobs
backend/workers/media.worker.ts - Media worker → PostgreSQL: updates media
backend/workers/media.worker.ts - Analysis worker → Analysis queue: consumes jobs
backend/workers/analysis.worker.ts - Analysis worker → AI service: requests analysis
backend/workers/analysis.worker.ts - Analysis worker → Analysis repository: persists results
backend/workers/analysis.worker.ts - AI service → Provider registry: selects provider
backend/services/ai/ai.service.ts - Provider registration → Provider registry: registers provider
backend/services/ai/register.ts - Provider registration → Gemini provider: loads provider
backend/services/ai/register.ts - Analysis repository → PostgreSQL: reads and writes
backend/services/ai/analysis.repository.ts