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 (SSG)
• Estilos: Tailwind CSS 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

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