Forecast — Construction Management Built on AIEP
Forecast is the first AIEP vertical SaaS.
It is a full-stack construction project management platform — CRM, projects, documents, programme, tasks, snag lists, contract administration, health & safety, commercial management, and tender engine — where every legally significant event is automatically committed to an evidence substrate backed by AIEP GENOME.
Evidence is not a feature. It is a consequence of how the platform works.
The problem Forecast solves
Construction projects fail in adjudication, arbitration, and litigation because the evidence is scattered, undated, and unverifiable. Instructions were given verbally. Variations were agreed informally. Notices were sent but not proven to have been received. Delay events lacked a contemporaneous record.
The industry spends enormous effort reconstructing what happened after a dispute arises. Forecast eliminates that reconstruction by making contemporaneous evidence automatic.
When a project manager issues an instruction in Forecast, the system creates a GENOME evidence artefact: a canonically serialised, SHA-256–hashed commitment to the instruction’s exact content at the exact moment of issue. No amendment, no backdating, no dispute about what was said.
What Forecast delivers
| Module | Description |
|---|---|
| CRM | Clients, contractors, consultants and contacts — the full supply chain |
| Projects | Project register with reference, contract value, status tracking, and client linkage |
| Documents | File upload to R2 with SHA-256 content hashing on receipt |
| Programme | Activity register with WBS coding and a live Gantt timeline |
| Tasks & Records | Site actions, RFIs and deficiency records |
| Snag Lists | Defect punchlists with photo attachment and location tagging |
| Contract Admin | Instructions, variations and formal notices — each automatically hashed as a GENOME evidence artefact |
| Health & Safety | Risk assessments with likelihood × severity scoring, incident log |
| Commercial | Cost plans, packages, and bill-of-quantities lines with automatic net amount calculation |
| Tender Engine | Procurement events, invited bidders and bid comparison |
| Evidence | GENOME evidence rail, artefact registry, bundle builder and legal evidence report |
The evidence substrate
Every contract event in Forecast that carries legal weight — instructions, variations, notices, snags, incidents — is recorded as a GENOME evidence artefact:
artefact_hash = sha256(
canonical_json({
artefact_id,
payload, // the exact content of the event
schema_id, // schema identifier (e.g. "forecast/instruction/v1")
schema_hash // pin of the schema at time of issue
})
)
Artefacts are serialised using RFC 8785 canonical JSON (deterministic key ordering) and hashed via WebCrypto SHA-256. The metadata — who created it, when, on which tenant — is stored separately and excluded from the hash, so timing variance does not alter the payload commitment.
Multiple artefacts can be assembled into an evidence bundle. The bundle’s integrity is protected by a chain hash — sha256 over the concatenation of all artefact hashes in sequence order. Any modification to any artefact breaks the chain.
The legal evidence report
From any project’s Evidence page, a project manager can:
- Select the artefacts relevant to a dispute (instructions issued, variations submitted, notices served)
- Bundle them into a named evidence package with chain-hash integrity
- Generate a legal evidence report — a self-contained HTML document formatted for admissibility
The report shows:
- The bundle’s chain hash and verification status
- Every artefact in sequence: schema, payload fields, artefact hash
- A plaintext explanation of the hash chain for lay readers
- Timestamps and actor records
The report can be printed, PDFed, or submitted directly as a legal exhibit. The hash values are independently verifiable: any party can re-run sha256(canonical_json(...)) against the stated payload and confirm the commitment.
Architecture
Forecast is built on the same architectural stack as AIEP’s reference implementations:
- Runtime: Cloudflare Workers + Hono v4 (edge-first API)
- Database: Cloudflare D1 (SQLite at the edge, full relational model)
- Storage: Cloudflare R2 (documents, photos)
- Frontend: Vite 5 + React 18 + TypeScript 5.4 (deployed to Cloudflare Pages)
- Auth: HMAC-SHA256 JWT, tenant-scoped, multi-tenant via subdomains
- Evidence substrate: AIEP GENOME R1–R6, R8 (canonical JSON, SHA-256, schema pins, artefacts, bundles, chain hashing)
- Monorepo: pnpm workspaces (
packages/genome,packages/types,apps/worker,apps/web)
The GENOME package is a pure TypeScript implementation with no runtime dependencies — it runs identically in Cloudflare Workers, browsers, and Node.js test environments.
Status
Forecast is under active development as an AIEP reference vertical SaaS.
- Source:
repos/private/aiep-forecast - Stack: Cloudflare Workers · D1 · R2 · React 18
- GENOME substrate: ✓ Active (R1–R6, R8)
- Evidence bundles: ✓ Active
- Legal report generation: ✓ Active
Forecast and AIEP
Forecast demonstrates the AIEP thesis at the application layer: that building software on a governed evidence substrate makes compliance and legal defensibility a structural property of the system, not a documentation overhead imposed after the fact.
The architecture is replicable. The GENOME substrate is open. The evidence model — canonical JSON, SHA-256 chain hashing, schema pins — can be applied to any vertical where contemporaneous, tamper-evident records carry legal weight.
Forecast is the first. It will not be the last.