atiVoto: Sistema de Votación Electrónica para el Consejo Estudiantil

Uno de los procesos más repetitivos —y a la vez más importantes— del año escolar es la elección del Consejo Estudiantil. Conteo manual de papeletas, actas escritas a mano, horas de trabajo del tribunal electoral… Por eso desarrollé atiVoto, un sistema de votación electrónica pensado específicamente para el laboratorio de cómputo de un colegio, y hoy lo comparto gratis para que cualquier institución pueda usarlo.

[update title="Información importante" icon="info-circle"]

Aunque nació pensando en la elección del Consejo Estudiantil, atiVoto no está limitado a ese proceso: sirve para cualquier votación por listas o candidatos que tu institución necesite organizar —Reina de Deportes, representantes de curso, comité de padres de familia, y más. Basta con cambiar el nombre de la elección en la configuración; todo lo demás (papeleta, control de votación, actas y resultados) funciona exactamente igual.

[/update]

¿Qué es atiVoto?

atiVoto es una aplicación web que corre en la red local de tu colegio (no necesita internet) y permite que los estudiantes voten desde las computadoras del laboratorio, mientras el sistema lleva el control de quién ya votó, guarda los votos de forma anónima y genera resultados y actas de escrutinio automáticamente.

¿Por qué lo desarrollé?

En muchos colegios del Ecuador, la elección del Consejo Estudiantil todavía se hace con papeletas de papel: imprimir, cortar, contar a mano, redactar las actas y transcribir los resultados. Es un proceso lento y propenso a errores, sobre todo cuando participan varios cursos y jornadas el mismo día. atiVoto nació para resolver ese problema usando el mismo laboratorio de computación que ya tiene el colegio, sin necesitar servidores externos ni conexión a internet.

Características principales

• Funciona 100% en red local (LAN) — no requiere internet en ningún momento
• Registro de estudiantes por curso y jornada, pegando el listado directo desde Excel
• Registro de listas y candidatos: foto y nombre del candidato a presidente, y el resto de la directiva con su cargo
• Control de votación por curso — el administrador habilita un curso y jornada a la vez, y solo esos estudiantes aparecen disponibles en las PC del laboratorio
• Voto 100% anónimo — el sistema jamás guarda qué estudiante votó por cuál lista, solo que ya votó
• Papeleta electrónica con foto y nombre del candidato a presidente destacado, y toda su directiva visible
• Pantalla de confirmación antes de registrar el voto, y opción de voto en blanco
• Dashboard de resultados en vivo, filtrable por jornada, por curso o vista general — ideal para proyectar
• Actas de escrutinio generadas automáticamente en Word — por curso, por jornada y general — con vista previa de impresión desde el navegador
• Configuración reutilizable año a año: nombre de la elección, año lectivo, rector/a, docentes delegados y secretario/a
• Resultados guardados automáticamente en CSV, listos para abrir en Excel
• Sin base de datos — todo en archivos CSV y JSON

Requisitos técnicos

Componente	Requisito
Servidor (1 PC)	Windows 10 - 11 x64
Software	Node.js (versión 18 o superior) software gratuito, sin licencias ni registro
RAM servidor	4 GB recomendado
Clientes	Cualquier PC con navegador web (Chrome, Firefox, Edge)
Red	Red local LAN (cable o WiFi)
Internet	No requerido
Base de datos	No requerida (usa archivos CSV)

[update title="Información importante" icon="info-circle"]

💡  atiVoto está disponible de forma gratuita para instituciones educativas.
        Incluye todos los archivos necesarios listos para instalar.
        No requiere licencias ni registro.

[/update]

Manual de Uso — atiVoto 

Instalación

1. Instalar Node.js

Node.js es el motor que hace funcionar a atiVoto. Descárgalo gratis desde: 

🌐  https://nodejs.org

• Elige la versión "LTS" (recomendada para la mayoría de usuarios)
• Instala con las opciones predeterminadas — no requiere configuración adicional

