Underwriting API

The decision engine for FloatMe’s lending: it evaluates whether a user is eligible for a float or loan by running rulebooks over their financial data, and manages the float profiles that set each user’s limits and fees.

What this service owns

Concern Summary

Eligibility decisions

Rulebook evaluation, result aggregation, and the ML override — Rule Engine, Payback Predictor V2, Float Decision

Float profiles

Per-user tiers, fees, temporary overrides — Float Profiles

Limit progression

CFI automatic increases/decreases — CFI

Experiments

Early advance — Early Advance

Evaluation history

Cached evaluations and permanent historical records — DynamoDB

Doc map

Page Covers

Architecture

System context, component inventory, external dependencies

Infrastructure

Lambdas, queues, EventBridge rules, secrets, monitoring

API spec

OpenAPI rendering (spec/api.yaml is canonical)

DynamoDB

Table design, entities, enums, access patterns

Rule Engine

Evaluation pipeline and decision aggregation

Rules Reference

Every rule and its properties

Rulebooks

Rulebook configuration and sync

CFI

Float-limit increase checks

Float Profiles

Profiles, defaults, fees

Early Advance

Advance-against-in-flight-repayment experiment

Payback Predictor V2

ML override model

ML Feature Pipeline

Feature sourcing, training, deployment

Events

Published and consumed event contracts

Feature Flags

Every GrowthBook flag

Local development setup: see the repository README.md.