ornitoweb/README.md

# Ornitonautas

Portal de aprendizaje de informática. Formación de FP oficial en España + preparación para el mercado laboral tech.

## Stack

- **Framework:** [Astro](https://astro.build) (SSG)
- **Estilos:** [Tailwind CSS](https://tailwindcss.com) v4
- **Lenguajes:** TypeScript, Astro components
- **I18n:** es (default) / en

## Estructura

```
/
├── agents/              # Agentes de código (codegraph)
├── docs/                # Documentación del proyecto
├── img/                 # Imágenes fuente
├── public/              # Assets estáticos (favicon, logos)
├── src/
│   ├── components/      # Componentes Astro (Header, Footer)
│   ├── content/         # Colecciones de contenido (MDX)
│   ├── i18n/            # Diccionarios de traducción
│   ├── layouts/         # Layouts (BaseLayout)
│   ├── pages/           # Rutas (es/, en/, campus/, etc.)
│   └── styles/          # Estilos globales (Tailwind)
├── AGENTS.md            # Instrucciones para agentes
├── CLAUDE.md            # Instrucciones para Claude
├── DESIGN.md            # Sistema visual y tokens
└── package.json
```

## Comandos

```sh
pnpm install            # Instalar dependencias
pnpm dev                # Servidor de desarrollo (localhost:4321)
pnpm build              # Build de producción → dist/
pnpm preview            # Preview del build
```

## Desarrollo

El servidor de desarrollo se ejecuta con `pnpm dev` en el directorio raíz.
Escucha en `http://localhost:4321/`.

### Páginas

| Ruta | Descripción |
|---|---|
| `/` | Home (es) |
| `/en/` | Home (en) |
| `/campus/` | Ciclos formativos |
| `/formacion/` | Formación |
| `/aprendizaje/` | Rutas de aprendizaje |
| `/recursos/` | Recursos |
| `/comunidad/` | Comunidad |
| `/sobre-nosotros/` | Sobre nosotros |
| `/contacto/` | Contacto |

## CodeGraph

Este proyecto usa [CodeGraph](https://codegraph.dev) para mantener indexado el código fuente.

- La base de datos está en `.codegraph/codegraph.db` (ignorada por git)
- Los agentes están en `agents/` y definen cómo interactúa cada agente con el proyecto
- Ejecutar `codegraph index` para re-indexar después de cambios significativos

## Despliegue

Pendiente de configurar. Planeado: Podman + Traefork en VPS Fedora/CentOS.

## Licencia

Propietario — Ornitonautas