# Decidim Vocdoni User Stories

This document describes the User Stories required to have an MVP (Minimal Valuable Product) for integrating Decidim with Vocdoni API.

https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/4

### Create a new election
Ref.: VOC-ADM-01
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/5

### Create questions with answers in an election
Ref.: VOC-ADM-02
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/6

---

### Add a census to this election
Ref.: VOC-ADM-03
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/7

As an administrator, I need to be able to add a census so they have the right to vote on the system.

The flow would be:

1. An administrator upload a CSV with the header `email;born_at`
2. Once its uploaded, the system will generate one wallet for voter using as a seed this data. The system will save the wallet's address, so it can be used in the election setup (ref. VOC-ADM-05)
3. Once the election is published and accepting votes, the participants must enter their email and date of birth in the UI when they go to vote (ref VOC-VOT-02)
4. The system checks their access and rejects/allows accordingly before voting
5. If its allowed, the system will send their vote with their census proof

On this story will only tackle the steps 1 and 2.

- [ ] Given that I'm an administrator
When I go to the election I have a section for the Census
And I have a form to upload the Census CSV file
And I have an example of this file
- [ ] Given that I've uploaded a CSV file without the header
Then I see an error
- [ ] Given that I'm an administrator
When I upload a Census CSV file,
Then the system generate the address of these wallets
and it checks that the email is valid
and it also checks that the date format is valid.

---

### Setup the Organization wallet
Ref.: VOC-ADM-04
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/8

### Set-up an election on Vocdoni API
Ref.: VOC-ADM-05
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/9

## Publish the results
Ref.: VOC-ADM-06
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/10

## View the information for an election
Ref.: VOC-VOT-01
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/11

## Identify myself with the census
Ref.: VOC-VOT-02
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/12

## Submit a vote with the Vocdoni API
Ref.: VOC-VOT-03
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/13

## Verify a vote with the Vocdoni API
Ref.: VOC-VOT-04
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/14

## View the results
Ref.: VOC-VOT-05
https://github.com/decidim-vocdoni/decidim-module-vocdoni/issues/15