Plataforma de Gestión Borde Costero · AAPP Norte

Plataforma web para revisar el desembarque artesanal y la recolección de orilla de pescadores:

• Asuntos Públicos Norte: Antofagasta y Mejillones.
• Asuntos Públicos Los Pelambres: Los Vilos y Canela.

Funciones principales:

• Inicio de sesión con usuario y contraseña, y creación de cuentas que un administrador aprueba.
• Dos niveles de usuario: Administrador y Visualizador.
• Dashboard con filtros y con un selector para ver toneladas totales o promedios.
• Calculadora de negociación.
• Mapa de poder e interés (5×5) por zona, por pescador u organización, con ranking y bitácora de relacionamiento.
• Alertas automáticas, comparación de zonas, proyección de 3 meses y reporte ejecutivo imprimible.
• Valor económico con precios de playa, calendario de vedas, escenarios de compensación, vistas guardadas y registro de actividad.
• Carga de Excel para actualizar los datos.

Qué hay en esta carpeta

Archivo	Para qué sirve
index.html	La plataforma completa (pantallas, gráficos, filtros, lectura del Excel).
api/	Funciones del servidor: inicio de sesión, usuarios, datos e historial de cargas.
lib/core.js	Código compartido por las funciones: contraseñas, sesión y acceso a la base.
supabase/schema.sql	Crea las tablas de la base de datos.
vercel.json	Configuración y cabeceras de seguridad para Vercel.
server.js	Servidor para hostings con Node distintos de Vercel (Render, Railway, VPS).
tools/hash.js	Genera el hash de una contraseña para restablecerla a mano.
.env.example	Lista de variables de configuración.

La seguridad se aplica en el servidor:

• Las contraseñas se guardan cifradas con scrypt, nunca en texto.
• La sesión vive en una cookie firmada a la que el navegador no tiene acceso.
• Un Visualizador no puede modificar datos ni administrar usuarios, aunque intente llamar directamente a la API.
• Las restricciones por comuna y la opción de ocultar nombres se aplican antes de enviar los datos al navegador.

Publicar en Vercel (unos 15 minutos)

1. Crear la base de datos en Supabase (gratis)

1. Entra a https://supabase.com y crea un proyecto. Elige la región São Paulo, que es la más cercana a Chile.
2. Abre SQL Editor > New query, pega todo el contenido de supabase/schema.sql y presiona Run.
3. Ve a Project Settings > API y copia:
   • Project URL, que irá en SUPABASE_URL.
   • La clave service_role, que irá en SUPABASE_SERVICE_ROLE_KEY. Es secreta: nunca la pongas en index.html ni la compartas.

2. Subir el código a GitHub

Crea un repositorio privado y sube esta carpeta completa. No subas archivos .env ni el Excel; el .gitignore ya los excluye.

3. Crear el proyecto en Vercel

1. En https://vercel.com elige Add New > Project e importa el repositorio.
2. En Framework Preset elige Other. No hace falta comando de compilación.
3. En Environment Variables agrega:

Variable	Valor
SUPABASE_URL	La Project URL de Supabase
SUPABASE_SERVICE_ROLE_KEY	La clave service_role
SESSION_SECRET	Un texto largo y aleatorio (ver abajo)
ADMIN_USER	ivillalobos
ADMIN_PASSWORD	La contraseña del administrador

Para generar SESSION_SECRET, en una terminal con Node escribe: node -e "console.log(require('crypto').randomBytes(48).toString('base64url'))"

4. Presiona Deploy.

4. Primer ingreso

1. Abre la dirección que te da Vercel e inicia sesión con ADMIN_USER y ADMIN_PASSWORD. El administrador se crea solo en ese momento.
2. Como aún no hay datos, la plataforma te pedirá subir el Excel. Usa el archivo con la hoja DatosPesca.
3. Listo. Desde ahí:
   • Los demás crean su cuenta con Crear cuenta.
   • Tú las apruebas en la pestaña Administración.

