Pular para o conteúdo

Estrutura do Projeto

.
├── .agents/skills/ # Skills especializadas para desenvolvimento com IA
├── .pages.yml # Manifesto de campos visuais do Pages CMS
├── public/
│ ├── _headers # Cabeçalhos do Cloudflare Pages (segurança/CSP)
│ ├── logo-cep.webp # Logotipo institucional otimizado
│ └── favicon.svg
├── src/
│ ├── components/
│ │ ├── calendar/ # Componentes do Calendário Letivo Oficial 2026
│ │ ├── layout/ # Header, Footer, BottomNav, CookieConsent, ThemeToggle
│ │ ├── sections/ # Seções de página montadas a partir de primitivas
│ │ └── ui/ # Primitivas atômicas de design (Button, Card, GovServiceCard…)
│ ├── content/ # Coleções de conteúdo (authors, blog, calendar, docs, faqs, pages, services, stack)
│ ├── i18n/ # Dicionários de interface (pt-BR e en para componentes universais)
│ ├── layouts/ # Layout Base com SEO, analytics e navegação móvel
│ ├── lib/ # Utilitários compartilhados (SEO, tags, tempo de leitura, site config)
│ ├── pages/ # Rotas Astro diretas na raiz (/cursos, /calendario, /noticias, /sobre, /contato)
│ ├── styles/ # Design System em tokens semânticos OKLCH (colors, base, components)
│ ├── content.config.ts # Schemas Zod com validação estrita das coleções
│ └── registry.json # Catálogo legível por máquina de componentes, seções e páginas
├── .github/workflows/ # Workflows de CI/CD (lint, skills verification, build estático)
├── astro.config.ts # Configurações do Astro + Starlight + integrações
├── wrangler.jsonc # Configuração Cloudflare Pages
└── package.json
  • Arquitetura Monolíngue Direta na Raiz (pt-BR): Todas as páginas vivem diretamente na raiz do projeto (src/pages/*.astro), eliminando prefixos artificiais para a comunidade escolar e cidadãos do DF.
  • Gestão Total via Pages CMS: Todo conteúdo editável vive em src/content/ (incluindo cursos, notícias, calendário escolar e páginas institucionais) e é mapeado no .pages.yml.
  • Arquitetura em Três Camadas: UI Primitives (ui/) → Seções (sections/) → Páginas (pages/). Todas as peças são catalogadas em src/registry.json.
  • Design Tokens Exclusivos: Estilização baseada em tokens semânticos em OKLCH com modo escuro automático sem cores Tailwind literais fixas.