How jeevansurya560-arch/finneas works
Finneas is intended to be a private, real-time study room for small groups. The sampled implementation currently provides a React status page that polls a NestJS health endpoint; the README describes broader V1 study-room capabilities, but the tree and excerpts do not show their implementation. Those capabilities are included as documented, unverified subsystems rather than presented as working runtime flows.
Main entry points: main.ts NestJS application · README.md Private rooms · App.tsx Status page · main.tsx React entry
Components 17
Web client
- Status page
apps/web/src/App.tsx - React entry
apps/web/src/main.tsx
API foundation
- NestJS application
apps/api/src/main.ts - App module
apps/api/src/app.module.ts - Health endpoint
apps/api/src/health/health.controller.ts - PostgreSQL
- Redis
Room collaboration
- Email and JWT auth
README.md - Private rooms
README.md - Room invitations
README.md - Real-time chat
README.md - Online presence
README.md - Resource sharing
README.md
Study workflows
- Study sessions
README.md - Shared timer
README.md - Session history
README.md
Other components
- Study group member
Connections 17
- Study group member → React entry: opens
- React entry → Status page: renders
apps/web/src/main.tsx - Status page → Health endpoint: polls health
apps/web/src/App.tsx - NestJS application → App module: creates
apps/api/src/main.ts - App module → Health endpoint: registers
apps/api/src/app.module.ts - NestJS application → Status page: serves API
README.md - NestJS application → PostgreSQL: persists state
README.md - NestJS application → Redis: uses presence
README.md - Study group member → Email and JWT auth: authenticates
README.md - Study group member → Private rooms: creates or joins
README.md - Private rooms → Room invitations: invites members
README.md - Study group member → Real-time chat: exchanges messages
README.md - Private rooms → Online presence: shows members
README.md - Study group member → Resource sharing: shares links
README.md - Study group member → Study sessions: tracks activity
README.md - Study group member → Shared timer: controls timer
README.md - Study sessions → Session history: records sessions
README.md