]> git.llucax.com Git - z.facultad/75.43/tp1.git/blobdiff - docs/informe/informe.html
Termino modo de uso del módulo de administración.
[z.facultad/75.43/tp1.git] / docs / informe / informe.html
index a52887ed37e1a599303b8883cd3cc2f246e13e70..719241dfef7adaeef467fac37ac9cf3fd7a026c3 100644 (file)
@@ -6,7 +6,7 @@
     </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="#disenio">Diseño de las páginas</a></li>
             <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="uso">Modo de uso</a></li>
+            <li><a href="#configuracion">Configuración del servidor</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
@@ -58,7 +59,7 @@
             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
@@ -70,7 +71,7 @@
             <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
@@ -80,7 +81,7 @@
             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
@@ -95,7 +96,7 @@
             <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 página lista 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 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>
+            El listador de respuestas 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>
+        <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>
+            Desde el menú de la aplicación se puede acceder a esta página. En caso de que el 
+                                               usuario logueado tenga los créditos para hacerlo, podrá formular una pregunta que 
+                                               se publicara en la lista de preguntas ( faq.listarPreguntas.php ). 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>
+        <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>
+            Desde el listado de preguntas se puede acceder a la pantalla que permite responder 
+                                               la pregunta. 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>
+        <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>
+            La pantalla de calificación de respuesta 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>
+        <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>
+                                        Desde esta pantalla, los administradores pueden dar de baja una pregunta. De todas formas la pregunta
+                                        seguirá existiendo, con sus respuestas, pero no sera mostrada mas por el listador. Para acceder a la pantalla
+                                        de baja de preguntas, se debe hacer click sobre el link que aparece en la página listarPreguntas.php. Este link
+                                        solo aparece en caso que el usuario logueado tenga privilegios de administrador. 
+        </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>
         <p>
             Todos los archivos del sistema se almacenan en el directorio data.
             <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>
+               COMPLETAR!
+        </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