Insight Service

The Insight Service is FloatMe’s authority for user financial intelligence: payday prediction, cashflow forecasts, employment and income data, and the Pave analytics integration. It serves these through a REST API and publishes insight events to EventBridge.

What This Service Owns

Domain Responsibility

Payday prediction

Next-payday and collection-date prediction for float creation, from Pave income data, transaction history, or the employment record

Forecasts

Recurring income and expense detection over transaction history, plus cash runway, cash calendar, and savings-progress projections

Employment & income

Employment records in RDS, manual income verification, and transaction-based income detection

Pave mining

Upload of Plaid transactions into Pave and the user_new_insights_available event when Pave finishes processing

Balance alerts

Low-balance push notification when a newly linked account’s balance is under the user’s threshold

Savings snapshots

Monthly checking and savings balance rows that back the savings-progress series

Documentation

  • Architecture — System context, component inventory, external dependencies

  • Infrastructure — AWS resources: Lambda config, queues, streams, EventBridge rules, secrets

  • API Specification — Full OpenAPI spec (Swagger UI)

  • PostgreSQL Schema — Employment table reference

  • DynamoDB Tables — site-pave single-table entities, income detection, data capture, settings, and locks tables

  • Pave Mining — Feeder, webhook, miner, and replay-feeder flows

  • Payday Prediction — Prediction chain, same-day cache, Pave and FloatMe algorithms

  • Forecasts — Recurring detection, cash runway, cash calendar, savings progress

  • Employment & Income — Employment records, income verification, income detection, institution changes

  • Balance Alerts — Low-balance notification flow

  • Events — EventBridge event contracts published and consumed

  • Feature Flags — GrowthBook flag reference