# chakornk/stormhacks-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/chakornk/stormhacks-2026
- Repository: https://github.com/chakornk/stormhacks-2026

## Overview

saveyour.tech is a personal saved-content service: users capture links or upload images, then browse and search their saved posts and organize them into albums. The backend also runs staged AI analysis to enrich captured content for search. The supplied tree includes backend source and platform startup shells, but not the Flutter application’s Dart source; the marketing site is not the product workflow. Some runtime wiring is only partially excerpted, so uncertain links are omitted.

Main entry points: [`backend/src/app.ts`](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/app.ts) (API assembly), [`backend/src/modules/analysis/orchestrator.ts`](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/orchestrator.ts) (Analysis orchestration), [`backend/src/modules/capture/routes.ts`](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/routes.ts) (Capture routes), [`backend/src/modules/capture/api-routes.ts`](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/api-routes.ts) (Capture API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_api_app["API assembly<br/>[app.ts]"]
  node_auth_routes["Authentication routes<br/>[routes.ts]"]
  node_auth_service["Identity and sessions<br/>[service.ts]"]
  node_auth_context["Request identity<br/>[context.ts]"]
end

subgraph group_capture["Capture and media"]
  node_capture_routes["Capture routes<br/>[routes.ts]"]
  node_capture_api["Capture API<br/>[api-routes.ts]"]
  node_manual_upload["Manual image upload"]
  node_capture_service["Capture service<br/>[service.ts]"]
  node_capture_repository[("Captured posts<br/>[repository.ts]")]
  node_media_store["Media storage<br/>[store.ts]"]
end

subgraph group_analysis["Analysis pipeline"]
  node_analysis_orchestrator["Analysis orchestration<br/>[orchestrator.ts]"]
  node_analysis_pipeline["Analysis stages<br/>[pipeline.ts]"]
  node_analysis_contracts["Stage contracts<br/>[contracts.ts]"]
  node_ai_provider["AI providers<br/>[cortex-provider.ts]"]
  node_analysis_repository[("Analysis jobs")]
end

subgraph group_library["Library and discovery"]
  node_search_routes["Search routes<br/>[routes.ts]"]
  node_search_service["Search service<br/>[service.ts]"]
  node_search_index[("Search index")]
  node_albums_routes["Album routes<br/>[routes.ts]"]
  node_album_service["Album service<br/>[service.ts]"]
  node_profile_routes["Profile route<br/>[routes.ts]"]
end

subgraph group_infra["Runtime infrastructure"]
  node_mongo[("MongoDB adapters")]
  node_queue["Analysis queue<br/>[redis-queue.ts]"]
end

node_user(("User"))

node_user -->|"signs in"| node_auth_routes
node_auth_routes -->|"authenticates"| node_auth_service
node_api_app -->|"registers"| node_auth_routes
node_api_app -->|"registers"| node_capture_routes
node_api_app -->|"registers"| node_search_routes
node_user -->|"submits link"| node_capture_api
node_capture_api -->|"uses identity"| node_auth_context
node_capture_api -->|"captures and lists"| node_capture_service
node_capture_service -->|"reads and writes"| node_capture_repository
node_capture_routes -->|"requests analysis"| node_analysis_orchestrator
node_capture_routes -->|"uses media"| node_media_store
node_user -->|"uploads image"| node_manual_upload
node_manual_upload -->|"stores image"| node_media_store
node_manual_upload -->|"inserts post"| node_capture_repository
node_analysis_orchestrator -->|"loads and saves jobs"| node_analysis_repository
node_analysis_orchestrator -->|"runs stages"| node_analysis_pipeline
node_analysis_pipeline -->|"requests AI analysis"| node_ai_provider
node_api_app -->|"configures"| node_analysis_orchestrator
node_api_app -->|"selects adapters"| node_mongo
node_api_app -->|"configures publisher"| node_queue
node_user -->|"searches library"| node_search_routes
node_search_routes -->|"queries"| node_search_service
node_api_app -->|"configures"| node_search_service
node_user -->|"manages albums"| node_albums_routes
node_albums_routes -->|"delegates"| node_album_service
node_user -->|"views profile"| node_profile_routes
node_profile_routes -->|"loads account"| node_auth_service
node_profile_routes -->|"lists saved posts"| node_capture_service

click node_api_app "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/routes.ts"
click node_auth_service "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/service.ts"
click node_auth_context "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/context.ts"
click node_capture_routes "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/routes.ts"
click node_capture_api "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/api-routes.ts"
click node_manual_upload "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/manual-upload-routes.ts"
click node_capture_service "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/service.ts"
click node_capture_repository "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/repository.ts"
click node_media_store "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/media/store.ts"
click node_analysis_orchestrator "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/orchestrator.ts"
click node_analysis_pipeline "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/pipeline.ts"
click node_analysis_contracts "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/contracts.ts"
click node_ai_provider "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/ai/cortex-provider.ts"
click node_analysis_repository "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/mongo/analysis-repository.ts"
click node_search_routes "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/search/routes.ts"
click node_search_service "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/search/service.ts"
click node_search_index "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/search/meilisearch-index.ts"
click node_albums_routes "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/albums/routes.ts"
click node_album_service "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/albums/service.ts"
click node_profile_routes "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/profile/routes.ts"
click node_mongo "https://github.com/chakornk/stormhacks-2026/tree/main/backend/src/infrastructure/mongo"
click node_queue "https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/queue/redis-queue.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_api_app,node_auth_routes,node_auth_service,node_auth_context,node_user toneBlue
class node_capture_routes,node_capture_api,node_manual_upload,node_capture_service,node_capture_repository,node_media_store toneAmber
class node_analysis_orchestrator,node_analysis_pipeline,node_analysis_contracts,node_ai_provider,node_analysis_repository toneMint
class node_search_routes,node_search_service,node_search_index,node_albums_routes,node_album_service,node_profile_routes toneRose
class node_mongo,node_queue toneIndigo
```

## Components

### API and identity

- [API assembly](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication routes](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/routes.ts): `backend/src/modules/auth/routes.ts`
- [Identity and sessions](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/service.ts): `backend/src/modules/auth/service.ts`
- [Request identity](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/auth/context.ts): `backend/src/modules/auth/context.ts`

### Capture and media

- [Capture routes](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/routes.ts): `backend/src/modules/capture/routes.ts`
- [Capture API](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/api-routes.ts): `backend/src/modules/capture/api-routes.ts`
- [Manual image upload](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/manual-upload-routes.ts): `backend/src/modules/capture/manual-upload-routes.ts`
- [Capture service](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/service.ts): `backend/src/modules/capture/service.ts`
- [Captured posts](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/capture/repository.ts): `backend/src/modules/capture/repository.ts`
- [Media storage](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/media/store.ts): `backend/src/modules/media/store.ts`

### Analysis pipeline

- [Analysis orchestration](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/orchestrator.ts): `backend/src/modules/analysis/orchestrator.ts`
- [Analysis stages](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/pipeline.ts): `backend/src/modules/analysis/pipeline.ts`
- [Stage contracts](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/analysis/contracts.ts): `backend/src/modules/analysis/contracts.ts`
- [AI providers](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/ai/cortex-provider.ts): `backend/src/infrastructure/ai/cortex-provider.ts`
- [Analysis jobs](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/mongo/analysis-repository.ts): `backend/src/infrastructure/mongo/analysis-repository.ts`

### Library and discovery

- [Search routes](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/search/routes.ts): `backend/src/modules/search/routes.ts`
- [Search service](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/search/service.ts): `backend/src/modules/search/service.ts`
- [Search index](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/search/meilisearch-index.ts): `backend/src/infrastructure/search/meilisearch-index.ts`
- [Album routes](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/albums/routes.ts): `backend/src/modules/albums/routes.ts`
- [Album service](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/albums/service.ts): `backend/src/modules/albums/service.ts`
- [Profile route](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/modules/profile/routes.ts): `backend/src/modules/profile/routes.ts`

### Runtime infrastructure

- [MongoDB adapters](https://github.com/chakornk/stormhacks-2026/tree/main/backend/src/infrastructure/mongo): `backend/src/infrastructure/mongo`
- [Analysis queue](https://github.com/chakornk/stormhacks-2026/blob/main/backend/src/infrastructure/queue/redis-queue.ts): `backend/src/infrastructure/queue/redis-queue.ts`

### Other components

- **User**

## Connections

- User → Authentication routes: signs in (evidence: `backend/src/modules/auth/routes.ts`)
- Authentication routes → Identity and sessions: authenticates (evidence: `backend/src/modules/auth/routes.ts`)
- API assembly → Authentication routes: registers (evidence: `backend/src/app.ts`)
- API assembly → Capture routes: registers (evidence: `backend/src/app.ts`)
- API assembly → Search routes: registers (evidence: `backend/src/app.ts`)
- User → Capture API: submits link (evidence: `backend/src/modules/capture/api-routes.ts`)
- Capture API → Request identity: uses identity (evidence: `backend/src/modules/capture/api-routes.ts`)
- Capture API → Capture service: captures and lists (evidence: `backend/src/modules/capture/api-routes.ts`)
- Capture service → Captured posts: reads and writes (evidence: `backend/src/modules/capture/service.ts`)
- Capture routes → Analysis orchestration: requests analysis (evidence: `backend/src/modules/capture/routes.ts`)
- Capture routes → Media storage: uses media (evidence: `backend/src/modules/capture/routes.ts`)
- User → Manual image upload: uploads image (evidence: `backend/src/modules/capture/manual-upload-routes.ts`)
- Manual image upload → Media storage: stores image (evidence: `backend/src/modules/capture/manual-upload-routes.ts`)
- Manual image upload → Captured posts: inserts post (evidence: `backend/src/modules/capture/manual-upload-routes.ts`)
- Analysis orchestration → Analysis jobs: loads and saves jobs (evidence: `backend/src/modules/analysis/orchestrator.ts`)
- Analysis orchestration → Analysis stages: runs stages (evidence: `backend/src/modules/analysis/orchestrator.ts`)
- Analysis stages → AI providers: requests AI analysis (evidence: `backend/src/modules/analysis/pipeline.ts`)
- API assembly → Analysis orchestration: configures (evidence: `backend/src/app.ts`)
- API assembly → MongoDB adapters: selects adapters (evidence: `backend/src/app.ts`)
- API assembly → Analysis queue: configures publisher (evidence: `backend/src/app.ts`)
- User → Search routes: searches library (evidence: `backend/src/modules/search/routes.ts`)
- Search routes → Search service: queries (evidence: `backend/src/modules/search/routes.ts`)
- API assembly → Search service: configures (evidence: `backend/src/app.ts`)
- User → Album routes: manages albums (evidence: `backend/src/modules/albums/routes.ts`)
- Album routes → Album service: delegates (evidence: `backend/src/modules/albums/routes.ts`)
- User → Profile route: views profile (evidence: `backend/src/modules/profile/routes.ts`)
- Profile route → Identity and sessions: loads account (evidence: `backend/src/modules/profile/routes.ts`)
- Profile route → Capture service: lists saved posts (evidence: `backend/src/modules/profile/routes.ts`)
