40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# Standards — Guías de Implementación Frontend Segura
|
|
## Referencia obligatoria para todo desarrollo en el proyecto frontend-ai
|
|
|
|
**Versión:** 1.0 · **Fecha:** 2026-05-27
|
|
**Patrón base:** `docs/guia-4-implemented-pattern.md`
|
|
|
|
---
|
|
|
|
## Contenido
|
|
|
|
| # | Guía | Objetivo |
|
|
|---|---|---|
|
|
| [01](./01-log-tracing.md) | **Trazas de Log** | Sistema de logs centralizado, `server-logger`, `client-logger`, proxy asíncrono `/api/logs` |
|
|
| [02](./02-security-tracing.md) | **Seguridad y Cifrado** | Autenticación server-side con `serverRequireAuth`, cookies JWT http-only, y encriptación Kong |
|
|
| [03](./03-headers-contract.md) | **Contrato de Headers** | Cookies de sesión, traceId (`deviceSessionReference`), propagación a APIs Spring Boot |
|
|
| [04](./04-configmap-management.md) | **Gestión de Configuración** | Estructura de archivos `.env`, variables del servidor (privadas) vs variables del cliente (`NEXT_PUBLIC_`) |
|
|
| [05](./05-client-insumos.md) | **Insumos de Frontend** | Plantilla interactiva para rellenar especificaciones de pantalla, estado, mockups y endpoints antes de empezar |
|
|
| [06](./06-auth-2fa-flow.md) | **Autenticación y 2FA** | Reglas de negocio del inicio de sesión, control de intentos, bloqueos de usuario y cookies http-only |
|
|
|
|
---
|
|
|
|
## Cómo usar estas guías
|
|
|
|
```
|
|
INICIO DE IMPLEMENTACIÓN PANTALLA
|
|
└─ Leer 05-client-insumos.md → recopilar con diseño/producto mockups y endpoints
|
|
└─ Leer 03-headers-contract.md → validar traceId, cookies JWT y headers requeridos
|
|
|
|
DURANTE EL DESARROLLO
|
|
└─ Leer 01-log-tracing.md → registrar logs en servidor y cliente (/api/logs)
|
|
└─ Leer 02-security-tracing.md → aplicar middleware serverRequireAuth y encriptación Kong
|
|
└─ Leer 04-configmap-management.md → registrar configuraciones en .env.local
|
|
|
|
CHECKLIST FINAL
|
|
└─ AGENT.md §Checklist pre-entrega
|
|
```
|
|
|
|
> **Regla de oro:** si tienes duda de si una lógica se ejecuta en el servidor o cliente,
|
|
> la respuesta está en `02-security-tracing.md` y `docs/guia-4-implemented-pattern.md`.
|