# AGENTS.md — enterfarmaplus-cuba-porto (feat/cuba-porto-admin) Este worktree es la migración de shell Cuba -> Porto. Se trabaja acá en paralelo con Claude Code, misma carpeta, sesiones distintas -- lo que sigue es para no pisarnos. ## Servidor local - URL: http://demo.enterfarmaplus.test:8080/ -- Apache, vhost fijo en `C:\laragon\etc\apache2\sites-enabled\porto-worktree-8080.conf`. - NO uses `php artisan serve`. Es single-thread: si una request se cuelga (ej. un browser de test que crashea a medio request), el server entero muere y deja de responder para siempre hasta reiniciarlo a mano. Ya pasó. - El tenant se resuelve por match EXACTO de hostname contra `hostnames.fqdn` en BD (`app/Tenancy/TenancyManager.php::identify()`), el puerto no cuenta para nada. Hoy solo existe la fila `demo.enterfarmaplus.test -> website_id 1`. No inventes otro dominio (tipo `porto.enterfarmaplus.test`) sin agregar esa fila -- si no, el tenant resuelve null y no vas a ver datos reales. - Login local: `admin@gmail.com` / `PortoLocal123!` ## Git -- regla dura (viene de CLAUDE.md del repo, no es opcional) - Antes de cualquier `checkout`/`reset`/`restore`/`clean`: corré `git status`. Si hay cambios que no son tuyos, no los toques -- puede ser la otra sesión a mitad de algo. - Commiteá WIP seguido, aunque esté a medias: `git commit -m "wip: ..."`. Un commit feo en esta rama es infinitamente mejor que un diff gigante sin guardar que la otra sesión puede pisar, o que alguien puede confundir con "esto se puede descartar". - Agregá archivos por path explícito (`git add `), nunca `git add -A` ni `git add .` -- puede haber cambios sueltos de la otra sesión en el árbol. - Si necesitás descartar algo tuyo para volver a un estado estable, usá `git stash push -u -m "..."`, nunca `reset --hard` / `checkout -- .` en seco. ## Trabajo simultáneo (mismo árbol, al mismo tiempo -- no por turnos) Se decidió explícitamente NO separar en worktrees. Vos y Claude Code editan esta misma carpeta en paralelo. Para que no se pisen los cambios en caliente: - **Carriles por área, no por archivo suelto.** Si los dos están activos a la vez, repartirse por zona (ej. "vos backend/rutas/controllers, yo CSS del shell") en vez de que ambos toquen el mismo archivo en la misma ventana de tiempo -- un archivo pisado a mitad de escritura no es un conflicto de git, es pérdida de datos silenciosa (nadie avisa). - **Antes de arrancar, mirá qué dejó la otra sesión:** `git log --oneline -5` y `git status --short`. Si hay diffs sin commitear que no son tuyos, no sigas editando esos archivos a ciegas -- puede estar a mitad de un cambio. - **Recompilá apenas termines un bloque de SCSS/JS** (`npx mix`), no lo dejes pendiente. `public/css/porto-app.css` es un archivo compilado que se sirve en vivo por Apache -- si lo dejás a medio compilar (o sin compilar) mientras la otra sesión está probando en el navegador, ve un estado roto que no es el tuyo ni el suyo. - **No mates ni reinicies el proceso de Apache** (`httpd.exe`, puerto 8080) mientras la otra sesión puede estar con el navegador abierto contra `demo.enterfarmaplus.test:8080` -- coordiná antes si hace falta. - **Commits chicos y frecuentes son el mecanismo de "guardado".** No hay isolation de worktree que te salve si dejás dos horas de cambios sin commitear: eso es exactamente lo que casi se pierde la vez pasada. ## Lo que rompió la app la última vez (no repetir) - `$isPortoAdmin = true;` hardcodeado en `resources/views/tenant/layouts/app.blade.php` -- bypasea el flag real (`Configuration::isPortoAdmin()`). Nunca hardcodear esto, siempre pasar por el flag del tenant. - Un `