00 · Inicio
Bienvenida a Naoro
Esta guía prepara a quien se suma al equipo para trabajar como trabajamos: entender una operación, encontrar dónde se atasca, diseñar la pieza que falta y construirla con nuestro stack. Al terminarla puedes participar en un proyecto real desde el diagnóstico hasta la entrega.
Objetivo
Al terminar la guía, quien la lee puede:
- Explicar qué hace Naoro y por qué el problema va antes que la tecnología.
- Llevar un descubrimiento: levantar la operación, mapearla, detectar fricciones con evidencia y priorizarlas.
- Diseñar una solución mínima y medible, probarla con quienes hacen el trabajo y construirla en rebanadas.
- Conectarla con lo que el cliente ya usa y demostrar con números que funcionó.
- Trabajar con el stack: FastAPI y PostgreSQL en el servidor, Next.js y React en la interfaz.
Es para alguien con experiencia en desarrollo. No enseña a programar. Da el contexto, el método y los links oficiales para profundizar. La metodología es la parte más larga porque es el centro de lo que hacemos.
Recorrido
| Etapa | Qué lee y hace | Evidencia de que quedó |
|---|---|---|
| 1 · Método | Naoro y toda la Metodología. Usa las demos de casos. Si hay un levantamiento activo, acompaña una sesión. | Tres fichas de fricción de un proceso real o del caso de cierre |
| 2 · Stack | Implementación, Backend, Frontend y Reglas de la casa. Tutoriales de FastAPI y de Next.js. Lectura guiada del código del sitio. | Una API pequeña en FastAPI y una pantalla en Next.js que la consuma |
| 3 · Caso | Cierre: aplica el método completo a un caso acotado. | Prueba funcional y presentación del caso |
Al cerrar cada etapa conviene una revisión con quien acompaña la inducción: qué se entendió, qué no y qué se ajusta. La página Cierre tiene la checklist completa.
Mapa de la guía
Cómo leerla
- Los links marcados Base se leen completos durante la inducción. Los de Consulta se abren cuando el trabajo lo pida.
- Si ya dominas una herramienta, lee solo lo que cambió en su versión actual. Next.js 16 y React 19 traen cambios que rompen hábitos de versiones anteriores.
- Las notas marcadas como propuesta describen cómo queremos trabajar, todavía sin práctica establecida. Si algo no funciona en un proyecto real, se corrige aquí.