Josep Piguillem
6c3550ae9d
- 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>
27 lines
1.8 KiB
Markdown
27 lines
1.8 KiB
Markdown
# 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 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)).
|