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

# Quickstart: Evaluation, Procurement & Rollout Readiness Website Surface

## 1. Confirm Scope

Work from repository root:

```bash
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:

```text
/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:

```text
/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:

```text
/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:

```bash
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:

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

Run the static scan from the plan against source:

```bash
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:

```bash
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