Después del primer ingreso puedes borrar ADMIN_PASSWORD de Vercel: el administrador ya quedó guardado. Si la dejas y alguien elimina la cuenta ADMIN_USER, se volverá a crear con esa contraseña en el siguiente inicio de sesión.

Indicadores económicos y actividad por caleta

• Indicadores del día: dólar observado, euro, UF, UTM, cobre, IPC y tasa de política monetaria. Se obtienen automáticamente desde mindicador.cl, que publica los valores del Banco Central de Chile, y se actualizan cada 30 minutos.
• Actividad por caleta y mes: un mapa de calor con las caletas agrupadas por zona (Asuntos Públicos Norte y Asuntos Públicos Los Pelambres) y los 12 meses. Responde a los filtros y al selector de medida (toneladas totales, promedio mensual o promedio por pescador).

Mapa de poder e interés

• Hay un mapa de 5×5 y un ranking por toneladas para cada zona: Asuntos Públicos Norte y Asuntos Públicos Los Pelambres.
• Poder de influencia (1 a 5): se calcula por volumen. Los pescadores se ordenan por toneladas dentro de su zona y se dividen en quintiles; el 20 % con más toneladas queda en 5.
• Interés (1 a 5): se calcula por regularidad, es decir, por los meses con desembarque en el período. También se divide en quintiles.
• Estrategia sugerida:
  • Gestionar de cerca: poder 3 o más e interés 3 o más.
  • Mantener satisfecho: poder 3 o más, interés bajo 3.
  • Mantener informado: poder bajo 3, interés 3 o más.
  • Monitorear: el resto.
• Un administrador puede ajustar el poder y el interés de cada pescador con Evaluar y dejar una nota. La nota solo la ven los administradores. También puede volver al cálculo automático.
• Los ajustes se guardan en la tabla evaluaciones.
• Si ya tenías la plataforma publicada: vuelve a ejecutar supabase/schema.sql en Supabase. Es seguro repetirlo: solo crea la tabla nueva. Mientras no lo hagas, el mapa funciona igual, pero solo con el cálculo automático.

Funciones de gestión

• Reporte ejecutivo (botón en el encabezado): resumen de una página con indicadores, comparación de zonas, alertas, claves, proyección y actores clave. Se puede imprimir o guardar como PDF, o descargar como HTML.
• Alertas (Resumen): caídas de una caleta, especie o zona frente al mismo mes del año anterior, y pescadores de "Gestionar de cerca" sin desembarques en los últimos 3 meses. Si la especie estaba en veda, la alerta lo indica. El umbral se ajusta en Administración.
• Comparación de zonas y Proyección de los próximos 3 meses (Resumen). La proyección es el promedio del mismo mes en los últimos 3 años, ajustado por la tendencia de 12 meses.
• Valor económico: un administrador ingresa precios de playa ($ por kg) en Administración. Con eso aparecen el valor estimado, el poder según valor y los montos en la negociación.
• Organizaciones: el mapa de poder e interés puede agrupar por organización. Se usa la columna Organización del Excel, o la que asigne un administrador con Evaluar.
• Bitácora: reuniones, compromisos, acuerdos y conflictos por pescador u organización, con estado y responsable. Solo la ven los administradores. Los pendientes aparecen en "Compromisos y seguimiento".
• Escenarios de compensación (Negociación): compara costo total y reparto de A (por kilo histórico), B (monto fijo) y C (mixto).
• Revisión de calidad al cargar el Excel: avisa RPA sin nombre, fechas futuras, filas repetidas, nombres distintos para un mismo RPA, especies y caletas nuevas (y las parecidas a una existente) y volúmenes inusuales. No impide la carga.
• Vedas: se registran en Administración. Se ven en el calendario de vedas (Especies y caletas) y sombreadas en la evolución mensual cuando filtras esa especie.
• Vistas guardadas: cada usuario guarda combinaciones de filtros y las abre con un clic.
• Registro de actividad (Administración): inicios de sesión, cargas, cambios de usuarios, evaluaciones, bitácora, ajustes, reportes y exportaciones.