2. Instalar atiVoto

Descargar atiVoto v1.0

• Descarga el archivo atiVoto.zip
• Descomprime la carpeta en la PC que hará de servidor (puede ser cualquier ubicación, por ejemplo el Escritorio)
• Haz doble clic en iniciar.bat
• Se abrirá una ventana de cmd (ventana negra) que debe permanecer abierta durante toda la votación

3. Conocer la dirección del servidor

Las demás computadoras del laboratorio necesitan la dirección del servidor para acceder. 

En la ventana de cmd la muestra automáticamente al iniciar, con un texto similar a:

http://192.168.1.25:3000

• Los estudiantes ingresan a esa dirección + /votar/ 
• El administrador ingresa a esa dirección + /admin/login.html
• El dashboard de resultados está en esa dirección + /dashboard/

Ejemplo: 

http://192.168.1.25:3000/votar

http://192.168.1.25:3000/admin/login.html

http://192.168.1.25:3000/dashboard/

[error title="Alerta" icon="exclamation-circle"]

⚠️  Si las demás PC no pueden acceder, puede ser el Firewall de Windows. 

        En Panel de control → Firewall de Windows → Reglas de entrada → Nueva regla → Puerto TCP 3000 → Permitir.

[/error]

Módulo del Administrador

Accede al panel desde cualquier navegador de la red: http://[IP_SERVIDOR]:3000/admin/login.html

Clave inicial	Dónde cambiarla
colegio2026	Panel → Configuración → Clave del administrador

Configuración de la elección

Antes de cada proceso electoral, registra en "Configuración":

• Nombre de la elección (Consejo Estudiantil, Reina de Deportes, etc.)
• Año lectivo
• Nombre del rector/a
• Los dos docentes delegados
• Nombre del secretario/a

[update title="Información importante" icon="info-circle"]

💡  Estos datos quedan guardados y se pueden reutilizar en años siguientes, cambiando solo lo necesario.

[/update]

Módulo Estudiantes

Registra cada curso por separado: elige la jornada, escribe el nombre del curso y pega el listado de estudiantes copiado directo de Excel (un nombre por línea).

• Si te equivocas en el nombre de un curso, usa el botón "Renombrar" — no hace falta borrar y volver a pegar el listado
• También puedes quitar un estudiante individual o eliminar un curso completo

Módulo Listas y candidatos

Registra cada lista (Lista A, Lista B, etc.) con el nombre del candidato a presidente y, si quieres, su foto. Agrega también al resto de la directiva (vicepresidente, secretario, tesorero, vocales) — solo el presidente lleva foto.

Control de votación

Los cursos pasan al laboratorio uno por uno. Desde esta pantalla, el administrador elige el curso y jornada que está en el laboratorio en ese momento:

Botón	Función
▶ Habilitar	Habilita el curso y jornada elegidos para recibir votos en las PC del laboratorio
⏸ Detener	Detiene la votación del curso actual, antes de habilitar el siguiente
👁 Avance	Muestra cuántos estudiantes ya votaron y cuántos faltan en el curso habilitado

Resultados y actas de escrutinio

Botón	Función
📊 Dashboard	Resultados en vivo con gráficos, filtrables por jornada, por curso o vista general
📄 Vista previa	Abre el acta en el navegador, lista para imprimir o guardar como PDF
⬇ Descargar Word	Descarga el acta en formato .docx, editable
📥 Exportar CSV	Descarga estudiantes, listas o votos para abrir directamente en Excel

atiVoto genera tres tipos de actas, todas con el día y mes tomados automáticamente de la fecha en que se registraron los votos:

🧾 Acta por curso

Una por cada junta receptora del voto, con el detalle de votos por lista, blancos y total, y los espacios de firma del presidente y secretario de la junta (docente tutor/a y presidente(a) de curso).

🏫 Acta por jornada

