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>
58 lines
3.0 KiB
Markdown
58 lines
3.0 KiB
Markdown
# TaskStream
|
|
|
|
Alternativa a Jira para equipos de desarrollo: proyectos, tickets (bugs, features, cambios de UI, tareas y QA),
|
|
releases, comentarios y relaciones entre tickets, **en tiempo real**.
|
|
|
|
- **API**: NestJS + GraphQL y REST con OpenAPI (Swagger, para otras apps), arquitectura hexagonal, CQRS y event sourcing (escritura en PostgreSQL, lectura en MongoDB,
|
|
Redis entre ambas).
|
|
- **Web**: Angular 22 + NgRx Signals (patrón de eventos) + `@pi/ui`, con la misma arquitectura.
|
|
- **Usuarios**: los gestiona [Pireon](https://oauth.pireon.dev/api/documentation).
|
|
|
|
## Empezar
|
|
|
|
```sh
|
|
docker compose up -d --build # web en http://localhost:8080
|
|
```
|
|
|
|
Para entrar hacen falta los clientes OAuth de Pireon en `.env`: uno `authorization_code` (`PIREON_CLIENT_ID` /
|
|
`_SECRET`, «Entrar con Pireon») y uno `password` (`PIREON_PASSWORD_CLIENT_ID` / `_SECRET`, email y contraseña). Ver
|
|
[Autenticación](docs/05-autenticacion.md#registrar-taskstream-como-cliente-en-pireon). Para desarrollar:
|
|
|
|
```sh
|
|
npm install # @pi/ui necesita el token del Nexus de Pireon en ~/.npmrc
|
|
docker compose up -d postgres mongo redis
|
|
cp .env.example .env
|
|
npx nx serve api # http://localhost:3000/graphql · REST: /api/docs
|
|
npx nx serve web # http://localhost:4200
|
|
```
|
|
|
|
## Documentación
|
|
|
|
| | |
|
|
| ------------------------------------------- | -------------------------------------------------------------------- |
|
|
| [Visión general](docs/01-vision-general.md) | Funcionalidades, stack y estructura del monorepo |
|
|
| [Arquitectura](docs/02-arquitectura.md) | Capas, CQRS, event sourcing, flujo escritura → lectura y tiempo real |
|
|
| [API](docs/03-api.md) | Dominio, workflow de tickets, eventos, GraphQL y REST (OpenAPI) |
|
|
| [Cliente web](docs/04-cliente-web.md) | Stores con eventos, GraphQL y `@pi/ui` |
|
|
| [Autenticación](docs/05-autenticacion.md) | Tokens de Pireon, login en el navegador y webhooks |
|
|
| [Desarrollo](docs/06-desarrollo.md) | Comandos, tests, cómo añadir una funcionalidad y problemas conocidos |
|
|
| [Despliegue](docs/07-despliegue.md) | Docker, variables de entorno y escalado |
|
|
| [Decisiones](docs/08-decisiones.md) | Por qué está hecho así |
|
|
|
|
Cada librería de `libs/api/*` y `libs/web/*` tiene su propio `README.md`.
|
|
|
|
## Estructura
|
|
|
|
```
|
|
apps/api apps/web
|
|
libs/api/{shared,identity,tracker}/{domain,application,infrastructure,presenters}
|
|
libs/web/{shared,identity,tracker}/{domain,application,infrastructure,presenters} (+ web/shared/ui)
|
|
docs/
|
|
```
|
|
|
|
```sh
|
|
npx nx run-many -t lint test build # todo
|
|
npx nx e2e api # flujo completo contra Docker
|
|
npx nx graph # dependencias entre proyectos
|
|
```
|