Skip to main content

Capabilities (jhf-web)

Documentation Map​

Capabilities (jhf-web)

Dieses Dokument folgt dem Fabric-Capabilities-Standard und trennt stabil verfügbare Fähigkeiten von experimentellen und offenen Lücken.

Stable External Capabilities​

public-web-presence​

  • Title: Public Website Delivery
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: static routes under https://helpifyr.com/*, build output .pages-dist, scripts/build-pages.sh

localized-content-rendering​

  • Title: DE/EN/FR Route Rendering
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: locale-driven routes in /, /en/*, /fr/*, locale assets in locales/*, route generation scripts/generate-localized-routes.mjs

lead-intake​

  • Title: Contact Intake API
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: POST /api/contact, implementation functions/api/contact.ts, contract contracts/contact-intake.contract.json

blog-draft-publish-gateway​

  • Title: Local-First Blog Staging API
  • Stability: transitional
  • Exposure: local-first / public fail-closed
  • Primary API surface / command / artifact / file: local POST /api/blog/publish via scripts/blog-publish-local-server.mjs, shared logic functions/_shared/blog-publish.mjs, contract contracts/blog-publish-api.contract.json, tests scripts/test-blog-publish.mjs

runtime-status​

  • Title: Public Runtime Status Surfaces
  • Stability: stable
  • Exposure: external
  • Primary API surface / command / artifact / file: GET /health, GET /ready, implementation functions/health.ts, functions/ready.ts

deployment-package-build​

  • Title: Versioned Deployment Bundle for Downstream Rollout
  • Stability: stable
  • Exposure: external (artifact consumer)
  • Primary API surface / command / artifact / file: scripts/package_bundle.sh, package namespace jhf-web-bundle

Stable Internal Capabilities​

fabric-contract-consumer​

  • Title: Fabric Contract Truth Consumption
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: consumed surfaces /api/v1/contracts/matrix, /api/v1/contracts/docs-standard, /api/v1/identity/contracts; contract contracts/fabric-contract-consumption.contract.json; verify script scripts/check-fabric-contracts.sh

external-blog-boundary-enforcement​

  • Title: Public Runtime Write-Deny Boundary for Blog Authoring
  • Stability: transitional
  • Exposure: internal
  • Primary API surface / command / artifact / file: functions/_shared/blog-publish.mjs, docs/BLOG_PUBLISH_API.md, contracts/blog-publish-api.contract.json

stack-runtime-contract-enforcement​

  • Title: Stack/Port Contract Verification
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: contracts/stack-runtime.contract.json, contracts/runtime-port-policy.contract.json, checks scripts/check-stack-runtime.sh, scripts/check-runtime-port-policy.sh

access-model-derived-view-materialization​

  • Title: Derived Access-Model Deep-Dive Materialization
  • Stability: stable
  • Exposure: internal
  • Primary API surface / command / artifact / file: scripts/build-access-model-truth.mjs, contracts/access-model-deep-dive.contract.json, artifacts/access-model-deep-dive.truth.json

Experimental Or Transitional Capabilities​

intake-forwarding​

  • Title: Webhook Forwarding for Intake
  • Stability: transitional
  • Exposure: internal/external-bridge
  • Primary API surface / command / artifact / file: env-driven forwarding in functions/api/contact.ts (CONTACT_WEBHOOK_URL, CONTACT_WEBHOOK_TOKEN, timeout/auth header settings)

mirrored-host-runtime​

  • Title: OpenClaw Mirror Runtime
  • Stability: transitional
  • Exposure: internal
  • Primary API surface / command / artifact / file: docker-compose.yml (jhf-web, optional jhf-web-monitor), host verification scripts/verify-standalone-openclaw.sh

oci-image-build​

  • Title: OCI Build Path
  • Stability: experimental
  • Exposure: internal
  • Primary API surface / command / artifact / file: scripts/oci_image.sh

Current Gaps​

  • Kein repo-eigener, verbindlicher End-to-End-ERP-Contract für Intake-Downstream; Übergabe bleibt env-/workflow-abhängig.
  • Öffentliche Cloudflare-Runtime publiziert bewusst nicht; positiver Authoring-Pfad ist lokal-first und muss vor Promotion lokal verifiziert werden.
  • Mirror-Runtime ist bewusst nicht gleichwertig zur Cloudflare-Pages-Function-Runtime und kann Function-Verhalten nicht vollständig abbilden.
  • Keine lokale Ownership für Fabric-Familien-/Versionspolitik; Änderungen müssen im Fabric-Owner-Repo passieren.
  • Kein eigener Autorisierungs-/Policy-Layer im Web-Repo (bewusst außerhalb des Scopes).

License​

AGPLv3. See LICENSE (LICENSE).

Learn more at helpifyr.com.