Si actualizas una plataforma ya publicada: vuelve a ejecutar supabase/schema.sql en Supabase. Crea las tablas nuevas (ajustes, bitacora, vistas, actividad) y agrega la columna organizacion a evaluaciones, sin tocar los datos existentes.

Interfaz

• Encabezado compacto: título, datos de la base, lugar y hora en una franja. Reporte ejecutivo, Actualizar datos, Administración y Cerrar sesión están en el menú de usuario (arriba a la derecha).
• Filtros en un panel lateral: período, medida, vistas guardadas y segmentadores se abren con el botón Filtros, que muestra cuántos filtros hay activos. Sobre el contenido queda una línea con el período y la medida.
• Resumen ejecutivo por niveles: indicadores arriba, una alerta visible (las demás con "Ver las N alertas"), claves del período en pestañas por zona y gráficos agrupados en secciones desplegables que recuerdan si las dejaste abiertas.
• Tarjetas de gráficos: menú ⋯ para ampliar a pantalla completa o descargar la imagen; los textos de ayuda están en el ícono ⓘ.
• Exigencias ambientales: fichas plegadas (se abren con la flecha o al hacer clic en el texto), "Más filtros" y "Más temas" desplegables, una barra de vistas con contadores y lista de RCA con buscador que se puede ocultar.
• Negociación: pestañas Calculadora / Escenarios de compensación y tabla de pescadores plegable. Poder e interés: ranking de 10 por zona con "Ver más" y acciones en un menú ⋯.
• Búsqueda para usuarios: los usuarios que no son administradores buscan palabras clave en el texto completo de todas las RCA visibles (al escribir o elegir un tema la búsqueda cambia sola a "Todas las RCA"; pueden volver a "Solo compromisos habilitados"). Nunca ven categorías de fichas no habilitadas.
• Pantallas angostas: las pestañas se eligen en un selector.

Gráficos

• Calculadora para negociación: además de especie, lugar, años y meses, permite acotar por fechas (desde/hasta o un día) y muestra la tabla «Extracción promedio por mes y por año» con totales, promedio anual y promedio mensual.
• Filtros de período: años, meses (un mes solo compara ese mes en todos los años), desde/hasta mes y Fechas: desde una fecha hasta otra, o un día puntual. Se guardan en las vistas.
• Cruces AMERB, planes de manejo y desembarque: desembarque en meses de veda según su explicación (alga varada, AMERB o plan aprobado, sin explicación), dependencia de recursos bajo manejo por caleta y superficie de AMERB decretadas frente a pescadores activos.
• Planes de manejo de recursos bentónicos (Geoportal Subpesca, actualización diaria): cada plan de las zonas del dashboard con su estado (aprobado, establecido en elaboración, sin resolución), especies, superficie, resoluciones y caletas que cubre.
• Actualización de datos externos: AMERB, caletas oficiales y ECMPO se vuelven a consultar cada día (hora de Chile); los indicadores económicos del Banco Central una vez al día. Las vedas oficiales se revisan a diario con una tarea programada que avisa si Subpesca publica cambios.
• ECMPO (espacios costeros marinos de pueblos originarios): el sitio consulta la capa pública de Subpesca publicada en la IDE de la SMA y muestra, para las zonas del dashboard, cada ECMPO con su comunidad solicitante, estado, superficie, decreto y caleta más cercana.
• Áreas de manejo (AMERB) y caletas oficiales: el sitio consulta las capas públicas del Geoportal de Subpesca (/api/geo, se actualizan todos los días). Muestra cada AMERB cercana a las caletas (nombre, organización destinataria o solicitante, estado con colores: verde decretada, amarillo en trámite, rojo rechazada, gris caducada u otro; agrupadas por caleta en secciones desplegables, especies, superficie y decreto), un resumen por organización y el registro oficial de pescadores, embarcaciones y organizaciones por caleta.
• Vedas oficiales precargadas (pulpo del norte, huiros de Coquimbo y Antofagasta, loco), con su decreto. Aviso emergente una vez al día y franja con las especies en veda vigente (rojo) y las que entran en veda en los próximos 30 días (amarillo); se marcan con esos colores en gráficos, tablas, filtros y calculadora. En Administración › Vedas se pueden desactivar las oficiales o agregar otras.
• Caletas y áreas de manejo (Resumen): ranking de caletas por actividad con el registro oficial de pescadores, y tabla de AMERB cercanas a cada caleta por estado del trámite.
• Todos los gráficos muestran un recuadro «Interpretación» que se recalcula con los filtros: qué muestran los datos y qué implica para la gestión o la negociación.
• Cada gráfico tiene una línea de lectura con la conclusión principal y variaciones respecto del año anterior.
• Resumen: evolución mensual por zona con el mismo mes del año anterior (o vista total), proyección con banda de rango probable, control de anomalías por caleta (± 2 desviaciones estándar), captura por caleta en barras con variación, años en toneladas o en % con el año en curso marcado, ranking de caletas entre los dos últimos años completos, dependencia de una especie, compañías en barras, pescadores por sexo con participación de mujeres por año y brecha de género por caleta o grupo.

