# 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)                          |
| [9. Servidor MCP](09-mcp.md)              | Usar TaskStream desde asistentes de IA (Claude…): herramientas y conexión           |
| [10. Lo que queda](10-futuro.md)          | Pendiente para cerrar, fallos conocidos, siguientes funcionalidades y lo descartado |

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 hacen falta dos clientes OAuth de Pireon en `.env` (`authorization_code` y `password`, ver
[Autenticación](05-autenticacion.md#registrar-taskstream-como-cliente-en-pireon)).