application public active Verified 2026-04-07

Topolo Forecast

Cash-flow and P&L forecasting product. Older repo and product references may still call it FinSight.

Aliases: FinSight

Documentation Map

What It Is

Cash-flow and P&L forecasting product. Older repo and product references may still call it FinSight.

Legacy aliases: FinSight

Canonical documentation for Topolo Forecast lives in `PlatformApplications/TopoloDocs`.

Use this repository for implementation only. Local product and operational docs have been retired in favor of the docs application.

Architecture

Owners: finance-platform

Source repos: PlatformApplications/TopoloForecast

Dependencies: topolo-auth, topolo-one

Repo shape

  • PlatformApplications/TopoloForecast/README.md
  • PlatformApplications/TopoloForecast/apps/
  • PlatformApplications/TopoloForecast/commitlint.config.js
  • PlatformApplications/TopoloForecast/docs/
  • PlatformApplications/TopoloForecast/eslint.config.js
  • PlatformApplications/TopoloForecast/package.json
  • PlatformApplications/TopoloForecast/packages/
  • PlatformApplications/TopoloForecast/pnpm-lock.yaml
  • PlatformApplications/TopoloForecast/pnpm-workspace.yaml
  • PlatformApplications/TopoloForecast/prettier.config.js
  • PlatformApplications/TopoloForecast/topolo.cloudcontrol.json

Runtime Surfaces

Hosts:

https://forecast.topolo.app
forecast

Config: PlatformApplications/TopoloForecast/apps/finsight-web/wrangler.toml

Main: not declared

Routes: workers.dev or asset-only surface

forecast-worker-production

Config: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

Main: src/index.ts

Routes: workers.dev or asset-only surface

API Reference

Coverage: curated

Source: PlatformApplications/TopoloDocs/src/content/public/applications/forecast.mdx

Source exists in repo: yes

Canonical Forecast coverage now lives in the docs application, with FinSight retained only as an alias.

App API page: /reference/apps/topolo-forecast

This system currently relies on a curated or README-derived contract surface instead of a source-controlled OpenAPI spec.

Auth and Permissions

Depends on Topolo Auth: yes

Service IDs:

srv_T0sKE7LIelMU

API key scopes

forecast.read

View forecasts

Resource pattern: none

forecast.write

Create and edit forecasts

Resource pattern: none

workspaces.read

View forecast workspaces

Resource pattern: workspace:*

workspaces.write

Manage forecast workspaces

Resource pattern: workspace:*

scenarios.read

View forecast scenarios

Resource pattern: none

scenarios.write

Manage forecast scenarios

Resource pattern: none

sharing.read

View workspace sharing

Resource pattern: none

sharing.write

Manage workspace sharing

Resource pattern: none

settings.read

View FinSight settings

Resource pattern: none

settings.write

Manage FinSight settings

Resource pattern: none

Service permissions

dashboard:read, forecasts:read, forecasts:write, transactions:read, transactions:write, reports:read, settings:read, settings:write

Data Ownership

d1

Binding: FS_DB

Target: 3f66df13-8b72-4c01-ad8f-8ff95d8b187d

Environment: default

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

kv

Binding: FS_CACHE

Target: c39ef688a2fb474ba240c80f9452f0e3

Environment: default

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

d1

Binding: FS_DB

Target: local-db-id

Environment: development

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

kv

Binding: FS_CACHE

Target: local-kv-preview-id

Environment: development

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

d1

Binding: FS_DB

Target: 344dc27c-de35-4cf3-ba41-47ef9075a8ec

Environment: staging

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

kv

Binding: FS_CACHE

Target: bd5f86a046f34e418f283f7e744d27c0

Environment: staging

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

d1

Binding: FS_DB

Target: 3f66df13-8b72-4c01-ad8f-8ff95d8b187d

Environment: production

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

kv

Binding: FS_CACHE

Target: c39ef688a2fb474ba240c80f9452f0e3

