# Approdo — an expedition for researchers and domain experts

> You already master your territory. We land you on its AI. From first contact to a real outpost in weeks.

## What This Site Is

The site for Approdo, a property with two arms for researchers (corporate R&D, innovation labs,
academic groups, PhDs, post-docs) and domain experts: (1) the expedition, a cohort that lands on
a new planet (the AI of their own field), explores it and builds a real outpost (a working prototype
or research artifact that stays theirs); (2) the instruments, the onboard scientific tools that bring
the scientific method (memory and measurement, reproducibility, provenance) to working with AI.
It is not a course and the audience is not developers.

## Site Structure

- `/` — Home page. Animated planet orb with orbital navigation. Hero: "destination: a new planet."
- `/foundations` — Phase 01 Landing: first contact, read the rules of the new world (from 2 days)
- `/discovery` — Phase 02 Exploration: recon of your terrain, where AI changes your field (1-2 days)
- `/implementation` — Phase 03 Outpost: build a working prototype or research artifact (from 3 days)
- `/scan` — The shadow vs the glass room: turning spontaneous AI adoption into governed, traceable practice.
- `/method` — The instruments (la strumentazione): Engram (memory and measurement), Lab Bench (reproducible test bench), Cosyne (method and provenance).
- `/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 expedition frames 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