How matheusaaguirra/wealthos works
WealthOS is a personal-finance application: users sign in, organize accounts and transactions, manage recurring expenses, and review their financial overview and investments. The current product combines an Angular finance interface with Next.js public pages and server APIs, using Supabase for identity and PostgreSQL-backed financial data. Public guides and multilingual landing pages are a separate product-facing branch. The README identifies the preserved NestJS/Prisma code as historical, so it is omitted. Some API and client wiring is unsampled; edges are limited to shown references or documented relationships.
Main entry points: route.ts Finance API · market Market endpoints · app.component.ts Finance interface · wealthos-guides.tsx Guides
Components 22
Public experience
- Landing pages
components/wealthos-landing.tsx - Localized content
components/international-landing.tsx - Guides
components/wealthos-guides.tsx - Guide content
lib/guides/content.ts - Monthly planner
components/monthly-planner.tsx - SEO metadata
lib/seo.ts
Finance application
- Finance interface
wealthos-source/apps/web/src/app.component.ts - App localization
wealthos-source/apps/web/src/i18n/language.ts - Transaction reports
wealthos-source/apps/web/src/transactions-pdf.ts
Server and data
- Finance API
app/api/finance/route.ts - Auth core
lib/auth-core.ts - Supabase server auth
lib/supabase/server.ts - Financial state
lib/financial-state.ts - Financial store
lib/supabase/finance.ts - Recurring posting
lib/recurring-posting.ts - Supabase PostgreSQL
db
Market data
- Market endpoints
app/api/market - Market normalization
lib/market.ts - Market cache
lib/market-cache.ts - Google Finance adapter
lib/google-finance.ts
Other components
- Visitor or user
- Market data providers
Connections 22
- Visitor or user → Landing pages: browses
README.md - Visitor or user → Finance interface: uses
README.md - Landing pages → SEO metadata: uses metadata
app/(pt)/page.tsx - Localized content → SEO metadata: uses metadata
app/(en)/en/page.tsx - Visitor or user → Guides: reads
README.md - Guides → Guide content: loads
components/wealthos-guides.tsx - Guides → Monthly planner: renders
components/wealthos-guides.tsx - Finance interface → App localization: uses
wealthos-source/apps/web/src/app.component.ts - Finance interface → Transaction reports: uses
wealthos-source/apps/web/src/app.component.ts - Finance interface → Finance API: uses APIs
README.md - Finance API → Supabase server auth: authenticates
app/api/finance/route.ts - Finance API → Financial state: validates request
app/api/finance/route.ts - Finance API → Financial store: reads and saves
app/api/finance/route.ts - Finance API → Recurring posting: posts due items
app/api/finance/route.ts - Supabase server auth → Auth core: uses errors
lib/supabase/server.ts - Financial state → Auth core: uses
lib/financial-state.ts - Financial state → Supabase PostgreSQL: persists user data
- Financial store → Supabase PostgreSQL: reads and writes
- Market endpoints → Market normalization: validates and normalizes
app/api/market/google-finance/route.ts - Market endpoints → Market cache: caches responses
app/api/market/google-finance/route.ts - Market endpoints → Google Finance adapter: fetches quotes
app/api/market/google-finance/route.ts - Market endpoints → Market data providers: requests data