]> git.llucax.com Git - z.facultad/75.43/tp1.git/blobdiff - docs/informe/informe.html
Fixes para que valide.
[z.facultad/75.43/tp1.git] / docs / informe / informe.html
index c6b4e3156157e68e8684efcdbac530a7aadfb6bb..72c0027858d23dd8a908b4948d595c8595bc5b74 100644 (file)
@@ -42,7 +42,7 @@
             <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>
             <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>
+        <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.
+        </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>
+        <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).
+        </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>
+        <p>
+               Desde aquí 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"
+               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.
+        </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>
+        <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.
+        </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>
+        <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>
+        <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>
+        <p>
+               Desde aquí 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".
+               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.
+        </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>
         <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 ).
         </p>
         <div align="center">
-            <img src=".jpg"
-                alt="Captura de pantalla de .php" />
+            <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>
             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 
             <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á
         <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>
-        <h1><a name="instalación">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/.
+            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>
             COMPLETAR!!! Mucho de esto por ahora está en la descripción del
-            diseño...
+            diseño... Habría que hacer una descripción de un circuito completo
+            que vaya por toas las páginas...
         </p>
     </body>
 </html>
-
-<!-- vim: set et sw=4 sts=4 : -->
+<!-- vim: set et sw=4 sts=4 : -->
\ No newline at end of file