Primer prototipo

2026-05-20 14:05:55 +02:00
parent c2ab9a46d4
commit c06300833b
22 changed files with 1115 additions and 2 deletions
@@ -0,0 +1,46 @@
+# Cómo contribuir
+
+¡Gracias por querer ayudar! El proyecto se mantiene gracias a la comunidad.
+
+## Antes de empezar
+
+1. Mira los [issues abiertos](../../issues), sobre todo los marcados
+   `good first issue`.
+2. Si tu cambio es grande, abre un issue antes de programar para discutirlo.
+
+## Flujo
+
+1. Haz fork del repositorio.
+2. Crea una rama desde `main`: `git checkout -b mi-cambio`.
+3. Escribe el código siguiendo las pautas de abajo.
+4. Asegúrate de que la app arranca: `npm install && npm run dev`.
+5. Abre un Pull Request hacia `main` describiendo el cambio.
+
+## Pautas de código
+
+- **Mantén la app simple.** Si dudas entre dos soluciones, elige la más corta
+  y obvia. Este proyecto evita la complejidad a propósito.
+- **Sigue la estructura existente.** Componentes en `src/components`, acceso a
+  datos en `src/services`.
+- **No añadas dependencias sin necesidad.** Cada nueva librería es coste de
+  mantenimiento.
+- **SOLID y Clean Code aplicados con sentido común.** Nombres claros,
+  funciones cortas, una responsabilidad por archivo.
+- **Estilo**: 2 espacios de indentación, comillas dobles en JSX y simples en JS.
+
+## Tipos de contribución
+
+- **Código**: bugs, mejoras, nuevas funciones acordadas en issues.
+- **Documentación**: cualquier archivo de `docs/` o el README.
+- **Diseño**: propuestas en issues con mockups.
+- **Reportar negocios**: usa la propia aplicación; no es necesario un PR.
+
+## Revisión
+
+Un mantenedor revisará tu PR. Puede pedir cambios. Una vez aprobado, hará
+merge. Sé paciente: somos voluntarios.
+
+## Reconocimiento
+
+Todas las personas que han contribuido aparecen automáticamente en la pestaña
+de Contributors del repositorio.