Exigencias ambientales (RCA)

• PDF de las RCA: los PDF están en Supabase Storage, bucket público RCA: https://oxrxklpjqyvtphfizuld.supabase.co/storage/v1/object/public/RCA/ + el nombre de archivo de la columna RCA del Consolidado (por ejemplo RCA%2020260200168.pdf). Para agregar una RCA, súbela a ese bucket con el mismo nombre que figura en la columna RCA.

• Los usuarios buscan con sus propias palabras clave en el texto completo de todas las RCA visibles, sin filtros predefinidos. Pueden acotar por su cuenta en «Más filtros» (por ejemplo, solo compromisos habilitados). Pestaña para revisar las resoluciones de calificación ambiental (RCA) de las operaciones y ordenar sus obligaciones.

• Carga inicial (una vez, solo administradores): en la pestaña Exigencias ambientales, presiona Cargar base de RCA y elige RCA_Operaciones_Norte_base.json.gz. Ese archivo trae las RCA divididas en fichas por numeral o considerando. Si más adelante cargas una base nueva, las categorizaciones se conservan.

• Medio humano y comunidades: la base trae el tema «Medio humano, comunidades y pescadores» con seis subtemas (pescadores y caletas, pueblos indígenas, organizaciones sociales y vecinos, participación ciudadana, grupos humanos y calidad de vida, proveedores y empleo local) y el filtro Tipo de texto (obligación, observación ciudadana, evaluación de impactos, descripción, vistos). El botón Compromisos con comunidades combina ambos. Para activarlo, vuelve a cargar RCA_Operaciones_Norte_base.json.gz; las categorizaciones existentes se conservan.

• Seguimiento de cumplimiento: cada ficha categorizada muestra sus verificadores o indicadores de cumplimiento (extraídos del texto de la RCA; el administrador puede editarlos, quitarlos o agregar otros). El administrador asigna un porcentaje de avance y una observación a cada verificador y presiona Guardar avance; cada cambio queda en el historial con fecha y usuario. La vista Seguimiento lista todos los compromisos con su avance promedio y se exporta a CSV. Los usuarios ven el avance de los compromisos habilitados, sin las observaciones. Requiere las tablas rca_seguimiento y rca_seguimiento_hist (vuelve a ejecutar supabase/schema.sql).

• Un registro por considerando: cada considerando numerado (o subnumeral del considerando, como 12.1.26) es un solo registro con todo su texto, aunque ocupe varias páginas; se indica la página de inicio y término. Los números de página, fechas, cantidades y listas internas no abren registros. Los saltos o repeticiones de numeración quedan marcados como (vista "Con dudas de numeración"). Al cargar la base nueva, las categorías y el avance registrados en bases anteriores pasan al considerando correspondiente.

