# Griddo AX

- [Arquitectura del proyecto](docs/PROJECT-ARCHITECTURE.md)
- [Estándares de commits](docs/COMMITS.md)
- [Comandos de npm](#comandos-de-npm)
- [AGENTS.md](#agentsmd)
- [Centralización de textos de UI](docs/LOCALE-UI-TEXTS.md)

## AGENTS.md

Este repositorio incluye un archivo llamado [AGENTS.md](docs/AGENTS.md) que contiene las directrices y reglas de arquitectura que la IA sigue al generar o modificar código. Este archivo define la estructura del proyecto, las convenciones tecnológicas (por ejemplo, el uso de React Router v5, estilo con styled-components, Redux manual), y recomendaciones específicas para mantener la coherencia y calidad del proyecto. Cada vez que la IA realiza cambios en el código, consulta este documento para asegurarse de respetar los patrones legacy y las mejores prácticas establecidas por el equipo de Griddo AX.

## Comandos de npm

### Desarrollo

- `yarn start` - Alias para `start:dev`
- `yarn start:local` - Inicia el servidor de desarrollo en entorno local
- `yarn start:dev` - Inicia el servidor de desarrollo en entorno de desarrollo
- `yarn start:staging` - Inicia el servidor de desarrollo en entorno de staging

### Build

- `yarn build` - Construye la aplicación para producción
- `yarn build:dev` - Construye la aplicación para desarrollo

### Testing

- `yarn test` - Ejecuta los tests con Jest
- `yarn test:watch` - Ejecuta los tests en modo watch
- `yarn test:ci` - Ejecuta los tests en modo CI (sin paralelización)
- `yarn test:coverage` - Ejecuta los tests y genera reporte de cobertura
- `yarn test:dev` - Ejecuta los tests en modo watch (alias de `test:watch`)
- `yarn test:dev:coverage` - Ejecuta los tests con cobertura en modo watch

### Linting y Formato

- `yarn lint` - Verifica el código con Biome (sin escribir)
- `yarn format:write` - Formatea el código con Biome (escribiendo)

¿Quieres comprobar solo una regla o categoría específica?
```bash
biome lint . --only=<GROUP|RULE|DOMAIN>
# por ejemplo, desde la raíz del proyecto
node_modules/.bin/biome lint . --only=noConsole
```


## Extras

### Biome organize imports constants group

// OJo! tiene que ser @/ no @ax/ etc..
- :ALIAS: sources starting with #, @/, ~, $, or %.
- :BUN: sources starting with the protocol bun: or that correspond to a built-in Bun module such as bun.
- :NODE: sources starting with the protocol node: or that correspond to a built-in Node.js module such as fs or path.
- :PACKAGE: scoped and bare packages.
- :PACKAGE_WITH_PROTOCOL: scoped and bare packages with a protocol.
- :PATH: absolute and relative paths.
- :URL: sources starting with https:// and http://.
- :BLANK_LINE: blank line.