Mantra Core Health

Frontend Angular 21 + SSR del sistema médico de Mantra Core Technologies (nombre de producto provisional: mantra-core-health).

Arranque

corepack enable          # habilita el Yarn que declara package.json (4.18)
corepack yarn install
corepack yarn test --watch=false
corepack yarn start:dev  # http://localhost:4200 (ng serve; `dev` es un alias)

Usá siempre corepack yarn <script>, nunca ng a secas. El CLI de Angular vive en las dependencias del proyecto: un ng global apunta a otra instalación y falla de formas que no señalan la causa. Todos los comandos de abajo pasan por los scripts de package.json.

Si el proyecto está en una ruta con espacios (por ejemplo C:\...\Sistema Salud\), no hace falta hacer nada especial: scripts/generate-env.mjs resuelve la ruta con fileURLToPath. Si ves un error del estilo ENOENT ... Sistema%20Salud, estás en un commit anterior al arreglo.

Comandos

Comando	Qué hace
corepack yarn start:dev	Servidor de desarrollo (ng serve) en :4200, con el proxy hacia la API; dev hace lo mismo
corepack yarn start:real-api	Servidor de desarrollo con la configuración real-api
corepack yarn start:lan	Servidor de desarrollo con la configuración lan, escuchando en 0.0.0.0
corepack yarn build	Compilación de producción con SSR en dist/
corepack yarn start	No es el servidor de desarrollo: ejecuta el servidor SSR ya compilado (dist/mantra-core-health/server/server.mjs), así que exige build antes
corepack yarn test --watch=false	Pruebas unitarias (Vitest)
corepack yarn test:coverage	Pruebas con cobertura y umbrales
corepack yarn lint	ESLint (eslint . --cache), con reglas no-restricted-imports de arquitectura
corepack yarn typecheck	tsc sobre la app y sobre Cypress
corepack yarn e2e	Suite Cypress de punta a punta (Chrome)
corepack yarn pw	Suite Playwright (playwright.config.ts); correla con --workers=1

La lista completa de scripts está en package.json; los comandos de esta tabla se leyeron de ahí y no se ejecutaron al escribirla.

Generar código

Con el CLI del proyecto, no a mano: angular.json ya fija la convención de nombres (clase X, archivo x.ts, sin sufijo Component).

corepack yarn ng generate component shared/components/atoms/mi-atomo
corepack yarn ng generate interface shared/components/atoms/mi-atomo/mi-atomo --type=types

La API

El frontend habla con mantra-core-health-api a través del proxy (proxy.conf.mjs, que carga proxy.conf.json → http://localhost:3000), así que en desarrollo no hay CORS de por medio. Para levantar la API y su base, ver el README de ese repositorio. Con el stack en pie, la cuenta sembrada por el bootstrap sirve para entrar.

Antes de tocar el código

• Coordinación. Si hay más de una persona o sesión sobre la misma rama, trabajá cada una en su propio git worktree: ya hubo un trabajo duplicado que costó reconciliar. El archivo COORDINACION-AGENTES.md ya no se versiona (commit a5e54f5a).
• Colores y tipografías salen de src/styles.css. Nunca un hex literal en un componente. Los exports de diseño (Stitch) traen su propia paleta Material y sus propias fuentes, que no son las de este sistema: de esos archivos se toma la estructura y la jerarquía, jamás los valores. Un hex copiado no lo detecta ninguna prueba, porque no es un token corrido sino uno nuevo.
• Mobile-first. Las consultas de medios van con min-width sobre los breakpoints tokenizados; el estilo base es el móvil.
• Todo tiene que renderizar bajo SSR: sin window, document ni localStorage en la ruta de render; lo que necesite el navegador va detrás de afterNextRender().

Documentos

Archivo	Para qué
docs/	Documentación técnica (sitio MkDocs)
FABLE_FRONTEND_REFACTOR_PLAYBOOK.md	Protocolo de calidad de todo cambio de frontend

Los informes de proceso fechados (planes, reportes de carril, auditorías, listas de pendientes) ya no se versionan: quedan en el historial de git.