# armaanmulla28/personal-experience architecture

> Architecture diagram of the GitHub repository armaanmulla28/personal-experience, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/armaanmulla28/personal-experience
- Repository: https://github.com/armaanmulla28/personal-experience

## Overview

LifeLog is a full-stack experience journal: users record and browse experiences, then explore them through search, timeline, rankings, analytics, memory-lane, and custom data-structure views. The main path runs from the React app through its API client to Spring controllers, services, and the experience repository. The server also maintains in-memory structures for timeline, pending items, recent views, ranking, and ID lookup. README content was absent; connections for unsampled analytics and memory-lane implementation are therefore not asserted beyond the client API boundary.

Main entry points: [`server/src/main/java/com/lifelog/controller/DSAController.java`](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/DSAController.java) (Structure API), [`client/src/services/api.js`](https://github.com/armaanmulla28/personal-experience/blob/main/client/src/services/api.js) (API client), [`server/src/main/java/com/lifelog/repository/ExperienceRepository.java`](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/repository/ExperienceRepository.java) (Experience store), [`server/src/main/java/com/lifelog/service/ExperienceSearchService.java`](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceSearchService.java) (ID search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App shell<br/>[App.jsx]"]
  node_experience_ui["Experience views"]
  node_feature_ui["Feature views"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["API services"]
  node_experience_api["Experience API"]
  node_dsa_api["Structure API<br/>[DSAController.java]"]
  node_analytics_api["Analytics API"]
end

subgraph group_domain["Experience domain"]
  node_experience_service["Experience service"]
  node_search_service["ID search"]
  node_repository[("Experience store")]
  node_experience_entity["Experience entity<br/>[Experience.java]"]
  node_memory["Memory lane"]
  node_analytics["Analytics"]
end

subgraph group_structures["In-memory features"]
  node_item_model["Structure item"]
  node_timeline["Timeline"]
  node_recent["Recent views"]
  node_pending["Pending queue"]
  node_ranking["Ranked experiences"]
  node_bst["BST index<br/>[ExperienceBST.java]"]
  node_linked_list["Linked list"]
  node_stack["View stack"]
  node_queue["FIFO queue"]
  node_heap["Max heap"]
end

node_person(("User"))

node_person -->|"uses"| node_app
node_app -->|"renders"| node_experience_ui
node_app -->|"renders"| node_feature_ui
node_app -->|"requests data"| node_api_client
node_experience_ui -.->|"requests data"| node_api_client
node_feature_ui -.->|"requests features"| node_api_client
node_api_client -.->|"HTTP requests"| node_experience_api
node_api_client -.->|"HTTP requests"| node_dsa_api
node_api_client -.->|"HTTP requests"| node_analytics_api
node_experience_api -->|"delegates"| node_experience_service
node_experience_api -->|"updates index"| node_search_service
node_experience_service -->|"reads writes"| node_repository
node_repository -->|"persists"| node_experience_entity
node_search_service -->|"reindexes from"| node_repository
node_search_service -->|"indexes and searches"| node_bst
node_search_service -->|"converts records"| node_item_model
node_item_model -->|"maps from"| node_experience_entity
node_dsa_api -->|"delegates"| node_timeline
node_dsa_api -->|"delegates"| node_recent
node_dsa_api -->|"delegates"| node_pending
node_dsa_api -->|"delegates"| node_search_service
node_dsa_api -->|"delegates"| node_ranking
node_dsa_api -->|"records lookup"| node_recent
node_timeline -->|"loads records"| node_repository
node_timeline -->|"builds timeline"| node_linked_list
node_timeline -->|"converts records"| node_item_model
node_recent -->|"records views"| node_stack
node_pending -->|"manages items"| node_queue
node_ranking -->|"loads records"| node_repository
node_ranking -->|"ranks items"| node_heap
node_ranking -->|"converts records"| node_item_model
node_memory -->|"loads records"| node_repository
node_analytics_api -.->|"delegates"| node_analytics

click node_app "https://github.com/armaanmulla28/personal-experience/blob/main/client/src/App.jsx"
click node_experience_ui "https://github.com/armaanmulla28/personal-experience/tree/main/client/src/components"
click node_feature_ui "https://github.com/armaanmulla28/personal-experience/tree/main/client/src/components"
click node_api_client "https://github.com/armaanmulla28/personal-experience/blob/main/client/src/services/api.js"
click node_experience_api "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/ExperienceController.java"
click node_dsa_api "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/DSAController.java"
click node_analytics_api "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/AnalyticsController.java"
click node_experience_service "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceService.java"
click node_search_service "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceSearchService.java"
click node_repository "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/repository/ExperienceRepository.java"
click node_experience_entity "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/model/Experience.java"
click node_item_model "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/model/ExperienceItem.java"
click node_timeline "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/TimelineService.java"
click node_recent "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/RecentlyViewedService.java"
click node_pending "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/PendingExperienceService.java"
click node_ranking "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceRankingService.java"
click node_memory "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/MemoryLaneService.java"
click node_analytics "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/AnalyticsService.java"
click node_bst "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/bst/ExperienceBST.java"
click node_linked_list "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/linkedlist/CustomLinkedList.java"
click node_stack "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/stack/ExperienceStack.java"
click node_queue "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/queue/ExperienceQueue.java"
click node_heap "https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/priorityqueue/ExperienceMaxHeap.java"

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_app,node_experience_ui,node_feature_ui,node_api_client,node_person toneBlue
class node_experience_api,node_dsa_api,node_analytics_api toneAmber
class node_experience_service,node_search_service,node_repository,node_experience_entity,node_memory,node_analytics toneMint
class node_item_model,node_timeline,node_recent,node_pending,node_ranking,node_bst,node_linked_list,node_stack,node_queue,node_heap toneRose
```

## Components

### Web client

- [App shell](https://github.com/armaanmulla28/personal-experience/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Experience views](https://github.com/armaanmulla28/personal-experience/tree/main/client/src/components): `client/src/components`
- [Feature views](https://github.com/armaanmulla28/personal-experience/tree/main/client/src/components): `client/src/components`
- [API client](https://github.com/armaanmulla28/personal-experience/blob/main/client/src/services/api.js): `client/src/services/api.js`

### API services

- [Experience API](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/ExperienceController.java): `server/src/main/java/com/lifelog/controller/ExperienceController.java`
- [Structure API](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/DSAController.java): `server/src/main/java/com/lifelog/controller/DSAController.java`
- [Analytics API](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/controller/AnalyticsController.java): `server/src/main/java/com/lifelog/controller/AnalyticsController.java`

### Experience domain

- [Experience service](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceService.java): `server/src/main/java/com/lifelog/service/ExperienceService.java`
- [ID search](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceSearchService.java): `server/src/main/java/com/lifelog/service/ExperienceSearchService.java`
- [Experience store](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/repository/ExperienceRepository.java): `server/src/main/java/com/lifelog/repository/ExperienceRepository.java`
- [Experience entity](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/model/Experience.java): `server/src/main/java/com/lifelog/model/Experience.java`
- [Memory lane](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/MemoryLaneService.java): `server/src/main/java/com/lifelog/service/MemoryLaneService.java`
- [Analytics](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/AnalyticsService.java): `server/src/main/java/com/lifelog/service/AnalyticsService.java`

### In-memory features

- [Structure item](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/model/ExperienceItem.java): `server/src/main/java/com/lifelog/dsa/model/ExperienceItem.java`
- [Timeline](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/TimelineService.java): `server/src/main/java/com/lifelog/service/TimelineService.java`
- [Recent views](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/RecentlyViewedService.java): `server/src/main/java/com/lifelog/service/RecentlyViewedService.java`
- [Pending queue](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/PendingExperienceService.java): `server/src/main/java/com/lifelog/service/PendingExperienceService.java`
- [Ranked experiences](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/service/ExperienceRankingService.java): `server/src/main/java/com/lifelog/service/ExperienceRankingService.java`
- [BST index](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/bst/ExperienceBST.java): `server/src/main/java/com/lifelog/dsa/bst/ExperienceBST.java`
- [Linked list](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/linkedlist/CustomLinkedList.java): `server/src/main/java/com/lifelog/dsa/linkedlist/CustomLinkedList.java`
- [View stack](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/stack/ExperienceStack.java): `server/src/main/java/com/lifelog/dsa/stack/ExperienceStack.java`
- [FIFO queue](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/queue/ExperienceQueue.java): `server/src/main/java/com/lifelog/dsa/queue/ExperienceQueue.java`
- [Max heap](https://github.com/armaanmulla28/personal-experience/blob/main/server/src/main/java/com/lifelog/dsa/priorityqueue/ExperienceMaxHeap.java): `server/src/main/java/com/lifelog/dsa/priorityqueue/ExperienceMaxHeap.java`

### Other components

- **User**

## Connections

- User → App shell: uses (evidence: `client/src/App.jsx`)
- App shell → Experience views: renders (evidence: `client/src/App.jsx`)
- App shell → Feature views: renders (evidence: `client/src/App.jsx`)
- App shell → API client: requests data (evidence: `client/src/App.jsx`)
- Experience views → API client: requests data (evidence: `client/src/components/Dashboard.jsx`)
- Feature views → API client: requests features (evidence: `client/src/components/Dashboard.jsx`)
- API client → Experience API: HTTP requests
- API client → Structure API: HTTP requests
- API client → Analytics API: HTTP requests
- Experience API → Experience service: delegates (evidence: `server/src/main/java/com/lifelog/controller/ExperienceController.java`)
- Experience API → ID search: updates index (evidence: `server/src/main/java/com/lifelog/controller/ExperienceController.java`)
- Experience service → Experience store: reads writes (evidence: `server/src/main/java/com/lifelog/service/ExperienceService.java`)
- Experience store → Experience entity: persists (evidence: `server/src/main/java/com/lifelog/repository/ExperienceRepository.java`)
- ID search → Experience store: reindexes from (evidence: `server/src/main/java/com/lifelog/service/ExperienceSearchService.java`)
- ID search → BST index: indexes and searches (evidence: `server/src/main/java/com/lifelog/service/ExperienceSearchService.java`)
- ID search → Structure item: converts records (evidence: `server/src/main/java/com/lifelog/service/ExperienceSearchService.java`)
- Structure item → Experience entity: maps from (evidence: `server/src/main/java/com/lifelog/dsa/model/ExperienceItem.java`)
- Structure API → Timeline: delegates (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Structure API → Recent views: delegates (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Structure API → Pending queue: delegates (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Structure API → ID search: delegates (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Structure API → Ranked experiences: delegates (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Structure API → Recent views: records lookup (evidence: `server/src/main/java/com/lifelog/controller/DSAController.java`)
- Timeline → Experience store: loads records (evidence: `server/src/main/java/com/lifelog/service/TimelineService.java`)
- Timeline → Linked list: builds timeline (evidence: `server/src/main/java/com/lifelog/service/TimelineService.java`)
- Timeline → Structure item: converts records (evidence: `server/src/main/java/com/lifelog/service/TimelineService.java`)
- Recent views → View stack: records views (evidence: `server/src/main/java/com/lifelog/service/RecentlyViewedService.java`)
- Pending queue → FIFO queue: manages items (evidence: `server/src/main/java/com/lifelog/service/PendingExperienceService.java`)
- Ranked experiences → Experience store: loads records (evidence: `server/src/main/java/com/lifelog/service/ExperienceRankingService.java`)
- Ranked experiences → Max heap: ranks items (evidence: `server/src/main/java/com/lifelog/service/ExperienceRankingService.java`)
- Ranked experiences → Structure item: converts records (evidence: `server/src/main/java/com/lifelog/service/ExperienceRankingService.java`)
- Memory lane → Experience store: loads records (evidence: `server/src/main/java/com/lifelog/service/MemoryLaneService.java`)
- Analytics API → Analytics: delegates
