Wiki de EGC - Contribuciones del usuario [es]

Administración de votaciones - 17 18 - G2

2017-12-17T17:41:20Z

Jesmarale: /* Eliminación de una respuesta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaCreate

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar (Inicialmente estará a false y al crearse no podrá editarse)

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaCreate?id_pregunta=1&texto_respuesta=Ejemplo

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "false",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaEdit.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaEdit.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/respuesta.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:58:00Z

Jesmarale: /* Edición de una respuesta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaCreate

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar (Inicialmente estará a false y al crearse no podrá editarse)

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaCreate?id_pregunta=1&texto_respuesta=Ejemplo

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "false",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaEdit.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaEdit.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:57:33Z

Jesmarale: /* Obtención de todas las respuestas de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaCreate

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar (Inicialmente estará a false y al crearse no podrá editarse)

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaCreate?id_pregunta=1&texto_respuesta=Ejemplo

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "false",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:25:10Z

Jesmarale: /* Creación de una respuesta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/respuestaCreate

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar (Inicialmente estará a false y al crearse no podrá editarse)

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/respuestaCreate?id_pregunta=1&texto_respuesta=Ejemplo

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "false",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:24:38Z

Jesmarale: /* Creación de una respuesta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar (Inicialmente estará a false y al crearse no podrá editarse)

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "false",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:17:50Z

Jesmarale: /* Creación de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaCreate

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.esapi/post/preguntaCreate?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T11:17:00Z

Jesmarale: /* Eliminación de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaDelete.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/preguntaDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T10:57:08Z

Jesmarale: /* Edición de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''

* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T10:56:53Z

Jesmarale: /* Edición de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-17T10:56:40Z

Jesmarale: /* Edición de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/preguntaEdit.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra
* respuestas: parametro para identificar las respuestas asociadas (Por id, ejemplo: [1,2])

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
"respuestas": "[1,2]"
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-16T17:02:25Z

Jesmarale: /* Edición de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-16T17:01:25Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17 10:30&fecha_fin=11/10/17 10:30

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-16T16:47:31Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"clave": "clave"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-14T22:02:31Z

Jesmarale: /* Obtención de todas las preguntas de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
"id_respuestas":"[1,9]"
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-14T22:00:38Z

Jesmarale: /* Obtención de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
"id_preguntas": "[2,3]"

}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-14T21:59:51Z

Jesmarale: /* Obtención de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
"id_respuestas":"[2,5]"
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-14T20:52:44Z

Jesmarale: /* Eliminación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionDelete.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/post/votacionDelete.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
Esta sería la plantilla para el formulario que permitiría crear una votación.
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-13T22:06:50Z

Jesmarale: /* Edición de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/editVotacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/editVotacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-13T21:53:13Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate.json?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-13T21:49:36Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacionCreate

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-13T21:40:41Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación
* clave: clave para asignar a la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-12T20:14:46Z

Jesmarale: /* Creación de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

Es probable que otros subsistemas necesiten funciones API que no ofrezcamos, por lo que crearemos los métodos necesarios que puedan ir surgiendo durante el proyecto.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/votacionCreate?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
En este apartado se mostrarán los templates de las distintas vistas que nuestro subsistema requiere
==Template Creación==
<nowiki>
<html lang="es">
<head>
<meta charset="utf-8"/>
<title>Administracion de votaciones</title>
</head>
<body>
<form method="post">
<label for="titulo">Name:</label>
<input name="titulo" type="text" value=""/>
<br />
<div>
<label for="censo">Censo:</label>
<select id="censo" name="id_censo" required>
<option value="">Seleccione un grupo</option>
<option value="id_c1">Censo A</option>
<option value="id_c2">Censo B</option>
<option value="id_c3">Censo C</option>
<option value="id_c4">...</option>
</select>
</div>
<div>
<label for="votacion"> Votación:</label>
<select id="votacion" name="id_votacion" required>
<option value="">Seleccione una votación</option>
<option value="id_v1">Votación tipo A</option>
<option value="id_v2">Votación tipo B</option>
<option value="id_v3">Votación tipo C</option>
<option value="id_v4">...</option>
</select>
</div>
<label for="pregunta1">Pregunta 1: ¿ Asistió a las jornadas de EGC ?</label>
<input type="radio" name="respuesta1" value="si" checked> Sí<br>
<input type="radio" name="respuesta1" value="no" checked> No<br>
{% if respuesta1.value=="si" %}
<label for="pregunta2">Pregunta 2: Califique la organización de estas</label>
<input type="radio" name="respuesta2" value="excelente" checked> excelente<br>
<input type="radio" name="respuesta2" value="muy buena" checked> muy buena<br>
<input type="radio" name="respuesta2" value="buenisima" checked> buenisima<br>
<input name="" type="submit" value="Save"/>
</form>
</body>
</html>
</nowiki>

= Gestión de grupo =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types:

add: Una nueva caracteristica.
fix: Se soluciono un bug.
docs: Se realizaron cambios en la documentacion.
style: Se aplico formato, comas y puntos faltantes, etc; Sin cambios en el codigo.
refactor: Refactorizacion del codigo en produccion.
test: Se añadieron pruebas, refactorizacion de pruebas; Sin cambios en el codigo.
chore: Actualizacion de tareas de build, configuracion del admin. de paquetes; Sin cambios en el codigo.

Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Las funcionalidades pueden ser genéricas o específicas.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-06T17:33:26Z

Jesmarale: /* Obtención de una respuesta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Obtención de todas las respuestas de una pregunta ===

Se hace una petición GET con la id de la preguntay se devolverá un JSON con un array de respuestas.

'''URL:'''
http://egc-votacion1718.es/api/get/respuestas.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/preguntas.json?id=1

'''Formato JSON:'''

[{
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
},
{

"id": "4",
"id_pregunta": "1",
"texto_respuesta": "¿Que consola prefieres?",
"seleccionada": "true",
}]

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=

EN CONTRUCCIÓN

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types: add(función añadida) y fix (error subsanado).
Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Si fuera necesario se crearán nuevas funcionalidades.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-06T17:31:26Z

Jesmarale: /* Obtención de todas las preguntas de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

'''URL:'''
http://egc-votacion1718.es/api/get/preguntas.json

'''Parámetros:'''
* id: Identificador de la votacion.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuestas.json?id=1

'''Formato JSON:'''

[{
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=

EN CONTRUCCIÓN

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types: add(función añadida) y fix (error subsanado).
Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Si fuera necesario se crearán nuevas funcionalidades.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-06T17:24:47Z

Jesmarale: /* Obtención de todas las preguntas de una votación */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98
* Dependencias con otros módulos: Recibimos datos de "Autenticación" y "Censo", enviamos datos a "Cabina de votaciones"

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

