Wiki de EGC - Contribuciones del usuario [es]

Cabina de votaciones - 17 18 - G2

2018-01-09T12:01:18Z

Ignalelop: /* APIs y datos que se usarán y devolverán */ Cambiado el retorno de la petición de voto para evitar enviar el voto cifrado

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"reason": "can_vote"
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %} 
<\h2>{{ election['nombre'] }}<\/h2> 
<\hr/> 
<\p>{{ election['descripcion'] }}<\/p> 
<\hr/> 
{% for question in election['preguntas'] %} 
<\p>Pregunta {{ question['nombre'] }}<\/p> 
<\span>{{ question['descripcion'] }}<\/span> 
{% if question['tipo_pregunta'] == "Cerrada" %} 
<select> 
{% for answer in question['respuestas'] %} 
<option value="{{\answer.seleccionada}}">{{answer['texto_pregunta']}}</option> 
{% endfor %} 
</select> 
{% endif %} 
{% if question['tipo_pregunta'] == "Abierta" %} 
<\p> 
{{ question['texto_pregunta'] }} 
<input id="answer" value="{{ question.respuestas[0].texto_respuesta}}" /> 
<\/p> 
{% endif %} 
{% endfor %} 
<button>Enviar voto</button> 
<\hr/> 
{% endblock %} 

'''Final de la votación de la encuesta'''

{% block body %} 
<\h2>{{ election.nombre }}<\/h2> 
<\hr/> 
<\p>{{ election.descripcion }}<\/p> 
<\hr/> 
<\p>Gracias por responder a {{ election.nombre }}<\/p> 
<button>Finalizar</button>
{% endblock %}

Para que pueda mostrarse, se ha tenido que añadir <\ en la mayoría de las etiquetas HTML, así como añadir \answers en el select dentro de la página de votación.

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2018-01-09T11:58:18Z

Ignalelop: /* Decisiones de diseño */ Cambiado el sistema para adaptarlo al cambio de guardado de votos

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %} 
<\h2>{{ election['nombre'] }}<\/h2> 
<\hr/> 
<\p>{{ election['descripcion'] }}<\/p> 
<\hr/> 
{% for question in election['preguntas'] %} 
<\p>Pregunta {{ question['nombre'] }}<\/p> 
<\span>{{ question['descripcion'] }}<\/span> 
{% if question['tipo_pregunta'] == "Cerrada" %} 
<select> 
{% for answer in question['respuestas'] %} 
<option value="{{\answer.seleccionada}}">{{answer['texto_pregunta']}}</option> 
{% endfor %} 
</select> 
{% endif %} 
{% if question['tipo_pregunta'] == "Abierta" %} 
<\p> 
{{ question['texto_pregunta'] }} 
<input id="answer" value="{{ question.respuestas[0].texto_respuesta}}" /> 
<\/p> 
{% endif %} 
{% endfor %} 
<button>Enviar voto</button> 
<\hr/> 
{% endblock %} 

'''Final de la votación de la encuesta'''

{% block body %} 
<\h2>{{ election.nombre }}<\/h2> 
<\hr/> 
<\p>{{ election.descripcion }}<\/p> 
<\hr/> 
<\p>Gracias por responder a {{ election.nombre }}<\/p> 
<button>Finalizar</button>
{% endblock %}

Para que pueda mostrarse, se ha tenido que añadir <\ en la mayoría de las etiquetas HTML, así como añadir \answers en el select dentro de la página de votación.

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-30T10:09:17Z

Ignalelop: Corrección de la sección de las plantillas para asegurarse que no son interpretadas como código HTML

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %} 
<\h2>{{ election['nombre'] }}<\/h2> 
<\hr/> 
<\p>{{ election['descripcion'] }}<\/p> 
<\hr/> 
{% for question in election['preguntas'] %} 
<\p>Pregunta {{ question['nombre'] }}<\/p> 
<\span>{{ question['descripcion'] }}<\/span> 
{% if question['tipo_pregunta'] == "Cerrada" %} 
<select> 
{% for answer in question['respuestas'] %} 
<option value="{{\answer.seleccionada}}">{{answer['texto_pregunta']}}</option> 
{% endfor %} 
</select> 
{% endif %} 
{% if question['tipo_pregunta'] == "Abierta" %} 
<\p> 
{{ question['texto_pregunta'] }} 
<input id="answer" value="{{ question.respuestas[0].texto_respuesta}}" /> 
<\/p> 
{% endif %} 
{% endfor %} 
<button>Enviar voto</button> 
<\hr/> 
{% endblock %} 

'''Final de la votación de la encuesta'''

{% block body %} 
<\h2>{{ election.nombre }}<\/h2> 
<\hr/> 
<\p>{{ election.descripcion }}<\/p> 
<\hr/> 
<\p>Gracias por responder a {{ election.nombre }}<\/p> 
<button>Finalizar</button>
{% endblock %}

Para que pueda mostrarse, se ha tenido que añadir <\ en la mayoría de las etiquetas HTML, así como añadir \answers en el select dentro de la página de votación.

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
[
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
},
{
...
}
]

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-30T10:03:09Z

Ignalelop: /* Plantillas HTML */ Corrección de las plantillas para que sean mejor interpretadas por Flask

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %} 

<h2>{{ election['nombre'] }}</h2> 

<hr/> 

{{ election['descripcion'] }} 

<hr/> 
{% for question in election['preguntas'] %} 
Pregunta {{ question['nombre'] }} 

{{ question['descripcion'] }} 

{% if question['tipo_pregunta'] == "Cerrada" %} 
<select> 
{% for answer in question['respuestas'] %} 
<option value="{{ answer.seleccionada }}">{{ answer['texto_pregunta'] }}</option> 
{% endfor %} 
</select> 
{% endif %} 
{% if question['tipo_pregunta'] == "Abierta" %} 
 
