---
# System prepended metadata

title: Votings (Descartados)

---

# Votings (Descartados) 

[Pliegos en formato Google Drive](https://docs.google.com/document/d/1er_tYc-EZNl-UdqYSN4g0cgdbllVdTBa/edit#)

[Prototipo multiconsulta](https://2gy0iy.axshare.com/prototype/login/2gy0iy) 
(password 12345)

----

## Glossary

:::danger
**Para Oliver Azevedo**
Revisar terminología en ingles
:::
* Voting == votación (sería mejor "Polls"?)
* Census == censo
* Polling station == mesa presencial 
* Polling officer == oficiales de mesa (presidentes i gestores)
* Monitoring Committee == comisión de seguimiento 
* In-person = presencial
* Elections results certification == certificación de resultados de las votaciones
* Monitoring Committee President == Comisionada de la comisión de seguimiento (en el pliego) ; Presidente de la Comisión de Seguimiento (al reglamento)
* Participant == participante
* Visitor == visitante
* digital electoral closure certificate = acta de cierre electoral
* Trustee == Depositario

![](https://i.imgur.com/lYUtc3v.png)

![](https://i.imgur.com/1FF7ty7.png)

:::info
A nivel logístico, deberíamos: 
1) crear un label en github para asignar a todos los issues actuales de Elections :heavy_check_mark: 
2) usar otro label en github para asignar a los issue nuevos de Votings
3) revisar los titulos de los issues cuando pueda dar lugar a malosentendidos entre uno y otro, por ej "Modify my vote" habra dos: "Modify my vote in an Election" y "Modify my vote in a Voting"
4) crear MEGA-EPIC que tenga enlace al resto de epics de cada una de las fases del desarrollo (Elections y Votings)

---
debates: 
hasta uqe punto se mantiene el legacy de consultations? hacemos un fork y empezamos de nuevo? (decidim-voting)
hasta que punto se reaprovecha elections? es un modulo dentro de consultations? hasta que punto esta integrado? 
:::

## Discarded

### Configure that a participant is redirected to a survey

ref V-AP.11

... Configure the form at which a participant was redirected at a survey when end to vote, for such to be able to capture these data and realise statistics, at the equal that [AP.9], it will ask for genus, age and district, and the responses will save to present them later.




----

# DEPRECATED



## ~~Introduce the statistical data~~

ref. V-AP.12

As an administrator, I want to be able to introduce the statistical socio-demographic data.

Related with: 
* As Administrator, "Integrate with surveys" (ref. V-AP.10)
* As Participant, "Emit an opinion of the process in a Consultation" (ref. V-VE.08)
* As Visitor, "Access to the consultations' participation statistics" (Ref: V-VP.05)

I'll need a way for introducing the accumulated socio-demographic data: 
* How many man, woman and non binary people has participated 
* How many participants were in every age group: 
  w(14-19 20-24 25-29 30-34 35-39 40-44 45-49 50-54 55-59 60-64 65-69 >70)
* How many participants were in every district (scopes)

Ideally this be matched with the survey (in "Integrate with surveys" (ref. V-AP.10)) but that could be difficult to implement.

:::warning
comprovar amb la demo de Consul
:::
:::success
**Para Product**
A) los datos serán solo los donados? no usaremos para nada los del padrón?  - antes no teniamos la posibilidad pero ahora en barcelona tenemos decidim-stats
o sea a nivel de UX un usuario puede
1. verificarse con sus datos reales
2. votar
3. cuando llegue a la encuesta demografica, poner otros datos
(a nivel de UX es raro preguntarle dos veces por lo mismo) 

---
B) Como alternativa, se podría hacer como hicieron en Madrid, que es una página estática hecha a posteriori a mano, para reducir complejidad en el pliego / admin

---
**Alternativa B, que además no todas las orgs tienen integrados los datos como el caso de Barcelona**
:::


### Additional context