Uso diario

• Actualizar datos (solo administradores): sube un Excel nuevo y elige Agregar solo filas nuevas o Reemplazar todos los datos. Todos los usuarios ven los datos nuevos al volver a entrar.
• Administración (solo administradores; el servidor rechaza estas acciones si las intenta otro nivel):
  • Agregar usuario: crea la cuenta directamente con usuario, nombre, cargo, área, contraseña inicial, nivel y permisos. Queda activa de inmediato.
  • Editar: cambia nombre, cargo, área, nivel (Administrador o Visualizador), comunas visibles, ver nombres y exportar a CSV.
  • Contraseña: asigna una contraseña nueva a cualquier usuario. Las sesiones abiertas de ese usuario se cierran.
  • Suspender o Reactivar el acceso sin borrar la cuenta.
  • Eliminar la cuenta (pide confirmación y no se puede deshacer).
  • Aprobar o rechazar las solicitudes creadas desde Crear cuenta.
  • Revisar el historial de cargas.
  • Para no quedar sin acceso: no puedes suspender, eliminar ni bajar de nivel tu propia cuenta, y siempre debe quedar al menos un administrador activo.
• Cierre de sesión: con el botón Cerrar sesión, tras 30 minutos sin uso, o a las 8 horas.

Restablecer una contraseña olvidada

Lo normal es que un administrador use el botón Contraseña en la pestaña Administración. Si el único administrador olvidó la suya:

1. En tu computador, dentro de esta carpeta, ejecuta: npm run hash -- "NuevaContraseña".
2. En Supabase, abre Table editor > usuarios, busca al usuario y pega el resultado en la columna hash.

Otros hostings

• Render, Railway, Fly.io o un servidor propio con Node 18 o superior:
  • Comando de inicio: npm start (usa server.js).
  • Carga las mismas variables de entorno.
  • Usa HTTPS en producción.
• Netlify: las funciones de api/ están escritas para Vercel. En Netlify es más simple usar Render.

Probar en tu computador

1. Copia .env.example como .env y completa los valores.
2. Agrega COOKIE_INSECURE=1 para poder usar http://localhost sin HTTPS.
3. Ejecuta npm start y abre http://localhost:3000.

Calculadora para negociación: línea base y beneficiarios

• Consulta rápida: toneladas por año de la especie, meses y lugar elegidos (p. ej., pulpo en agosto 2021–2025), con total y promedio.
• Línea base para negociar: promedio, mediana, promedio sin el año más alto y más bajo, piso (mínimo) y techo (máximo), calculados con años completos.
• Excluir meses de veda: los meses en veda no se cuentan como extracción perdida.
• Criterios de beneficiarios: meses, años y toneladas mínimas, y opción de pescadores históricos (al menos 3 de los últimos 5 años completos).
• Beneficiarios por organización: pescadores, toneladas y montos por escenario.

SQL de exigencias ambientales: componentes y pesca

Para guardar los componentes ambientales y la relación con pesca, ejecuta una vez en Supabase (SQL Editor › New query › Run). Incluye la columna aplica por si aún no la agregaste:

alter table public.rca_estado add column if not exists aplica boolean;
alter table public.rca_estado add column if not exists componentes jsonb not null default '[]'::jsonb;
alter table public.rca_estado add column if not exists pesca boolean not null default false;

Si faltan estas columnas, la plataforma lo avisa en la pestaña Exigencias ambientales.

Identificación de exigencias por número de considerando (reinicio 17-10-2026)

• La base RCA_Operaciones_Norte_base.json.gz (versión 3) identifica cada ficha por su número de considerando (por ejemplo, «Considerando 12.1.23», «Resuelvo 1°»), sin importar cuántas páginas abarque. Las páginas se muestran solo como referencia.
• Mejoras en los escaneos: corrige números mal leídos y, cuando el número es ilegible, lo asigna por orden y lo marca como duda. Las observaciones ciudadanas quedan como fichas propias dentro de su considerando.
• Al cargar esta base, la plataforma ofrece (con confirmación) borrar las clasificaciones anteriores y empezar desde cero. En Vercel esto borra las filas de rca_estado y rca_seguimiento.

