# Evolutivo Aero — AI Process Enablement

> Teaching domain experts to speak AI. From zero to working prototype in 6-8 days.

## What This Site Is

A marketing and interactive-learning site for Evolutivo's "AI Process Enablement" program.
The program trains non-technical professionals (construction, finance, healthcare, legal,
manufacturing, logistics) to build AI-powered solutions for their own workflows.

## Site Structure

- `/` — Home page. Animated Mars-like orb with orbital tier navigation. Hero: "destination: ai fluency."
- `/foundations` — Tier 01: LLM fundamentals, prompt engineering, context engineering (10 modules, 2-3 days)
- `/discovery` — Tier 02: Process mapping workshop, AI suitability scoring (1-2 days)
- `/implementation` — Tier 03: Guided prototype development, team handover (3-5 days)
- `/descent` — Interactive AI-powered learning adventure. Users pick an archetype (builder, keeper, alchemist, oracle, healer, navigator) and explore 7 scenes teaching AI concepts through alien-planet metaphors.
- `/book` — Journey showcase + booking. Shows saved descent journeys by industry.
- `/book/:journeyId` — Detail view for a specific saved journey.
- `/contact` — Contact form (name, email, message).

## API Endpoints

Backend is FastAPI (Python) at `/api`. In dev, Vite proxies `/api` to `localhost:8000`.

- `POST /api/scene` — Generate a scene for the descent adventure. Body: `{history, choice, scene_number, origin, lang}`. Returns `{scene_text, choices, ai_concept, mode, metrics?}`.
- `POST /api/journey/render` — Render a descent journey markdown to PDF. Body: `{markdown, origin}`. Returns PDF bytes.
- `POST /api/journey/send` — Email a rendered journey PDF via Resend. Body: `{email, markdown, data, origin, lang}`.
- `POST /api/journey/save` — Save a completed journey. Body: `{origin, depth, mode, lang, scenes, session}`.
- `GET /api/journeys` — List all saved journeys grouped by origin.
- `POST /api/contact` — Send contact form. Body: `{name, email, message}`.
- `GET /api/health` — Health check. Returns `{status, mode}`.

OpenAPI docs available at `/docs` and `/openapi.json` when the backend is running.

## Languages

The site supports English (`en`), Italian (`it`), and Klingon (`tlh`). Language is toggled via a switcher in the header.

## Industry Archetypes

The descent adventure and journey showcase are organized by six archetypes:

- **Builder** — construction & engineering
- **Keeper** — accounting & finance
- **Alchemist** — manufacturing & pharma
- **Oracle** — legal
- **Healer** — healthcare
- **Navigator** — logistics & supply chain

## Key Concepts

The program teaches AI through an alien-planet metaphor system:
- LLM = "the astrolabe"
- Tokens = "beads"
- Parameters = "tiny knobs"
- Prompts = "inscriptions"
- Context window = "the loom"
- Temperature = "the furnace heat"
- Model families = "the great forges"

## Contact

Evolutivo — info@evolutivo.it