为什么值得关注

它为灾难响应提供了透明、社区驱动的工具，内置审核机制、手写名单OCR集成以及供第三方集成的公开API。

适合谁使用

构建类似灾难响应系统的开发者
协调地震救援的人道主义组织
管理已定位人员的委内瑞拉当局和医院
寻找已定位亲属信息的市民

典型使用场景

按姓名、身份证或备注搜索已定位人员
通过审核表单提交新的已定位人员记录
通过带OCR支持的审核面板批准或拒绝提交的数据
集成公开API以驱动外部应用或数据面板

项目优势

完全开源（MIT许可）且贡献流程清晰
包含使用OpenAI Vision进行手写名单OCR的审核面板
提供公开的只读API，GET路由启用CORS
附带示例数据和Docker配置，便于本地开发

使用前须知

仅适用于已定位人员，不用于报告失踪人员
需要MongoDB和Node.js (22+)，对非技术用户可能较复杂
OCR功能依赖OpenAI API密钥，可能产生费用

README 快速开始

Localizados Venezuela

Registro open source y colaborativo de personas ya localizadas tras el sismo en Venezuela — en hospitales, recintos, direcciones y otros sitios.

Sitio: localizadosvenezuela.com

Este proyecto es solo para localizados. No sirve para reportar desaparecidos.
Para desaparecidos: desaparecidosterremotovenezuela.com

Qué hace

Búsqueda de personas localizadas por nombre, cédula u observación
Una página por persona (/localizados/{slug}) y por lugar (/lugares/{slug})
API pública de lectura para integraciones
Formulario para contribuir localizados o fotos de listados (quedan en cola pending hasta moderación)
Panel de moderación (/admin) para aprobar contribuciones, OCR de imágenes, CRUD de personas y acciones masivas
Botones para compartir en WhatsApp, Telegram, X, etc.

Requisitos

Node.js 22+
MongoDB 6+ (local o remoto)
npm

Empezar en 5 minutos

git clone https://github.com/ggangix/localizados-venezuela.git
cd localizados-venezuela
npm install
cp .env.example .env.local

Usa .env.local. Tanto Next.js (npm run dev) como los scripts de seed (vía tsx --env-file=.env.local) lo leen. Está en .gitignore, así que tus credenciales no se suben.

Levanta MongoDB. Dos opciones comunes:

# A) Instalado localmente, sin autenticación
mongod

# B) En Docker con usuario/clave (lo más habitual)
docker run -d --name mongo -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=root \
  -e MONGO_INITDB_ROOT_PASSWORD=123456 \
  mongo:7

Si usas la opción B (Docker con autenticación), tu MONGODB_URI en .env.local debe llevar las credenciales y ?authSource=admin (el usuario root vive en la base admin):

MONGODB_URI=mongodb://root:123456@localhost:27017/localizados_venezuela?authSource=admin

Carga datos de prueba e inicia el servidor:

npm run seed:sample
npm run dev

Abre http://localhost:3000.

Desarrollo con Docker

Si prefieres no instalar Node.js ni MongoDB localmente, puedes levantar todo el entorno con Docker.

Requisitos: Docker Desktop (o Docker Engine + Compose).

cp .env.example .env.local   # si aún no lo has hecho
docker co

项目描述

Registro

localizados-venezuela