Process Flow
How the RevIQ financing simulator runs — from submitted inputs to governed, auditable results
Architecture at a glance
Everything on the left is supplied by the finance team; everything on the right is produced by the automation.
5 declared inputs
- project_name
- project_cost
- currency
- project_duration_months
- simulation_data
Determin-AI
automation
14 declared outputs
Stage-by-stage flow
Each stage groups the underlying procedure steps and lists what it hands to the next stage.
Stage 1 · Intake
Parse and Validate1 stepThe simulation_data JSON is parsed and every optional block gets a safe default so the run never halts on a missing field.
- 1Parse and validate the simulation request payload
Hands off
- Normalised payload
- parse_error flag
- base_rate 6.5% fallback
Stage 2 · Model build
Build Profiles and Schedules4 stepsMonthly spend, usable cash, straight-line revenue recognition and the month-by-month interest curve are assembled into one timeline.
- 2Build the monthly project spending profile
- 3Compute the available cash position and project cash
- 4Build the monthly revenue recognition schedule
- 5Build the monthly interest rate schedule
Hands off
- Spend profile
- Cash available for project
- Revenue & deferred schedule
- Rate schedule
Stage 3 · Simulation
Run Financing Simulations2 stepsThree standard structures (100% cash, 100% debt, 50/50) plus any custom scenario run through a monthly cash-flow engine, then rates are swept for sensitivity.
- 6Compare financing scenarios and generate the scenario summary
- 7Run sensitivity analysis across key interest rate variables
Hands off
- Scenario cash flows
- Interest & fees
- Peak financing
- Sensitivity curve
Stage 4 · Controls
Analysis and Exceptions2 stepsFive review conditions are evaluated across every scenario and the cost forecast separates project cost from financing cost.
- 8Evaluate the simulation against review conditions
- 9Compute the project cost forecast and net funding requirement
Hands off
- Exception list + severity
- Net funding requirement
- REVIEW_REQUIRED status
Stage 5 · Response & audit
Assemble Output4 stepsA plain-language explanation, KPI snapshot and full structured response are assembled, then persisted as one immutable simulation record.
- 10Generate the plain-language AI financial explanation
- 11Assemble the dashboard KPI snapshot
- 12Assemble the full structured API response
- 13Persist the simulation to the RevIQ FC Simulations audit collection
Hands off
- AI explanation
- 8 KPIs
- Structured JSON result
- SIM_ audit row
Where humans stay in control
Automation prepares; people decide.
- Any triggered review condition sets the run to REVIEW_REQUIRED — no condition is ever auto-resolved.
- Scenario recommendations compare cost against liquidity; selecting a financing structure remains a treasury decision.
- Every run is persisted once with a unique SIM_ identifier — prior simulations are never overwritten.
Follow the flow in the app
Each stage maps to a working screen.
- Stage 1–2 · Submit inputs and watch the 13 steps run
- Stage 3 · Compare the three financing structures
- Stage 3 · Interest rate sensitivity sweep
- Stage 2 · Revenue recognition and deferred balance
- Stage 4 · Triggered review conditions
- Stage 5 · Persisted simulation audit log
- Reference · Full step and guardrail detail