# sakshij2810/personal-ai-memory-action-assistant architecture

> Architecture diagram of the GitHub repository sakshij2810/personal-ai-memory-action-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sakshij2810/personal-ai-memory-action-assistant
- Repository: https://github.com/sakshij2810/personal-ai-memory-action-assistant

## Overview

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: [`backend/config/db.ts`](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/config/db.ts) (PostgreSQL), [`frontend/src/App.tsx`](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/App.tsx) (Application routes), [`backend/helpers/media.helper.ts`](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/helpers/media.helper.ts) (Media metadata and jobs), [`backend/app.ts`](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/app.ts) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["Application routes<br/>[App.tsx]"]
  node_home["Home and login<br/>[Home.tsx]"]
  node_upload["Image uploads<br/>[UploadImages.tsx]"]
  node_gallery["Gallery data hook<br/>[useGallery.ts]"]
  node_mediaapi["Media API client<br/>[media.api.ts]"]
end

subgraph group_api["Backend API"]
  node_server["Express application<br/>[app.ts]"]
  node_authroutes["Auth routes<br/>[auth.routes.ts]"]
  node_auth["Authentication<br/>[auth.controller.ts]"]
  node_authguard["Session guard<br/>[isAuth.ts]"]
  node_redis_sessions[("Session Redis<br/>[redis.ts]")]
  node_mediaroutes["Media routes<br/>[media.routes.ts]"]
  node_uploadmiddleware["Upload validation<br/>[multer.ts]"]
  node_mediacontroller["Media operations"]
  node_postgres[("PostgreSQL<br/>[db.ts]")]
end

subgraph group_processing["Media processing"]
  node_mediahelper["Media metadata and jobs<br/>[media.helper.ts]"]
  node_mediaqueue["Media queue<br/>[media.queue.ts]"]
  node_analysisqueue["Analysis queue<br/>[analysis.queue.ts]"]
  node_bullredis[("BullMQ Redis")]
  node_mediaworker["Media worker<br/>[media.worker.ts]"]
end

subgraph group_ai["AI analysis"]
  node_analysisworker["Analysis worker<br/>[analysis.worker.ts]"]
  node_aiservice["AI service<br/>[ai.service.ts]"]
  node_airegistry["Provider registry<br/>[registry.ts]"]
  node_providerregister["Provider registration<br/>[register.ts]"]
  node_gemini["Gemini provider<br/>[gemini.provider.ts]"]
  node_analysisrepo["Analysis repository"]
end

node_user(("User"))

node_user -.->|"uses"| node_webapp
node_webapp -->|"routes to"| node_home
node_webapp -->|"routes to"| node_upload
node_webapp -->|"loads data via"| node_gallery
node_gallery -->|"calls"| node_mediaapi
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_mediaroutes
node_server -->|"guards media with"| node_authguard
node_authroutes -->|"routes to"| node_auth
node_auth -->|"reads and writes"| node_postgres
node_auth -->|"stores sessions"| node_redis_sessions
node_authguard -->|"checks session"| node_redis_sessions
node_mediaroutes -->|"validates uploads"| node_uploadmiddleware
node_mediaroutes -->|"routes requests"| node_mediacontroller
node_mediacontroller -->|"saves and enqueues"| node_mediahelper
node_mediacontroller -->|"queries media"| node_postgres
node_mediahelper -->|"writes metadata"| node_postgres
node_mediahelper -->|"enqueues processing"| node_mediaqueue
node_mediahelper -->|"enqueues analysis"| node_analysisqueue
node_mediaqueue -->|"uses connection"| node_bullredis
node_analysisqueue -->|"uses connection"| node_bullredis
node_mediaworker -->|"consumes jobs"| node_mediaqueue
node_mediaworker -->|"updates media"| node_postgres
node_analysisworker -->|"consumes jobs"| node_analysisqueue
node_analysisworker -->|"requests analysis"| node_aiservice
node_analysisworker -->|"persists results"| node_analysisrepo
node_aiservice -->|"selects provider"| node_airegistry
node_providerregister -->|"registers provider"| node_airegistry
node_providerregister -->|"loads provider"| node_gemini
node_analysisrepo -->|"reads and writes"| node_postgres

