Next.js · React · TypeScript
Empiece desde una arquitectura definida, no desde un repositorio vacío.
Foundation es una base de sitio web que prioriza la configuración, con un núcleo independiente del framework, puertos y adaptadores, configuración validada por esquema y una puerta de verificación real. Hereda los fundamentos y dedica su tiempo a las partes que son genuinamente específicas del sitio que está construyendo.
- Next.js App Router con React Server Components
- TypeScript en todo el proyecto, con configuración validada por esquema
- Puertas de pruebas unitarias, de arquitectura y de navegadores reales en el repositorio
La arquitectura de un vistazo
Cuatro etapas con una dirección de dependencia única. Las dos centrales son la base; la primera y la última son suyas.
- Stage 1
Datos del sitio, contenido y recursos
Identidad, navegación, idiomas, contenido en Markdown y gráfica: las entradas del adoptante, validadas antes de que nada las lea.
- Stage 2
Entorno derivado de Foundation
Conceptos de dominio independientes del framework y los servicios de aplicación que los orquestan, sin importaciones propias del framework.
- Stage 3
Presentación, enrutamiento y puntos de integración
Rutas, composición de diseño, metadatos y las fábricas de adaptadores que vinculan reservas, consultas, mapas y analítica desde la configuración.
- Stage 4
Despliegue
Una compilación orientada a la generación estática, desplegada desde su propio repositorio a su propia cuenta de alojamiento.
La dirección de las dependencias se afirma con pruebas en lugar de suponerse: el núcleo no puede importar React, Next.js ni una capa exterior, y la capa de aplicación no puede entrar en un adaptador concreto.
Configurar o programar
Esta frontera es el punto del proyecto. La mayoría de las decisiones específicas del negocio son datos; las extensiones reales son código, y Foundation es explícita sobre qué es cada cosa.
Normalmente se configura o se redacta
- Identidad: nombre, eslogan, descripción y URL canónica
- La navegación y el grupo secundario o de pie de página
- El conjunto de idiomas y los diccionarios de interfaz
- Las regiones del negocio, los horarios y las indicaciones
- Contenido: páginas y colecciones en Markdown
- Marca, iconos e imágenes
- Selección de proveedores para reservas, consultas, mapas y analítica
- Activación de funciones para ofertas, portafolio, blog y testimonios
- Valores de presentación que expone el contrato de configuración
Requiere código cuando se amplía el comportamiento de verdad
- Un nuevo adaptador de proveedor para una capacidad existente
- Una nueva capacidad reutilizable
- Nuevo comportamiento o interacción de interfaz
- Un nuevo módulo de aplicación posterior
- Cualquier cosa fuera de las fronteras de configuración establecidas
La postura aprobada: la mayor parte de la identidad, el contenido, la marca y la selección de funciones específicas del negocio vive fuera del núcleo de la aplicación. Eso no promete que nunca se escriba código: una capacidad genuinamente nueva es trabajo de plataforma, y Foundation lo dice en lugar de insinuar que existe un sistema de complementos.
El contrato de ingeniería
A lo que el proyecto se compromete, y lo que se niega a afirmar.
Configuración estrictamente validada
Un esquema, claves desconocidas rechazadas, fallos accionables y configuración legible solo a través del cargador.
Fronteras hexagonales
Un núcleo puro, puertos y servicios de aplicación, adaptadores tras fábricas y rutas de framework delgadas.
Aplicación de las dependencias
Las pruebas de arquitectura recorren el árbol de código y fallan ante una importación prohibida, de modo que el diagrama no puede alejarse del código.
Composición primero en servidor
React Server Components y generación estática por defecto, con la interactividad de cliente limitada a los componentes que la necesitan.
Verificación en navegadores reales
Una matriz comprometida de navegador sin interfaz recorre anchos de escritorio, tableta y móvil, interacción con teclado y puntero, movimiento reducido y esquema oscuro, y hace fallar la ejecución ante cualquier aserción incumplida.
Puertas de arquitectura y unitarias
Las pruebas de fronteras y unitarias se ejecutan junto a la comprobación de recursos, la de tipos, el lint y la compilación de producción.
Disciplina en las afirmaciones de capacidad
Las afirmaciones documentadas sobre capacidades se contrastan con el registro propio del proyecto de lo implementado y verificado, de modo que una afirmación no puede elevarse por encima de su evidencia.
Un modelo de actualización honesto
Como su configuración, su contenido y sus recursos viven fuera del núcleo de la aplicación, las mejoras de la plataforma se pueden absorber en lugar de sobrescribir su trabajo.
Lo que el proyecto no afirma
Foundation no afirma conformidad con WCAG, una certificación de seguridad, pruebas de penetración, puntuaciones de rendimiento o Lighthouse publicadas, ni cobertura universal de navegadores y dispositivos. La accesibilidad y el rendimiento se desarrollan y se verifican allí donde el proyecto puede verificarlos; no están certificados.
Dónde se detiene Foundation
La misma división de propiedad, expresada técnicamente. Foundation se detiene deliberadamente antes de la complejidad operativa del negocio y ofrece el punto de integración con el servicio que usted elija.
Propiedad del adoptante
- Configuración
- Contenido
- Diccionarios de idioma
- Gráfica del negocio
- Elección de proveedores
- Extensiones posteriores
Propiedad de Foundation
- Arquitectura de la aplicación
- Maquinaria reutilizable de interfaz
- Validación de la configuración
- Maquinaria de enrutamiento y contenido
- Puntos de integración
- Infraestructura de verificación
La extensión funciona de fuera hacia dentro: un nuevo proveedor es un adaptador más una rama de fábrica y una entrada de enumeración en el esquema, y un nuevo tipo de contenido o idioma son datos. Una capacidad genuinamente nueva es trabajo de plataforma.
Flujo de adopción
Ocho etapas. El repositorio posee el detalle a nivel de comando; esta es la forma del trabajo.
- 1
Obtener Foundation
Clone o bifurque el repositorio público.
- 2
Instalar y ejecutar
Instale las dependencias e inicie el sitio localmente.
- 3
Configurar
Defina identidad, idiomas, funciones y elección de proveedores.
- 4
Redactar contenido y recursos
Escriba sus páginas y sustituya los roles de recursos de marca.
- 5
Conectar proveedores
Apunte los puntos de integración a los servicios que realmente usa.
- 6
Validar
Ejecute la puerta de calidad del propio proyecto localmente.
- 7
Desplegar
Compile y despliegue desde su propio repositorio y cuenta.
- 8
Mantener y actualizar
Absorba las mejoras anteriores sin sobrescribir su material.
Los manuales del repositorio cubren cada etapa, incluida la resolución de problemas.
Documentación autorizada
GitHub es la fuente técnica canónica. Este sitio web resume; el repositorio instruye.
Repository
El código completo, su licencia y la declaración propia del proyecto sobre lo que es y no es.
README.md
Qué es el proyecto, inicio rápido, estructura del repositorio y la postura sobre la licencia.
ARCHITECTURE.md
Estilo arquitectónico, fronteras, dirección de dependencias y patrones de integración.
CUSTOMIZING.md
La guía para el usuario posterior y la referencia completa de configuración.
DEPLOYMENT.md
El runbook de lanzamiento y la lista de verificación posterior al despliegue.
BRAND_ASSETS.md
El contrato de sustitución de recursos de marca: cada rol gráfico reemplazable.
Manuales
Procedimientos de adopción, personalización, marca, contenido, actualización, validación, despliegue y resolución de problemas.
Cada destino anterior es un enlace al repositorio público, que es donde se mantienen esos documentos.
Léalo, ejecútelo, cámbielo
El código, sus pruebas y su documentación son el argumento. Empiece ahí.