first commit

docs/README.md

@@ -0,0 +1,25 @@
+# Documentación de TaskStream
+
+TaskStream es una alternativa a Jira para equipos de desarrollo: proyectos, tickets (bugs, features, cambios de UI,
+tareas, QA), releases, comentarios y relaciones entre tickets, todo en tiempo real.
+
+| Documento                                 | Para qué                                                                 |
+| ----------------------------------------- | ------------------------------------------------------------------------ |
+| [1. Visión general](01-vision-general.md) | Qué hace el producto, stack y estructura del monorepo                    |
+| [2. Arquitectura](02-arquitectura.md)     | Hexagonal, CQRS, event sourcing, flujo escritura → lectura y tiempo real |
+| [3. API](03-api.md)                       | Dominio (agregados, workflow, eventos) y la API GraphQL                  |
+| [4. Cliente web](04-cliente-web.md)       | Angular, NgRx Signals con eventos, GraphQL y `@pi/ui`                    |
+| [5. Autenticación](05-autenticacion.md)   | Pireon: tokens, login en el navegador, sesiones y webhooks               |
+| [6. Desarrollo](06-desarrollo.md)         | Puesta en marcha, comandos, tests y cómo añadir una funcionalidad        |
+| [7. Despliegue](07-despliegue.md)         | Docker, variables de entorno y escalado                                  |
+| [8. Decisiones](08-decisiones.md)         | Por qué está hecho así (y qué alternativas se descartaron)               |
+
+Cada librería de `libs/` tiene además su propio `README.md` con su responsabilidad y su contenido.
+
+**Empezar rápido**
+
+```sh
+docker compose up -d --build     # web en http://localhost:8080
+```
+
+Para entrar hace falta un cliente OAuth de Pireon en `.env` (ver [Autenticación](05-autenticacion.md#registrar-taskstream-como-cliente-en-pireon)).