X-Git-Url: https://git.llucax.com/z.facultad/75.43/tp1.git/blobdiff_plain/9db4c11e955d35f8a727c00ffe68da450c2ffa2e..HEAD:/docs/informe/informe.html

diff --git a/docs/informe/informe.html b/docs/informe/informe.html
index 0b95360..ac1d567 100644
--- a/docs/informe/informe.html
+++ b/docs/informe/informe.html
@@ -32,8 +32,8 @@
             </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>
@@ -42,11 +42,12 @@
             <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
@@ -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
@@ -105,7 +106,7 @@
             <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
@@ -121,7 +122,7 @@
             <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
@@ -134,210 +135,156 @@
             <img src="admin.admin.jpg"
                 alt="Captura de pantalla de admin.admin.php" />
         </div>
-				<h2><a name="faq_listarPreguntas_php">faq.listarPreguntas.php</a></h2>
-        <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.
+        <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="faq.listarPreguntas.jpg"
                 alt="Captura de pantalla de faq.listarPreguntas.php" />
         </div>
-				<h2><a name="faq_listarRespuestas_php">faq.listarRespuestas.php</a></h2>
+				<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. 
+            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>
-				<h2><a name="faq_ingresarPregunta_php">faq.ingresarPregunta.php</a></h2>
+				<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. 
+            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>
-				<h2><a name="faq_responderPregunta_php">faq.responderPregunta.php</a></h2>
+				<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 
+            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>
-				<h2><a name="faq_calificarRespuesta_php">faq.calificarRespuesta.php</a></h2>
+				<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. 
+            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>
-				<h2><a name="faq_desactivarPregunta_php">faq.desactivarPregunta.php</a></h2>
+				<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. 
+					 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>
-        	El siguiente menu es el que se le presenta al asesor o socio para
-        	interactuar con el modulo de info.
-        </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 para
-        	interactuar con el modulo de info.
-        </p>
-        <div align="center">
-            <img src="info.menu.administrador.jpg"
-                alt="Captura de pantalla de info.menu.administrador.jpg" />
-        </div>
-        <h2><a name="info_ingresarTemas_php">info.ingresarTemas.php</a></h2>
-        <p>
-        	Desde aquí el usuario puede ingresar nuevos temas. (Solo pueden acceder
-        	los usuarios administradores)
-        	Los campos a completar son:
-        		<strong>Tema</strong>: Nombre del Tema.
-        		<strong>Icono</strong>: Cada Tema tiene un ícono asociado.
-        		<strong>Descripción</strong>: Cada Tema tiene un descripción asociada.
-        	Una vez completados se procede a "Guardar Tema".
-        	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 recien insertado.
-        	De retirarse de la página, o presionar sobre "Nuevo Tema" se pierde la posibilidad de modificar.
+        	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>
-        <h2><a name="info_listarTemas_php">info.listarTemas.php</a></h2>
+        <h3><a name="info_listarTemas_php">info.listarTemas.php</a></h3>
         <p>
-        	Desde aquí 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).
+        	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>
-        <h2><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h2>
+        <h3><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h3>
         <p>
-        	Desde aquí el usuario puede ingresar nuevos informaciones.
-        	Los campos a completar son:
-        		<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>
-        	Una vez completados se procede a "Guardar Información"
-        	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.
-        	De retirarse de la página, o presionar sobre "Nuevo Información" se pierde la posibilidad de modificar.
+        	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>
-        <h2><a name="info_listarInfo_php">info.listarInfo.php</a></h2>
+        <h3><a name="info_listarInfo_php">info.listarInfo.php</a></h3>
         <p>
-        	Desde aquí 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).
-        	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".
-        	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.
+        	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>
-        <h2><a name="info_listarComentarios_php">info.listarComentarios.php</a></h2>
+        <h3><a name="info_listarComentarios_php">info.listarComentarios.php</a></h3>
         <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.
+        	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>
-        <h2><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h2>
+        <h3><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h3>
         <p>
-        	Desde aquí el usuario puede ingresar nuevos comentarios a informaciones existentes.
-        	El campo a completar es:
-        		<li><strong>Comentario</strong></li>
-        	Una vez completados se procede a "Guardar Comentario".
-        	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.
-        	De retirarse de la página, o presionar sobre "Nuevo Comentario" se pierde la posibilidad de modificar.
+        	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>
-        <h2><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h2>
+        <h3><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h3>
         <p>
-        	En esta pagina 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 ).
+        	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
@@ -560,7 +507,7 @@
             Los campos del archivo son:
         </p>
         <ol>
-        	<li>ID que identifica unívocamente a los temas.</li>
+            <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>
@@ -575,7 +522,7 @@
             Los campos del archivo son:
         </p>
         <ol>
-        	<li>ID que identifica univocamente a las informaciones.</li>:
+       	    <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>
@@ -631,29 +578,285 @@
         <h2>Sebastián Arena</h2>
         <dl>
             <dt>Navegador</dt>
-           	<dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
+            <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
             <dt>Editor de texto</dt>
             <dd><p>EmEditor</p></dd>
             <dt>Validador</dt>
             <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>
-        <h1><a name="instalación">Instalación</a></h1>
+        <pre>
+LoadModule php4_module libexec/libphp4.so
+AddModule mod_php4.c
+AddType application/x-httpd-php .php
+        </pre>
         <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/.
+            El archivo php.ini no necesita modificaciones a los valores por
+            omisión que trae cuando se instala.
+        </p>
+        <h1><a name="instalacion">Instalación</a></h1>
+        <p>
+            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>
-            COMPLETAR!!! Mucho de esto por ahora está en la descripción del
-            diseño...
+        	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>
+        	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>
\ No newline at end of file
+</html>
+<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file