How chakornk/stormhacks-2026 works
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: app.ts API assembly · orchestrator.ts Analysis orchestration · routes.ts Capture routes · api-routes.ts Capture API
Components 24
API and identity
- API assembly
backend/src/app.ts - Authentication routes
backend/src/modules/auth/routes.ts - Identity and sessions
backend/src/modules/auth/service.ts - Request identity
backend/src/modules/auth/context.ts
Capture and media
- Capture routes
backend/src/modules/capture/routes.ts - Capture API
backend/src/modules/capture/api-routes.ts - Manual image upload
backend/src/modules/capture/manual-upload-routes.ts - Capture service
backend/src/modules/capture/service.ts - Captured posts
backend/src/modules/capture/repository.ts - Media storage
backend/src/modules/media/store.ts
Analysis pipeline
- Analysis orchestration
backend/src/modules/analysis/orchestrator.ts - Analysis stages
backend/src/modules/analysis/pipeline.ts - Stage contracts
backend/src/modules/analysis/contracts.ts - AI providers
backend/src/infrastructure/ai/cortex-provider.ts - Analysis jobs
backend/src/infrastructure/mongo/analysis-repository.ts
Library and discovery
- Search routes
backend/src/modules/search/routes.ts - Search service
backend/src/modules/search/service.ts - Search index
backend/src/infrastructure/search/meilisearch-index.ts - Album routes
backend/src/modules/albums/routes.ts - Album service
backend/src/modules/albums/service.ts - Profile route
backend/src/modules/profile/routes.ts
Runtime infrastructure
- MongoDB adapters
backend/src/infrastructure/mongo - Analysis queue
backend/src/infrastructure/queue/redis-queue.ts
Other components
- User
Connections 28
- User → Authentication routes: signs in
backend/src/modules/auth/routes.ts - Authentication routes → Identity and sessions: authenticates
backend/src/modules/auth/routes.ts - API assembly → Authentication routes: registers
backend/src/app.ts - API assembly → Capture routes: registers
backend/src/app.ts - API assembly → Search routes: registers
backend/src/app.ts - User → Capture API: submits link
backend/src/modules/capture/api-routes.ts - Capture API → Request identity: uses identity
backend/src/modules/capture/api-routes.ts - Capture API → Capture service: captures and lists
backend/src/modules/capture/api-routes.ts - Capture service → Captured posts: reads and writes
backend/src/modules/capture/service.ts - Capture routes → Analysis orchestration: requests analysis
backend/src/modules/capture/routes.ts - Capture routes → Media storage: uses media
backend/src/modules/capture/routes.ts - User → Manual image upload: uploads image
backend/src/modules/capture/manual-upload-routes.ts - Manual image upload → Media storage: stores image
backend/src/modules/capture/manual-upload-routes.ts - Manual image upload → Captured posts: inserts post
backend/src/modules/capture/manual-upload-routes.ts - Analysis orchestration → Analysis jobs: loads and saves jobs
backend/src/modules/analysis/orchestrator.ts - Analysis orchestration → Analysis stages: runs stages
backend/src/modules/analysis/orchestrator.ts - Analysis stages → AI providers: requests AI analysis
backend/src/modules/analysis/pipeline.ts - API assembly → Analysis orchestration: configures
backend/src/app.ts - API assembly → MongoDB adapters: selects adapters
backend/src/app.ts - API assembly → Analysis queue: configures publisher
backend/src/app.ts - User → Search routes: searches library
backend/src/modules/search/routes.ts - Search routes → Search service: queries
backend/src/modules/search/routes.ts - API assembly → Search service: configures
backend/src/app.ts - User → Album routes: manages albums
backend/src/modules/albums/routes.ts - Album routes → Album service: delegates
backend/src/modules/albums/routes.ts - User → Profile route: views profile
backend/src/modules/profile/routes.ts - Profile route → Identity and sessions: loads account
backend/src/modules/profile/routes.ts - Profile route → Capture service: lists saved posts
backend/src/modules/profile/routes.ts