Descarga de RCA y consolidado

• La carpeta rca/ contiene los PDF de las 58 RCA (comprimidos para la web, legibles) y Consolidado_RCA_Operaciones_Norte.xlsx, cuyos enlaces de la columna RCA apuntan a esos PDF.
• En Exigencias ambientales: botón Consolidado RCA (Excel), botón Descargar RCA (PDF) en el detalle de cada RCA y enlace PDF en cada ficha (abre en la página de referencia).
• Son documentos públicos del SEIA; se sirven como archivos estáticos (sin inicio de sesión).

Registro Pesquero Artesanal (Sernapesca)

• api/rpa.js consulta el registro público de Sernapesca por número RPA: estado del pescador (activo/inactivo), caleta base, oficina, categorías y embarcaciones (código, nombre, estado y, para las activas, matrícula, capitanía, caleta base, vencimiento, tipo y eslora). RUT, dirección y fecha de nacimiento son confidenciales en la fuente y no se usan.
• Caché diaria en la tabla rpa_cache: cada RPA se consulta como máximo una vez al día; si cambia de activo a inactivo (o al revés) queda una alerta.
• Dónde se ve: Detalle (columnas Estado RPA y Embarcaciones activas, y el desplegable de cada pescador), la ficha del pescador y, en Negociación › Criterios de beneficiarios, «Excluir pescadores con RPA inactivo».
• Solo funciona en la versión de Vercel (el artefacto y la versión independiente no pueden consultar a Sernapesca).
• SQL (ejecutar una vez en Supabase):

create table if not exists public.rpa_cache (
  rpa text primary key,
  datos jsonb not null default '{}'::jsonb,
  dia text,
  actualizado timestamptz not null default now()
);
alter table public.rpa_cache enable row level security;

Búsqueda en exigencias para usuarios

• Los usuarios ven los apartados validados y, con el buscador, encuentran palabras exactas en el texto de todas las RCA (salvo descartadas y RCA ocultas). Las coincidencias se resaltan y las fichas sin validar se marcan como «sin validar».

Negociación: cálculo por pescador y especie

• Se agregan uno o más pescadores (nombre o RPA) y, a cada uno, las especies que se le reconocen (por defecto, las que desembarcó en el período).
• El cuadro tiene sus propios filtros: años, meses a comparar, fechas desde/hasta o un día, y excluir los períodos de veda.
• Monto por especie = kilos (promedio por año o total del período, con esos filtros) × precio por kilo (precio base de Administración, editable solo para este cálculo).
• Cada pescador tiene un % reconocido en el sector (0–100) que multiplica su monto.
• Un % sobre el total (0–100) se aplica al subtotal de todos los pescadores: «Pagar este % del total» o «Sumar este % al total». Exportable a CSV.

Aplicación instalable (Android, iPhone/iPad y computador)

La plataforma es una aplicación web instalable (PWA), gratuita y sin tiendas de aplicaciones:

• Android (Chrome): abrir https://ivillalobosgaete.vercel.app, tocar «Instalar app» o el menú ⋮ › «Instalar aplicación».
• iPhone/iPad (Safari): abrir el sitio, tocar Compartir › «Agregar a pantalla de inicio».
• Computador (Chrome o Edge): botón «Instalar app» o el ícono de instalar en la barra de direcciones.

Archivos: manifest.webmanifest (nombre, colores e íconos), sw.js (service worker) e icons/. El service worker solo guarda la estructura de la página e íconos; nunca guarda datos: /api/*, Supabase y los PDF de RCA van siempre a la red. Para forzar a todos los equipos a renovar la caché, cambiar VERSION en sw.js.