ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
website-dev
TenantAtlas/specs/408-review-evidence-decision/quickstart.md
ahmido acdea41d92 408: add review pack story surfaces and homepage polish (#405) 
## 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
2026-05-29 13:48:21 +00:00

4.9 KiB
Raw Permalink Blame History

Quickstart: Customer-safe Review, Evidence & Decision Story

1. Confirm Scope

Work from repository root:

cd /Users/ahmeddarrazi/Documents/projects/wt-website
git status --short --branch
cat package.json
cat pnpm-workspace.yaml 2>/dev/null || true
cat apps/website/package.json
find apps/website -maxdepth 3 -type f | sort | sed -n '1,260p'

Scope boundaries:

  • Allowed: /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/**
  • Allowed: /Users/ahmeddarrazi/Documents/projects/wt-website/specs/408-review-evidence-decision/**
  • Forbidden: /Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform/**
  • Forbidden: root workspace script contract changes

2. Implement The Route

Preferred routes:

  • /platform/review-packs
  • /en/platform/review-packs

Expected files:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/platform/review-packs.astro
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en/platform/review-packs.astro
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/ReviewPacksPage.astro

Follow the existing PlatformPage.astro product-page pattern and keep the locale files thin.

3. Add Localized Content

Use the existing copy file:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts

Add German and English review-story copy with:

  • page metadata
  • hero copy and CTA labels
  • problem cards
  • governance workflow steps
  • review-pack anatomy cards
  • Evidence cards
  • decision-summary cards
  • customer-safe boundary content
  • MSP and Enterprise IT value cards
  • trust teaser copy
  • final CTA labels and routes

4. Keep Discovery Light

Preferred discovery surfaces:

  • homepage teaser
  • compact platform-page teaser
  • MSP use-case crosslink
  • Mittelstand / Enterprise IT use-case crosslink
  • footer link

Do not add a main-nav item unless implementation proves the current IA still reads cleanly.

5. Keep Claims Soft Where Runtime Truth Is Unverified

Use soft wording for export or availability claims:

  • "helps prepare"
  • "can"
  • "if available"
  • "review-ready"
  • "audit-ready"

Do not introduce hard claims for:

  • completed customer portal
  • automatic Review Pack generation
  • automatic exports
  • immutable Evidence
  • complete audit trail
  • DSGVO-konform
  • ISO-zertifiziert
  • real-time drift
  • automatic remediation
  • automatic restore
  • Google/AWS support

6. Update Smoke Coverage

Expected test updates:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/public-routes.spec.ts
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/interaction.spec.ts
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/smoke-helpers.ts

Cover:

  • /platform/review-packs
  • /en/platform/review-packs
  • metadata for both routes
  • homepage/platform/use-case/footer discovery links as implemented
  • no placeholder links
  • no forbidden public claims
  • no horizontal overflow
  • readable desktop/mobile layout

7. Run Validation

Run only scripts that currently exist:

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

Optional if formatting was touched broadly:

corepack pnpm --filter @tenantatlas/website format:check

Run the static scan from the plan against source:

grep -RIn \
  -e 'href="#"' \
  -e 'lorem ipsum' \
  -e 'customer-safe consumption productization' \
  -e 'route-owned' \
  -e 'artifact taxonomy' \
  -e 'source family' \
  -e 'capability registry' \
  -e 'repo-real foundation' \
  -e 'lueckenlose Evidence' \
  -e 'lueckenlose Evidenz' \
  -e 'gerichtsfeste Nachweise' \
  -e 'immutable evidence' \
  -e 'immutable review packs' \
  -e 'complete audit trail' \
  -e 'guarantees audit success' \
  -e 'macht Sie compliant' \
  -e 'DSGVO-konform' \
  -e 'ISO-zertifiziert' \
  -e 'real-time drift' \
  -e 'automatic remediation' \
  -e 'automatic restore' \
  -e 'Google supported' \
  -e 'AWS supported' \
  apps/website/src apps/website/public 2>/dev/null || true

If generated output is committed, scan apps/website/dist as well.

8. Browser Smoke

If local preview is available:

WEBSITE_PORT=${WEBSITE_PORT:-4321} corepack pnpm --filter @tenantatlas/website preview

Verify:

  • /platform/review-packs loads
  • /en/platform/review-packs loads
  • homepage/platform/use-case/footer links work if implemented
  • trust teaser points to a real route
  • Review Pack story is understandable
  • Evidence story is understandable
  • customer-safe versus internal-only boundary is understandable
  • no fake portal/export/automation claims appear
  • no false compliance/provider claims appear
  • desktop and mobile layouts remain readable