How woodysc8/richard-newport works
This is a single-user personal-finance dashboard with Plaid account linking and refresh, transaction classification and accounting, investment tracking, and an MCP/API surface. The main workflow is linking financial accounts, refreshing their data into Supabase, then calculating and presenting dashboard and financial-context results. The source excerpts show the dashboard calculations and several API-to-library calls; some Plaid endpoints and MCP implementation are indexed but not excerpted, so their internal relationships are left unconnected.
Main entry points: PlaidConnect.tsx Plaid Connect · financialContext.ts Financial Context Builder · audit/route.ts Accounting Audit API · refresh/route.ts Refresh APIs
Components 22
Account Connections
- Plaid Connect
app/components/PlaidConnect.tsx - Link Token API
app/api/plaid/create-link-token/route.ts - Token Exchange API
app/api/plaid/exchange-token/route.ts - Refresh APIs
app/api/plaid/refresh/route.ts - Account Repair API
app/api/plaid/repair-accounts/route.ts - Plaid Diagnostics
app/api/plaid/institutions-diagnostic/route.ts
Financial Data
- Plaid Refresh
lib/plaidRefresh.ts
Finance Logic
- Transaction Classifier
lib/classifyTransaction.ts - Accounting Engine
lib/accounting.ts - Budget Logic
lib/budget.ts - Weekly Spending
lib/weeklySpending.ts - Account Types
lib/dashboard.ts - Dashboard View Model
lib/dashboardViewModel.ts
Dashboard and APIs
- Dashboard Page
app/page.tsx - Accounting Audit API
app/api/accounting/audit/route.ts - Classification API
app/api/transactions/classify/route.ts - Financial Context API
app/api/financial-context/route.ts - Financial Context Builder
lib/financialContext.ts - MCP API
app/api/mcp/route.ts
Other components
- User
- Plaid
- Supabase
Connections 27
- User → Dashboard Page: views
app/page.tsx - Dashboard Page → Supabase: reads
app/page.tsx - Dashboard Page → Dashboard View Model: builds view
app/page.tsx - Dashboard View Model → Accounting Engine: computes totals
lib/dashboardViewModel.ts - Dashboard View Model → Account Types: classifies accounts
lib/dashboardViewModel.ts - Plaid Connect → User: offers linking
app/components/PlaidConnect.tsx - Plaid Connect → Link Token API: requests token
app/components/PlaidConnect.tsx - Plaid Connect → Token Exchange API: exchanges token
- Plaid Connect → Refresh APIs: requests refresh
- Link Token API → Plaid: creates link token
- Token Exchange API → Plaid: exchanges token
- Refresh APIs → Plaid Refresh: invokes refresh
app/api/plaid/refresh/route.ts - Refresh APIs → Supabase: reads status
- Plaid Refresh → Plaid: fetches updates
lib/plaidRefresh.ts - Plaid Refresh → Supabase: writes records
lib/plaidRefresh.ts - Account Repair API → Supabase: repairs records
- Plaid Diagnostics → Plaid: checks institutions
- Accounting Audit API → Supabase: reads records
app/api/accounting/audit/route.ts - Accounting Audit API → Transaction Classifier: classifies transactions
app/api/accounting/audit/route.ts - Accounting Audit API → Accounting Engine: computes accounting
app/api/accounting/audit/route.ts - Classification API → Supabase: reads transactions
app/api/transactions/classify/route.ts - Classification API → Transaction Classifier: classifies transactions
app/api/transactions/classify/route.ts - Financial Context API → Financial Context Builder: builds context
app/api/financial-context/route.ts - Financial Context Builder → Supabase: reads financial data
lib/financialContext.ts - Financial Context Builder → Accounting Engine: summarizes accounts
lib/financialContext.ts - Financial Context Builder → Account Types: classifies accounts
lib/financialContext.ts - Weekly Spending → Transaction Classifier: uses classifications
lib/weeklySpending.ts