public active Last verified 2026-04-07

Topolo Forecast

Public overview of the forecasting product for cash-flow, P&L, KPI, and multi-scenario planning workflows.

Owners
finance-platform
Source Repos
PlatformApplications/TopoloForecast, PlatformApplications/TopoloDocs
Systems
Topolo Auth, Topolo Forecast, TopoloOne
Tags
forecasting, finance, planning

What It Is

Topolo Forecast is the finance-planning surface for cash-flow forecasting, P&L analysis, KPI tracking, and multi-scenario modeling. Older references may still call it FinSight.

Architecture

The system combines a browser app, worker/API surface, shared domain logic, and shared UI packages under a Cloudflare-oriented deployment model.

Runtime Surfaces

Use /systems/topolo-forecast for the current runtime inventory and host mapping.

API Reference

The current contract is curated in the docs platform rather than OpenAPI-backed. The main surface centers on forecasting models, scenarios, dashboard and KPI flows, and their Auth-protected runtime.

Auth and Permissions

Forecast relies on Topolo Auth for user and org access. Older FinSight naming remains an alias rather than a separate auth boundary.

Data Ownership

Forecast owns financial models, scenarios, KPI calculations, and related planning data.

Workspace URLs and creation are organization-scoped. Two different organizations can use the same workspace slug, while each organization still keeps its own unique workspace URLs internally.

Deployments

Forecast deploys as a web-plus-worker application with shared packages and a Cloudflare deployment path.

Failure Modes

  • legacy FinSight naming causes service-registration or environment drift
  • web and worker deployments disagree on the active environment contract
  • Auth configuration is bypassed or incorrectly stubbed

Debugging

Start with /systems/topolo-forecast, then verify the current environment contract and Auth wiring for the failing scenario flow.

Change Log / Verification

  • Fixed Forecast’s shared auth callback handoff on 2026-04-07 so production /auth/callback consumes callback tokens directly again and no longer fails immediately on app-switch entry
  • Restored Forecast’s shared suite app launcher on 2026-04-07 so the production app no longer opens the legacy Topolo Suite modal
  • Standardized the Forecast-facing labels and frontend API defaults on 2026-04-07 so the live app routes against forecast-worker-production instead of the retired FinSight host
  • Added canonical Topolo Forecast coverage and retired repo-local Forecast docs on 2026-03-30