SkyMoney/docs/api-phase6-move-log.md

API Phase 6 Move Log

Date: 2026-03-17
Scope: Move income, budget, and payday endpoints out of api/src/server.ts into dedicated route modules.

Route Registration Changes

• Added income route import in server.ts
• Added payday route import in server.ts
• Added budget route import in server.ts
• Registered income routes in server.ts
• Registered payday routes in server.ts
• Registered budget routes in server.ts
• Removed inline route blocks from server.ts to avoid duplicate registration:
  • POST /income
  • GET /income/history
  • POST /income/preview
  • GET /payday/status
  • POST /payday/dismiss
  • POST /budget/allocate
  • POST /budget/fund
  • POST /budget/reconcile

Endpoint Movements

1. POST /income

• Original: server.ts line 1382
• Moved to income.ts
• References:
  • useIncome.ts
  • PaydayOverlay.tsx
  • OnboardingPage.tsx
  • income.test.ts
  • income.integration.test.ts

2. GET /income/history

• Original: server.ts line 1421
• Moved to income.ts
• References:
  • useIncomeHistory.ts

3. POST /income/preview

• Original: server.ts line 1459
• Moved to income.ts
• References:
  • useIncomePreview.ts

4. GET /payday/status

• Original: server.ts line 1483
• Moved to payday.ts
• References:
  • PaydayOverlay.tsx

5. POST /payday/dismiss

• Original: server.ts line 1586
• Moved to payday.ts
• References:
  • PaydayOverlay.tsx

6. POST /budget/allocate

• Original: server.ts line 1597
• Moved to budget.ts
• References:
  • budget.ts
  • OnboardingPage.tsx

7. POST /budget/fund

• Original: server.ts line 1624
• Moved to budget.ts
• References:
  • budget.ts
  • OnboardingPage.tsx

8. POST /budget/reconcile

• Original: server.ts line 1657
• Moved to budget.ts
• References:
  • budget.ts
  • ReconcileSettings.tsx

Helper Ownership in Phase 6

• Shared helper injection from server.ts:
  • mutationRateLimit
  • computeDepositShares
  • computeWithdrawShares
  • isProd flag for environment-sensitive logging
• Route-local schemas/helpers:
  • income.ts: AllocationOverrideSchema
  • budget.ts: BudgetBody, ReconcileBody
  • payday.ts: local debug logger and query schema

Notes

• Removed legacy unregistered api/src/routes/income-preview.ts to avoid duplicate endpoint logic drift.

Verification

1. Build

• cd api && npm run build ✅

2. Focused tests

• cd api && npm run test -- tests/income.test.ts tests/income.integration.test.ts
• Result: blocked by local DB connectivity (127.0.0.1:5432 unavailable), suites skipped/failed before endpoint assertions.