ahmido
acdea41d92
## Summary - add the localized review-pack product story routes at `/platform/review-packs` and `/en/platform/review-packs` with shared page composition, evidence/decision framing, audience sections, trust handoff, and footer/use-case/home/platform discovery - extend `site-copy`, smoke coverage, and Spec Kit artifacts for feature 408 so the public website contract, tests, research, plan, quickstart, and checklist stay aligned - polish the public presentation with a cleaner review-pack comparison surface, a more opaque navbar to remove homepage logo bleed-through, a higher-contrast secondary CTA, unique homepage feature icons, and less repetitive homepage use-case copy ## Validation - `corepack pnpm --filter @tenantatlas/website build` - `corepack pnpm --filter @tenantatlas/website test tests/smoke/public-routes.spec.ts` - `corepack pnpm --filter @tenantatlas/website test tests/smoke/interaction.spec.ts` - source/dist claim scans plus manual browser comprehension checks are recorded in `specs/408-review-evidence-decision/checklists/requirements.md` - current touched website files are free of editor diagnostics; live browser console check on the homepage returned no errors ## Notes - trust/proof messaging remains intentionally honest; this PR does not add fabricated customer logos, certifications, or unsupported compliance claims - `origin/website-dev` is the review base for this PR Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #405
190 lines
6.4 KiB
YAML
190 lines
6.4 KiB
YAML
openapi: 3.1.0
|
|
info:
|
|
title: Tenantial Public Review Pack Story Routes
|
|
version: 0.1.0
|
|
description: >
|
|
Static public website route contract for Spec 408. These routes return
|
|
HTML pages only and do not expose platform runtime APIs, tenant data,
|
|
review workspace state, or export functionality.
|
|
servers:
|
|
- url: http://127.0.0.1:4321
|
|
description: Local website preview using WEBSITE_PORT default
|
|
paths:
|
|
/platform/review-packs:
|
|
get:
|
|
summary: German public review-pack and evidence story page
|
|
operationId: getGermanReviewPackStory
|
|
tags:
|
|
- Public Website
|
|
responses:
|
|
"200":
|
|
description: Static HTML review-story page
|
|
content:
|
|
text/html:
|
|
schema:
|
|
type: string
|
|
examples:
|
|
page:
|
|
summary: Required visible content
|
|
value: "Von Policy-Drift zu pruefbaren Entscheidungen. Evidence, Findings und Accepted Risks statt Screenshot-Governance."
|
|
"404":
|
|
description: Route not configured
|
|
x-content-requirements:
|
|
locale: de
|
|
mustInclude:
|
|
- Review Pack hero framing in German buyer language
|
|
- Problem section explaining why technical truth alone is insufficient for governance, review preparation, and audit conversations
|
|
- Governance workflow from policy state to review-pack preparation
|
|
- Review Pack anatomy with executive summary, Evidence basis, Findings, Accepted Risks, Decision Summary, status, and export context
|
|
- Evidence section explaining Evidence beyond screenshots
|
|
- Decision Summary section covering status, reason, impact, Evidence, next action, and review context
|
|
- Customer-safe versus internal detail boundary
|
|
- MSP and Enterprise IT value framing
|
|
- Differentiation from raw exports, screenshot collections, and admin-center snapshots
|
|
- Trust teaser linking to the existing trust route
|
|
- Final CTA with real destinations only
|
|
- Real CTA destinations only
|
|
mustNotInclude:
|
|
- href="#"
|
|
- customer-safe consumption productization
|
|
- route-owned
|
|
- artifact taxonomy
|
|
- source family
|
|
- capability registry
|
|
- repo-real foundation
|
|
- lueckenlose Evidence
|
|
- lueckenlose Evidenz
|
|
- gerichtsfeste Nachweise
|
|
- immutable evidence
|
|
- immutable review packs
|
|
- complete audit trail
|
|
- guarantees audit success
|
|
- macht Sie compliant
|
|
- DSGVO-konform
|
|
- ISO-zertifiziert
|
|
- real-time drift
|
|
- automatic remediation
|
|
- automatic restore
|
|
- Google supported
|
|
- AWS supported
|
|
/en/platform/review-packs:
|
|
get:
|
|
summary: English public review-pack and evidence story page
|
|
operationId: getEnglishReviewPackStory
|
|
tags:
|
|
- Public Website
|
|
responses:
|
|
"200":
|
|
description: Static HTML review-story page
|
|
content:
|
|
text/html:
|
|
schema:
|
|
type: string
|
|
examples:
|
|
page:
|
|
summary: Required visible content
|
|
value: "Evidence, reviews, and decisions instead of screenshots. Review-ready governance context for Microsoft 365 buyers."
|
|
"404":
|
|
description: Route not configured
|
|
x-content-requirements:
|
|
locale: en
|
|
mustInclude:
|
|
- Review Pack hero framing in buyer language
|
|
- Problem section explaining why technical truth alone is insufficient for governance, review preparation, and audit conversations
|
|
- Governance workflow from policy state to review-pack preparation
|
|
- Review Pack anatomy with executive summary, Evidence basis, Findings, Accepted Risks, Decision Summary, status, and export context
|
|
- Evidence section explaining Evidence beyond screenshots
|
|
- Decision Summary section covering status, reason, impact, Evidence, next action, and review context
|
|
- Customer-safe versus internal detail boundary
|
|
- MSP and Enterprise IT value framing
|
|
- Differentiation from raw exports, screenshot collections, and admin-center snapshots
|
|
- Trust teaser linking to the existing trust route
|
|
- Final CTA with real destinations only
|
|
- Real CTA destinations only
|
|
mustNotInclude:
|
|
- href="#"
|
|
- customer-safe consumption productization
|
|
- route-owned
|
|
- artifact taxonomy
|
|
- source family
|
|
- capability registry
|
|
- repo-real foundation
|
|
- immutable evidence
|
|
- immutable review packs
|
|
- complete audit trail
|
|
- guarantees audit success
|
|
- DSGVO-konform
|
|
- ISO-zertifiziert
|
|
- real-time drift
|
|
- automatic remediation
|
|
- automatic restore
|
|
- Google supported
|
|
- AWS supported
|
|
components:
|
|
schemas:
|
|
ReviewPackCard:
|
|
type: object
|
|
required:
|
|
- key
|
|
- title
|
|
- content
|
|
- availabilityTone
|
|
properties:
|
|
key:
|
|
type: string
|
|
enum:
|
|
- executive-summary
|
|
- evidence-basis
|
|
- findings
|
|
- accepted-risks
|
|
- decision-summary
|
|
- review-pack-status
|
|
- download-export-context
|
|
title:
|
|
type: string
|
|
content:
|
|
type: string
|
|
availabilityTone:
|
|
type: string
|
|
enum:
|
|
- hard-available
|
|
- soft-availability
|
|
EvidenceCard:
|
|
type: object
|
|
required:
|
|
- key
|
|
- title
|
|
- content
|
|
properties:
|
|
key:
|
|
type: string
|
|
enum:
|
|
- policy-evidence
|
|
- change-evidence
|
|
- finding-evidence
|
|
- recovery-evidence
|
|
- review-evidence
|
|
title:
|
|
type: string
|
|
content:
|
|
type: string
|
|
DecisionFacetCard:
|
|
type: object
|
|
required:
|
|
- key
|
|
- title
|
|
- content
|
|
properties:
|
|
key:
|
|
type: string
|
|
enum:
|
|
- status
|
|
- reason
|
|
- impact
|
|
- evidence
|
|
- next-action
|
|
- review-context
|
|
title:
|
|
type: string
|
|
content:
|
|
type: string |