Environment: production

Source: PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml

Queues / Cron / Workflows

Queue bindings:

No queue bindings were detected.

Cron triggers

No cron triggers were detected.

Workflow signals

No explicit queue/workflow script or cron signal was discovered.

Environment Variables and Bindings

Environment variables:

ENVIRONMENT SERVICE_ID SERVICE_NAME migrations_dir

All wrangler bindings

  • FS_DB (d1) -> 3f66df13-8b72-4c01-ad8f-8ff95d8b187d
  • FS_CACHE (kv) -> c39ef688a2fb474ba240c80f9452f0e3
  • FS_DB (d1) -> local-db-id [development]
  • FS_CACHE (kv) -> local-kv-preview-id [development]
  • FS_DB (d1) -> 344dc27c-de35-4cf3-ba41-47ef9075a8ec [staging]
  • FS_CACHE (kv) -> bd5f86a046f34e418f283f7e744d27c0 [staging]
  • FS_DB (d1) -> 3f66df13-8b72-4c01-ad8f-8ff95d8b187d [production]
  • FS_CACHE (kv) -> c39ef688a2fb474ba240c80f9452f0e3 [production]

Deployments

Deployment environments: development, staging, production

Routes: workers.dev or Pages-only delivery

Observability enabled: no explicit setting found

Wrangler surfaces

  • PlatformApplications/TopoloForecast/apps/finsight-web/wrangler.toml -> forecast
  • PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml -> forecast-worker-production (build npm run build)

Build and deploy commands

  • prebuild — PlatformApplications/TopoloForecast/apps/finsight-web/package.json :: cd ../../packages/finsight-core && npm run build && cd ../ui-kit && npm run build
  • build — PlatformApplications/TopoloForecast/apps/finsight-web/package.json :: vite build
  • build:with-types — PlatformApplications/TopoloForecast/apps/finsight-web/package.json :: tsc -b && vite build
  • preview — PlatformApplications/TopoloForecast/apps/finsight-web/package.json :: vite preview
  • deploy — PlatformApplications/TopoloForecast/apps/finsight-worker/package.json :: wrangler deploy
  • prebuild — PlatformApplications/TopoloForecast/apps/finsight-worker/package.json :: cd ../../packages/finsight-core && npm run build
  • build — PlatformApplications/TopoloForecast/apps/finsight-worker/package.json :: tsc
  • build — PlatformApplications/TopoloForecast/package.json :: pnpm run --recursive build
  • build:packages — PlatformApplications/TopoloForecast/package.json :: pnpm run --filter './packages/*' build
  • build-storybook — PlatformApplications/TopoloForecast/package.json :: pnpm run --filter @finsight/ui-kit build-storybook
  • build — PlatformApplications/TopoloForecast/packages/config/package.json :: tsc
  • build — PlatformApplications/TopoloForecast/packages/finsight-core/package.json :: tsc

Failure Modes

No default failure-mode heuristics are currently flagged for this system.

Debugging Runbooks

Start with these entrypoints:

  • PlatformApplications/TopoloForecast/apps/finsight-web/wrangler.toml
  • PlatformApplications/TopoloForecast/apps/finsight-worker/wrangler.toml
  • PlatformApplications/TopoloDocs/src/content/public/applications/forecast.mdx
  • PlatformApplications/TopoloForecast/README.md
  • PlatformApplications/TopoloForecast/apps/finsight-web/package.json
  • PlatformApplications/TopoloForecast/apps/finsight-worker/package.json
  • PlatformApplications/TopoloForecast/package.json
  • PlatformApplications/TopoloForecast/packages/config/package.json
  • PlatformApplications/TopoloForecast/packages/finsight-core/package.json

Change Log / Verification

Lifecycle: active

Last verified: 2026-04-07

Any code change to this system is expected to update the canonical docs in PlatformApplications/TopoloDocs and refresh the verification date.