How yashwardhan61/code_frolics works
The Legacy Trunk is a secure, collaborative family archive for preserving and revisiting stories, media, recipes, heirlooms, and scrapbooks. A family member enters through the React app, signs in, and uses archive features; frontend API modules send requests to Spring REST controllers, which delegate business work to services and persist domain records and media. The README documents family, friend, profile, notification, search/statistics, AI, and administration capabilities. Some subsystem links are documented rather than confirmed in sampled implementation; those are shown at the broad API boundary.
Main entry points: api API clients · repository Domain repositories · App.jsx React application · AuthController.java Authentication API
Components 21
Family experience
- React application
frontend/src/App.jsx - Sign-in and profile
frontend/src/pages - Archive workspace
frontend/src/pages - API clients
frontend/src/api
API surface
- Authentication API
backend/src/main/java/com/codefrolics/legacytrunk/controller/AuthController.java - Story and memory APIs
backend/src/main/java/com/codefrolics/legacytrunk/controller/StoryController.java - Archive feature APIs
backend/src/main/java/com/codefrolics/legacytrunk/controller - Media delivery API
backend/src/main/java/com/codefrolics/legacytrunk/controller/MediaController.java
Domain services
- Account services
backend/src/main/java/com/codefrolics/legacytrunk/service/UserService.java - Story workflows
backend/src/main/java/com/codefrolics/legacytrunk/service/StoryService.java - Archive workflows
backend/src/main/java/com/codefrolics/legacytrunk/service - Media storage
backend/src/main/java/com/codefrolics/legacytrunk/service/MediaStorageService.java - AI assistance
backend/src/main/java/com/codefrolics/legacytrunk/service/GroqService.java - Email and reset
backend/src/main/java/com/codefrolics/legacytrunk/service/EmailService.java
Persistence
- Domain repositories
backend/src/main/java/com/codefrolics/legacytrunk/repository - Media repository
backend/src/main/java/com/codefrolics/legacytrunk/repository/StoredMediaRepository.java - PostgreSQL archive
External integrations
- Firebase auth
- Groq API
- Email provider
Other components
- Family member
Connections 25
- Family member → React application: uses
- React application → Sign-in and profile: routes to
- React application → Archive workspace: routes to
- Sign-in and profile → API clients: requests auth
- Archive workspace → API clients: requests features
- API clients → Authentication API: calls
- API clients → Story and memory APIs: calls
- API clients → Archive feature APIs: calls
- API clients → Media delivery API: fetches media
- Authentication API → Account services: delegates
- Authentication API → Email and reset: requests reset
- Story and memory APIs → Story workflows: delegates
- Archive feature APIs → Archive workflows: delegates
- Media delivery API → Media storage: loads media
- Story workflows → Media storage: stores uploads
- Story workflows → Domain repositories: reads and writes
- Account services → Domain repositories: reads and writes
- Archive workflows → Domain repositories: reads and writes
- Media storage → Media repository: reads and writes
- Domain repositories → PostgreSQL archive: persists records
- Media repository → PostgreSQL archive: persists blobs
- Email and reset → Firebase auth: updates password
- Email and reset → Email provider: sends email
- Archive feature APIs → AI assistance: requests AI
- AI assistance → Groq API: calls