=== Obtención de todas las preguntas de una votación ===

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

[{

"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=

EN CONTRUCCIÓN

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types: add(función añadida) y fix (error subsanado).
Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Si fuera necesario se crearán nuevas funcionalidades.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-06T17:23:58Z

Jesmarale: /* Obtención de una pregunta */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98
* Dependencias con otros módulos: Recibimos datos de "Autenticación" y "Censo", enviamos datos a "Cabina de votaciones"

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí, se usará MySQL Workbench. Habrá 3 tablas (Votación, Pregunta Respuesta).

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Votación ==
Definimos las API que dependerán del objeto "Votación"

=== Obtención de una votación ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Creación de una votación ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Pregunta ==
Definimos las API que dependerán del objeto "Pregunta"

=== Obtención de una pregunta ===

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
}
}

== Obtención de todas las preguntas de una votación ==

Se hace una petición GET con la id de la votación y se devolverá un JSON con un array de votaciones.

[{

"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abierta",
"id_dependencia": "2",
},
{

"id": "8",
"id_votacion": "1",
"texto_pregunta": "¿Que consola prefieres?",
"tipo_pregunta": "Abierta",
"id_dependencia": "7",
}]

=== Creación de una pregunta ===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

=== Edición de una pregunta===

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

=== Eliminación de una pregunta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Respuesta ==
Definimos las API que dependerán del objeto "Respuesta"

=== Obtención de una respuesta ===
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

=== Creación de una respuesta ===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "Consola",
"seleccionada": "true",
}
}

=== Edición de una respuesta===
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

=== Eliminación de una respuesta ===

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=

EN CONTRUCCIÓN

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types: add(función añadida) y fix (error subsanado).
Ejemplos de funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Si fuera necesario se crearán nuevas funcionalidades.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''requirement'': para el cumplimiento de requisitos de nuestro subsistema.
''enhancement'': propuesta de mejora.
''bug'': fallos encontrados en el sistema.
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro.
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión.
''wontfix'': incidencias que no serán resueltas por el momento.

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-06T15:33:26Z