{{ question['texto_pregunta'] }} 
<input id="answer" ="{{ question.respuestas[0].texto_respuesta}}" /> 
 
{% endif %} 
{% endfor %} 

<button>Enviar voto</button> 
<hr/> 

{% endblock %} 

'''Final de la votación de la encuesta'''

{% block body %} 
<h2>{{ election.nombre }}</h2> 
<hr/> 
{{ election.descripcion }} 
<hr/> 
Gracias por responder a {{ election.nombre }} 
<button>Finalizar</button>
{% endblock %}

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
[
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
},
{
...
}
]

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18

2017-12-15T17:52:02Z

Ignalelop: /* Ramas */ Añadida la descripción del sistema de trabajos con ramas introduciendo Pull Requests y explicando el proceso de confirmación de pull request

'''
== Miembros del grupo ==
'''
- Ignacio José Alés López, coordinador del grupo. 
- Juan Carlos López Muñoz, gestor de incidencias. 
- Jorge Gordo Aguilar, programador. 
- Antonio Rodríguez Artacho, programador. 
- Javier Román Bayar, programador. 

'''

== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Modelo de uso del repositorio ==
'''
En esta sección se describirá cómo se gestionará el código fuente y otros productos resultados del trabajo realizado por el grupo.

Se dispone de dos repositorios, en uno de ellos se guardará la documentación del proyecto (https://github.com/EGC-G2-Trabajo-1718/egc-cabinas) y en el otro se pondrá el código del programa (https://github.com/EGC-G2-Trabajo-1718/cabina-de-votacion).

== Commits ==
Los commits se realizarán cada día que se realice alguna tarea correspondiente con el proyecto y deben tener el siguiente formato:

<razón>:<título>
(<colaboradores>)
<cuerpo>
(IMPORTANTE
<detalles importantes>)

Se describirán cada componente del formato ahora: 
- razón: Consitirá en la causa de la subida del commit, que puede ser uno de los siguientes: fix (arreglo), add (funcionalidad añadida), doc (documentación de código o otros). 
- título: Resumen, de menos de 20 palabras del commit. 
- colaboradores: Miembros del grupo que han ayudado en la realización del trabajo. 
- cuerpo: Explicación más en profundidad del contenido del commit. 
- IMPORTANTE: Sección donde se describe un detalle importante. 
- detalles importantes: Detalles a destacar para otros miembros del grupo. 

== Ramas ==
La gestión de ramas será la siguiente: 
- master: Contendrá una versión funcionando y con las funcionalidades confirmadas por el equipo de integración. Se considera usable para producción. 
- dev: Contendrá una versión en funcionamiento, pero puede contener problemas de código o conflictos con otras funcionalidades, necesitará un testeo en entorno de pre producción. 
- <funcionalidad>: Esta rama contendrá una versión master del código y desarrollará una funcionalidad para la próxima versión del programa. 
- <miembro>: Esta rama será personal para cada uno de los desarrolladores y no será modificada por otros miembros del grupo. Podrá contener código en cualquier estado (por ejemplo sin compilar correctamente). 

El funcionamiento para pasar de una rama a otra será el siguiente.
- miembro a funcionalidad: Los miembros que tengan asignada la funcionalidad podrán modificar y realizar merge de la rama personal a la funcionalidad. 
- funcionalidad a dev: Para poder actualizar dev, se deberá realizar un pull request y se realizarán pruebas de que el funcionamiento de la funcionalidad es correcta). 
- dev a master: Se realizará un nuevo pull request, donde se indicarán los cambios de una versión de master a otra. De nuevo pasará por un periodo de pruebas para asegurar que funciona de forma correcta. 

Al implementarse el sistema de integración continua, se usarán Pull Requests para pasar de una rama a otra, como se ve en el apartado anterior. El Pull Request no podrá ser aceptado hasta que la integración continua indique que la nueva versión es compilable y aprueba los tests indicados. Una vez se obtenga una versión correcta, el jefe del proyecto (Ignacio José Alés López) eligirá o él mismo realizará una evaluación del código y hará comentarios pertinentes. Si se decide que el pull request es válido, se procederá a confirmar el merge de las ramas.

== Incidencias ==
Las incidencias realizadas a nuestro módulo deben seguir el siguiente formato:
Título: (descripción breve del error, debe ser reconocible entre otros posibles errores, por lo que mencionar acción, resultado incorrecto...)
Grupo: (grupo al que pertenece el creador de la incidencia o grupos a los que le influyen la incidencia)
Prioridad: (¿Es necesario tener la solución cuanto antes o es un pequeño detalle a arreglar?. Podrá tener los siguiente valores: Baja, Media, Alta)
Descripción: (Descripción textual del error, un resumen del problema o mejora).
(Si aplicable) Pasos para reproducir: (Lista de acciones que se debe realizar para que se produzca el error, cuanto más preciso mejor)

Además, se asignará a un miembro del grupo para gestionar la incidencia, por parte del gestor de incidencias. Se asignará labels que mostrarán el estado de la incidencia y tendrá los siguiente valores:
- Estado: Puede ser Por iniciar, En progreso y Por revisar.
- Prioridad: Será asignada por el gestor de la incidencia, según sea necesario. Podrá ser Baja prioridad o Muy importante.
- Otros: Estos serán los labels creados por defecto en Github y serán asignados por el gestor de incidencias como sea necesario.

Cabina de votaciones - 17 18

2017-12-15T17:48:56Z

Ignalelop: /* Incidencias */ Añadido el elemento de grupo al formato de issue

'''
== Miembros del grupo ==
'''
- Ignacio José Alés López, coordinador del grupo. 
- Juan Carlos López Muñoz, gestor de incidencias. 
- Jorge Gordo Aguilar, programador. 
- Antonio Rodríguez Artacho, programador. 
- Javier Román Bayar, programador. 

