CLAUDE.md

# basic-erp

ERP base para SAP Business One (Service Layer). Monorepo npm workspaces:

- `apps/api` — NestJS: proxy hacia el Service Layer, login, sesión SAP compartida, permisos de menú (SQLite).
- `apps/web` — Angular: componentes reutilizables estilo SAP Business One.
- `libs/sap-types` — tipos TypeScript compartidos entre api y web.
- `tools/` — mockups y colecciones de pruebas.

## Reglas del proyecto base

- Solo campos **estándar** de SAP Business One. Ningún campo de usuario (`U_*`) salvo `U_WEB_USER` / `U_WEB_PASS` de `EmployeesInfo`, usados para el login web.
- Los formularios se construyen con componentes reutilizables y configuración declarativa; no se duplica markup por documento.
- Los colores y el aspecto salen de variables CSS (temas). Tema por defecto: claro, con la paleta de `tools/oferta_venta.html` (mockup de ejemplo: tiene algunos campos no estándar, pero se conserva la idea: filas de etiqueta + controles, máx. 2 columnas).

## Criterios de la interfaz

Es un ERP, no una página de publicidad: **ligera y rápida**. Sin librerías de componentes (Material/PrimeNG), sin webfonts ni animaciones, componentes propios y densos, zoneless + `OnPush`, rutas con carga diferida, presupuesto de bundle en `angular.json`, listas largas paginadas en el servidor.

## Comandos

- `npm install` (npm 11) instala todo y compila `libs/sap-types` (postinstall).
- `npm run dev:api` · `npm run dev:web` · `npm run build` · `npm test`.

## Flujo de trabajo por cliente (branches)

1. `main` es la versión base/genérica, sin personalizaciones de cliente.
2. Cada cliente tiene su branch (`cliente/<nombre-cliente>`); ahí viven sus personalizaciones y fixes.
3. Los cambios de una branch de cliente no se mezclan con `main` ni con otro cliente, salvo backport genérico decidido explícitamente.
4. Antes de crear branches, mergear a `main`, o hacer merge/backport entre clientes, confirmar con el usuario. No hacer `git push` sin confirmación.

## Flujo de las pantallas de documento

Cada menú abre primero una **lista de los últimos documentos** (con barra de filtros y búsqueda por columna, 50 por página); desde ahí se crea uno nuevo (`/…/nuevo`, formulario vacío) o se abre uno existente (`/…/:docEntry`, ver/editar). Las pantallas se definen en `apps/web/src/app/features/documents/document-screens.ts`.
chore: esqueleto del monorepo (npm workspaces) 2026-10-13 18:07:07 -05:00			`# basic-erp`

			`ERP base para SAP Business One (Service Layer). Monorepo npm workspaces:`

			- `apps/api` — NestJS: proxy hacia el Service Layer, login, sesión SAP compartida, permisos de menú (SQLite).
			- `apps/web` — Angular: componentes reutilizables estilo SAP Business One.
			- `libs/sap-types` — tipos TypeScript compartidos entre api y web.
			- `tools/` — mockups y colecciones de pruebas.

			`## Reglas del proyecto base`

			- Solo campos estándar de SAP Business One. Ningún campo de usuario (`U_*`) salvo `U_WEB_USER` / `U_WEB_PASS` de `EmployeesInfo`, usados para el login web.
			`- Los formularios se construyen con componentes reutilizables y configuración declarativa; no se duplica markup por documento.`
refactor(web): filas de formulario con varios controles combinables 2026-10-13 19:49:16 -05:00			- Los colores y el aspecto salen de variables CSS (temas). Tema por defecto: claro, con la paleta de `tools/oferta_venta.html` (mockup de ejemplo: tiene algunos campos no estándar, pero se conserva la idea: filas de etiqueta + controles, máx. 2 columnas).
chore: esqueleto del monorepo (npm workspaces) 2026-10-13 18:07:07 -05:00
feat(web): app Angular, librería compartida sap-types y sistema de temas 2026-10-13 19:11:05 -05:00			`## Criterios de la interfaz`

			Es un ERP, no una página de publicidad: ligera y rápida. Sin librerías de componentes (Material/PrimeNG), sin webfonts ni animaciones, componentes propios y densos, zoneless + `OnPush`, rutas con carga diferida, presupuesto de bundle en `angular.json`, listas largas paginadas en el servidor.

			`## Comandos`

			- `npm install` (npm 11) instala todo y compila `libs/sap-types` (postinstall).
			- `npm run dev:api` · `npm run dev:web` · `npm run build` · `npm test`.

chore: esqueleto del monorepo (npm workspaces) 2026-10-13 18:07:07 -05:00			`## Flujo de trabajo por cliente (branches)`

			1. `main` es la versión base/genérica, sin personalizaciones de cliente.
			2. Cada cliente tiene su branch (`cliente/<nombre-cliente>`); ahí viven sus personalizaciones y fixes.
			3. Los cambios de una branch de cliente no se mezclan con `main` ni con otro cliente, salvo backport genérico decidido explícitamente.
			4. Antes de crear branches, mergear a `main`, o hacer merge/backport entre clientes, confirmar con el usuario. No hacer `git push` sin confirmación.
feat(web): lista de documentos con barra de filtros y búsqueda por columna 2026-10-13 20:01:34 -05:00
			`## Flujo de las pantallas de documento`

			Cada menú abre primero una lista de los últimos documentos (con barra de filtros y búsqueda por columna, 50 por página); desde ahí se crea uno nuevo (`/…/nuevo`, formulario vacío) o se abre uno existente (`/…/:docEntry`, ver/editar). Las pantallas se definen en `apps/web/src/app/features/documents/document-screens.ts`.