# Konstrukt documentation

> Technical documentation of the Konstrukt planning platform — its data model, calculation engine, apps, security, integration and APIs — plus a separate best-practice section on the ready-made templates.

Konstrukt is a low-code platform for financial planning, forecasting, reporting and other FP&A and finance-operations processes. You model your business as **plans** containing **dimensions**, **value types** and **calculations**, and build spreadsheet-like **apps** on top of them for the people who plan and report.

This site has these parts:

- **Platform documentation** describes the platform itself: its concepts, how data is stored and versioned, how calculations are written and run, how apps are configured, and how you secure, integrate and administer a tenant. It uses neutral examples and describes no particular model.
- **Best practice** collects working rules and known pitfalls for building models, including a guide for AI agents.

## Platform

<div class="cards" markdown="0">
<a href="overview.html"><span class="c-t">Overview</span><span class="c-d">What the platform is for and how its parts fit together.</span></a>
<a href="concepts.html"><span class="c-t">Core concepts</span><span class="c-d">Tenant, plan, dimension, property, value type, reference, calculation, app.</span></a>
<a href="architecture.html"><span class="c-t">Architecture</span><span class="c-d">Plans as building blocks, the engine, history and interfaces.</span></a>
<a href="data-model.html"><span class="c-t">Data model</span><span class="c-d">Dimensions, properties, value types, precision, limits and line states.</span></a>
<a href="references-history.html"><span class="c-t">References and history</span><span class="c-d">Snapshots, point-in-time references and the full change history.</span></a>
<a href="calculations.html"><span class="c-t">Calculations</span><span class="c-d">Guided and script calculations, dependency graph, run order.</span></a>
<a href="kex.html"><span class="c-t">Kex</span><span class="c-d">The query and scripting language: clauses, joins, writes, variables, windowing.</span></a>
<a href="apps.html"><span class="c-t">Apps</span><span class="c-d">Datasets, workspaces, components, actions and the configuration format.</span></a>
<a href="security.html"><span class="c-t">Security and access</span><span class="c-d">Roles, groups, access lists, row-level access and SSO.</span></a>
<a href="operations.html"><span class="c-t">Hosting and operations</span><span class="c-d">Swedish hosting, tenant isolation, encryption, backup, release tracks.</span></a>
<a href="integration.html"><span class="c-t">Data integration</span><span class="c-d">Import configurations, file transports, REST and the import wizard.</span></a>
<a href="apis.html"><span class="c-t">APIs and SQL access</span><span class="c-d">REST API, the Kex endpoint and external SQL views.</span></a>
<a href="ai-agents.html"><span class="c-t">AI agents and MCP</span><span class="c-d">The built-in MCP server, its tools and resources.</span></a>
</div>

## Best practice

<div class="cards" markdown="0">
<a href="agent-pitfalls.html"><span class="c-t">Agent guide</span><span class="c-d">Working rules and known pitfalls for AI agents, per area.</span></a>
</div>

## Auto-generated references

Some reference material is generated from the product and kept up to date automatically. This site links to it instead of duplicating it — see [Reference documentation](reference-docs.html).

| Reference | Covers |
|---|---|
| [REST API](https://acme.konstrukt.app/api/documentation/index.html) | Endpoints, request and response schemas |
| [Kex reference](https://acme.konstrukt.app/api/documentation/kex) | Full Kex language reference and function list |
| [Kex Lite reference](https://acme.konstrukt.app/api/documentation/kex-lite) | The expression language used in app datasets |

## For AI agents

!!! agent "Reading this site as an agent"
    - [`llms.txt`](llms.txt) lists every page with a one-line summary. [`llms-full.txt`](llms-full.txt) contains the whole site as one Markdown document.
    - Every page has a Markdown source under `md/<page>.md`, linked from the page header.
    - Read the [Agent guide: pitfalls and learnings](agent-pitfalls.html) before writing Kex, app configuration or data.
    - To work in a live tenant, connect to its MCP server; see [AI agents and MCP](ai-agents.html). The server's own resources (`konstrukt://resources/kex/*`, `konstrukt://TenantInstructions.md`) and the app-config schema from `get_app_config_schema` take precedence over this site for tenant-specific conventions.

Back to [www.konstrukt.se](https://www.konstrukt.se) ↗
