Skip to main content

Data Model

Documentation Map​

Data Model

Scope​

This repo does not own a large persistent application database.

Relevant data models are:

  • public content and locale files
  • transient contact-intake payloads
  • machine-readable repository metadata

Content Model​

Static pages​

  • source: *.html
  • role: public website content
  • persistence: Git only

Locale files​

  • source: locales/*.json
  • role: runtime localization for DE, EN, FR
  • persistence: Git only

Intake Model​

Incoming request​

Required:

  • name
  • email
  • interest
  • message

Optional:

  • company
  • interest_label
  • language
  • profile
  • readiness
  • usecase
  • boost
  • source
  • sourcePath
  • website (honeypot)

Normalized intake payload​

Top-level fields:

  • intake_id
  • received_at
  • source
  • language
  • route
  • contact
  • interest
  • profiling
  • message
  • site

Nested groups:

  • contact
    • name
    • email
    • company
  • interest
    • key
    • label
  • profiling
    • profile
    • readiness
    • usecase
    • boost
  • site
    • host
    • path
    • user_agent
    • ip
    • country
    • ray
    • referer

Persistence note:

  • the website repo itself does not guarantee durable storage
  • durable handling happens only in the configured downstream webhook target, if present

Metadata Model​

fabric-manifest.json​

  • purpose: standardized repository self-description
  • audience: Fabric, dashboards, tooling

status.json​

  • purpose: small machine-readable status snapshot
  • audience: Fabric, docs aggregation, update tooling

contracts/contact-intake.contract.json​

  • purpose: machine-readable API contract for /api/contact
  • audience: integration planning and verification