'''

== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Modelo de uso del repositorio ==
'''
En esta sección se describirá cómo se gestionará el código fuente y otros productos resultados del trabajo realizado por el grupo.

Se dispone de dos repositorios, en uno de ellos se guardará la documentación del proyecto (https://github.com/EGC-G2-Trabajo-1718/egc-cabinas) y en el otro se pondrá el código del programa (https://github.com/EGC-G2-Trabajo-1718/cabina-de-votacion).

== Commits ==
Los commits se realizarán cada día que se realice alguna tarea correspondiente con el proyecto y deben tener el siguiente formato:

<razón>:<título>
(<colaboradores>)
<cuerpo>
(IMPORTANTE
<detalles importantes>)

Se describirán cada componente del formato ahora: 
- razón: Consitirá en la causa de la subida del commit, que puede ser uno de los siguientes: fix (arreglo), add (funcionalidad añadida), doc (documentación de código o otros). 
- título: Resumen, de menos de 20 palabras del commit. 
- colaboradores: Miembros del grupo que han ayudado en la realización del trabajo. 
- cuerpo: Explicación más en profundidad del contenido del commit. 
- IMPORTANTE: Sección donde se describe un detalle importante. 
- detalles importantes: Detalles a destacar para otros miembros del grupo. 

== Ramas ==
La gestión de ramas será la siguiente: 
- master: Contendrá una versión funcionando y con las funcionalidades confirmadas por el equipo de integración. Se considera usable para producción. 
- dev: Contendrá una versión en funcionamiento, pero puede contener problemas de código o conflictos con otras funcionalidades, necesitará un testeo en entorno de pre producción. 
- <funcionalidad>: Esta rama contendrá una versión master del código y desarrollará una funcionalidad para la próxima versión del programa. 
- <miembro>: Esta rama será personal para cada uno de los desarrolladores y no será modificada por otros miembros del grupo. Podrá contener código en cualquier estado (por ejemplo sin compilar correctamente). 

El funcionamiento para pasar de una rama a otra será el siguiente.
- miembro a funcionalidad: Los miembros que tengan asignada la funcionalidad podrán modificar y realizar merge de la rama personal a la funcionalidad. 
- funcionalidad a dev: Para poder actualizar dev, se deberá realizar un pull request y se realizarán pruebas de que el funcionamiento de la funcionalidad es correcta). 
- dev a master: Se realizará un nuevo pull request, donde se indicarán los cambios de una versión de master a otra. De nuevo pasará por un periodo de pruebas para asegurar que funciona de forma correcta. 

== Incidencias ==
Las incidencias realizadas a nuestro módulo deben seguir el siguiente formato:
Título: (descripción breve del error, debe ser reconocible entre otros posibles errores, por lo que mencionar acción, resultado incorrecto...)
Grupo: (grupo al que pertenece el creador de la incidencia o grupos a los que le influyen la incidencia)
Prioridad: (¿Es necesario tener la solución cuanto antes o es un pequeño detalle a arreglar?. Podrá tener los siguiente valores: Baja, Media, Alta)
Descripción: (Descripción textual del error, un resumen del problema o mejora).
(Si aplicable) Pasos para reproducir: (Lista de acciones que se debe realizar para que se produzca el error, cuanto más preciso mejor)

Además, se asignará a un miembro del grupo para gestionar la incidencia, por parte del gestor de incidencias. Se asignará labels que mostrarán el estado de la incidencia y tendrá los siguiente valores:
- Estado: Puede ser Por iniciar, En progreso y Por revisar.
- Prioridad: Será asignada por el gestor de la incidencia, según sea necesario. Podrá ser Baja prioridad o Muy importante.
- Otros: Estos serán los labels creados por defecto en Github y serán asignados por el gestor de incidencias como sea necesario.

Cabina de votaciones - 17 18 - G2

2017-12-09T18:16:03Z

Ignalelop: /* Objetivo del subsistema */ Eliminada una dependencia que no estaba siendo usada

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
[
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
},
{
...
}
]

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-08T09:49:43Z

Ignalelop: /* Decisiones de diseño */ Cambiado el formato del voto cifrado para que sea consistente con los últimos cambios de la API

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
[
{
"question_id": <id_de_la_pregunta>,
"answer": "<respuesta_a_la_pregunta>"
},
{
...
}
]

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-08T09:47:47Z

Ignalelop: /* APIs y datos que se usarán y devolverán */ Mejorado el formato de envío de votos

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id_user: (int) identificador del usuario que ha votado, es única y es posible verificar el voto [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[(int,string)]) Lista que contendrá el par question_id, que es el identificador de la pregunta como int, y answer, que es la respuesta del usuario. La representación de cada par sería la siguiente:
{
"question_id": 0,
"answer": "..."
}

Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13. Se debe enviar:

{
"id_user": 23,
"id_election": 34,
"answers": [
{
"question_id": 0,
"answer": "Algo"
},
{
"question_id": 1,
"answer": "Sí"
}
]
}

La respuesta a esta petición será:

