mint-backend-dev

What problem does it solve?

Helps engineers implement and maintain MINT's Python/FastAPI backend logic so financial calculations, APIs, and schemas remain correct, testable, and compliant with project contracts.

Core Features & Use Cases

• Rules engine development: Add pure, deterministic calculation functions in services/backend/app/services/rules_engine.py with legal sources and disclaimers in docstrings.
• API & schema work: Extend Pydantic v2 models, wire endpoints in api/v1/endpoints, and keep tools/openapi/mint.openapi.canonical.json synchronized with SOT.md.
• Testing & contracts: Write pytest golden tests with hardcoded expected values and use TestClient for endpoint tests; update SOT.md and OpenAPI when models or behaviors change.
• Use Case: Add a new financial scenario that computes retirement projections, expose it via a REST endpoint, validate responses with schemas, and provide exact expected test vectors.

Quick Start

Implement a new scenario by adding an enum to schemas/scenario.py, creating a pure calculation function in services/rules_engine.py with the legal source in the docstring, wiring the endpoint, adding the response schema, writing pytest tests with hardcoded expected values, and updating the OpenAPI canonical file and SOT.md.