NovaFast Pattern

Plantilla base para proyectos Fastify con arquitectura modular.

¿Qué incluye?

• Estructura modular por dominios
• Plugins base (CORS, Swagger)
• Conexión simple a PostgreSQL
• Ejemplo de módulo example

Cómo usar

1. Copia el repositorio
2. Instala dependencias: npm install
3. Crea un fichero de entorno local:

cp .env.example .env
# Edita `.env` y establece los valores (por ejemplo DATABASE_URL)

4. Ejecuta en desarrollo (recarga automática):

npm run dev

5. Probar el endpoint de salud:

curl http://127.0.0.1:3000/health
# - En dev sin DATABASE_URL configurada devuelve: {"status":"ok","db":"skipped"}
# - Si DATABASE_URL está presente y la BD responde devuelve: {"status":"ok"}
# - Si DATABASE_URL está presente pero la BD no responde devuelve 503 y {"status":"error"}

Notas:

• No subas tu archivo .env al repositorio. Este repo incluye .env.example con las variables necesarias.
• En producción debes proporcionar las variables de entorno mediante tu sistema de despliegue (GitHub Actions secrets, Kubernetes Secrets, Vault, etc.).