Resume todos los cursos de una misma jornada (matutina, vespertina o nocturna), con firmas del rector/a, docentes delegados, delegados de cada lista y secretario/a.

🗳️ Acta general

Resume las tres jornadas en una sola acta, con la misma estructura de firmas que el acta por jornada.

💡  Las tres actas quedan en hoja vertical, listas para imprimir en una sola página, con los espacios de firma en blanco para completarse a mano el día del escrutinio.

Estación de Votación (módulo del estudiante)

Las PC del laboratorio acceden a: http://[IP_SERVIDOR]:3000/votar/

El docente de apoyo elige al estudiante

Mientras un curso está habilitado, la pantalla muestra la lista de sus estudiantes que aún no han votado. El docente de apoyo hace clic en el nombre del estudiante que va a votar — una vez que un estudiante vota, su nombre desaparece de la lista en todas las PC del laboratorio, así que no puede volver a ser elegido.

La papeleta electrónica

El estudiante ve una casilla por cada lista, con la foto y el nombre del candidato a presidente destacado, y debajo el resto de la directiva con su cargo. También puede elegir "Voto en blanco".

Confirmar el voto

Antes de registrar el voto, aparece una pantalla "Usted eligió:" con el nombre de la lista y el candidato a presidente, para confirmar o volver a elegir. Al confirmar, aparece un sello de "Voto registrado" y la pantalla vuelve automáticamente a la selección del siguiente estudiante.

🔒  El voto es secreto: el sistema jamás guarda qué estudiante eligió qué lista. Solo se registra que ese estudiante ya votó, y por separado, el conteo total de cada lista.

Dashboard de resultados (para proyectar)

Disponible en: http://[IP_SERVIDOR]:3000/dashboard/

Muestra el total de estudiantes registrados, cuántos ya votaron, el porcentaje de participación y una barra de votos por lista, con la lista en primer lugar destacada. Un filtro permite ver el resultado general, de una jornada específica, o de un curso puntual — ideal para seguir el avance en tiempo real mientras se proyecta en una pantalla grande.

Preguntas frecuentes

¿El voto es realmente secreto?

Sí. El sistema registra los votos sin ninguna referencia al estudiante que los emitió — solo guarda que ese estudiante ya votó. El conteo por lista es completamente independiente de la identidad del votante.

¿Qué pasa si se va la luz o se reinicia el servidor?

Los datos no se pierden: cada cambio se guarda de inmediato en los archivos CSV de la carpeta data/. Solo hay que volver a abrir iniciar.bat y, si el corte ocurrió a mitad de una votación, volver a habilitar ese curso desde Control de votación.

¿Puedo reutilizar el sistema el próximo año?

Sí. En "Configuración" solo hay que actualizar el año lectivo, el nombre de la elección y las autoridades — el resto del sistema funciona igual.

¿Puedo usar atiVoto para otro tipo de elecciones, además del Consejo Estudiantil?

Sí. El campo "Nombre de la elección" en Configuración es completamente libre, así que atiVoto sirve para cualquier votación por listas o candidatos: Reina de Deportes, representantes de curso, comité de padres de familia, o cualquier otro proceso electoral del colegio. Solo hay que cambiar ese nombre, registrar las listas o candidatas correspondientes, y el resto del sistema (papeleta, control de votación, actas y resultados) funciona exactamente igual.

¿Funciona sin internet?

Sí, completamente. atiVoto corre en la red local del colegio y no depende de ningún servicio externo en ningún momento.

¿Puedo poner el escudo real de mi colegio?

Sí — basta con colocar un archivo llamado escudo.png en la carpeta public/img/ y aparecerá automáticamente en las pantallas del sistema.

¿Cómo cambio la clave del administrador?

Desde el panel → Configuración → "Cambiar clave", sin necesidad de editar ningún archivo.

atiVoto
Desarrollado por José Cruz Abril
Unidad Educativa Ati II Pillahuaso
Guayaquil - Ecuador
2026

Distribución gratuita para uso educativo