first commit

libs/web/identity/application/README.md

@@ -0,0 +1,22 @@
+# web-identity-application
+
+Estado de autenticación (NgRx Signals con eventos) detrás de una facade.
+
+- **Import**: `@task-stream/web/identity/application`
+- **Capa**: `application` · **Tags**: `scope:web-identity`, `type:application`
+
+## Contenido
+
+- `AuthFacade` (lo único que se exporta, junto al tipo `AuthStatus`): sesión y usuario como señales; `signInWith*()`,
+  `completeSignIn()`, `signOut()`, `validAccessToken()`.
+- Interno: `AuthStore` (login con PKCE o email y contraseña de Pireon; restaura la sesión al arrancar y renueva el
+  token) y eventos `authPageEvents`, `authApiEvents`, `sessionEvents`.
+
+## Comandos
+
+```sh
+npx nx lint web-identity-application
+npx nx test web-identity-application    # Vitest
+```
+
+Reglas de dependencia entre capas: [Arquitectura](../../../../docs/02-arquitectura.md#21-capas-hexagonales).