</head>
<body>
<h1>Carátula</h1>
- <p><strong>Introducción a Sistemas Distribuídos (75.43)</strong></p>
+ <p><strong>Introducción a Sistemas Distribuidos (75.43)</strong></p>
<p>Trabajo Práctico Número 1</p>
<h2>Grupo</h2>
<dl>
</tr>
<tr>
<td>Jonathan Schein</td>
- <td>COMPLETAR</td>
- <td>COMPLETAR</td>
+ <td>80083</td>
+ <td>Actualización de información de FAQ's</td>
</tr>
<tr>
<td>Sebastián Arena</td>
- <td>COMPLETAR</td>
- <td>COMPLETAR</td>
+ <td>80367</td>
+ <td>Actualización de información de interés de otros sitios y comentarios</td>
</tr>
</table>
<h1>Índice</h1>
<li><a href="#desarrollo">Desarrollo</a></li>
<li><a href="#herramientas">Herramientas de desarrollo</a></li>
<li><a href="#configuracion">Configuración del servidor</a></li>
- <li><a href="#instalación">Instalación</a></li>
+ <li><a href="#instalacion">Instalación</a></li>
<li><a href="#uso">Modo de uso</a></li>
</ol>
<h1><a name="disenio">Diseño de las páginas</a></h1>
- <h2><a name="index_php">index.php</a></h2>
+ <h2><a name="modulo_admin">Modulo de Administración</a></h2>
+ <h3><a name="index_php">index.php</a></h3>
<p>
Esta página es el punto de partida del sistema. Normalmente se
encarga de mostrar el <a href="#admin_login_php"><span
se usa el sistema y todavía no hay 2 administradores asignados;
respectivamente).
</p>
- <h2><a name="admin_login_php">admin.login.php</a></h2>
+ <h3><a name="admin_login_php">admin.login.php</a></h3>
<p>
Es la página que realmente se encarga de hacer el
<span lang="en">login</span>. Debe ingresarse el código de usuario
<img src="admin.login.jpg"
alt="Captura de pantalla de admin.login.php" />
</div>
- <h2><a name="admin_logout_php">admin.logout.php</a></h2>
+ <h3><a name="admin_logout_php">admin.logout.php</a></h3>
<p>
Esta página, al igual que <a href="#index_php">index.php</a>, no
tiene contenido propio, sino que se encarga de borrar todos los
Si el usuario no existe, o si está mal el password, etc, se muestra
el correspondiente mensaje de error.
</p>
- <h2><a name="admin_asociarse_php">admin.asociarse.php</a></h2>
+ <h3><a name="admin_asociarse_php">admin.asociarse.php</a></h3>
<p>
Esta página asocia a un integrante del grupo (presente en el archivo
int_2005.txt si es socio o ase_2005.txt si es asesor). Si el sistema
<img src="admin.asociarse.jpg"
alt="Captura de pantalla de admin.asociarse.php" />
</div>
- <h2><a name="admin_log_php">admin.log.php</a></h2>
+ <h3><a name="admin_log_php">admin.log.php</a></h3>
<p>
Esta página muestra el <span lang="en">log</span> de actividades del
usuario. Permite elegir la fecha desde la cual se quieren ver las
<img src="admin.log.jpg"
alt="Captura de pantalla de admin.log.php" />
</div>
- <h2><a name="admin_creditos_php">admin.creditos.php</a></h2>
+ <h3><a name="admin_creditos_php">admin.creditos.php</a></h3>
<p>
En esta página el administrador puede agregar créditos a los
usuarios. Para realizar esta tarea el administrador debe ingresar su
<img src="admin.creditos.jpg"
alt="Captura de pantalla de admin.creditos.php" />
</div>
- <h2><a name="admin_admin_php">admin.admin.php</a></h2>
+ <h3><a name="admin_admin_php">admin.admin.php</a></h3>
<p>
A través de esta página un administrador puede <em>ceder</em> sus
permisos de administración. Una vez cedidos, este usuario dejará de
<img src="admin.admin.jpg"
alt="Captura de pantalla de admin.admin.php" />
</div>
- <!--
-
- COMPLETAR!!!!
-
- Template:
-
- <h2>.php</h2>
+ <h2><a name="modulo_faqs">Modulo de FAQs</a></h2>
+ <h3><a name="faq_listarPreguntas_php">faq.listarPreguntas.php</a></h3>
<p>
+ Esta pagina muestra la lista de preguntas ingresadas al sistema. Permite acceder
+ a las respuestas, y en caso de ser posible, darlas de alta. A los administradores,
+ tambien les permite acceder a la baja de preguntas.
</p>
<div align="center">
- <img src=".jpg"
- alt="Captura de pantalla de .php" />
+ <img src="faq.listarPreguntas.jpg"
+ alt="Captura de pantalla de faq.listarPreguntas.php" />
+ </div>
+ <h3><a name="faq_listarRespuestas_php">faq.listarRespuestas.php</a></h3>
+ <p>
+ Para cada una de las preguntas, se pueden ver desde esta pantalla las respuestas dadas
+ de alta. Las muestra por ranking. En caso de que la respuesta no haya sido calificada
+ aun y quien esta logueado es el autor de la pregunta, permite acceder a la pantalla de
+ calificaciones.
+ </p>
+ <div align="center">
+ <img src="faq.listarRespuestas.jpg"
+ alt="Captura de pantalla de faq.listarRespuestas.php" />
+ </div>
+ <h3><a name="faq_ingresarPregunta_php">faq.ingresarPregunta.php</a></h3>
+ <p>
+ Permite dar de alta una pregunta en el sistema. Es necesario que el usuario sea un asesor, o
+ tenga los creditos suficientes.
+ </p>
+ <div align="center">
+ <img src="faq.ingresarPregunta.jpg"
+ alt="Captura de pantalla de faq.ingresarPregunta.php" />
+ </div>
+ <h3><a name="faq_responderPregunta_php">faq.responderPregunta.php</a></h3>
+ <p>
+ La pantalla permite ingresar la respuesta a una pregunta seleccionada. Esta respuesta deberá
+ ser calificada por el autor de la pregunta posteriormente, y le permitirá al que responde, obtener
+ créditos.
+ </p>
+ <div align="center">
+ <img src="faq.responderPregunta.jpg"
+ alt="Captura de pantalla de faq.responderPregunta.php" />
+ </div>
+ <h3><a name="faq_calificarRespuesta_php">faq.calificarRespuesta.php</a></h3>
+ <p>
+ A esta pantalla solo accede el autor de la pregunta. Desde la misma puede calificar la respuesta.
+ Dependiendo de la calidad de la respuesta, quien la formulo podra obtener mas o menos créditos, para
+ de esta manera poder efectuar nuevas preguntas.
+ </p>
+ <div align="center">
+ <img src="faq.calificarRespuesta.jpg"
+ alt="Captura de pantalla de faq.calificarRespuesta.php" />
+ </div>
+ <h3><a name="faq_desactivarPregunta_php">faq.desactivarPregunta.php</a></h3>
+ <p>
+ La pantalla de baja de preguntas solo puede ser accedida por un administrador. Permite que la pregunta
+ y sus respuestas no sean listadas mas, pero queden logueadas en un historico.
+ </p>
+ <div align="center">
+ <img src="faq.desactivarPregunta.jpg"
+ alt="Captura de pantalla de faq.desactivarPregunta.php" />
+ </div>
+ <h2><a name="modulo_info">Modulo de Info</a></h2>
+ <h3><a name="info_ingresarTemas_php">info.ingresarTemas.php</a></h3>
+ <p>
+ Permite al usuario el ingreso/modificación de nuevos Temas.
+ </p>
+ <div align="center">
+ <img src="info.ingresarTemas.php.jpg"
+ alt="Captura de pantalla de info.ingresarTemas.php" />
+ </div>
+ <h3><a name="info_listarTemas_php">info.listarTemas.php</a></h3>
+ <p>
+ Permite ver la lista de temas disponibles para ingresar informaciones.
+ </p>
+ <div align="center">
+ <img src="info.listarTemas.php.jpg"
+ alt="Captura de pantalla de info.listarTemas.php" />
+ </div>
+ <h3><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h3>
+ <p>
+ Permite al usuario ingresar nuevas informaciones a los temas actuales.
+ </p>
+ <div align="center">
+ <img src="info.ingresarInfo.php.jpg"
+ alt="Captura de pantalla de info.ingresarInfo.php" />
+ </div>
+ <h3><a name="info_listarInfo_php">info.listarInfo.php</a></h3>
+ <p>
+ Permite al usuario puede ver la lista de informaciones disponibles ordenadas por ranking,
+ o por tema y ranking.
+ </p>
+ <div align="center">
+ <img src="info.listarInfo.php.jpg"
+ alt="Captura de pantalla de info.listarInfo.php" />
+ </div>
+ <h3><a name="info_listarComentarios_php">info.listarComentarios.php</a></h3>
+ <p>
+ Permite ver los comentarios agregados hasta el momento.
+ </p>
+ <div align="center">
+ <img src="info.listarComentarios.php.jpg"
+ alt="Captura de pantalla de info.listarComentarios.php" />
+ </div>
+ <h3><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h3>
+ <p>
+ Permite al usuario ingresar nuevos comentarios a informaciones existentes.
+ </p>
+ <div align="center">
+ <img src="info.ingresarComentario.php.jpg"
+ alt="Captura de pantalla de info.ingresarComentario.php" />
+ </div>
+ <h3><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h3>
+ <p>
+ Permite ver la lista de el o los usuarios que hayan publicado informaciones con alto ranking.
+ </p>
+ <div align="center">
+ <img src="info.mencionEspecial.php.jpg"
+ alt="Captura de pantalla de info.mencionEspecial.php" />
</div>
-
- -->
<h1><a name="desarrollo">Desarrollo</a></h1>
- AGREGAR DESCRIPCION DE LO HECHO!!!!
- <h2><a name="desarrollo_archivos">Formato de Archivos</a></h2>
+ <h2><a name="desarrollo_diseño">Diseño del sistema</a></h2>
+ <p>
+ Los siguientes dos graficos describen como fue pensado el sistema a nivel
+ clases, y como se integrarian las diferentes partes, para que, pese a contar
+ con tres modulos separados, quede una unica aplicacion homogenea. Como punto de
+ partida entonces se realizaron estos dos graficos que sirvieron como guia, y
+ a lo largo del desarrollo fueron actualizandose. Se adjuntan aqui sus versiones
+ finales.
+ </p>
+ <h3><a name="desarrollo_diagrama_clases">Diagrama de Clases</a></h3>
+ <p>
+ El diagrama de clases se penso con el fin de poder reutilizar la mayor cantidad
+ de codigo posible, y de dividir de forma mas clara las tareas. La idea de estas
+ clases, principalmente, es que sean las entidades que son persistidas en los archivos
+ de texto, para tener un manejo mas sencillo y eficiente de la informacion.
+ </p>
+ <div align="center">
+ <img src="clases.jpg"
+ alt="Diagrama de clases" />
+ </div>
+ <h3><a name="desarrollo_diagrama_navegacion">Gráfico de Navegación</a></h3>
+ <p>
+ Este esquema permite ver la interrelación entre las diferentes pantallas del sistema
+ y como se puede acceder de una a la otra. Ademas, da una idea a alto nivel de como funciona
+ y como aparecen integrados los diferentes elementos.
+ </p>
+ <div align="center">
+ <img src="graficoNavegacion.jpg"
+ alt="Gráfico de Navegación" />
+ </div>
+ <h2><a name="desarrollo_archivos">Formato de Archivos</a></h2>
<p>
Todos los archivos del sistema se almacenan en el directorio data.
Varios archivos son creados en <em>tiempo de ejecución</em> por el
<li>Cantidad de días que lleva sin preguntar</li>
</ol>
<p>
- Este archivo se actualiza en etapas distintas. Cuando el usuario
- ingresa al sistema, se recalculan los créditos para ver si se le
- deben restar por cantidad de días sin preguntar. Se resta 1 crédito
- por cada 30 días sin responder. El cálculo realizado es el
- siguiente:
+ Este archivo se actualiza en etapas distintas (siempre que se
+ actualiza, se agrega un nuevo registro con los nuevos datos y se
+ actualiza el <em>índice</em>). Cuando el usuario ingresa al sistema,
+ se recalculan los créditos para ver si se le deben restar por
+ cantidad de días sin preguntar. Se resta 1 crédito por cada 30 días
+ sin responder. El cálculo realizado es el siguiente:
</p>
<p>
Llamaremos FECHA al campo 1 del registro del archivo leído, CREDITOS
<code>CREDITOS_NUEVO = CREDITOS - (DIAS_NUEVO / 30)</code> y la
nueva cantidad de días sin preguntar restantes (DIAS_RESTO) como
<code>DIAS_RESTO = DIAS_NUEVO % 30</code> (siendo % el resto de la
- división entera), ya que estos días sin pregutnar <em>extra</em> que
+ división entera), ya que estos días sin preguntar <em>extra</em> que
todavía no llegan a sumar 30 como para restar créditos, deben ser
considerados para futuros cálculos. Finalmente en el archivo de
créditos se guarda un nuevo registro con los datos CREDITOS_NUEVO y
</p>
<p>
Finalmente, el último caso en donde se actualiza este archivo (se
- recalculan los créditos) es cuando un usuario califica una respuesta
- con un valor igual o superior a 2. En este caso se suma uno al campo
- 3 y se verifica si es igual o superior a 5 (en realidad jamás será
- superior a 5). Si lo es, se pone en cero y se agregan 5 créditos.
+ recalculan los créditos) es cuando un usuario califica una
+ respuesta. Se suma a CREDITOS la calificación de dicha respuesta y
+ si la respuesta está calificada con un valor igual o superior a 2
+ se suma uno al campo 3 (BONUS) y se verifica si es igual o superior
+ a 5 (en realidad jamás será superior a 5). Si lo es, se pone en cero
+ BONUS y se suma 5 CREDITOS.
</p>
<h3><a name="desarrollo_archivos_log_csv">log.*.csv</a></h3>
<p>
<ol>
<li>Timestamp con la fecha en la que se creó la entrada</li>
<li>Descripción de la acción realizada</li>
+ </ol>
+ <h3><a name="desarrollo_archivos_preguntas_csv">preguntas.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. y se crea en
+ <em>tiempo de ejecución</em>. A medida que se van dando de alta las
+ preguntas, se agrega una línea al final. Se guarda toda la información
+ necesaria para poder operar con las preguntas. Cuando una pregunta se
+ da de baja, <em>no</em> es eliminada de este archivo. De esta forma,
+ queda un registro histórico de las preguntas que fueron dadas de alta en
+ el sistema.
+ Los campos del archivo son:
+ <ol>
+ <li>Id de la pregunta</li>
+ <li>Id del usuario autor de la pregunta</li>
+ <li>Timestamp con la fecha de creación de la pregunta</li>
+ <li>Texto de la pregunta</li>
+ </ol>
+ <h3><a name="desarrollo_archivos_respuestas_csv">respuestas.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. y se crea en
+ <em>tiempo de ejecución</em>. Cuando se da de alta una respuesta a una
+ pregunta, se da de alta un nuevo registro en este archivo. El id de las
+ respuestas es simplemente el orden en el que fueron loguadas. Se guarda información
+ de la pregunta que se esta respondiendo para que sea mas sencilla la operatoria con
+ las respuestas, y pueda trabajar de manera independiente a las preguntas.
+ Los campos del archivo son:
+ <ol>
+ <li>Id de la pregunta que se esta respondiendo</li>
+ <li>Id del usuario autor de la pregunta que se esta respondiendo</li>
+ <li>Id del usuario autor de la respuesta</li>
+ <li>Timestamp con la fecha de creación de la respuesta</li>
+ <li>Texto de la respuesta</li>
+ </ol>
+ <h3><a name="desarrollo_archivos_calificacion_csv">calificacion.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. y se crea en
+ <em>tiempo de ejecución</em>. Cuando un usuario autor de una pregunta
+ califica las respuestas a dicha pregunta, se da de alta un registro en este archivo.
+ Luego, se asociara al calificacion a la respuesta correspondiente. Si una respuesta
+ no aparece en este archivo, es que todavía no fue calificada.
+ Los campos del archivo son:
+ <ol>
+ <li>Id de la respuesta calificada</li>
+ <li>Puntaje</li>
+ </ol>
+ <h3><a name="desarrollo_archivos_desactivadas_csv">desactivadas.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. y se crea en
+ <em>tiempo de ejecución</em>. Cuando un administrador da de baja una pregunta,
+ simplemente se ingresa el id de la misma en este archivo. A partir de ese momento, el
+ listador la ignorará al momento de mostrar las preguntas por pantalla.
+ Los campos del archivo son:
+ <ol>
+ <li>Id de la pregunta</li>
+ <li>Timestamp con la fecha de baja</li>
+ </ol>
+ <h3><a name="temas_csv">temas.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. Se va cargando por los administradores durante
+ la ejecución del sistema.
+ Los campos del archivo son:
+ </p>
+ <ol>
+ <li>ID que identifica unívocamente a los temas.</li>
+ <li>Usuario que cargo el mismo.</li>
+ <li>Nombre del mismo.</li>
+ <li>Ruta al icono del mismo.</li>
+ <li>Breve descripción.</li>
+ <li>Fecha de alta/modificación.</li>
+ </ol>
+ <h3><a name="infos_csv">infos.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
+ la ejecución del sistema.
+ Los campos del archivo son:
+ </p>
+ <ol>
+ <li>ID que identifica univocamente a las informaciones.</li>
+ <li>ID del tema al cual pertenece.</li>
+ <li>URL (link) a la información otorgada.</li>
+ <li>Usuario que cargo el mismo.</li>
+ <li>Breve descripción.</li>
+ <li>Cantidad de visitas a la URL (link) proporcionada.</li>
+ <li>Fecha de alta/modificación.</li>
+ </ol>
+ <h3><a name="comentarios_csv">comentarios.*.csv</a></h3>
+ <p>
+ Este archivo tiene formato <acronym lang="en"
+ title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
+ la ejecución del sistema.
+ Los campos del archivo son:
+ </p>
+ <ol>
+ <li>ID que identifica univocamente a las informaciones.</li>
+ <li>Usuario que cargó el mismo.</li>
+ <li>Comentario.</li>
+ <li>Fecha de alta/modificación.</li>
</ol>
<h1><a name="herramientas">Herramientas de desarrollo</a></h1>
<p>
<h2>Jonathan Schein</h2>
<dl>
<dt>Navegador</dt>
- <dd><p></p></dd>
+ <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
<dt>Editor de texto</dt>
- <dd><p></p></dd>
+ <dd><p>HTML-Kit, Notepad</p></dd>
<dt>Validador</dt>
- <dd><p></p></dd>
+ <dd><p>Herramientas de w3c: tidy y el servicio de validación
+ online (http://validator.w3.org/)</p></dd>
<dt>Herramientas de diseño de HTML</dt>
- <dd><p></p></dd>
+ <dd><p>Ninguna</p></dd>
</dl>
<h2>Sebastián Arena</h2>
<dl>
<dt>Navegador</dt>
- <dd><p></p></dd>
+ <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
<dt>Editor de texto</dt>
- <dd><p></p></dd>
+ <dd><p>EmEditor</p></dd>
<dt>Validador</dt>
- <dd><p></p></dd>
+ <dd><p>Herramientas de w3c: tidy y el servicio de validación
+ online (http://validator.w3.org/)</p></dd>
<dt>Herramientas de diseño de HTML</dt>
- <dd><p></p></dd>
+ <dd><p>Ninguna</p></dd>
</dl>
<h1><a name="configuracion">Configuración del servidor</a></h1>
<p>
- COMPLETAR!!! Por ahora nada, sólo que ande PHP.
+ El servidor no debe ser configurado de ninguna forma en particular,
+ sólo debe tener activado el módulo de PHP y la extensión user_dir de
+ apache si va a ser instalado en el directorio public_html de un
+ usuario. El resto de las configuración se realizan desde el mismo
+ sistema, por lo que no es necesario hacer modificaciones ni a la
+ configuración del apache ni a la del PHP.
+ </p>
+ <p>
+ Si no estuviera configurado el módulo user_dir, habría que agregar
+ al apache las siguiente líneas:
+ </p>
+ <pre>
+LoadModule userdir_module libexec/mod_userdir.so
+AddModule mod_userdir.c
+UserDir public_html
+ </pre>
+ <p>
+ Si no estuviera configurado el módulo de php, habría que agregar
+ al apache las siguiente líneas:
+ </p>
+ <pre>
+LoadModule php4_module libexec/libphp4.so
+AddModule mod_php4.c
+AddType application/x-httpd-php .php
+ </pre>
+ <p>
+ El archivo php.ini no necesita modificaciones a los valores por
+ omisión que trae cuando se instala.
</p>
- <h1><a name="instalación">Instalación</a></h1>
+ <h1><a name="instalacion">Instalación</a></h1>
<p>
- COMPLETAR!!! Supongo que es suficiente con copiar los archivos de
- src/ al public_html, ponerle permisos de lectura para el apache en
- todo y permisos de escritura en el directorio data/ y fotos/.
+ Sólo debe ejecutar el script ./install.sh que se encuentra en el
+ disquette. El script crea el directorio public_html en el directorio
+ del usuario actual (si no existiese) y copia los archivos
+ necesarios, con los permisos pertinentes para que el apache pueda
+ leer o escribir según corresponda. Una vez instalado, el sistema se
+ puede acceder en
+ <a href="http://localhost/~sisdis10/">http://localhost/~sisdis10/</a>
+ (si se instala con el usuario sisdis10, por supuesto).
</p>
<h1><a name="uso">Modo de uso</a></h1>
+ <h2><a name="uso_modulo_admin">Modulo de Administración</a></h2>
+ <p>
+ Este módulo se compone escencialmente de las páginas descriptas en
+ la sección de <a href="#modulo_admin">desarrollo del módulo de
+ administración</a>. A continuación se describe coloquialmente, en
+ orden lo más cronológico posible, como se usa el módulo.
+ </p>
+ <p>
+ Al sistema siempre se accede por la página
+ <a href="#index_php">index.php</a>, la primera vez que se ejecuta,
+ muestra la <a href="#admin_asociarse_php">página para asociarse</a>,
+ que se ejecuta de un modo especial, haciendo a los usuarios que se
+ asocien administradores hasta que el sistema tenga 2
+ administradores. Es decir, no se puede ingresar al sistema hasat que
+ no hayan 2 usuarios administradores y siempre los 2 primeros
+ usuarios que se asocien, serán administradores.
+ </p>
+ <p>
+ Una vez especificados los 2 administradores, el sistema comienza su
+ ciclo de vida <em>normal</em>, mostrando la pantalla de
+ <a href="#admin_login_php">ingreso</a>, en la cual hay un enlace a
+ la <a href="#admin_asociarse_php">página para asociarse</a>, para
+ que usuarios aún no asociados, puedan hacerlo (esta vez como
+ usuarios comunes, no como administradores). Para asociarse el
+ usuario debe ingresar el número de registro o código (si es asesor),
+ ingresar 2 veces (para evitar errores de tipeo) la contraseña que
+ desea usar, especificar su e-mail y foto que lo identifica.
+ </p>
+ <p>
+ Una vez dentro del sistema, se muestra la
+ <a href="#admin_log_php">página con el log de actividades</a> del
+ usuario, mostrando también la cantidad de créditos disponible (si no
+ es un asesor). Por omisión se muestran las actividades del día
+ actual, pero se puede elegir la fecha desde la cual mostrar las
+ actividades, o incluso mostrar todo.
+ </p>
+ <p>
+ Si el usuario es administrador, se presenta el submenú
+ <strong>Admin</strong>, que posee 2 opciones:
+ <strong>Créditos</strong> y <strong>Cambio de Admin</strong>.
+ La primera presenta la <a href="#admin_creditos_php">página para
+ agregar créditos</a>. Se presentan los usuarios no asesores en
+ una lista, un campo donde ingresar la cantidad de créditos a
+ agregarle y un campo para ingresar la contraseña, ya que es una
+ operación privilegiada que necesita una seguridad extra. La segunda
+ opción presenta <a href="#admin_admin_php">página de cambio de
+ administrador</a>. En esta página se muestra una lista de usuario
+ que no sean administradores, para elegir a quien <em>ceder</em> los
+ permisos de administrador. Al igual que la opción anterior, hay que
+ reingresar la contraseña, por ser una operación <em>delicada</em>.
+ Los permisos de administración se <em>ceden</em> al usuario
+ seleccionado, dejando de ser administrador el usuario actual, para
+ cumplir la restricción de que siempre hayan 2 y sólo 2
+ administradores en el sistema.
+ </p>
+ <p>
+ Finalmente está la opción <strong>Salir</strong> que permite al
+ usuario <a href="#admin_logout_php">salir del sistema</a>. Si el
+ usuario no sale del sistema pero está inactivo por más de media
+ hora, la sesión caduca y el usuario deberá volver a ingresar. Si
+ el usuario cierra el navegador o se va del sistema de otra forma,
+ y luego, antes de que se cumpla media hora de inactividad, retorna
+ al sistema, la <a href="#index_php">página de inicio</a> reconocerá
+ la sesión, y hará que el usuario continúe en la misma pantalla
+ donde había abandonado la sesión.
+ </p>
+ <h2><a name="uso_modulo_faqs">Modulo de FAQs</a></h2>
+ <p>
+ El módulo se encarga de la administracion de el subsistema de preguntas y
+ respuestas. Maneja altas y bajas, asi como tambien ingreso de respuestas y
+ ranking de cada una. Mientras mejor es la respuesta de un usuario (que será
+ calificado por el autor de una pregunta), mejor será su puntuación. Esos puntos
+ son créditos para poder seguir efectuando preguntas.
+ </p>
+ <p>
+ La página <a href="#faq_listarPreguntas_php">Listar Preguntas</a> muestra
+ las preguntas ingresadas en el sistema. Para cada pregunta, se muestra la fecha
+ de creación, el nombre de autor, con su correspondiente foto, la pregunta en si,
+ la posibilidad de accederá a todas las respuestas para dicha pregunta, así como
+ también la posibilidad de responder la pregunta ( solo en caso que quien esta
+ logueado en el sistema no sea el mismo usuario que formulo la pregunta ). El listado
+ de preguntas aparece paginado cada 2 ( se muestran dos preguntas por pantalla ).
+ Debajo de las preguntas aparece el navegador. En caso que el usuario logueado sea un
+ administrador, en la parte inferior de cada pantalla aparece un link que permite
+ acceder a la página de <a href="#faq_desactivarPregunta_php">Baja de Preguntas.</a>
+ </p>
+ <p>
+ El <a href="#faq_listarRespuestas_php">listador de respuestas</a> muestra ordenadas por ranking
+ las respuestas a una pregunta seleccionada. Utiliza el paginador, al igual que el listador de preguntas,
+ y también lo hace de a dos respuestas por pantalla. Muestra la información del usuario
+ que genero la respuesta ( foto y nombre ), la respuesta y el ranking de la misma. Si la
+ respuesta todavía no fue evaluada por el autor de la pregunta, muestra un mensaje que
+ indica que no hay ranking para esa pregunta. Si el usuario que esta accediendo a la lista
+ de respuestas es el mismo que formulo la pregunta y todavía no calificó a la misma, aparece
+ un botón que lo redirecciona a la página de calificación de preguntas.
+ </p>
+ <p>
+ Desde el menú de la aplicación se puede acceder a la página que permite <a href="#faq_ingresarPregunta_php">
+ agregar una pregunta</a>. En caso de que el usuario logueado tenga los créditos para hacerlo, podrá formular
+ una pregunta que se publicara en la <a href="#faq_listarPreguntas_php">lista de preguntas</a>. Si el usuario no
+ contara con los créditos suficientes, un warning lo alertara y le sugerirá que pida créditos al administrador
+ del sistema. El usuario podrá ingresas desde esta pantalla tantas preguntas como créditos tenga.
+ </p>
+ <p>
+ Desde el listado de preguntas se puede acceder a la pantalla que permite <a href="#faq_responderPregunta_php">
+ responder la pregunta </a>. La misma muestra en el encabezado la pregunta que se esta respondiendo.
+ Al lograr un ingreso satisfactorio de una respuesta, aparece un mensaje que avisa al
+ usuario que su respuesta fue dada de alta en el sistema. Esta respuesta quedara pendiente
+ de calificar por parte del autor de la pregunta que se esta respondiendo. Cualquier usuario
+ logueado en el sistema puede acceder a responder preguntas. Únicamente no podrá responder una
+ pregunta el autor de la misma.
+ </p>
+ <p>
+ La pantalla de <a href="#faq_calificarRespuesta_php">calificación de respuesta</a> solo puede ser accedida
+ por el autor de la pregunta que tiene dicho ítem como respuesta. En esta pantalla, desde un combo, se
+ puede elegir alguna de las cuatro categorías de calificación ( a cada una le corresponde un
+ puntaje ). Inmediatamente se le acreditara a quien pregunta tantos créditos como puntos valgan la
+ calificación de la respuesta. La respuesta solo podrá ser calificada una vez, luego de ser calificada,
+ desaparecerá el botón que permite acceder a la pantalla para ese ítem.
+ </p>
+ <p>
+ Si un administrador lo desea, desde la pantalla de <a href="#faq_listarPreguntas_php">listado de preguntas</a>
+ es posible acceder a la pantalla de <a href="#faq_desactivarPregunta_php">baja de preguntas</a> y pasar una pregunta
+ a un log historico. De esta manera ni la pregunta ni sus respuestas seran mostradas mas por el listador. La lista de preguntas
+ a desactivar aparece para seleccionar de un combo.
+ </p>
+ <h2><a name="uso_modulo_info">Modulo de Info</a></h2>
+ <p>
+ El módulo de info permite el ingreso de temas, informaciones y comentarios,
+ y para la interaccion con el mismo se definieron distintos menúes en base
+ a los roles presentes en la plataforma.
+ El siguiente menu es el que se le presenta al asesor o socio.
+ </p>
+ <div align="center">
+ <img src="info.menu.asesor.jpg"
+ alt="Captura de pantalla de info.menu.asesor.jpg" />
+ </div>
+ <p>
+ El siguiente menu es el que se le presenta al administrador.
+ </p>
+ <div align="center">
+ <img src="info.menu.administrador.jpg"
+ alt="Captura de pantalla de info.menu.administrador.jpg" />
+ </div>
+ <p>
+ Desde <a href="#info_ingresarTemas_php">info.ingresarTemas.php</a> el usuario puede ingresar nuevos temas.
+ (Solo pueden acceder los usuarios administradores).<br />Los campos a completar son:
+ </p>
+ <ul>
+ <li><strong>Tema</strong>: Nombre del Tema.</li>
+ <li><strong>Icono</strong>: Cada Tema tiene un ícono asociado.</li>
+ <li><strong>Descripción</strong>: Cada Tema tiene un descripción asociada.</li>
+ </ul>
+ <p>
+ Una vez completados se procede a "Guardar Tema".<br />
+ Se mostrará un mensaje indicando si la operación fue exitosa o no.
+ En cualquiera de los dos casos se mantienen los datos en los campos, y se
+ permite la modificación de lo recien insertado, a modo de correccion de posibles errores
+ del usuario al tipear.<br />De retirarse de la página, o presionar sobre "Nuevo Tema"
+ se pierde la posibilidad de modificar (al presionar sobre "Nuevo Tema" se pedirá la confirmación
+ antes de cambiar de contexto).
+ </p>
+ <p>
+ Desde <a href="#info_listarTemas_php">info.listarTemas.php</a> el usuario puede ver la lista de temas disponibles
+ para ingresar informaciones. La página se muestra paginada de a 5 temas por vez, se puede acceder a
+ las diferentes páginas navegando el menu superior. (La página actual queda marcada en negrita).
+ </p>
+ <p>
+ Desde <a href="#info_ingresarInfo_php">info.ingresarInfo.php</a> el usuario puede ingresar nuevas informaciones.
+ Los campos a completar son:
+ </p>
+ <ul>
+ <li><strong>Tema</strong>: se debe seleccionar el tema de la lista disponible.</li>
+ <li><strong>URL</strong>: es la URL hacia la información que se está ingresando.</li>
+ <li><strong>Comentario</strong>: una breve descripción de la información provista.</li>
+ </ul>
+ <p>
+ Una vez completados se procede a "Guardar Información".<br />
+ Se mostrará un mensaje indicando si la operación fue exitosa o no.
+ Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado,
+ a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página,
+ o presionar sobre "Nueva Información" se pierde la posibilidad de modificar (al presionar sobre
+ "Nueva Información" se pedirá la confirmación antes de cambiar de contexto).
+ </p>
+ <p>
+ Desde <a href="#info_listarInfo_php">info.listarInfo.php</a> el usuario puede ver la lista de informaciones disponibles.
+ La página se muestra paginada de a 5 informaciones por vez, se puede acceder a las diferentes
+ páginas navegando el menu superior. (La página actual queda marcada en negrita).<br />
+ Se despliega el icono del tema al cual pertenece, así como la imagen del usuario que cargó
+ dicha información. A continuación se muestra la URL correspondiente, con su comentario.
+ Por último el ranking ( que es la cantidad de accesos que hubo a dicha URL ) y se puede
+ acceder finalmente a la sección de comentarios sobre la información haciendo click en
+ "Ver Comentarios".<br />
+ Esta sección está disponible ordenada por ranking de acceso a la URL, o, eligiendo en "Ver Tema",
+ se listan las informaciones del tema, y luego dentro de ahi las mismas ordenadas por ranking.
+ </p>
+ <p>
+ Esta página es accedida desde "Ver Comentarios" que se encuentra disponible para cada información presente.
+ La misma muestra los comentarios agregados hasta el momento.
+ La página se muestra paginada de a 5 temas por vez, se puede acceder a las diferentes
+ páginas navegando el menu superior. (La página actual queda marcada en negrita).
+ Se presenta el ícono del tema al cual pertenece la información, y por supuesto el comentario en cuestión.
+ Luego se presenta el ícono y apellido del usuario que cargó el comentario (si el usuario que cargó el comentario
+ es el mismo que cargó la información entonces se muestra solamente el apellido), y finalmente se muestra el comentario.
+ Se puede acceder a cargar un nuevo comentario desde "Ingresar Comentario" (esto solo puede ser realizado por los asesores
+ o socios.
+ </p>
+ <p>
+ Desde <a href="#info_ingresarComentario_php">info.ingresarComentario.php</a> el usuario puede ingresar nuevos comentarios a informaciones existentes.
+ El campo a completar es:
+ </p>
+ <ul>
+ <li><strong>Comentario</strong></li>
+ </ul>
+ <p>
+ Una vez completados se procede a "Guardar Comentario".<br />
+ Se mostrará un mensaje indicando si la operacion fue exitosa o no.
+ Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado,
+ a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página,
+ o presionar sobre "Nuevo Comentario" se pierde la posibilidad de modificar (al presionar sobre "Nuevo Comentario"
+ se pedirá la confirmación antes de cambiar de contexto).
+ </p>
<p>
- COMPLETAR!!! Mucho de esto por ahora está en la descripción del
- diseño...
+ En <a href="#info_mencionEspecial_php">info.mencionEspecial.php</a> se lista el o los usuarios que hayan publicado informaciones con alto ranking.
+ Se suma para cada usuario los rankings de las páginas publicadas, y luego se muestran aquellos que con el
+ ranking mas alto ( se muestra mas de uno cuando el ranking es el mismo para varios usuarios ).
</p>
</body>
</html>
-
-<!-- vim: set et sw=4 sts=4 : -->
+<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file
projects / z.facultad / 75.43 / tp1.git / blobdiff