Files
task-stream/docs/README.md
Josep Piguillem 6c3550ae9d docs(auth): two Pireon clients, production URLs and sign-in troubleshooting
- Registering clients: the authorization_code client is confidential and needs
  its secret; Pireon shows it once (rotate-secret if lost); containers must be
  recreated to read new environment variables.
- Production URLs (taskstream.pireon.dev, api.taskstream.pireon.dev) and their
  redirect URIs.
- "Si el login falla": each error seen while deploying (not configured,
  unauthorized_client, missing client_secret, invalid_client, redirect URI,
  expired code, wrong credentials, intermittent 404s) with cause and fix.
- READMEs mention both clients; Word/PDF regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 16:01:33 +02:00

1.8 KiB

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 Qué hace el producto, stack y estructura del monorepo
2. Arquitectura Hexagonal, CQRS, event sourcing, flujo escritura → lectura y tiempo real
3. API Dominio (agregados, workflow, eventos) y la API GraphQL
4. Cliente web Angular, NgRx Signals con eventos, GraphQL y @pi/ui
5. Autenticación Pireon: tokens, login en el navegador, sesiones y webhooks
6. Desarrollo Puesta en marcha, comandos, tests y cómo añadir una funcionalidad
7. Despliegue Docker, variables de entorno y escalado
8. Decisiones 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

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).