TenantAtlas/specs/409-evaluation-procurement-rollout/quickstart.md

Quickstart: Evaluation, Procurement & Rollout Readiness Website Surface

1. Confirm Scope

Work from repository root:

cd /Users/ahmeddarrazi/Documents/projects/wt-website
pwd
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,280p'

Scope boundaries:

• Allowed: /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/**
• Allowed: /Users/ahmeddarrazi/Documents/projects/wt-website/specs/409-evaluation-procurement-rollout/**
• Forbidden: /Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform/**
• Forbidden: root workspace script contract changes

2. Implement The Route

Preferred routes:

• /evaluierung
• /en/evaluation

Expected files:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/evaluierung.astro
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en/evaluation.astro
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/EvaluationPage.astro

Follow the existing thin-route plus shared-page-component pattern used by TrustPage.astro, ContactPage.astro, and PricingPage.astro.

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 evaluation copy with:

• page metadata
• hero copy and CTA labels
• evaluation path steps
• preparation cards
• pilot scenario cards
• stakeholder cards
• security/procurement checklist items
• Microsoft 365 access principles
• non-requirement cards
• example timeline
• FAQ entries
• final CTA labels and routes

4. Keep Discovery Contextual

Preferred discovery surfaces:

• homepage teaser
• compact platform-page teaser
• review-pack page crosslink
• 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 CTA Targets Real

Preferred CTA targets:

• /contact or /en/contact for Demo buchen, Pilot anfragen, and Security-Unterlagen anfragen
• /trust or /en/trust for trust/privacy handoff
• /platform or /en/platform for product-context fallback

Do not introduce:

• href="#"
• fake calendar widgets
• fake AVV/TOM downloads
• fake security-pack downloads
• fake procurement or trial portals

6. Keep Claims Conservative

Do not introduce hard claims for:

• instant trial
• self-service onboarding
• automated provisioning
• DSGVO-konform
• ISO-zertifiziert
• NIS2-konform
• in Deutschland gehostet
• no customer data stored
• Google/AWS support
• automatic remediation
• automatic restore
• one-click restore

Prefer wording like:

• evaluieren
• anfragen
• Status klären
• je nach Pilot-Scope
• kontrollierter Rollout

7. 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:

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

8. 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 'procurement readiness website surface' \
  -e 'productization gap' \
  -e 'repo-real foundation' \
  -e 'workspace-first route context' \
  -e 'capability registry' \
  -e 'provider-neutral artifact taxonomy' \
  -e 'instant trial' \
  -e 'self-service onboarding available' \
  -e 'sofort kostenlos starten' \
  -e 'DSGVO-konform' \
  -e 'ISO-zertifiziert' \
  -e 'NIS2-konform' \
  -e 'garantiert auditbereit' \
  -e 'automatic remediation' \
  -e 'automatic restore' \
  -e 'one-click restore' \
  -e 'Google supported' \
  -e 'AWS supported' \
  -e 'no customer data stored' \
  -e 'in Deutschland gehostet' \
  apps/website/src apps/website/public 2>/dev/null || true

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

9. Browser Smoke

If local preview is available:

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

Verify:

• /evaluierung loads
• /en/evaluation loads
• homepage/platform/review-pack/use-case/footer links work if implemented
• trust CTA points to a real route
• evaluation path is understandable
• pilot preparation is understandable
• Microsoft 365 access section is understandable
• FAQ is buyer-friendly
• no fake downloads, fake forms, or fake calendar widgets appear
• no false legal, provider, or runtime claims appear
• desktop and mobile layouts remain readable