{
"result": true,
"vote": {
"id_user": 23,
"id_election": 34,
"encrypted_answers": "ot7yfg913..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
{
"question_id": <id_de_la_pregunta>, "response": <respuesta_a_la_pregunta>
},
{
...
}
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-07T16:01:16Z

Ignalelop: /* APIs y datos que se usarán y devolverán */ Mejorado el estilo de los parámetros de entrada del método de voto

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros:
id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
{
"question_id": <id_de_la_pregunta>, "response": <respuesta_a_la_pregunta>
},
{
...
}
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-06T15:58:43Z

Ignalelop: /* Decisiones de diseño */ Mejora de estilo

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

'''
== Decisiones de diseño ==
'''

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
{
"question_id": <id_de_la_pregunta>, "response": <respuesta_a_la_pregunta>
},
{
...
}
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18

2017-12-06T15:57:34Z

Ignalelop: /* Miembros del grupo */ Corrección del estilo de los miembros del grupo

'''
== Miembros del grupo ==
'''
- Ignacio José Alés López, coordinador del grupo. 
- Juan Carlos López Muñoz, gestor de incidencias. 
- Jorge Gordo Aguilar, programador. 
- Antonio Rodríguez Artacho, programador. 
- Javier Román Bayar, programador. 

'''

== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Modelo de uso del repositorio ==
'''
En esta sección se describirá cómo se gestionará el código fuente y otros productos resultados del trabajo realizado por el grupo.

Se dispone de dos repositorios, en uno de ellos se guardará la documentación del proyecto (https://github.com/EGC-G2-Trabajo-1718/egc-cabinas) y en el otro se pondrá el código del programa (https://github.com/EGC-G2-Trabajo-1718/cabina-de-votacion).

== Commits ==
Los commits se realizarán cada día que se realice alguna tarea correspondiente con el proyecto y deben tener el siguiente formato:

<razón>:<título>
(<colaboradores>)
<cuerpo>
(IMPORTANTE
<detalles importantes>)

Se describirán cada componente del formato ahora: 
- razón: Consitirá en la causa de la subida del commit, que puede ser uno de los siguientes: fix (arreglo), add (funcionalidad añadida), doc (documentación de código o otros). 
- título: Resumen, de menos de 20 palabras del commit. 
- colaboradores: Miembros del grupo que han ayudado en la realización del trabajo. 
- cuerpo: Explicación más en profundidad del contenido del commit. 
- IMPORTANTE: Sección donde se describe un detalle importante. 
- detalles importantes: Detalles a destacar para otros miembros del grupo. 

== Ramas ==
La gestión de ramas será la siguiente: 
- master: Contendrá una versión funcionando y con las funcionalidades confirmadas por el equipo de integración. Se considera usable para producción. 
- dev: Contendrá una versión en funcionamiento, pero puede contener problemas de código o conflictos con otras funcionalidades, necesitará un testeo en entorno de pre producción. 
- <funcionalidad>: Esta rama contendrá una versión master del código y desarrollará una funcionalidad para la próxima versión del programa. 
- <miembro>: Esta rama será personal para cada uno de los desarrolladores y no será modificada por otros miembros del grupo. Podrá contener código en cualquier estado (por ejemplo sin compilar correctamente). 

El funcionamiento para pasar de una rama a otra será el siguiente.
- miembro a funcionalidad: Los miembros que tengan asignada la funcionalidad podrán modificar y realizar merge de la rama personal a la funcionalidad. 
- funcionalidad a dev: Para poder actualizar dev, se deberá realizar un pull request y se realizarán pruebas de que el funcionamiento de la funcionalidad es correcta). 
- dev a master: Se realizará un nuevo pull request, donde se indicarán los cambios de una versión de master a otra. De nuevo pasará por un periodo de pruebas para asegurar que funciona de forma correcta. 

== Incidencias ==
Las incidencias realizadas a nuestro módulo deben seguir el siguiente formato:
Título: (descripción breve del error, debe ser reconocible entre otros posibles errores, por lo que mencionar acción, resultado incorrecto...)
Prioridad: (¿Es necesario tener la solución cuanto antes o es un pequeño detalle a arreglar?. Podrá tener los siguiente valores: Baja, Media, Alta)
Descripción: (Descripción textual del error, un resumen del problema o mejora).
(Si aplicable) Pasos para reproducir: (Lista de acciones que se debe realizar para que se produzca el error, cuanto más preciso mejor)

Además, se asignará a un miembro del grupo para gestionar la incidencia, por parte del gestor de incidencias. Se asignará labels que mostrarán el estado de la incidencia y tendrá los siguiente valores:
- Estado: Puede ser Por iniciar, En progreso y Por revisar.
- Prioridad: Será asignada por el gestor de la incidencia, según sea necesario. Podrá ser Baja prioridad o Muy importante.
- Otros: Estos serán los labels creados por defecto en Github y serán asignados por el gestor de incidencias como sea necesario.

Cabina de votaciones - 17 18

2017-12-06T15:56:58Z

Ignalelop: Añadidos los miembros del grupo

'''
== Miembros del grupo ==
'''
- Ignacio José Alés López, coordinador del grupo.
- Juan Carlos López Muñoz, gestor de incidencias.
- Jorge Gordo Aguilar, programador
- Antonio Rodríguez Artacho, programador
- Javier Román Bayar, programador

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Modelo de uso del repositorio ==
'''
En esta sección se describirá cómo se gestionará el código fuente y otros productos resultados del trabajo realizado por el grupo.

Se dispone de dos repositorios, en uno de ellos se guardará la documentación del proyecto (https://github.com/EGC-G2-Trabajo-1718/egc-cabinas) y en el otro se pondrá el código del programa (https://github.com/EGC-G2-Trabajo-1718/cabina-de-votacion).

== Commits ==
Los commits se realizarán cada día que se realice alguna tarea correspondiente con el proyecto y deben tener el siguiente formato:

<razón>:<título>
(<colaboradores>)
<cuerpo>
(IMPORTANTE
<detalles importantes>)

Se describirán cada componente del formato ahora: 
- razón: Consitirá en la causa de la subida del commit, que puede ser uno de los siguientes: fix (arreglo), add (funcionalidad añadida), doc (documentación de código o otros). 
- título: Resumen, de menos de 20 palabras del commit. 
- colaboradores: Miembros del grupo que han ayudado en la realización del trabajo. 
- cuerpo: Explicación más en profundidad del contenido del commit. 
- IMPORTANTE: Sección donde se describe un detalle importante. 
- detalles importantes: Detalles a destacar para otros miembros del grupo. 

== Ramas ==
La gestión de ramas será la siguiente: 
- master: Contendrá una versión funcionando y con las funcionalidades confirmadas por el equipo de integración. Se considera usable para producción. 
- dev: Contendrá una versión en funcionamiento, pero puede contener problemas de código o conflictos con otras funcionalidades, necesitará un testeo en entorno de pre producción. 
- <funcionalidad>: Esta rama contendrá una versión master del código y desarrollará una funcionalidad para la próxima versión del programa. 
- <miembro>: Esta rama será personal para cada uno de los desarrolladores y no será modificada por otros miembros del grupo. Podrá contener código en cualquier estado (por ejemplo sin compilar correctamente). 

El funcionamiento para pasar de una rama a otra será el siguiente.
- miembro a funcionalidad: Los miembros que tengan asignada la funcionalidad podrán modificar y realizar merge de la rama personal a la funcionalidad. 
- funcionalidad a dev: Para poder actualizar dev, se deberá realizar un pull request y se realizarán pruebas de que el funcionamiento de la funcionalidad es correcta). 
- dev a master: Se realizará un nuevo pull request, donde se indicarán los cambios de una versión de master a otra. De nuevo pasará por un periodo de pruebas para asegurar que funciona de forma correcta. 

== Incidencias ==
Las incidencias realizadas a nuestro módulo deben seguir el siguiente formato:
Título: (descripción breve del error, debe ser reconocible entre otros posibles errores, por lo que mencionar acción, resultado incorrecto...)
Prioridad: (¿Es necesario tener la solución cuanto antes o es un pequeño detalle a arreglar?. Podrá tener los siguiente valores: Baja, Media, Alta)
Descripción: (Descripción textual del error, un resumen del problema o mejora).
(Si aplicable) Pasos para reproducir: (Lista de acciones que se debe realizar para que se produzca el error, cuanto más preciso mejor)

Además, se asignará a un miembro del grupo para gestionar la incidencia, por parte del gestor de incidencias. Se asignará labels que mostrarán el estado de la incidencia y tendrá los siguiente valores:
- Estado: Puede ser Por iniciar, En progreso y Por revisar.
- Prioridad: Será asignada por el gestor de la incidencia, según sea necesario. Podrá ser Baja prioridad o Muy importante.
- Otros: Estos serán los labels creados por defecto en Github y serán asignados por el gestor de incidencias como sea necesario.

Cabina de votaciones - 17 18

2017-12-06T15:54:12Z

Ignalelop: /* Incidencias */ Mejorada la descripción de la descripción de incidencias

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Modelo de uso del repositorio ==
'''
En esta sección se describirá cómo se gestionará el código fuente y otros productos resultados del trabajo realizado por el grupo.

Se dispone de dos repositorios, en uno de ellos se guardará la documentación del proyecto (https://github.com/EGC-G2-Trabajo-1718/egc-cabinas) y en el otro se pondrá el código del programa (https://github.com/EGC-G2-Trabajo-1718/cabina-de-votacion).

== Commits ==
Los commits se realizarán cada día que se realice alguna tarea correspondiente con el proyecto y deben tener el siguiente formato:

<razón>:<título>
(<colaboradores>)
<cuerpo>
(IMPORTANTE
<detalles importantes>)

Se describirán cada componente del formato ahora: 
- razón: Consitirá en la causa de la subida del commit, que puede ser uno de los siguientes: fix (arreglo), add (funcionalidad añadida), doc (documentación de código o otros). 
- título: Resumen, de menos de 20 palabras del commit. 
- colaboradores: Miembros del grupo que han ayudado en la realización del trabajo. 
- cuerpo: Explicación más en profundidad del contenido del commit. 
- IMPORTANTE: Sección donde se describe un detalle importante. 
- detalles importantes: Detalles a destacar para otros miembros del grupo. 

== Ramas ==
La gestión de ramas será la siguiente: 
- master: Contendrá una versión funcionando y con las funcionalidades confirmadas por el equipo de integración. Se considera usable para producción. 
- dev: Contendrá una versión en funcionamiento, pero puede contener problemas de código o conflictos con otras funcionalidades, necesitará un testeo en entorno de pre producción. 
- <funcionalidad>: Esta rama contendrá una versión master del código y desarrollará una funcionalidad para la próxima versión del programa. 
- <miembro>: Esta rama será personal para cada uno de los desarrolladores y no será modificada por otros miembros del grupo. Podrá contener código en cualquier estado (por ejemplo sin compilar correctamente). 

El funcionamiento para pasar de una rama a otra será el siguiente.
- miembro a funcionalidad: Los miembros que tengan asignada la funcionalidad podrán modificar y realizar merge de la rama personal a la funcionalidad. 
- funcionalidad a dev: Para poder actualizar dev, se deberá realizar un pull request y se realizarán pruebas de que el funcionamiento de la funcionalidad es correcta). 
- dev a master: Se realizará un nuevo pull request, donde se indicarán los cambios de una versión de master a otra. De nuevo pasará por un periodo de pruebas para asegurar que funciona de forma correcta. 

== Incidencias ==
Las incidencias realizadas a nuestro módulo deben seguir el siguiente formato:
Título: (descripción breve del error, debe ser reconocible entre otros posibles errores, por lo que mencionar acción, resultado incorrecto...)
Prioridad: (¿Es necesario tener la solución cuanto antes o es un pequeño detalle a arreglar?. Podrá tener los siguiente valores: Baja, Media, Alta)
Descripción: (Descripción textual del error, un resumen del problema o mejora).
(Si aplicable) Pasos para reproducir: (Lista de acciones que se debe realizar para que se produzca el error, cuanto más preciso mejor)

Además, se asignará a un miembro del grupo para gestionar la incidencia, por parte del gestor de incidencias. Se asignará labels que mostrarán el estado de la incidencia y tendrá los siguiente valores:
- Estado: Puede ser Por iniciar, En progreso y Por revisar.
- Prioridad: Será asignada por el gestor de la incidencia, según sea necesario. Podrá ser Baja prioridad o Muy importante.
- Otros: Estos serán los labels creados por defecto en Github y serán asignados por el gestor de incidencias como sea necesario.

Cabina de votaciones - 17 18 - G2

2017-12-06T12:51:36Z

Ignalelop: Añaadida la sección de decisiones de diseño y indicado el proceso de cifrado del voto

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

=== Decisiones de diseño ===

'''Cifrado de los votos'''
Para el cifrado de los votos, se seguirá el siguiente criptosistema. Primero, se recogerá la representación en JSON del voto, siguiendo el siguiente formato:
{
{
"question_id": <id_de_la_pregunta>, "response": <respuesta_a_la_pregunta>
},
{
...
}
}

Después, se cifrará el contenido de éste JSON a base64, usando como encodificado UTF-8. Finalmente, se recogerá la clave de cifrado de la votación y se aplicará el cifrado XOR, aplicando XOR a la clave y el string en base64 antes mencionado.

Cabina de votaciones - 17 18 - G2

2017-12-06T12:47:57Z

Ignalelop: /* Objetivo del subsistema */ Añadida una nueva librería para el cifrado en base64 del voto

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
- js-base64: 2.4.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''

== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

== Código de respuesta del servidor HTTP ==

Para nuestra API, hemos definido los siguientes códigos de respuestas del servidor HTTP:

{| border="1" style="border-collapse:collapse"
|-
! Código
! Valor result
! Valor msg
! Posible motivo
|-
| 200
| true
| Successfull
|El usuario ha realizado correctamente el voto
|-
| 404
| false
| User not found
| El usuario no ha realizado correctamente el voto
|-
| 403
| false
| Don't have access
| El usuario ha realizado correctamente el voto pero no tiene los permisos necesarios para el procesamiento de su voto
|}

Cabina de votaciones - 17 18

2017-12-05T16:57:46Z

Ignalelop: Añadido el formato de las incidencias

Cabina de votaciones - 17 18 - G2

2017-12-02T16:31:20Z

Ignalelop: /* APIs y datos que se usarán y devolverán */ Mejorado los tipos de errores de permisos de voto

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.
- "user_not_found" El usuario introducido no existe.
- "election_not_found" La votación introducida no existe.
- "election_not_open" La votación no ha abierto todavía el plazo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

Cabina de votaciones - 17 18 - G2

2017-11-30T11:51:07Z

Ignalelop: /* Plantillas HTML */ cerrados los búcles y condicionales del código Jinja2

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% endfor %}
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
{% endif %}
{% endif %}
{% endfor %}
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

Cabina de votaciones - 17 18 - G2

2017-11-30T10:44:30Z

Ignalelop: /* APIs y datos que se usarán y devolverán */ Eliminados métodos que colisionaban con otros módulos

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% if questions.filter(
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

Cabina de votaciones - 17 18 - G2

2017-11-30T10:37:43Z

Ignalelop: /* Plantillas HTML */ Actualizadas con el formato de Jinja2

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Obtención de un voto''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y 
Parámetros:
id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y 
Parámetros:
encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},
"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

{% block body %}
<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
{% for question in election.preguntas %}
<\p>Pregunta {% question.nombre %}<\/p> 
<\span>{% question.descripcion %}<\/span> 
{% if question.tipo_pregunta == "Cerrada" 
{% if questions.filter(
{% for answer in question.respuestas %} 
<select> 
<option value="{% answer.seleccionada %}">{% answer.texto_pregunta %} 
</select> 
{% if question.tipo_pregunta == "Abierta" %} 
<label...>{% question.texto_pregunta %}</label> 
<input value="{% question.answers[0].texto_respuesta" /> 
<\hr/> 
<button>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX>{% election.nombre %}</hX> 
<\hr/> 
<\p>{% election.descripcion %}<\/p> 
<\hr/> 
<\p>Gracias por responder a {% election.nombre %}<\/p> 
<button>Finalizar</button>

Cabina de votaciones - 17 18 - G2

2017-11-28T19:30:24Z

Ignalelop: Cambiado el formato de los de forma que puedan mostrarse

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null] 
encrypted_answers: (string) es un string con el contenido de la votación cifrado. 

'''Obtención de un voto''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y 
Parámetros:
id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y 
Parámetros:
encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},
"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Pregunta <-- X --><\/p> 
<\span><-- Texto de la preguna X --><\/span> 
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %> 
<select> 
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta --> 
</select> 
<% En el caso de que se trate de una respuesta donde habrá que poner texto %> 
<label...><-- Texto de la pregunta --></label> 
<input value="<-- Valor de la pregunta -->" /> 
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %> 
<\hr/> 
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p> 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18 - G2

2017-11-28T19:28:59Z

Ignalelop: Mejorado el estilo y añadida una nueva funcionalidad a la API

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable] 
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null] 
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros:
id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET 
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y 
Parámetros:
encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},
"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Consulta de permisos de voto'''
Tipo: GET 
URL: http://egc-cabina.es/api/check/vote.json?user=x&election=y 
Parámetros:
user: Nombre de usuario al que comprobar si puede votar
election: Identificador de la votación a comprobar
Formato JSON Ejemplo, usuario "user" puede votar en "election":

{
"result": true,
"reason": "can_vote"
}

Otras consideraciones: "reason" determina la razón de por qué no puede votar y pueden ser alguno de los siguientes: 
- "can_vote" El usuario puede votar.
- "already_voted" El usuario ha realizado su voto y la votación es de un sólo voto, por lo tanto no podrá votar.
- "cant_vote" El usuario no pertenece a un grupo de votación.

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Pregunta <-- X --><\/p> 
<\span><-- Texto de la preguna X --><\/span> 
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %> 
<select> 
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta --> 
</select> 
<% En el caso de que se trate de una respuesta donde habrá que poner texto %> 
<label...><-- Texto de la pregunta --></label> 
<input value="<-- Valor de la pregunta -->" /> 
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %> 
<\hr/> 
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p> 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-27T18:35:36Z

Ignalelop: /* Modelo de uso del repositorio */ actualizado el link a los repositorios

Cabina de votaciones - 17 18

2017-11-27T18:34:19Z

Ignalelop: /* Commits */ mejora de estilo

Cabina de votaciones - 17 18

2017-11-27T18:33:38Z

Ignalelop: /* Ramas */ mejora de estilo

Cabina de votaciones - 17 18

2017-11-27T18:32:03Z

Ignalelop: /* Ramas */ Mejorado el estilo

Cabina de votaciones - 17 18

2017-11-27T18:30:56Z

Ignalelop: /* Commits */ Mejorado el estilo

Cabina de votaciones - 17 18

2017-11-27T18:29:50Z

Ignalelop: Eliminada la especificación de la API (se encuentra en el espacio de trabajo) y añadida la descripción del modelo de uso

Cabina de votaciones - 17 18 - G2

2017-11-27T12:31:50Z

Ignalelop: Migrada la especificación de la API y tecnologías al espacio de trabajo

== Objetivo del subsistema ==
Permitir la votación para las distintas votaciones disponibles en el sistema.

== Consideraciones ==
* Debe comprobar que el usuario autenticado tiene permiso para participar en la votación indicada
* Se debe encargar de la encriptación del voto para que se envíe de manera segura
* Repositorio del año pasado: https://github.com/AgoraUS-G1-1617/Cabina-de-votaciones
* Wiki de la asignatura referente al submodulo (año pasado): https://1984.lsi.us.es/wiki-egc/index.php/Cabina_de_votación_1617_G1

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Pregunta <-- X --><\/p> 
<\span><-- Texto de la preguna X --><\/span> 
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %> 
<select> 
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta --> 
</select> 
<% En el caso de que se trate de una respuesta donde habrá que poner texto %> 
<label...><-- Texto de la pregunta --></label> 
<input value="<-- Valor de la pregunta -->" /> 
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %> 
<\hr/> 
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p> 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-27T12:14:52Z

Ignalelop: Mejorado de nuevo el estilo, para permitir que la sección de especificación de la API quede con estilo de código, al igual que las plantillas HTML

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación 
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8) 
Bibliotecas: 
- restify: 6.3.4 
- rest: 2.0.0 
- lodash: 4.17.4 
- async: 2.6.0 
Sistema de gestión de bibliotecas: npm 
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado). 

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Pregunta <-- X --><\/p> 
<\span><-- Texto de la preguna X --><\/span> 
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %> 
<select> 
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta --> 
</select> 
<% En el caso de que se trate de una respuesta donde habrá que poner texto %> 
<label...><-- Texto de la pregunta --></label> 
<input value="<-- Valor de la pregunta -->" /> 
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %> 
<\hr/> 
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p> 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-25T20:11:29Z

Ignalelop: Añadido un espaciado para mejorar la disposición del texto de las plantillas

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8)
Bibliotecas:
- restify: 6.3.4
- rest: 2.0.0
- lodash: 4.17.4
- async: 2.6.0
Sistema de gestión de bibliotecas: npm
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado).

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Pregunta <-- X --><\/p> 
<\span><-- Texto de la preguna X --><\/span> 
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %> 
<select> 
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta --> 
</select> 
<% En el caso de que se trate de una respuesta donde habrá que poner texto %> 
<label...><-- Texto de la pregunta --></label> 
<input value="<-- Valor de la pregunta -->" /> 
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %> 
<\hr/> 
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button> 

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX> 
<\hr/> 
<\p><-- Descripción de la encuesta --><\/p> 
<\hr/> 
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p> 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-25T20:10:19Z

