Josep Piguillem
2c501a50d0
- Postgres: every table has a uuid `id` (gen_random_uuid()); the event store keeps its relay order in `seq`, and the lookup tables their uniqueness in constraints of their own. - MongoDB: `_id` is Mongo's ObjectId; `id` is the domain id (the same uuid as the aggregate's stream in Postgres), unique, and every query goes by it. Production starts from empty databases. - Web: linking tickets and hanging one from a parent are picked from a searchable select (links across projects, parents within the project) instead of typing a key; every checkbox is @pi/ui's pi-checkbox. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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) |
| 9. Servidor MCP | Usar TaskStream desde asistentes de IA (Claude…): herramientas y conexión |
| 10. Lo que queda | 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
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).