Escrutinio y recuento
El resultado nunca es un bloque del registro: es un nuevo cálculo determinista, a partir de la configuración publicada y de las papeletas firmadas, que cualquiera puede reproducir.
La referencia es la lista bloqueada de papeletas firmadas; el nuevo cálculo sirve para contrastarla. Una divergencia entre dos implementaciones o entre dos versiones de la biblioteca sería un defecto de un programa de cálculo, no un fallo de verificabilidad: las papeletas publicadas no cambian. Todos los métodos disponibles son deterministas, así que el resultado es estable para una lista de papeletas dada.
Protocolo v1
Lo que lee el recuento.
Solo datos públicos: la configuración bloqueada (bloque 0), las papeletas (bloques votes) y el registro de participación publicado al cierre, para los pesos. El método forma parte de la configuración. El documento CEF no es una entrada necesaria.
-
candidates[].labelcadenas · configuration - Los candidatos declarados, incluidos los que no figuran en ninguna clasificación. La etiqueta es el único identificador de un candidato.
-
election_typepreferential | fptp · configuration - Clasificación (métodos de Condorcet) u opción única (sistema mayoritario). También fija la regla de clasificación implícita.
-
ballot_rulesobjeto · configuration - Los cuatro parámetros de la papeleta, de los que se deducen las restricciones del escrutinio mediante una regla fija (véase más abajo).
-
seatsentero ≥ 1 · configuration - El número de elegidos: las primeras posiciones de la clasificación, tantas como escaños.
-
weighted_votingbooleano · configuration - Si es verdadero, cada papeleta pesa lo que indica el peso firmado en su payload; si no, cada papeleta pesa 1. El peso suele servir para reflejar las milésimas de una comunidad de propietarios o las participaciones de una sociedad.
-
ballots[].payloadcadena JSON · votes - El payload firmado: su campo ballot (clasificación CEF o /EMPTY_RANKING/) y su campo weight.
-
electoral_roll[].weightentero ≥ 1 · closure - El peso autorizado de cada votante, para comprobar los pesos firmados de una elección ponderada.
-
methodnombre canónico · configuration - Lo elige el organizador; se bloquea y se publica con la configuración en el lanzamiento, es decir, antes del primer voto. Se designa por su nombre exacto en la biblioteca, por ejemplo Schulze Winning, dentro de una lista cerrada.
Para cada papeleta publicada, una regla mecánica.
El contenido de una papeleta no se valida al emitirla: decide el escrutinio, según una regla pública y determinista. Una papeleta descartada sigue publicada y verificable; solo queda excluida de la clasificación.
- 1 Verificar. Cada papeleta publicada lleva una firma de anillo válida y una imagen de clave (key image) única en la elección: la plataforma lo comprueba al recibirla y el verificador vuelve a comprobarlo. Un fallo sería un defecto del registro, no una regla de escrutinio.
- 2 Filtrar el formato. El campo ballot pasa el control estricto de cef-writer, que lo rechaza si contiene una cadena vacía, el separador de etiqueta ||, una posición vacía (A>>B), UTF-8 no válido, un salto de línea, los caracteres reservados ; , # / * ^ o un candidato repetido. Después lo lee el analizador de la biblioteca, que a su vez puede rechazarlo. Una papeleta rechazada es nula por formato: nunca llega a ser un voto.
- 3 Reconocer el voto en blanco. El centinela /EMPTY_RANKING/ es una papeleta en blanco: una abstención que se contabiliza.
- 4 Aplicar las restricciones. Las restricciones deducidas de ballot_rules clasifican cada voto como válido o como nulo por restricción. Un voto cuya clasificación nombra a un candidato no declarado cuenta como expresado; el nombre desconocido se ignora en los duelos.
- 5 Ponderar. En una elección ponderada, el peso aplicado es el weight del payload firmado, nunca un multiplicador leído en la clasificación (el filtro de formato lo prohíbe). Los pesos firmados deben formar exactamente el multiconjunto de los pesos de los votantes marcados con has_voted, cuya suma es totals.voted_weight. Sin ponderación, cada voto pesa 1.
De los parámetros a las restricciones
-
NoTiesi ties_allowed = false - Rechaza un voto que contiene un empate, incluido el empate implícito de los candidatos sin ordenar en una clasificación parcial.
-
NoBlankVotesi blank_allowed = false - Rechaza la papeleta en blanco, que pasa entonces a ser nula por restricción en lugar de en blanco.
-
CompleteRankingsi partial_ranking_allowed = false - Rechaza una clasificación que no nombra explícitamente a todos los candidatos.
-
Implicit Rankingsegún election_type - Activado para preferential: un candidato sin ordenar queda empatado en la última posición. Desactivado para fptp: una opción única deja a los demás candidatos sin ordenar.
Las restricciones no se publican como tales: se deducen de los parámetros publicados mediante esta regla. Un voto en blanco es una abstención, no un empate ni una clasificación parcial: NoTie y CompleteRanking lo eximen, y solo NoBlankVote lo rechaza. La plataforma aplica esta exención con sus propias variantes de las restricciones nativas de CondorcetPHP; un recuento independiente debe reproducirla.
En una elección fptp, los parámetros publicados son fijos (empates prohibidos, clasificación parcial permitida, clasificación completa nunca exigida): NoTie se aplica siempre, y NoBlankVote si la abstención está prohibida. De una clasificación con varias preferencias solo se lee la primera.
Seis contadores, dos invariantes.
Se calculan una vez por escrutinio y son idénticos para todos los métodos. Un recuento con las mismas restricciones debe reproducirlos exactamente.
-
totalentero - Los votos que la biblioteca ha registrado.
-
validentero - Los votos que superan todas las restricciones.
-
expressedentero - Los votos válidos que no están en blanco: los que forman la clasificación.
-
blankentero - Los votos válidos con la clasificación vacía (/EMPTY_RANKING/).
-
invalidByConstraintentero - Los votos registrados pero rechazados por una restricción: los nulos por restricción.
-
invalidByFormatentero - Las papeletas que nunca llegaron a ser un voto: los nulos por formato, fuera de total.
total = valid + invalidByConstraint; valid = expressed + blank. El número de nulos publicado es invalidByFormat + invalidByConstraint. El mismo desglose, sumado por peso en lugar de por papeleta, da los votos de una elección ponderada (sin equivalente para invalidByFormat, porque esas papeletas no llevan peso); sin ponderación, coincide con las cifras.
Un método, fijado antes de la votación.
La plataforma no implementa ningún algoritmo de votación: cada método es el de la biblioteca julien-boudry/condorcet (CondorcetPHP), designado por su nombre exacto. El tipo de elección y el método, que elige el organizador, se bloquean en el lanzamiento y se publican juntos en el bloque 0.
-
FPTPfptp - Sistema mayoritario a una vuelta: gana el candidato que obtiene más votos (o más peso, en una elección ponderada). El resultado sigue siendo una clasificación completa.
-
Schulze Winningpreferential · por defecto - Schulze, variante de votos ganadores.
-
Schulze Marginpreferential - Schulze, variante de márgenes.
-
Ranked Pairs Winningpreferential - Ranked Pairs (Tideman), variante de votos ganadores.
-
Ranked Pairs Marginpreferential - Ranked Pairs (Tideman), variante de márgenes.
-
Copelandpreferential - El método de Copeland.
-
Dodgson Quickpreferential - La aproximación polinómica del método de Dodgson.
- Una variante, un nombre. Cada variante es una opción distinta, que corresponde uno a uno con el nombre canónico de la biblioteca: el método registrado se reproduce tal cual.
- Solo deterministas. No se ofrece ningún método no determinista: las mismas papeletas dan siempre el mismo resultado.
- La ponderación no es un método. Con weighted_voting se aplica el mismo método, y cada voto lleva su peso, que la biblioteca contabiliza de forma nativa.
- Los escaños son un corte. Los elegidos son las primeras posiciones de la clasificación obtenida, tantas como escaños; no se calcula nada más. Los métodos proporcionales de la biblioteca no se ofrecen.
- Métodos complementarios, a título indicativo. En una elección Condorcet, la página de resultados puede mostrar la clasificación que habrían dado los otros métodos de la lista con las mismas papeletas. Solo el método principal determina el resultado oficial.
Ningún desempate inventado.
La plataforma comunica lo que devuelve la biblioteca y nunca retoca al ganador.
- Posiciones compartidas. La clasificación se numera a partir de 1; los candidatos empatados comparten la misma posición.
- Ciclos. Si no hay ganador de Condorcet, el ciclo lo resuelve el método configurado, y solo él.
- Empate en el límite de escaños. Si un empate se extiende a ambos lados de la frontera entre la posición N y la N+1, nadie queda elegido más allá de esa frontera. El organizador lo resuelve fuera de la plataforma, normalmente con una segunda vuelta organizada como una nueva elección.
- Ninguna papeleta. Sin papeletas no hay nada que escrutar: el resultado oficial está vacío (cifras a cero, clasificación vacía, ningún elegido) y no se llama a la biblioteca.
La versión del cálculo, registrada con el resultado.
Cada resultado registra lo necesario para reproducir exactamente la misma semántica: la versión del contrato de escrutinio, la versión de la biblioteca y la clasificación de cada método calculado. La página pública de resultados muestra el método oficial, el de la configuración, y, en una elección Condorcet, la versión de la biblioteca.
-
engine_contract_versionentero · hoy 1 - La versión del contrato de escrutinio (puede mostrarse como «v1»): la forma del documento de resultado y las reglas de cómputo descritas en esta página.
-
condorcet_library_versioncadena - La versión de julien-boudry/condorcet que calculó el resultado (Condorcet::VERSION).
-
rankingsobjeto - La clasificación de cada método calculado (todos los de la familia de la elección, en un solo escrutinio), guardada bajo el nombre del método. La clasificación oficial es la del método publicado en la configuración.
-
counts, weightsobjetos - Los seis contadores anteriores y su equivalente ponderado.
El documento de resultado se conserva tal como lo produce la biblioteca: para cada método, la clasificación, el ganador y el perdedor, el ganador y el perdedor de Condorcet y las advertencias; opcionalmente, la matriz de duelos. La única operación que añade la plataforma es el corte en las primeras posiciones, tantas como escaños.
Una comodidad, no una pieza del protocolo.
Una vez terminado el escrutinio y publicado el resultado, la página de resultados ofrece las papeletas en Condorcet Election Format (CEF), un formato de texto abierto con especificación pública, que pueden leer tanto la biblioteca Condorcet como cualquier implementación conforme.
- Nunca imprescindible. El documento puede reconstruirse solo a partir del registro: un verificador puede regenerarlo para contrastarlo con el archivo servido, y el recuento no lo necesita.
- Sin restricciones ni método. No figuran en él: se leen en la configuración publicada (ballot_rules, method).
- Regenerado en cada escrutinio. Se produce tras cada escrutinio que termina con éxito, incluso en una elección sin papeletas; un nuevo escrutinio produce un nuevo documento. Nunca se purga.
- /elections/{election}/results/ballots.cef
- Redirige al documento almacenado, una vez publicada la elección y terminado el escrutinio.
Contenido del documento
-
#/Candidates:parámetro - Las etiquetas oficiales, declaradas de antemano: un candidato que no figura en ninguna clasificación existe igualmente.
-
#/Implicit Ranking:parámetro - true para una elección preferential, false para una elección fptp.
-
#/Weight Allowed:parámetro, solo con ponderación - Solo está presente en una elección ponderada; cada línea de voto lleva entonces su peso firmado.
-
una línea por papeletaclasificación CEF - El campo ballot de cada payload publicado, escrito por cef-writer, incluidos los votos en blanco /EMPTY_RANKING/. Los nulos por formato no figuran en él.
Reproducir el escrutinio por su cuenta.
Con la biblioteca de referencia en la versión registrada, el recuento reproduce la clasificación y las cifras de forma idéntica. Cualquier otra implementación conforme a CEF debería, en teoría, llegar al mismo resultado.
- 1 Descargar el registro de la elección y verificar cada papeleta: firma, unicidad de las imágenes de clave, coherencia con el registro de participación y, en una elección ponderada, con los pesos.
- 2 Leer en el bloque 0 los candidatos, el tipo, ballot_rules, seats y weighted_voting, y deducir de ellos las restricciones y la regla de clasificación implícita.
- 3 Escribir cada payload publicado en CEF con cef-writer, o aplicar el mismo filtro de formato, con su peso firmado si la elección es ponderada; los rechazos son los nulos por formato.
- 4 Calcular con julien-boudry/condorcet, en la versión registrada, el método publicado en la configuración, con las restricciones deducidas y el voto en blanco exento de NoTie y de CompleteRanking.
- 5 Comparar la clasificación y los seis contadores con el resultado publicado, y leer después los elegidos: las primeras posiciones, tantas como escaños.
Véase también
- Registro público Lo que publica cada elección, con independencia del medio que lo transporte: definición, anillos, registro de participación y papeletas.
- Procedimiento de verificación Verificar una elección de principio a fin: solo con el registro o con la blockchain.
- Papeleta firmada La papeleta tal como la firma el votante: payload, firma de anillo, imagen de clave y huella del anillo.