Ignalelop: Mejorado el estilo de la página e incluida una leyenda del esquema usado

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8)
Bibliotecas:
- restify: 6.3.4
- rest: 2.0.0
- lodash: 4.17.4
- async: 2.6.0
Sistema de gestión de bibliotecas: npm
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado).

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

Leyenda:
- <-- variable --> Esta sección será reemplazada por un texto que sea más cercano a lo especificado en el interior de la sección
- <% Comentario %> Comentario
- <hX> Un texto de alto tamaño
- <\hr/> Una barra horizontal u alguna otra forma de separación.
- <\p/> Un parrafo, preferible de una única linea
- <\span/> Un parrafo de varias lineas

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX>
<\hr/>
<\p><-- Descripción de la encuesta --><\/p>
<\hr/>
<\p>Pregunta <-- X --><\/p>
<\span><-- Texto de la preguna X --><\/span>
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %>
<select>
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta -->
</select>
<% En el caso de que se trate de una respuesta donde habrá que poner texto %>
<label...><-- Texto de la pregunta --></label>
<input value="<-- Valor de la pregunta -->" />
<% En el caso de existir una pregunta donde se requiera una selección y también un input de pregunta, mezclar las dos disposiciones anteriores %>
<\hr/>
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button>

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX>
<\hr/>
<\p><-- Descripción de la encuesta --><\/p>
<\hr/>
<\p>Gracias por responder a <-- Nombre de la encuesta --><\/p>
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-25T20:05:04Z

