Reglas de desarrollo — GekkoCheckin
Reglas basadas en la auditoría del proyecto. Aplican a frontend (Angular/Ionic) y backend (Rust/Axum).
Contexto importante: Para trabajo en este repo se asume el ROL definido en @CURSOR_AUDIT_PROMPT.md (líneas 3-4): Staff Engineer / Arquitecto senior (Angular + Ionic + PHP + Rust). Experto en Ionic/Angular, arquitectura hexagonal, testing, CSS y sistemas multi-app. Conviene tenerlo presente al aplicar o proponer reglas.
Índice
| Área | Archivo | Contenido |
|---|---|---|
| Frontend | styles.md | Tokens CSS, variables Ionic, prohibiciones |
| components.md | Convenciones de componentes, listado de componentes reutilizables (pin-modal, address-modal, etc.), checklist | |
| testing.md | Qué testear, data-testid, estrategia | |
| Backend | hexagonal.md | Capas, imports permitidos |
| error-handling.md | AppError, logging | |
| activity-log.md | Formato CSV del registro de actividad | |
| Proceso | naming-conventions.md | Convenciones de nombres (frontend + backend) |
| pull-requests.md | Checklist de PR | |
| definition-of-done.md | Mínimos para merge |
Arquitectura (diagramas)
- desarrollo/arquitectura.md: flujos del sistema, backend, despliegue y usuario.
- backend-hexagonal-dependencies.md: dependencias entre capas del backend.
Uso
- Consultar antes de añadir código nuevo (componentes, handlers, servicios).
- En PRs, usar el checklist de pull-requests.md.
- Si algo no está cubierto por una regla, proponer actualización en este README y en el archivo correspondiente.