click node_webapp "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/App.tsx"
click node_home "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/views/Home/Home.tsx"
click node_upload "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/views/MediaUploads/UploadImages.tsx"
click node_gallery "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/hooks/useGallery.ts"
click node_mediaapi "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/apis/media.api.ts"
click node_server "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/app.ts"
click node_authroutes "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/routes/auth.routes.ts"
click node_auth "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/controllers/auth.controller.ts"
click node_authguard "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/middleware/isAuth.ts"
click node_redis_sessions "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/shared/redis/redis.ts"
click node_mediaroutes "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/routes/media.routes.ts"
click node_uploadmiddleware "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/middleware/multer.ts"
click node_mediacontroller "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/controllers/media.controller.ts"
click node_postgres "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/config/db.ts"
click node_mediahelper "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/helpers/media.helper.ts"
click node_mediaqueue "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/queues/media.queue.ts"
click node_analysisqueue "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/queues/analysis.queue.ts"
click node_bullredis "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/shared/redis/bullmq-connection.ts"
click node_mediaworker "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/workers/media.worker.ts"
click node_analysisworker "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/workers/analysis.worker.ts"
click node_aiservice "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/ai.service.ts"
click node_airegistry "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/registry.ts"
click node_providerregister "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/register.ts"
click node_gemini "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/providers/gemini.provider.ts"
click node_analysisrepo "https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/analysis.repository.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_home,node_upload,node_gallery,node_mediaapi,node_user toneBlue
class node_server,node_authroutes,node_auth,node_authguard,node_redis_sessions,node_mediaroutes,node_uploadmiddleware,node_mediacontroller,node_postgres toneAmber
class node_mediahelper,node_mediaqueue,node_analysisqueue,node_bullredis,node_mediaworker toneMint
class node_analysisworker,node_aiservice,node_airegistry,node_providerregister,node_gemini,node_analysisrepo toneRose
```

## Components

### Web client

- [Application routes](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Home and login](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/views/Home/Home.tsx): `frontend/src/views/Home/Home.tsx`
- [Image uploads](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/views/MediaUploads/UploadImages.tsx): `frontend/src/views/MediaUploads/UploadImages.tsx`
- [Gallery data hook](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/hooks/useGallery.ts): `frontend/src/hooks/useGallery.ts`
- [Media API client](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/frontend/src/apis/media.api.ts): `frontend/src/apis/media.api.ts`

### Backend API

- [Express application](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/app.ts): `backend/app.ts`
- [Auth routes](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/routes/auth.routes.ts): `backend/routes/auth.routes.ts`
- [Authentication](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/controllers/auth.controller.ts): `backend/controllers/auth.controller.ts`
- [Session guard](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/middleware/isAuth.ts): `backend/middleware/isAuth.ts`
- [Session Redis](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/shared/redis/redis.ts): `backend/shared/redis/redis.ts`
- [Media routes](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/routes/media.routes.ts): `backend/routes/media.routes.ts`
- [Upload validation](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/middleware/multer.ts): `backend/middleware/multer.ts`
- [Media operations](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/controllers/media.controller.ts): `backend/controllers/media.controller.ts`
- [PostgreSQL](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/config/db.ts): `backend/config/db.ts`

### Media processing

- [Media metadata and jobs](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/helpers/media.helper.ts): `backend/helpers/media.helper.ts`
- [Media queue](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/queues/media.queue.ts): `backend/queues/media.queue.ts`
- [Analysis queue](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/queues/analysis.queue.ts): `backend/queues/analysis.queue.ts`
- [BullMQ Redis](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/shared/redis/bullmq-connection.ts): `backend/shared/redis/bullmq-connection.ts`
- [Media worker](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/workers/media.worker.ts): `backend/workers/media.worker.ts`

### AI analysis

- [Analysis worker](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/workers/analysis.worker.ts): `backend/workers/analysis.worker.ts`
- [AI service](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/ai.service.ts): `backend/services/ai/ai.service.ts`
- [Provider registry](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/registry.ts): `backend/services/ai/registry.ts`
- [Provider registration](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/register.ts): `backend/services/ai/register.ts`
- [Gemini provider](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/providers/gemini.provider.ts): `backend/services/ai/providers/gemini.provider.ts`
- [Analysis repository](https://github.com/sakshij2810/personal-ai-memory-action-assistant/blob/main/backend/services/ai/analysis.repository.ts): `backend/services/ai/analysis.repository.ts`

### Other components

- **User**

## Connections

- User → Application routes: uses
- Application routes → Home and login: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Image uploads: routes to (evidence: `frontend/src/App.tsx`)
- Application routes → Gallery data hook: loads data via (evidence: `frontend/src/App.tsx`)
- Gallery data hook → Media API client: calls (evidence: `frontend/src/hooks/useGallery.ts`)
- Express application → Auth routes: mounts (evidence: `backend/app.ts`)
- Express application → Media routes: mounts (evidence: `backend/app.ts`)
- Express application → Session guard: guards media with (evidence: `backend/app.ts`)
- Auth routes → Authentication: routes to (evidence: `backend/routes/auth.routes.ts`)
- Authentication → PostgreSQL: reads and writes (evidence: `backend/controllers/auth.controller.ts`)
- Authentication → Session Redis: stores sessions (evidence: `backend/controllers/auth.controller.ts`)
- Session guard → Session Redis: checks session (evidence: `backend/middleware/isAuth.ts`)
- Media routes → Upload validation: validates uploads (evidence: `backend/routes/media.routes.ts`)
- Media routes → Media operations: routes requests (evidence: `backend/routes/media.routes.ts`)
- Media operations → Media metadata and jobs: saves and enqueues (evidence: `backend/controllers/media.controller.ts`)
- Media operations → PostgreSQL: queries media (evidence: `backend/controllers/media.controller.ts`)
- Media metadata and jobs → PostgreSQL: writes metadata (evidence: `backend/helpers/media.helper.ts`)
- Media metadata and jobs → Media queue: enqueues processing (evidence: `backend/helpers/media.helper.ts`)
- Media metadata and jobs → Analysis queue: enqueues analysis (evidence: `backend/helpers/media.helper.ts`)
- Media queue → BullMQ Redis: uses connection (evidence: `backend/queues/media.queue.ts`)
- Analysis queue → BullMQ Redis: uses connection (evidence: `backend/queues/analysis.queue.ts`)
- Media worker → Media queue: consumes jobs (evidence: `backend/workers/media.worker.ts`)
- Media worker → PostgreSQL: updates media (evidence: `backend/workers/media.worker.ts`)
- Analysis worker → Analysis queue: consumes jobs (evidence: `backend/workers/analysis.worker.ts`)
- Analysis worker → AI service: requests analysis (evidence: `backend/workers/analysis.worker.ts`)
- Analysis worker → Analysis repository: persists results (evidence: `backend/workers/analysis.worker.ts`)
- AI service → Provider registry: selects provider (evidence: `backend/services/ai/ai.service.ts`)
- Provider registration → Provider registry: registers provider (evidence: `backend/services/ai/register.ts`)
- Provider registration → Gemini provider: loads provider (evidence: `backend/services/ai/register.ts`)
- Analysis repository → PostgreSQL: reads and writes (evidence: `backend/services/ai/analysis.repository.ts`)
