]> git.llucax.com Git - z.facultad/75.43/tp1.git/blobdiff - docs/informe/informe.html
Aca esta mi bugfixing, para que le llevemos algo que le guste mas.
[z.facultad/75.43/tp1.git] / docs / informe / informe.html
index c6b4e3156157e68e8684efcdbac530a7aadfb6bb..ac1d567d2dfbcfc8642a1c195d99ab9c32eff7d6 100644 (file)
@@ -32,8 +32,8 @@
             </tr>
             <tr>
                 <td>Sebastián Arena</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>
             </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="#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>
             <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
         <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>
             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
         <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>
             <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
         <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>
             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
         <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>
             <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
         <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>
             <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
         <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>
             <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
         <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>
             <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>
         </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>
         <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>
         </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>
         <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>
         </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>
         <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>
         </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>
         <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>
         </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>
         <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>
         </p>
         <div align="center">
             <img src="faq.desactivarPregunta.jpg"
                 alt="Captura de pantalla de faq.desactivarPregunta.php" />
         </div>
-        <!--
-        
-        COMPLETAR!!!!
-
-        Template:
-
-        <h2>.php</h2>
+        <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>
         <p>
+               Permite al usuario ingresar nuevos comentarios a informaciones existentes.
         </p>
         <div align="center">
         </p>
         <div align="center">
-            <img src=".jpg"
-                alt="Captura de pantalla de .php" />
+            <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>
         </div>
-
-        -->
         <h1><a name="desarrollo">Desarrollo</a></h1>
         <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
         <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
             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
             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 linea al final. Se guarda toda la información
+                                               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 
                                                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 
             <li>Id de la pregunta</li>
             <li>Timestamp con la fecha de baja</li>
         </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>
             Cada integrante eligió herramientas de desarrollo propias, más allá
         <h1><a name="herramientas">Herramientas de desarrollo</a></h1>
         <p>
             Cada integrante eligió herramientas de desarrollo propias, más allá
         <h2>Sebastián Arena</h2>
         <dl>
             <dt>Navegador</dt>
         <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>
             <dt>Editor de texto</dt>
-            <dd><p></p></dd>
+            <dd><p>EmEditor</p></dd>
             <dt>Validador</dt>
             <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>
             <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>
         </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>
-        <h1><a name="instalación">Instalación</a></h1>
         <p>
         <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/.
+            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="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>
         </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>
         <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>
         </p>
     </body>
 </html>
-
-<!-- vim: set et sw=4 sts=4 : -->
+<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file