* Article 81 of the [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (in Spanish) 

### Acceptance criteria

- [ ] As an administrator I can introduce how many people of sex "female"  has participated 
- [ ] As an administrator I can introduce how many people of sex "male"  has participated 
- [ ] As an administrator I can introduce how many people of sex "non binary" has participated 
- [ ] As an administrator I can introduce how many people of age groups has participated in groups: w(20-24 25-29 30-34 35-39 40-44 45-49 50-54 55-59 60-64 65-69 >70)
- [ ] As an administrator I can introduce how many people by district (scopes) has participated 



---


## ~~Define the Questions, Answers and Rules on a Consultation~~

ref. V-AP.02

As an administrator I need to configure a Consultation. This is closely related with "EPIC: Elections [Administrator]" #5958, but this time for Consultations module. The relevant issues are: 
 
* set up a new election (S-AP.01) #5959
* create new questions and answers for an election (S-AP.02) #5960
* define which authorization strategy to use in an election (S-AP.05) #5963
* publish or unpublish and election (S-AP.02) #6075

:::success
**A Product**
Deberiamos revisar como se encuentra a dia de hoy decidim-consultations y como poner al día los dos desarrollos: decidim-elections y decidim-consultations (a nivel de backend de Administrador y modelo de datos; a nivel de frontend ya lo haremos en otro EPIC, el de Voter)


---
En principio haremos un espacio nuevo. Nombre provisional **decidim-voting**
:::

### Additional context

* Articles 69.2/71/72/73/74/75/77/95/96 [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (in Spanish) 

### Acceptance criteria

- [x] As an administrator I can define Questions and Responses on a Consultation 
- [ ] As an administrator I can define Question for only the participants that has an attribute that belongs to a given Scope
 
---

## ~~Configure the web address for a Consultation~~ (descartada)

ref. V-AP.03

As an Administrator I need to configure an optional website where all the information for a given Consultation is published, as it could be the case where some of the information is on others sites.

### Additional context

* Articles 73/74/75/77/78/79/82 [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (on Spanish) 

### Acceptance criteria

- [ ] As an administrator I can configure an external URL
- [ ] As a visitor I can click and go to this external URL 

:::danger
es cau 
:::



---

## ~~Define the start and end datetime of a Voting~~

ref. V-AP.04 

As an administrator I need to be able to configure when the Consultation voting starts and ends as we already do in Elections (see "set up a new election (S-AP.01)" #5959).

:warning: Mind that currently there's a bug in the format, as it only lets you configure the date, NOT the time. The field should be datetime.

![](https://i.imgur.com/Bo2cqdB.png)

### Additional context

* Articles 77/78/79/80/86/95 [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (on Spanish) 

### Acceptance criteria

- [ ] As an administrator I can configure the start datetime of a voting 
- [ ] As an administrator I can configure the end datetime of a voting 
- [ ] As an administrator I can't configure a voting that ends before it starts 


---

## ~~Define the URL and credentials of the census service~~

ref: V-AP.06

As an administrator I want to be able to configure the URL and credentials to the census service for verification. Related with "EPIC: Consultations [Census Administrator]".

:::danger
**Nota** 
Esto lo ponia así en el pliego, pero depende de como se termina implementando en "EPIC: Consultations [Census Administrator]"
:::

### Additional context

* Articles 77/78/79/80/82/95 [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (on Spanish) 

### Acceptance Criteria

- [ ] As an administrator I can configure an external census service
- [ ] As an administrator I can try the connection (through a ping or a test call) for checking that the URL and credentials are correct

---

## ~~Communicate credentials to Officers~~


:::warning

Backlog
:::

ref: V-AP.08

As an administrator, I want a way to communicate the credentials to Officers users so they can use the system. This is closely related with "Give permissions to Officer" (ref: V-AP.07) as it's the second step: what happens once I've given permissions to Officer? 


:::danger
**TODO** 
Quitar, por consistencia deberia ser aplicado a todo el mundo
:::

For extra security the Polling Station Officer will have a two step log-in the first time:

1) as a regular Invitation like other admin roles in Decidim. This will be sent by email.
2) with a PIN short code defined by me (the administrator) or autogenerated: the first time that the Polling Station Officer logs in she'll have to submit a short PIN code (6 numbers) that will allow her to log-in. Mind that this will only happen the first time. This will be trasmited in-person, Instant Messaging platforms (like Telegram or WhatsApp) or by SMS, but the transmission of this PIN code is out of the scope of this development.

### Additional context

* Articles 74.6/76/79/89/90/91/92/93/94/97 of the [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (in Spanish) 

### Acceptance criteria

- [ ] As an administrator I can get the short PIN code (6 numbers) for the Polling Station Officer




---


## ~~Integrate with surveys~~

ref. V-AP.10
 
Related with "Emit an opinion of the process" #5978 (ref: S-US.07) and with "Introduce the statistical data" (ref: V-AP.09)

As an administrator I want to configure a survey so I can get some opinion in the process (#5978) and also get statistical data from the participants. 

As a participant I want to give an evaluation of the process. This would enable the participant to evaluate the experience in the voting process or to ask for socio-demographic data by administrators.

Apart from the evaluation or opinion of the process it can ask for gender, age group, district, education level, for giving some demographic data about *who* participates in this Consultation. 


:::danger

Cal fer aquesta? o ja estaria amb Emit an opinion of the process?
:::

### Additional context

* Article 81 of the [Citizen Participation Normative of Barcelona City Hall](https://ajuntament.barcelona.cat/participaciociutadana/sites/default/files/documents/reglamento_participacion_cast.pdf) (in Spanish) 

### Acceptance criteria

- [ ] As an administrator I can set up if I want a survey after the participant has answered
- [ ] As an administrator I can set up which questions will be answered
- [ ] As an administrator I can setup answers for this survey with radio buttons 
- [ ] As an administrator I can setup answers for this survey with checkboxes
- [ ] As an administrator I can setup answers for this survey with a short text 
- [ ] As an administrator I can setup answers for this survey with text area
- [ ] As an administrator I can export the surveys' answers
- [ ] As a participant I can give the opinion of the process through this survey or form



----

# FRIDGE


## Newsletter segmentation of voting spaces

ref. V-AP.08

As an administrator I want to be able to segment by "the participants with the newsletter checkbox enabled and that have participated in a given voting" by the "Select spaces to segment the newsletter" feature in Newsletters. 

### Mockup 

![](https://i.imgur.com/za6GIS6.png)

![](https://i.imgur.com/SJzo5q0.png)

### Acceptance criteria

- [ ] **Given that** there is a a voting that has 100 participants
      **when** there are 50 participants that have marked the "I want to receive a newsletter" checkbox
      **then** when an administator send the newsletter, it gets sent to these 50 participants. 

---



---

# DEPRECATED

## ~~Generate Access Codes for the people that has modified their data~~

Ref: V-ALP.05

Related with the workflow defined in "EPIC: Consultations [Census Administrator]", after I corrected the census data (see "Make the participants updated load" (ref: V-ALP.02)), I need to be able to re-generate Access Codes for these people when their modify their data (see "Generate an access code for participants" (ref: V-ALP.03)).

:::warning 
**Para Product**
Hay que revisar bien el reglamento y como seria el workflow, este paso y el siguiente (exportar de nuevo los codigos para enviar) son inevitables? Tengo dudas... Entiendo que la gente se enteraria si tiene los datos incorrectos cuando reciban la primera carta?? Pero si tienen los datos incorrectos no la recibirian, no??


---
Para mi no tiene sentido enviar las cartas 2 veces. Debería exponerse el censo, que la gente pueda comprobar y reclamar si aplica, volver a subir el censo actualizado, y sobre ese generar los códigos de acceso para exportarlos y enviar las cartas
:::

### Acceptance criteria

- [ ] As a census administrator I've a button for creating the Access Codes (??)
- [ ] As a census administrator I **can't** see the Access Code generated for a given user
- [ ] As a census system administrator I can see an Access Code through the Rails console
- [ ] The generation of the Access Codes is only for the modified people 

---

## ~~Export Access Codes and data for the modified people~~

Ref: V-ALP.06

Related with the workflow defined in "EPIC: Consultations [Census Administrator]", after I re-generated the Access Code (see "Generate Access Codes for the people that has modified their data" (ref: V-ALP.05)), I need to be able to export again these codes (see "Export Access Codes and census data" (ref V-ALP.04)).

### Acceptance criteria

- [ ] As a census administrator I can export a CSV with format: `"Full name; Full address; Postal Code; Access Code"`
- [ ] As a census administrator when I download this export is encripted or protected by some mechanism
- [ ] The export is only for the modified people 


---


---- 




# DESCARTADOS



## ~~View the reported incidents from the polling stations~~

ref V-VP.06

As a visitor, after the voting has ended, I want to see all the incidents that have happenend in the process, for transparency purposes.

This is closely related with "View the reported incidents from the Polling Place Staff" (ref V-CCS.03).

### Acceptance criteria

- [ ] As a visitor I can see all the reported incidents after the consultation has ended

--- 

## ~~View the activity and the closing electoral certificates from the Monitoring Committee~~

ref V-VP.07

As a visitor, I want to see all the closing electoral certificates, with all the confirmations and notes that happened. 

This is closely related with "View and validate the closing electoral certificates from the Polling Place Staff" (ref V-CCS.01).

:::danger
**Para Product**
Que pasa con los datos personales de las fotos de los certificados electorales? entiendo que debemos asumir que deben ser publicados por transparencia

:::

### Acceptance criteria

- [ ] As a visitor I can see published all the electoral certificates from the Polling Places
 

---

## ~~View the Consultations' statistics and opinions~~

ref V-VP.08

:::danger
**TODO: REFINE**
[V-*VP.08] ... Visualise the statistics of estimation of the process.
They show the in shape graphic data and tabulate collection at the [COMES.8], so that everybody can view which estimation have given the voters at the procedure of vote.

---
**Para Product**

Me parece un poco demasiado tener un panel para esto, los datos demográficos si que pueden al final sacarse unos más estandar, pero una encuesta de opinion de un proceso de este estilo no consigo ver la abstracción necesaria, y se dispara la complejidad la verdad 
:::

---- 


## Search votings globally

:::info
Freeze
:::

ref. V-VP.03

As a visitor I want to be able to globally search the votings (/search), at least the titles and descriptions: 

### Mockups

![](https://i.imgur.com/LJYIHOg.png)

![](https://i.imgur.com/PPRoySJ.png)


### Acceptance criteria

- [ ] As a visitor I can globally search by title on votings 
- [ ] As a visitor I can globally search by description on votings 

----


--- 

# DESCARTADAS

:::success
(como usamos Elections ya nos vale todo, pero por las dudas habría que revisar al final si efectivamente esta todo cubierto solo con Elections o haria falta una revisión final)
:::


----
## ~~Emit my vote~~

ref V-VE.03

As a participant, I want to be able to emit my vote. I should have access to every question that I have the right to participate, depending on my district and the consultation rules. 

Related with: 
* Emit the encrypted vote in Decidim in an Election (ref: S-US.XX)
* Receive the encrypted vote in the Bulletin Board in an Election (ref: S-US.XX)

### Acceptance criteria
- [ ] (same as defined on S-AP.02) As a participant I can emit an encrypted vote while the election is open
- [ ] As a participant I can't emit a vote when the election is closed
- [ ] As a Decidim implementer I can't see the meaning of the vote 
- [ ] As the Bulletin Board I can receive an encrypted vote while the election is open
- [ ] As the BB I can't receive a vote when the election is closed
- [ ] As a Bulletin Board implementer I can't see the meaning of the vote 


---

## ~~Modify my vote in a Consultation~~

ref V-VE.04

As a Voter, I want to be able to modify my vote, as we already do in an Election. This is the same as "Modify my vvote in an Election" #5974 (ref: S-US.03) but this time is for Consultations.
 
It's important to take in account that there could be two different cases: 

1) I want to modify my vote after I've voted online
2) I want to modify my vote after I've voted in-person: in this case then I **can't** modify it, I should see a message like "You've voted in-person and you can't modify your vote." 

### Acceptance Criteria

- [ ] As a participant I can see that I've already have voted
- [ ] As a participant I can't see what I've voted
- [ ] Given that I'm a participant that has already voted online
      when I vote for a second time
      then only the last vote gets tallied.
- [ ] Given that I'm a participant that has already voted in-person
      when I try vote for a second time
      then I can't do it and I see an message: "You've voted in-person and you can't modify your vote".

----

## ~~Receive my Tracking ID by email in a Consultation~~

ref V-VE.05
 
As a Voter, I want to be able to receive my Tracking ID by email, as we already do in an Election. This is the same as "Receive my Tracking ID by email" #5976 (ref: S-US.05) but this time is for Consultations.

- [ ] As a participant I can obtain a Tracking ID on long version format
- [ ] As a participant I can receive an email with my Tracking ID with instructions explaining what's that and how I can "Verify my vote" (see ref: V-VE.06)

---

## ~~Verify my vote in a Consultation~~

ref. V-VE.06

As a Voter, I want to be able to verify my vote, as we already do in an Election. This is the same as "Verify my vote in an Election" #5975 (ref: S-US.04) but this time is for Consultations.

The only diference would be in the cases where a voter has voted online and then went to vote in-person; in this case then it should return a message that "you've voted online and then voted in-person so your online Tracking ID is not relevant". 

:::danger
**A Leo:** se podría mostrar esto al momento o debería mostrarse al final de la votación una vez se haga la consolidación de votos presenciales y votos online? 
:::
 
### Acceptance Criteria

- [ ] As a participant that has voted, I can see my Tracking ID
- [ ] As a participant that has voted, I can verify that my vote has been saved in the Tracker
- [ ] Given that I've voted first online and then in-person 
      When I verify my online vote
      Then I see an error of "you've voted online and then voted in-person so your online Tracking ID is not relevant"
---

## ~~Fill a socio-demographic survey~~

ref V-VE.07

Related with "Emit an opinion of the process" #5978 

[V-VE.07] ... Introduce my  of gender, age and education data 

(related with [VP.5]).

:::danger
Unificada con V-VE.08 (será la misma encuesta que la de Opinión, habrá que revisar el copy si eso)

----
:::



## ~~Emit an opinion of the process in a Consultation~~

ref. V-VE.08

As a Voter, I want to be able to emit my opinion of the process in a Consultation, as we already do in an Election. This is the same as "Emit an opinion of the process" #5978 (ref: S-US.07) but this time is for Consultations.

### Acceptance criteria
- [ ] As the participatory space administrator I can set up if I want a survey after the participant has answered
- [ ] As the participatory space administrator I can set up which questions will be answered
- [ ] As the participatory space administrator I can setup answers for this survey with radio buttons 
- [ ] As the participatory space administrator I can setup answers for this survey with checkboxes
- [ ] As the participatory space administrator I can setup answers for this survey with a short text 
- [ ] As the participatory space administrator I can setup answers for this survey with text area
- [ ] As a participant I can give the opinion of the process through this survey or form

----


## ~~View the reported incidents from the Polling Station Officer~~

ref V-CCS.03

As a member of the Monitoring Committee, I want to view the reported incidents from the Polling Station Officer. 

I want to be able to: 
* have pagination of all the reports
* have full text search in title and description of incidents
* filter incidents by reporter 
* filter incidents by polling station 
* filter by status
* be able to sort by creation date (ascendent and descendent)
* be able to upload documents
* be able to add notes to these incidents 
* be able to change status of these incidents

As a summary, a Reported Incident will have:
- title
- body
- document 
- status: Open, Closed
- a reporter
- a polling station
- creation date
- multiple notes

A Note, will have:
* an author 
* body
* creation date

:::danger
**Pregunta a Product**
Hace falta poder subir documentos o es demasiado?
Que estados tendrá un incidente?
Deberan enviarse correos? 
Tambien en los cambios de estado?
:::

:::danger
**Para Product**
Esto de los incidentes puede ser bastante complejo de gestionar... aparte de que es el tipico sistema de support que al final crecerá mucho más que consultations, se merece un modulo propio EMHO y al final no tenemos los recursos suficietnes para desarrollarlo bien a nivel de tiempo y forma en el marco de este contrato... lo podriamos dejar caer? :pray: 
:::


### Acceptance Criteria

- [ ] As a member of the Monitoring Committee, I have pagination in reported incidents 
- [ ] As a member of the Monitoring Committee, I can search in reported incidents 
- [ ] As a member of the Monitoring Committee, I can filter by "open" status in reported incidents
- [ ] As a member of the Monitoring Committee, I can filter by "closed" status in reported incidents 
- [ ] As a member of the Monitoring Committee, I can filter by reporter in reported incidents 
- [ ] As a member of the Monitoring Committee, I can filter by polling stations in reported incidents 
- [ ] As a member of the Monitoring Committee, I can sort by creation date (from new to old) in reported incidents 
- [ ] As a member of the Monitoring Committee, I can sort by creation date (from old to new) in reported incidents 
- [ ] As a member of the Monitoring Committee, I can upload documents in reported incidents 
- [ ] As a member of the Monitoring Committee, I can add notes in reported incidents 
- [ ] As a member of the Monitoring Committee, I can change status in reported incidents 



---

# DESCARTADOS



## ~~Review the people that has voted (ref V-PGMF.07)~~

ref V-PGMF.07

As a Pollign Station Officer I want to be able to see all the participants that have alrady voted. It could be a list of DNIs or a request with her DNI on an internal web form. 

:::success
**Para Jordi**
La verdad que no le veo mucho sentido a esto, puede ser un problema a nivel de LOPD, y creo que en realidad con V-PGMF.03 -  Identify and verify a person - si ahi ya dicen que ha votado no hace falta esta en particular 


---
es cau, no hi haurà llostat de DNIs
:::

---

## ~~Report incidents~~

ref V-PGMF.08

As a Pollign Station Officer, I need a way to report incidents that could happen in the polling station.

Related with "View the reported incidents from the Polling Station Officer" (ref V-CCS.03).

A Reported Incident will have:
- title
- body
- document 
- status: Open, Closed
- a reporter
- a polling station
- creation date
- multiple notes

It'll get sent to members of the Monitoring Committee.

:::success
**Para Product**

Propongo que esto se caiga para este MVP, es la tipica cosa que crecerá lo suficiente que molaría hacerlo bien desde el principio y no que quede algo infumable/inusable (remember Metrics): 
https://hackmd.io/P2luGt8wTpW-dyDh7SJmZg#View-the-reported-incidents-from-the-Polling-Station-Officer

---
lo descartamos
:::

---