Ignalelop: Mejorado de nuevo el estilo de las plantillas HTML

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8)
Bibliotecas:
- restify: 6.3.4
- rest: 2.0.0
- lodash: 4.17.4
- async: 2.6.0
Sistema de gestión de bibliotecas: npm
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado).

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

<hX><-- Nombre de la encuesta --></hX>
<hr/>
<-- Descripción de la encuesta -->
<hr/>
Pregunta <-- X -->
<-- Texto de la preguna X -->
<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %>
<select>
<option value="<-- Valor de la respuesta -->"><-- Texto de la respuesta -->
</select>
<% En el caso de que se trate de una respuesta donde habrá que poner texto %>
<label...><-- Texto de la pregunta --></label>
<input value="<-- Valor de la pregunta -->" />
<hr/>
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button>

'''Final de la votación de la encuesta'''

<hX><-- Nombre de la encuesta --></hX>
<hr/>
<-- Descripción de la encuesta -->
<hr/>
Gracias por responder a <-- Nombre de la encuesta -->
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-25T20:03:42Z

Ignalelop: Mejorado el estilo de la página

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8)
Bibliotecas:
- restify: 6.3.4
- rest: 2.0.0
- lodash: 4.17.4
- async: 2.6.0
Sistema de gestión de bibliotecas: npm
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado).

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1

