Nueva pantalla "Descripción" (paso 5 de 6, opcional, máx. 200 caracteres) entre Tipo específico y Revisión. La descripción viaja en la propuesta (trim; vacía → ausente/NULL), el filtro de palabras prohibidas la cubre y el resumen la muestra. Backend/BD ya la soportaban: cambio frontend-only. Incluye el archivo del cambio hide-admin-route y la propuesta openspec del nuevo cambio. Suite: 114/114.
9.2 KiB
Tasks: Hide Admin Route
Pivote decidido por el usuario (2026-10-02): "solo quiero que se pueda configurar el prefijo de admin, nada más". El enfoque de middleware de enmascaramiento con 404 se descarta; las rutas admin se montan bajo un prefijo configurable (
LOCALESP_ADMIN_PREFIX, única variable para servidor y frontend) y las rutas históricas bajo/apidejan de existir (404 natural, sin handler).reportar/confirmarsiguen públicas (las usa la web);DELETE /api/locales/:idpasa al prefijo.Estado (2026-10-02, tras el pivote + obligatoriedad): implementado y verificado.
./node_modules/.bin/vitest run→ 109/109 en verde (16 ficheros), incluyendotests/unit/test-routes.spec.js(18 tests, prefijo configurado) ytests/unit/test-admin-prefix-required.spec.js(fail-fast sin configurar).
Actualización 2 (2026-10-02): a petición del usuario,
LOCALESP_ADMIN_PREFIXpasa a ser obligatoria (sin default/api): sin ella el servidor lanza error claro y no arranca. Añadidos.env.example, cargador de.enven el servidor (no sobrescribe el entorno) y lectura del prefijo envite.config.jsvíaloadEnv. Test de compatibilidad con/apisustituido portest-admin-prefix-required.spec.js(fail-fast verificado). Suite: 109/109.Actualización 3 (2026-10-02): eliminada la redundancia
VITE_ADMIN_PREFIX: una sola variable (LOCALESP_ADMIN_PREFIX) para servidor, proxy de dev y frontend (Vite la expone víaenvPrefix;npm run buildfalla si falta).Actualización 4 (2026-10-03): el panel admin vive en la raíz del prefijo (
/administradoren prototipo-yb01) y/adminmuestra la web pública.Actualización 5 (2026-10-03): config por entorno movida del host al repo (
scripts/entornos.env, mappingslug=prefijo): el workflow la aplica al build ydeploy.shgenera<dest>/.envdesde ella. Fail-fast sin entrada.
1. Revisión de rutas existentes
- 1.1 Leer y entender la estructura de rutas de
server/index.js - 1.2 Identificar las rutas solo-admin (
/api/pendientes,/api/reportes,/api/locales/:id/reportar,/api/locales/:id/confirmar,/api/locales/:id,/api/aprobar/:id,/api/rechazar/:id,/api/reportes/:id/descartar) - 1.3 Documentar el orden de rutas y la posición del fallback SPA
2. Prefijo de administración configurable (re-encaminado)
Originalmente "middleware de ofuscación"; sustituido por el pivote al prefijo configurable. El middleware roto y
ADMIN_ROUTES/ROUTE_REGEXPSse eliminaron del servidor.
- 2.1 Montar las rutas admin bajo
ADMIN_PREFIX(LOCALESP_ADMIN_PREFIX, obligatoria y sin valor por defecto: fail-fast al arrancar si falta; template en.env.example, que el servidor autocarga sin pisar el entorno) - 2.2 Rutas bajo prefijo:
pendientes,aprobar/:id,rechazar/:id,locales/:id(DELETE),reportes,reportes/:id/descartar— sin middleware ni matching por patrón - 2.3 Posición: mismas posiciones que las rutas originales; el fallback SPA sigue excluyendo
api/ - 2.4 Verificado por tests: las rutas históricas bajo
/apidevuelven 404 cuando el prefijo está configurado
3. Verificar que las rutas no-admin siguen funcionando
- 3.1
GET /api/locales→ 200 con lista de locales (test) - 3.2
POST /api/propuestas→ 201 con la propuesta creada (test) - 3.3 Fallback SPA
GET /sirveindex.html(test, aserción case-insensitive)
4. Documentación
- 4.1 Documentar las reglas de protección y las rutas afectadas en el spec (
specs/route-obfuscation/spec.md, actualizado al enfoque de prefijo) - 4.2 README actualizado: tabla de rutas admin bajo prefijo, variable única
LOCALESP_ADMIN_PREFIX(servidor + proxy dev + build), proxy de dev y advertencia de que es ocultación, no autenticación - 4.3
DELETE /api/locales/:id— decidido por el usuario: pasa al prefijo configurable (test cubre borrado bajo prefijo y 404 en la ruta antigua)
5. Pruebas
Con el enfoque de prefijo, "protegida" = la ruta histórica bajo
/apiya no tiene handler (404 idéntico para cualquier método, query, extensión o variante de cadena) y la funcionalidad vive bajo$ADMIN_PREFIX. Cubierto portests/unit/test-routes.spec.js(prefijo/prefijo-admin-test) ytests/unit/test-admin-prefix-default.spec.js(prefijo por defecto).
5.1 Rutas públicas (deben funcionar sin cambios)
- 5.1
GET /api/locales→ 200 (test) - 5.2
POST /api/propuestas→ 201 con cuerpo (test) - 5.3
POST /api/check-duplicado→ 200 con contratocoincidenciasintacto (test) - 5.4 N/A: no existe ruta
/healthni middleware que la intercepte - 5.5
GET /→ 200 sirvedist/index.html(test, doctype case-insensitive) - 5.6 N/A: assets estáticos los sirve
express.staticsin intervención - 5.7 N/A: ídem
- 5.8 Corregido el enunciado:
GET /api/locales/123→ 404 (el fallback SPA siempre excluyóapi/); sin fuga - 5.9
GET /api/config/filtro_palabras→ 200 (test)
5.2 Rutas protegidas (la ruta histórica devuelve 404; la función vive bajo prefijo)
- 5.10
GET /api/pendientes→ 404 y$P/pendientes→ 200 con datos (test) - 5.11
GET /api/reportes→ 404 y$P/reportes→ 200 con datos (test) - 5.12
POST /api/locales/:id/reportar→ pública (la usa la web); su flujo admin (listar/descartar reportes) bajo prefijo (test) - 5.13
POST /api/locales/:id/confirmar→ pública (la usa la web); 200 renueva fecha (test) - 5.14
POST /api/aprobar/:id→ 404 en/api; bajo prefijo mueve a locales y saca de pendientes (test) - 5.15
POST /api/rechazar/:id→ 404 en/api; bajo prefido elimina pendiente (test) - 5.16
POST /api/reportes/:id/descartar→ 404 en/api; bajo prefijo descarta (test)
5.3 Comportamiento (evitar falsos positivos)
- 5.17
GET /api/locales→ 200 (test) - 5.18/5.19/5.20 Corregido el enunciado: cualquier GET bajo
api/sin handler → 404 (el fallback SPA siempre excluyóapi/); sin middleware que bloquee de más - 5.21
GET /API/PENDIENTES→ sin handler API; cae al fallback SPA sin datos (test) - 5.22
GET /api/pendientes/extra→ 404 (test) - 5.23
POST /api/locales/:id/reponer→ 404 (sin handler)
5.4 Pruebas de seguridad (enumeración y rutas maliciosas)
- 5.24
GET /api/pendientes.json→ 404 (test) - 5.25
GET /api/pending//api/xpendientes→ 404 (test) - 5.26–5.34 Sin handler bajo
/api, cualquier método/query/extensión/cadena recibe el mismo 404 (por construcción); las variantes que no empiezan porapi/reciben el HTML genérico del fallback SPA, sin datos - 5.35
GET /api/xpendientes→ 404 (test)
5.5 Pruebas de regresión y no-regresión
- 5.36
POST /api/propuestas→ 201 con campos correctos (test); payload malformado gestionado por la BD/validación existente (sin cambios en este cambio) - 5.38
DELETEbajo prefijo → 200 y borra local + reportes (test); ruta antigua → 404 - 5.39–5.44 N/A o por construcción: no hay middleware, no hay cabeceras especiales ni logs nuevos
- Suite completa previa (componentes incluidos) en verde: 110/110
5.6 Validación contra el esquema de base de datos
- 5.45
GET /api/localessin cambios de columnas (no se tocó la query) - 5.46
POST /api/propuestassin cambios (ídem) - 5.47
$P/reportesdevuelve exactamente lo que devolvía/api/reportes(misma query)
6. Limpieza
- 6.1 N/A tras el pivote: no hay lista
ADMIN_ROUTES - 6.2
DELETE /api/locales/:idresuelto: vive bajo el prefijo (4.3) - 6.3 N/A tras el pivote:
reportes/:id/descartarmontado bajo prefijo y verificado por test - 6.4 Ficheros de prueba duplicados/muertos eliminados:
tests/integration/test-hide-admin-route.js(nunca recogido por ningún include y con sintaxis rota) yvitest.config.jsredundante (pisabavitest.config.mjs, que es la config vigente); se conserva un únicotests/unit/test-routes.spec.js(+ el de prefijo obligatorio)
7. Seguimiento: protección fina por método
Obsoleto tras el pivote: el prefijo configurable ya separa superficie pública y admin sin matching por método. Si en el futuro se añade autenticación real, este apartado queda como referencia.
8. Bloqueadores para cerrar el cambio
- 8.1 Obsoleto: el middleware se eliminó (pivote al prefijo)
- 8.2 El handler de
GET pendientesexiste de nuevo, montado bajo el prefijo: quien conoce la URL prefijada obtiene los datos; la ruta/api/pendienteshistórica devuelve 404 - 8.3 Suite en verde: 109/109 tests (19 de rutas/prefijo en 2 ficheros: configurado + obligatorio)
- 8.4 Aserción del SPA corregida (comparación case-insensitive de
<!doctype html>) - 8.5 Revertidos los cambios fuera de alcance:
distanciaMetros(haversine) restaurada,db→Dbdeshecho, comentarios originales restaurados, contratocoincidenciasintacto,src/App.jsx(resaltado?local=ID+ bloque de estadísticas) restaurado víagit checkout,vite.config.jslimpio (solo proxy + prefijo de dev),package-lock.jsonrevertido - 8.6 README actualizado (4.2) y
DELETE /api/locales/:iddecidido (4.3)