Ir al contenido
Condorcet.vote Alpha
← Documentación técnica

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

Entradas

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[].label cadenas · configuration
Los candidatos declarados, incluidos los que no figuran en ninguna clasificación. La etiqueta es el único identificador de un candidato.
election_type preferential | 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_rules objeto · 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).
seats entero ≥ 1 · configuration
El número de elegidos: las primeras posiciones de la clasificación, tantas como escaños.
weighted_voting booleano · 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[].payload cadena JSON · votes
El payload firmado: su campo ballot (clasificación CEF o /EMPTY_RANKING/) y su campo weight.
electoral_roll[].weight entero ≥ 1 · closure
El peso autorizado de cada votante, para comprobar los pesos firmados de una elección ponderada.
method nombre 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.
Papeletas

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. 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. 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. 3 Reconocer el voto en blanco. El centinela /EMPTY_RANKING/ es una papeleta en blanco: una abstención que se contabiliza.
  4. 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. 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

NoTie si 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.
NoBlankVote si blank_allowed = false
Rechaza la papeleta en blanco, que pasa entonces a ser nula por restricción en lugar de en blanco.
CompleteRanking si partial_ranking_allowed = false
Rechaza una clasificación que no nombra explícitamente a todos los candidatos.
Implicit Ranking segú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.

Cifras

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.

total entero
Los votos que la biblioteca ha registrado.
valid entero
Los votos que superan todas las restricciones.
expressed entero
Los votos válidos que no están en blanco: los que forman la clasificación.
blank entero
Los votos válidos con la clasificación vacía (/EMPTY_RANKING/).
invalidByConstraint entero
Los votos registrados pero rechazados por una restricción: los nulos por restricción.
invalidByFormat entero
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.

Métodos

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.

FPTP fptp
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 Winning preferential · por defecto
Schulze, variante de votos ganadores.
Schulze Margin preferential
Schulze, variante de márgenes.
Ranked Pairs Winning preferential
Ranked Pairs (Tideman), variante de votos ganadores.
Ranked Pairs Margin preferential
Ranked Pairs (Tideman), variante de márgenes.
Copeland preferential
El método de Copeland.
Dodgson Quick preferential
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.
Los métodos de Condorcet, explicados
Empates

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.
Contrato de escrutinio

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_version entero · 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_version cadena
La versión de julien-boudry/condorcet que calculó el resultado (Condorcet::VERSION).
rankings objeto
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, weights objetos
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.

Exportación CEF

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.
Especificación del formato CEF

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 papeleta clasificació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.
Recuento independiente

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. 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. 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. 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. 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. 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.

Elija qué mide Condorcet.Vote en sus páginas públicas. Su elección se guarda en este dispositivo y puede cambiarla en cualquier momento.

Imprescindibles Siempre activos

Idioma, tema y conservación de estas opciones.