---
# System prepended metadata

title: Decidim Vocdoni User Stories

---

# 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