Jesmarale: /* Estructura de datos */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98
* Dependencias con otros módulos: Recibimos datos de "Autenticación" y "Censo", enviamos datos a "Cabina de votaciones"

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí (Ninguna empleada actualmente, a la espera de directrices)

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
- clave: (String) clave que se usará para cifrar los votos [not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Obtención de una votación ==

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Creación de una votación ==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Edición de una votación==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Eliminación de una votación ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Obtención de una pregunta ==

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

== Creación de una pregunta ==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

== Edición de una pregunta==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

== Eliminación de una pregunta ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Obtención de una respuesta ==
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

== Creación de una respuesta ==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

== Edición de una respuesta==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

== Eliminación de una respuesta ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

=Template=
El template de jinja2 de nuestro subsistema es la siguiente

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".
Cada semana todos los miembros se reunirán para hablar del estado actual, los problemas encontrados y los siguientes pasos a seguir.

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

===Formato de commits===

El formato general de los commits parte de la siguiente base.
Diferenciaremos dos tipos básicos(types). Luego un breve título que resuma la funcionalidad de dicho commit. En la descripción añadiremos a que funcionalidad pertenece y una descripción. Al final del commit podemos añadir a que incidencia pertenece, si procede.

Types: add(función añadida) y fix (error subsanado).
Funcionalidades: Editar votación,Crear votación, Borrar votación y Desarrolllo API. ''Si fuera necesario se crearán nuevas funcionalidades.''

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Emision Voto - Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

===Gestión de ramas===

Tendremos la rama "master" donde estará todo nuestro código estable, una rama "development" donde se unirán las ramas de desarrollo para ser validadas, y una vez validada pasará a la rama master. Por último cada miembro tendrá su propia rama de desarrollo (usuario UVUS), para evitar posibles errores a la hora de unir las ramas, cada miembro deberá de programar la funcionalidad o el trozo de código que se le ha sido asignado.

[[Archivo:Gestion_ramas.JPG|center|thumb|1000px|link=https://1984.lsi.us.es/wiki-egc/images/egc/a/af/Gestion_ramas.JPG]]

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Además, crearemos un proyecto "Administración de votaciones" al que asignar dichas incidencias.
Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''Open'', ''En curso'', ''Finalizado''. Los dos primeros estados estarán por defecto al crear al issues, se considerará "En curso" cuando la issues este asignada y abierta. El último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''enhancement'': propuesta de mejora
''bug'': fallos encontrados en el sistema
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del Coordinador y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-03T17:47:11Z

Jesmarale: /* API */

= Miembros y contacto =

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

= Especificaciones =

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/EGC-G2-Trabajo-1718/AdministracionVotaciones
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98
* Dependencias con otros módulos: Recibimos datos de "Autenticación" y "Censo", enviamos datos a "Cabina de votaciones"

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': Java 1.8 -> Eclipse Jee Neon 3
'''Sistema de gestión de bibliotecas''': Maven
'''Bibliotecas''':
'''Jackson (Para API)'''
'''Necesita Base de datos''': Sí (Ninguna empleada actualmente, a la espera de directrices)

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_respuesta: (string/varchar) texto de la respuesta [blank, not null]
- seleccionada: (boolean) parámetro para establecer la selección de la respuesta

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

= API =
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

== Dependencias ==
En primer lugar estableceremos cuales van a ser las dependencias de nuestro módulo con otros.

Por una parte, necesitaremos información a cerca de si el usuario tiene los permisos necesarios para crear, editar o borrar una votación. Obtendremos esta información recibiendo los datos pertinentes del módulo de "Autenticación", para que a la hora de crear una votación se le asignen los permisos con los que se podrá crear.

Por otro lado, necesitamos saber qué usuarios van a poder votar en dicha votación. Para ello necesitaremos obtener esta información recibiendo los datos necesarios del módulo de "Censo", para que a la hora de crear la votación también podamos asignar al grupo de usuarios que podrán votar.

Para terminar, nuestro módulo deberá poder ofrecer la información completa de la votación al módulo de "Cabina de votación" para que se lleve a cabo. Para ello, ofreceremos una API que procedemos a definir.

== Obtención de una votación ==

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Creación de una votación ==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/create

'''Parámetros:'''
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/create?id_censo=1&id_grupo=2&titulo=Prueba&descripcion=Descripcion&fecha_ini=10/10/17&fecha_fin=11/10/17

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Edición de una votación==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

== Eliminación de una votación ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Obtención de una pregunta ==

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/pregunta.json?id=7

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

== Creación de una pregunta ==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createPregunta

'''Parámetros:'''
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createPregunta?id_votacion=1&texto_pregunta=Ejemplo&tipo_pregunta=Abierta&id_dependencia=2

'''Formato JSON:'''
{
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}
}

== Edición de una pregunta==

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionPregunta.json

'''Parámetros:'''
* id: identificador de la pregunta a editar
* id_votación: identificador de la votación a la que pertenece
* texto_pregunta: texto de la pregunta que se realiza
* tipo_pregunta: parametro para establecer el tipo de pregunta
* id_dependencia: parametro para identificar si la pregunta depende de otra

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionPregunta.json?id=1&id_votacion=3&texto_pregunta=Prueba&tipo_pregunta=Cerrada&id_dependencia=8

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"pregunta": {
"id": "7",
"id_votacion": "1",
"texto_pregunta": "¿Prefieres consola o pc?",
"tipo_pregunta": "Abiera",
"id_dependencia": "2",
}

== Eliminación de una pregunta ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/pregunta.json

'''Parámetros:'''
* id: Identificador de la pregunta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

== Obtención de una respuesta ==
Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/respuesta.json?id=3

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

== Creación de una respuesta ==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/createRespuesta

'''Parámetros:'''
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se puede seleccionar
* seleccionada: parametro para indicar si esa pregunta se puede seleccionar

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/createRespuesta?id_pregunta=1&texto_respuesta=Ejemplo&seleccionada=true

'''Formato JSON:'''
{
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}
}

== Edición de una respuesta==
Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/post/edicionRespuesta.json

'''Parámetros:'''
* id: identificador de la respuesta a editar
* id_pregunta: identificador de la pregunta a la que pertenece
* texto_respuesta: texto de la respuesta que se realiza
* seleccionada: parametro para indicar si se ha seleccionado la respuesta

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/post/edicionRespuesta.json?id=1&id_pregunta=3&texto_respuesta=Prueba&seleccionada=true

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"respuesta": {
"id": "3",
"id_pregunta": "1",
"texto_respuesta": "¿Prefieres consola o pc?",
"seleccionada": "true",
}

== Eliminación de una respuesta ==

Se hace una petición DELETE (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/delete/respuesta.json

'''Parámetros:'''
* id: Identificador de la respuesta a eliminar.

'''Ejemplo:'''
DELETE http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}

= Gestión =

== Gestión de la comunicación ==

Se realizará la comunicación mediante la aplicación "Telegram", creando un grupo en el que se encuentran todos los miembros del equipo. Las reuniones no presenciales serán gestionadas telematicamente con "Skype".

== Gestión del trabajo ==

La gestión del trabajo, la creación de tareas y la asignación de las mismas se harán mediante la plataforma "Trello". Se crearán los siguientes tableros:
* Lista de tareas: Se añadirán las tareas que se vayan identificando durante el desarrollo del trabajo.
* En proceso: Se añadirán las tareas a este tablero una vez se asignen y se empiecen a trabajar.
* En revisión: Se añadirán las tareas finalizadas a falta de una revisión por el resto del equipo.
* Hecho: Se añadirán las tareas terminadas una vez revisadas.
* Q&A: Tablero para preguntas y respuestas.

== Gestión del código ==

Gestionaremos el código a desarrollar mediante la plataforma "GitHub".

Nuestra rama master contendrá la última versión estable, y de ella sacaremos una rama para cada funcionalidad del módulo que implementemos (Editar,Crear,Borrar votación). Una vez finalizadas las pruebas de cada funcionalidad, se procederá a hacer un merge de cada rama con la rama master.

'''Formato general de commits'''

El formato general de los commits parte de la siguiente base.
Es importante diferenciar entre los tipos (types) y usar todos en la medida de lo posible. Los ámbitos o focos (scopes) pueden emplearse para hacer referencia a distintas funcionalidades (features).

A continuación se detalla un ejemplo:

Título del commit: fix: redirección errónea tras emitir voto.
Cuerpo del commit: Después de que el usuario emitiese su voto este era redireccionado a una URL no existente. Ahora el usuario es redireccionado al panel
principal.
Pie del commit: Closes #<número de la incidencia en GitHub>.

== Gestión de incidencias ==

Gestionaremos las incidencias que vayan apareciendo durante el trabajo con la herramienta propia de GitHub.

Crearemos en primer lugar un Milestone en GitHub por cada Milestone de la asignatura para saber el plazo que tenemos para resolver la incidencia y a ellos asignaremos las incidencias (Según proceda). Además, crearemos un proyecto "Administración de votaciones" al que asignar dichas incidencias.
Usaremos las labels por defecto de GitHub, y crearemos nuevas si fuese necesario.

=== Plan de actuación ===

Las incidencias se tratarán con la siguiente nomenclatura:

'''Título''': <breve título>
'''Prioridad''': a seleccionar: ''urgente'', ''alto'', ''medio'', ''bajo''.
'''Estado''': ''pendiente'', ''en curso'', ''finalizado''. Los dos primeros estados deberían meterse como etiquetas en GitHub, el último estado se prouduce cuando se cierra la incidencia en GitHub.
'''Descripción''': <descripción detallada de la incidencia>
La descripción puede incluir imagenes o la salida emitida por la incidencia.
'''Etiquetas''': <etiquetas de GitHub para clasificar las incidencias>
''enhancement'': propuesta de mejora
''bug'': fallos encontrados en el sistema
''help wanted'': incidencia que puede ser resuelta por un miembro del equipo pero que ha sido atendida previamente por otro
''question'': (a usar solo entre miembros del equipo) dudas sobre un commit en concreto, hay que referenciar el commit en cuestión

El plan de actuación cuando se encuentre una incidencia será el siguiente:
* Se identificará cual es la incidencia.
* Añadiremos dicha incidencia con la nomenclatura descrita en github al proyecto, milestone y label que corresponda.
* En caso de no tener claro quien podría resolver la incidencia, se notificará al coordinador del grupo via "Telegram" para que la revise y asigne según su criterio; además de al resto del equipo por "Telegram".
* Una vez resuelta (Antes del plazo del Milestone asignado) se cerrará en "GitHub", previa validación del jefe de proyecto y el creador de la issue. Se notificará por "Telegram" al equipo.

Administración de votaciones - 17 18 - G2

2017-12-03T17:37:16Z

Jesmarale: /* Estructura de datos */

Administración de votaciones - 17 18 - G2

2017-12-03T17:36:07Z

Jesmarale: /* API */

Administración de votaciones - 17 18 - G2

2017-12-03T17:35:02Z

Jesmarale: /* API */

Administración de votaciones - 17 18 - G2

2017-12-03T16:55:30Z

Jesmarale: /* Tecnología usada */

Administración de votaciones - 17 18 - G2

2017-12-02T18:57:45Z

Jesmarale: /* Tecnología usada */

Administración de votaciones - 17 18 - G2

2017-11-30T20:44:05Z

Jesmarale: /* Tecnología usada */

Administración de votaciones - 17 18 - G2

2017-11-30T20:43:53Z

Jesmarale: /* Tecnología usada */

Administración de votaciones - 17 18 - G2

2017-11-30T20:39:36Z

Jesmarale: /* Consideraciones */

Administración de votaciones - 17 18 - G2

2017-11-27T15:43:04Z

Jesmarale: /* Edición de una votación */

Administración de votaciones - 17 18 - G2

2017-11-27T15:42:51Z

Jesmarale: /* Edición de una votación */

Administración de votaciones - 17 18 - G2

2017-11-27T15:41:14Z

Jesmarale: /* Creación de una votación */

Administración de votaciones - 17 18 - G2

2017-11-27T15:40:56Z

Jesmarale: /* Creación de una votación */

Administración de votaciones - 17 18 - G2

2017-11-27T15:40:34Z

Jesmarale: /* API */

Administración de votaciones - 17 18 - G2

2017-11-25T18:05:42Z

Jesmarale: /* Eliminación de una votación */

Administración de votaciones - 17 18 - G2

2017-11-25T17:53:46Z

Jesmarale: /* API */

Administración de votaciones - 17 18 - G2

2017-11-25T17:46:21Z

Jesmarale:

Administración de votaciones - 17 18 - G2

2017-11-25T17:13:30Z

Jesmarale: Página creada con «== Miembros y contacto == * Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador''' * Francisco Fernández Angulo * Jesús Martos Alé * Miguel Medrano Gil...»

== Miembros y contacto ==

* Pablo Tinoco Castillo, ''ptinococastillo@gmail.com'' '''Coordinador'''
* Francisco Fernández Angulo
* Jesús Martos Alé
* Miguel Medrano Gil
* Gonzalo Trabado García

== Objetivo del subsistema ==
* Gestionar la creación de una votación
* Gestionar la edición de una votación
* Gestionar el borrado de una votación

== Consideraciones ==
* Repositorio del proyecto: https://github.com/martos93/EGC1718
* Página Opera: http://opera.eii.us.es/egc/public/trabajo/ver/id/98
* Dependencias con otros módulos: Recibimos datos de "Autenticación" y "Censo", enviamos datos a "Cabina de votaciones"

== Tecnología usada ==

'''Subsistema''': Administración de votaciones
'''Lenguaje/Herramienta''': PHP -> PHPStorm
'''Sistema de gestión de bibliotecas''': ¿?
'''Bibliotecas''':
'''Larabel framework''': versión 5.5
'''Necesita Base de datos''': Sí (Ninguna empleada actualmente, a la espera de directrices)

== Estructura de datos ==

Haremos uso de la tablas votación, pregunta y respuesta:

Votación:
- id: (int) identificador de la votación [pk, autoincrementable]
- id_censo: (int) identificador del censo [fk, not null]
- id_grupo: (int) identificador del grupo que puede votar en la votación [fk, not null]
- titulo: (string/varchar) titulo de la votación a crear [blank, not null]
- descripcion: (string/varchar) descripción de los objetivos de la votación [blank, not null]
- fecha_ini: (datetime) fecha de inicio de la votación [not null, default=fecha_actual]
- fecha_fin: (datetime) fecha de fin de la votación[not null]
Pregunta:
- id: (int) identificador de la pregunta [pk, autoincrementable]
- id_votacion: (int) identificador de la votación a la que pertenece [fk, not null]
- texto_pregunta: (string/varchar) texto de la pregunta que se realiza [blank, not null]
- tipo_pregunta: (string/varchar ?) parametro para establecer el tipo de pregunta (Abierta, cerrada) [blank, not null]
- id_dependencia: (int) identificador para definir dependencias entre preguntas [fk]
Respuesta:
- id: (int) identificador de la respuesta [pk, autoincrementable]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- id_pregunta: (int) identificador de la pregunta [fk, not null]
- texto_pregunta: (string/varchar) texto de la respuesta [blank, not null]
- seleccionada: (boolean) parámetro para establecer la selección de la respuesta

Esta sería la estructura de las tablas sobre las que trabajaríamos, una votación tendrá varias preguntas que podrán ser abiertas o cerradas, y estas a su vez podrán depender de otras preguntas. Las preguntas podrán tener una o más respuestas.

== API ==
Las funcionalidades aquí descritas y especificadas no son finales. Debido a la diversidad de funcionalidades y necesidades de los otros grupos, éstas pueden variar a lo largo del desarrollo (sea debido al despliege, conflictos, etc).

=== Obtención de una votación ===

----

Se hace una petición GET con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/get/votacion.json?id=1

'''Formato JSON:'''
{
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Edición de una votación===

----

Se hace una petición POST (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: identificador de la votación
* id_censo: identificador del censo
* id_grupo: identificador del grupo que puede votar en la votación
* titulo: titulo de la votación a crear
* descripcion: descripción de los objetivos de la votación
* fecha_ini: fecha de inicio de la votación
* fecha_fin: fecha de fin de la votación

Aquellos parámetros que no se introduzcan no se modificarán.

'''Ejemplo:'''
POST http://egc-votacion1718.es/api/get/votacion.json?id=1&titulo=Titulo_modificado

'''Formato JSON:'''
{
"exito": true,
"mensaje": "Editado con éxito",
"votacion": {
"id": "1",
"id_censo": "288",
"id_grupo": "31",
"titulo": "Votación sobre consolas",
"descripción": "En esta votación comprobaremos si hay mas gamers de PC o consolas",
"fecha_ini": "31/07/2017 07:07",
"fecha_fin": "31/08/2017 07:07"
}
}

=== Eliminación de una votación ===

----

Se hace una petición GET (a través del formulario descrito en su correspondiente vista) con los parámetros siguientes y se devolverá un JSON con la siguiente información.

'''URL:'''
http://egc-votacion1718.es/api/get/votacion.json

'''Parámetros:'''
* id: Identificador de la votación a eliminar.

'''Ejemplo:'''
GET http://egc-votacion1718.es/api/delete/result.json?id=1
'''Formato JSON:'''
{
"exito": true,
"mensaje": "Eliminado con éxito"
}