{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.

{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

<hX></hX>
<hr/>

<hr/>
Pregunta 

<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %>
<select>
<option value="">
</select>
<% En el caso de que se trate de una respuesta donde habrá que poner texto %>
<label...></label>
<input value="" />
<hr/>
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button>

'''Final de la votación de la encuesta'''

<hX></hX>
<hr/>

<hr/>
Gracias por responder a 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>

Cabina de votaciones - 17 18

2017-11-25T20:02:09Z

Ignalelop: Mejorada (por parte de Javier) la descripción de la API y añadidas las plantillas HTML.

'''
== Resumen del trabajo ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''
== Objetivo del subsistema ==
'''
Nuestro trabajo consistirá en realizar el apartado de cabina de votación que consiste en permitir mediante el uso de un conjunto de métodos la posibilidad de que los usuarios puedan votar anónimamente teniendo en cuenta las restricciones posibles que puedan existir.

'''Tecnologías que se usarán''':
Subsistema: Cabina de votación
Lenguaje/Herramienta: Node.js 9.2 (Javascript v8)
Bibliotecas:
- restify: 6.3.4
- rest: 2.0.0
- lodash: 4.17.4
- async: 2.6.0
Sistema de gestión de bibliotecas: npm
Base de datos: No (Aunque es necesaria alguna forma de verificar los votos a partir del usuario encriptado).

'''
== APIs y datos que se usarán y devolverán ==
'''

'''Estructura de un voto''':

id: (int) identificador del voto [pk, autoincrementable]
encrypted_user: (string) identificador del usuario que ha votado de forma encriptada, es única y es posible verificar el voto (voto anónimo) [unique, not null]
id_election: (int) identificador de la votación [fk, not null]
encrypted_answers: (string) es un string con el contenido de la votación cifrado.

'''Obtención de un voto''':
Tipo: GET
URL: http://egc-cabina.es/api/get/vote.json?id=x&id_election=y
Parámetros: id_vote: Identificador del voto (x)
id_election: Identificador de la elección del voto (y)
Formato JSON Ejemplo: Obtención del voto 1
<nowiki>
{
"vote": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_answers": "..."
}
}</nowiki>

'''Consulta de votos''':
Tipo: GET
URL: http://egc-cabina.es/api/get/votes.json?encrypted_user=x&id_election=y
Parámetros: encrypted_user: (opcional) Identificador del usuario encriptado. (x)
id_election (opcional) Identificador de la votación (y)
Formato JSON Ejemplo: Buscando la votación 165

<nowiki>
{
"votos": {
"vote1": {
"id": "1",
"encrypted_user": "xgs5fdy2",
"id_election": "165",
"encrypted_anwers": "..."
},

"voto2": {
"id": "2",
"encrypted_user": "whedvsg3",
"id_election": "165",
"encrypted_anwers": "..."
}
}
}</nowiki>

'''Creación de voto''':
Tipo: POST
URL: http://egc-cabina.es/api/create/vote.json
Parámetros: id_user: (int) Identificador del usuario (sin encriptar)
id_election: (int) Identificador de la votación
answers: (list[string]) Lista con las respuestas de la votación de forma ordenada (en la posición 1 estará la respuesta a la pregunta 1 de la votación)
Formato JSON Ejemplo: Creando un voto por el usuario 23, la votación 34, el grupo de usuarios 13.
<nowiki>
{
"result": true,
"vote": {
"id": "1",
"encrypted_user": "as5d8gr4",
"id_election": "34",
"id_group": "13",
"encrypted_answers": "..."
}
}</nowiki>

== Plantillas HTML ==

Se tiene pensado que el formato de la cabina de votación sea el siguiente:

'''Votación de la pregunta X'''

<nowiki>
<hX></hX>
<hr/>

<hr/>
Pregunta 

<% En el caso de que se trate de una lista de posibles opciones donde sólo se selecciona una %>
<select>
<option value="">
</select>
<% En el caso de que se trate de una respuesta donde habrá que poner texto %>
<label...></label>
<input value="" />
<hr/>
<button <% Botón de siguiente pregunta %>>Siguiente pregunta</button>
</nowiki>

'''Final de la votación de la encuesta'''

<nowiki><hX></hX>
<hr/>

<hr/>
Gracias por responder a 
<button>Finalizar</button> <% Con este botón, se enviaría a la cabina de votación el voto y los credenciales del usuario que lo ha creado %>
</nowiki>