docs/informe/informe.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html lang="es">
   3     <head>
   4         <title>Informe Trabajo Práctico 1</title>
   5         <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" >
   6     </head>
   7     <body>
   8         <h1>Carátula</h1>
   9         <p><strong>Introducción a Sistemas Distribuidos (75.43)</strong></p>
  10         <p>Trabajo Práctico Número 1</p>
  11         <h2>Grupo</h2>
  12         <dl>
  13             <dt>Número de grupo:</dt>
  14             <dd><p>10</p></dd>
  15             <dt>Nombre del host:</dt>
  16             <dd><p>lb10</p></dd>
  17             <dt>Nombre de usuario:</dt>
  18             <dd><p>sisdis10</p></dd>
  19         </dl>
  20         <table border="1" summary="Integrantes">
  21             <caption>Integrantes</caption>
  22             <tr><th>Nombre</th><th>Padrón</th><th>Módulo desarrollado</th></tr>
  23             <tr>
  24                 <td>Leandro Lucarella</td>
  25                 <td>77891</td>
  26                 <td>Actualización de socios y administración de créditos</td>
  27             </tr>
  28             <tr>
  29                 <td>Jonathan Schein</td>
  30                 <td>80083</td>
  31                 <td>Actualización de información de FAQ's</td>
  32             </tr>
  33             <tr>
  34                 <td>Sebastián Arena</td>
  35                 <td>80367</td>
  36                 <td>Actualización de información de interés de otros sitios y comentarios</td>
  37             </tr>
  38         </table>
  39         <h1>Índice</h1>
  40         <ol>
  41             <li><a href="#disenio">Diseño de las páginas</a></li>
  42             <li><a href="#desarrollo">Desarrollo</a></li>
  43             <li><a href="#herramientas">Herramientas de desarrollo</a></li>
  44             <li><a href="#configuracion">Configuración del servidor</a></li>
  45             <li><a href="#instalacion">Instalación</a></li>
  46             <li><a href="#uso">Modo de uso</a></li>
  47         </ol>
  48         <h1><a name="disenio">Diseño de las páginas</a></h1>
  49         <h2><a name="modulo_admin">Modulo de Administración</a></h2>
  50         <h3><a name="index_php">index.php</a></h3>
  51         <p>
  52             Esta página es el punto de partida del sistema. Normalmente se
  53             encarga de mostrar el <a href="#admin_login_php"><span
  54             lang="en">login</span></a>, pero puede encargarse también de
  55             resumir la sesión o de ir directo a la <a
  56             href="#admin_asociarse_php">asociación</a> de administradores si
  57             correspondiese (por ejemplo, si se cerró el navegador y se vuelve
  58             a abrir en un corto período de tiempo; o si es la primera vez que
  59             se usa el sistema y todavía no hay 2 administradores asignados;
  60             respectivamente).
  61         </p>
  62         <h3><a name="admin_login_php">admin.login.php</a></h3>
  63         <p>
  64             Es la página que realmente se encarga de hacer el
  65             <span lang="en">login</span>. Debe ingresarse el código de usuario
  66             (sea socio o asesor) y el password.
  67             Si el usuario no existe, o si está mal el password, etc, se muestra
  68             el correspondiente mensaje de error.
  69         </p>
  70         <div align="center">
  71             <img src="admin.login.jpg"
  72                 alt="Captura de pantalla de admin.login.php" />
  73         </div>
  74         <h3><a name="admin_logout_php">admin.logout.php</a></h3>
  75         <p>
  76             Esta página, al igual que <a href="#index_php">index.php</a>, no
  77             tiene contenido propio, sino que se encarga de borrar todos los
  78             datos de la sesión del usuario y luego muestra la pantalla de <a
  79             href="#admin_login_php"><span lang="en">login</span></a>
  80             ingresarse el código de usuario (sea socio o asesor) y el password.
  81             Si el usuario no existe, o si está mal el password, etc, se muestra
  82             el correspondiente mensaje de error.
  83         </p>
  84         <h3><a name="admin_asociarse_php">admin.asociarse.php</a></h3>
  85         <p>
  86             Esta página asocia a un integrante del grupo (presente en el archivo
  87             int_2005.txt si es socio o ase_2005.txt si es asesor). Si el sistema
  88             todavía no tiene 2 administradores asignados, los usuarios que se
  89             asocien, serán administradores (el sistema lo advierte, si es el
  90             caso). Una vez asignados 2 administradores, la única forma de
  91             cambiarlos es a través de la <a href="#admin_admin_php">página para
  92             ceder los permisos de administración</a> (accesible sólo por los
  93             administradores).
  94         </p>
  95         <div align="center">
  96             <img src="admin.asociarse.jpg"
  97                 alt="Captura de pantalla de admin.asociarse.php" />
  98         </div>
  99         <h3><a name="admin_log_php">admin.log.php</a></h3>
 100         <p>
 101             Esta página muestra el <span lang="en">log</span> de actividades del
 102             usuario. Permite elegir la fecha desde la cual se quieren ver las
 103             actividades.
 104         </p>
 105         <div align="center">
 106             <img src="admin.log.jpg"
 107                 alt="Captura de pantalla de admin.log.php" />
 108         </div>
 109         <h3><a name="admin_creditos_php">admin.creditos.php</a></h3>
 110         <p>
 111             En esta página el administrador puede agregar créditos a los
 112             usuarios. Para realizar esta tarea el administrador debe ingresar su
 113             password para corroborar su identidad como un mecanismo de seguridad
 114             extra (ya que de todas formas sólo un usuario con permisos de
 115             administrador puede realizar esta tarea). De esta manera, si por
 116             alguna razón un usuario se quedara sin créditos para preguntar,
 117             podría solicitar al administrador que le asigne algunos créditos.
 118             Las razones de aprobación y la cantidad de créditos otorgados, queda
 119             enteramente a consideración del administrador.
 120         </p>
 121         <div align="center">
 122             <img src="admin.creditos.jpg"
 123                 alt="Captura de pantalla de admin.creditos.php" />
 124         </div>
 125         <h3><a name="admin_admin_php">admin.admin.php</a></h3>
 126         <p>
 127             A través de esta página un administrador puede <em>ceder</em> sus
 128             permisos de administración. Una vez cedidos, este usuario dejará de
 129             ser administrador y comenzará a serlo el nuevo usuario asignado.
 130             Al ser esta acción de un compromiso considerable, el administrador
 131             debe volver a ingresar su password para confirmarlo (aunque ya esté
 132             logueado y sólo los administradores puedan realizar esta acción).
 133         </p>
 134         <div align="center">
 135             <img src="admin.admin.jpg"
 136                 alt="Captura de pantalla de admin.admin.php" />
 137         </div>
 138         <h2><a name="modulo_faqs">Modulo de FAQs</a></h2>
 139                                 <h3><a name="faq_listarPreguntas_php">faq.listarPreguntas.php</a></h3>
 140         <p>
 141             Esta página lista las preguntas ingresadas en el sistema. Para cada
 142                                                 pregunta, se muestra la fecha de creación, el nombre de autor, con su
 143                                                 correspondiente foto, la pregunta en si, la posibilidad de accederá a
 144                                                 todas las respuestas para dicha pregunta, así como también la posibilidad
 145                                                 de responder la pregunta ( solo en caso que quien esta logueado en el sistema
 146                                                 no sea el mismo usuario que formulo la pregunta ). El listado de preguntas
 147                                                 aparece paginado cada 2 ( se muestran dos preguntas por pantalla ). Debajo de
 148                                                 las preguntas aparece el navegador. En caso que el usuario logueado sea un
 149                                                 administrador, en la parte inferior de cada pantalla aparece un link que permite
 150                                                 acceder a la página de baja de preguntas.
 151         </p>
 152         <div align="center">
 153             <img src="faq.listarPreguntas.jpg"
 154                 alt="Captura de pantalla de faq.listarPreguntas.php" />
 155         </div>
 156                                 <h3><a name="faq_listarRespuestas_php">faq.listarRespuestas.php</a></h3>
 157         <p>
 158             El listador de respuestas muestra ordenadas por ranking las respuestas a una
 159                                                 pregunta seleccionada. Utiliza el paginador, al igual que el listador de preguntas,
 160                                                 y también lo hace de a dos respuestas por pantalla. Muestra la información del usuario
 161                                                 que genero la respuesta ( foto y nombre ), la respuesta y el ranking de la misma. Si la
 162                                                 respuesta todavía no fue evaluada por el autor de la pregunta, muestra un mensaje que
 163                                                 indica que no hay ranking para esa pregunta. Si el usuario que esta accediendo a la lista
 164                                                 de respuestas es el mismo que formulo la pregunta y todavía no calificó a la misma, aparece
 165                                                 un botón que lo redirecciona a la página de calificación de preguntas.
 166         </p>
 167         <div align="center">
 168             <img src="faq.listarRespuestas.jpg"
 169                 alt="Captura de pantalla de faq.listarRespuestas.php" />
 170         </div>
 171                                 <h3><a name="faq_ingresarPregunta_php">faq.ingresarPregunta.php</a></h3>
 172         <p>
 173             Desde el menú de la aplicación se puede acceder a esta página. En caso de que el
 174                                                 usuario logueado tenga los créditos para hacerlo, podrá formular una pregunta que
 175                                                 se publicara en la lista de preguntas ( faq.listarPreguntas.php ). Si el usuario no
 176                                                 contara con los créditos suficientes, un warning lo alertara y le sugerirá que
 177                                                 pida créditos al administrador del sistema. El usuario podrá ingresas desde esta pantalla
 178                                                 tantas preguntas como créditos tenga.
 179         </p>
 180         <div align="center">
 181             <img src="faq.ingresarPregunta.jpg"
 182                 alt="Captura de pantalla de faq.ingresarPregunta.php" />
 183         </div>
 184                                 <h3><a name="faq_responderPregunta_php">faq.responderPregunta.php</a></h3>
 185         <p>
 186             Desde el listado de preguntas se puede acceder a la pantalla que permite responder
 187                                                 la pregunta. La misma muestra en el encabezado la pregunta que se esta respondiendo.
 188                                                 Al lograr un ingreso satisfactorio de una respuesta, aparece un mensaje que avisa al
 189                                                 usuario que su respuesta fue dada de alta en el sistema. Esta respuesta quedara pendiente
 190                                                 de calificar por parte del autor de la pregunta que se esta respondiendo. Cualquier usuario
 191                                                 logueado en el sistema puede acceder a responder preguntas. Únicamente no podrá responder una
 192                                                 pregunta el autor de la misma
 193         </p>
 194         <div align="center">
 195             <img src="faq.responderPregunta.jpg"
 196                 alt="Captura de pantalla de faq.responderPregunta.php" />
 197         </div>
 198                                 <h3><a name="faq_calificarRespuesta_php">faq.calificarRespuesta.php</a></h3>
 199         <p>
 200             La pantalla de calificación de respuesta solo puede ser accedida por el autor de
 201                                                 la pregunta que tiene dicho ítem como respuesta. En esta pantalla, desde un combo, se
 202                                                 puede elegir alguna de las cuatro categorías de calificación ( a cada una le corresponde un
 203                                                 puntaje ). Inmediatamente se le acreditara a quien pregunta tantos créditos como puntos valgan la
 204                                                 calificación de la respuesta. La respuesta solo podrá ser calificada una vez, luego de ser calificada,
 205                                                 desaparecerá el botón que permite acceder a la pantalla para ese ítem.
 206         </p>
 207         <div align="center">
 208             <img src="faq.calificarRespuesta.jpg"
 209                 alt="Captura de pantalla de faq.calificarRespuesta.php" />
 210         </div>
 211                                 <h3><a name="faq_desactivarPregunta_php">faq.desactivarPregunta.php</a></h3>
 212         <p>
 213                                          Desde esta pantalla, los administradores pueden dar de baja una pregunta. De todas formas la pregunta
 214                                          seguirá existiendo, con sus respuestas, pero no sera mostrada mas por el listador. Para acceder a la pantalla
 215                                          de baja de preguntas, se debe hacer click sobre el link que aparece en la página listarPreguntas.php. Este link
 216                                          solo aparece en caso que el usuario logueado tenga privilegios de administrador.
 217         </p>
 218         <div align="center">
 219             <img src="faq.desactivarPregunta.jpg"
 220                 alt="Captura de pantalla de faq.desactivarPregunta.php" />
 221         </div>
 222         <h2><a name="modulo_info">Modulo de Info</a></h2>
 223         <h3><a name="info_ingresarTemas_php">info.ingresarTemas.php</a></h3>
 224         <p>
 225                 Permite al usuario el ingreso/modificación de nuevos Temas.
 226         </p>
 227         <div align="center">
 228             <img src="info.ingresarTemas.php.jpg"
 229                 alt="Captura de pantalla de info.ingresarTemas.php" />
 230         </div>
 231         <h3><a name="info_listarTemas_php">info.listarTemas.php</a></h3>
 232         <p>
 233                 Permite ver la lista de temas disponibles para ingresar informaciones.
 234         </p>
 235         <div align="center">
 236             <img src="info.listarTemas.php.jpg"
 237                 alt="Captura de pantalla de info.listarTemas.php" />
 238         </div>
 239         <h3><a name="info_ingresarInfo_php">info.ingresarInfo.php</a></h3>
 240         <p>
 241                 Permite al usuario ingresar nuevas informaciones a los temas actuales.
 242         </p>
 243         <div align="center">
 244             <img src="info.ingresarInfo.php.jpg"
 245                 alt="Captura de pantalla de info.ingresarInfo.php" />
 246         </div>
 247         <h3><a name="info_listarInfo_php">info.listarInfo.php</a></h3>
 248         <p>
 249                 Permite al usuario puede ver la lista de informaciones disponibles ordenadas por ranking,
 250                 o por tema y ranking.
 251         </p>
 252         <div align="center">
 253             <img src="info.listarInfo.php.jpg"
 254                 alt="Captura de pantalla de info.listarInfo.php" />
 255         </div>
 256         <h3><a name="info_listarComentarios_php">info.listarComentarios.php</a></h3>
 257         <p>
 258                 Permite ver los comentarios agregados hasta el momento.
 259         </p>
 260         <div align="center">
 261             <img src="info.listarComentarios.php.jpg"
 262                 alt="Captura de pantalla de info.listarComentarios.php" />
 263         </div>
 264         <h3><a name="info_ingresarComentario_php">info.ingresarComentario.php</a></h3>
 265         <p>
 266                 Permite al usuario ingresar nuevos comentarios a informaciones existentes.
 267         </p>
 268         <div align="center">
 269             <img src="info.ingresarComentario.php.jpg"
 270                 alt="Captura de pantalla de info.ingresarComentario.php" />
 271         </div>
 272         <h3><a name="info_mencionEspecial_php">info.mencionEspecial.php</a></h3>
 273         <p>
 274                 Permite ver la lista de el o los usuarios que hayan publicado informaciones con alto ranking.
 275         </p>
 276         <div align="center">
 277             <img src="info.mencionEspecial.php.jpg"
 278                 alt="Captura de pantalla de info.mencionEspecial.php" />
 279         </div>
 280         <h1><a name="desarrollo">Desarrollo</a></h1>
 281         <h2><a name="desarrollo_archivos">Formato de Archivos</a></h2>
 282         <p>
 283             Todos los archivos del sistema se almacenan en el directorio data.
 284             Varios archivos son creados en <em>tiempo de ejecución</em> por el
 285             servidor web, por lo tanto este directorio debe tener permisos de
 286             escritura para el usuario con el que corre dicho servidor.
 287             Además las fotos de los usuarios se guardan en el directorio fotos y
 288             también se crean en <em>tiempo de ejecución</em>, por lo tanto este
 289             directorio también debe tener permisos de escritura para el servidor
 290             web. El nombre del archivo de la foto de un usuario es su número de
 291             registro (si es socio) o código (si es asesor).
 292         </p>
 293         <p>
 294             A continuación se describe el formato de cada archivo.
 295         </p>
 296         <h3><a name="desarrollo_archivos_int_2005_txt">int_2005.txt</a></h3>
 297         <p>
 298             Este archivo tiene formato <acronym lang="en"
 299             title="Comma Separated Values">CSV</acronym> y está cargado previo
 300             a la ejecución del sistema con todos los integrantes que
 301             potencialmente serán <em>socios</em> del sistema.
 302             Los campos del archivo son:
 303         </p>
 304         <ol>
 305             <li>Número de registro</li>
 306             <li>Nombre del usuario</li>
 307             <li>Apellido del usuario</li>
 308         </ol>
 309         <h3><a name="desarrollo_archivos_ase_2005_txt">ase_2005.txt</a></h3>
 310         <p>
 311             Este archivo tiene formato <acronym lang="en"
 312             title="Comma Separated Values">CSV</acronym> y está cargado previo
 313             a la ejecución del sistema con todos los integrantes que
 314             potencialmente serán <em>asesores</em> del sistema.
 315             Los campos del archivo son:
 316         </p>
 317         <ol>
 318             <li>Código (formato A+año+número correlativo)</li>
 319             <li>Nombre del usuario</li>
 320             <li>Apellido del usuario</li>
 321         </ol>
 322         <h3><a name="desarrollo_archivos_users_csv">users.csv</a></h3>
 323         <p>
 324             Este archivo tiene formato <acronym lang="en"
 325             title="Comma Separated Values">CSV</acronym> y se crea en
 326             <em>tiempo de ejecución</em>. En él se almacenan los usuarios
 327             registrados en el sistema.
 328             Los campos del archivo son:
 329         </p>
 330         <ol>
 331             <li>
 332                 Número de registro/Código (dependiendo de si es socio o
 333                 asesor)
 334             </li>
 335             <li>Contraseña del usuario</li>
 336             <li>Dirección de correo electrónico del usuario</li>
 337         </ol>
 338         <h3><a name="desarrollo_archivos_admin_txt">admin.txt</a></h3>
 339         <p>
 340             Este archivo tiene formato de texto plano y almacena un número de
 341             registro o código (según sea socio o asesor) por línea (aunque
 342             también puede ser visto como un archivo <acronym lang="en"
 343             title="Comma Separated Values">CSV</acronym> con un sólo campo).
 344             Su función es almacenar los identificadores de los 2 administradores
 345             del sistema y es creado en <em>tiempo de ejecución</em>.
 346         </p>
 347         <h3><a name="desarrollo_archivos_creditos_csv">creditos.*.csv</a></h3>
 348         <p>
 349             Este archivo tiene formato <acronym lang="en"
 350             title="Comma Separated Values">CSV</acronym> modificado, ya que
 351             incluye en los primeros 11 bytes un <em>índice</em> a la última
 352             entrada. Es decir, en los primeros 11 bytes se almacena la posición
 353             del archivo en la que se encuentra el último <em>registro</em> CSV.
 354             Dicha posición, se almacena en codificación ASCII como un número de
 355             10 cifras (con ceros delante) y un caracter de fin de línea al
 356             final. Como normalmente sólo importa el último registro del archivo,
 357             esto acelera mucho, ya que no hay que recorrerlo completo para
 358             obtener dicho registro. De esta manera el acceso es casi directo y
 359             se conserva la historia de la variación de los créditos.
 360         </p>
 361         <p>
 362             Este archivo se crea en <em>tiempo de ejecución</em>, uno por cada
 363             socio, en el momento en que se registra en el sistema. El nombre
 364             del archivo incluye el número de registro del socio
 365             (creditos.[nro_registro].csv) y en él se almacena la
 366             historia de créditos de dicho usuario.
 367             Los campos del archivo son:
 368         </p>
 369         <ol>
 370             <li>Timestamp con la fecha en la que se creó la entrada</li>
 371             <li>Cantidad de créditos que tiene el socio</li>
 372             <li>
 373                 Cantidad de respuestas con <span lang="en">ranking</span>
 374                 2 o más que le falta para obtener los 5 créditos extra
 375             </li>
 376             <li>Cantidad de días que lleva sin preguntar</li>
 377         </ol>
 378         <p>
 379             Este archivo se actualiza en etapas distintas (siempre que se
 380             actualiza, se agrega un nuevo registro con los nuevos datos y se
 381             actualiza el <em>índice</em>). Cuando el usuario ingresa al sistema,
 382             se recalculan los créditos para ver si se le deben restar por
 383             cantidad de días sin preguntar. Se resta 1 crédito por cada 30 días
 384             sin responder. El cálculo realizado es el siguiente:
 385         </p>
 386         <p>
 387             Llamaremos FECHA al campo 1 del registro del archivo leído, CREDITOS
 388             al campo 2 y DIAS al campo 4. Llamaremos FECHA_ACTUAL a la fecha del
 389             instante del login. Ambas fechas expresadas como timestamps. Para
 390             calcular la diferencia en días entre 2 fechas, simplemente se restan
 391             y se divide por 86400 (cantidad de segundos en un día). Entonces
 392             para saber la cantidad de días que hace que no se pregunta en el
 393             instante del login (DIAS_NUEVO), se realiza: <code>DIAS_NUEVO =
 394             DIAS + (FECHA_ACTUAL - FECHA) / 86400</code>. Luego, si DIAS_NUEVO
 395             es más que 30, se calculan los nuevos créditos (CREDITOS_NUEVO) como
 396             <code>CREDITOS_NUEVO = CREDITOS - (DIAS_NUEVO / 30)</code> y la
 397             nueva cantidad de días sin preguntar restantes (DIAS_RESTO) como
 398             <code>DIAS_RESTO = DIAS_NUEVO % 30</code> (siendo % el resto de la
 399             división entera), ya que estos días sin preguntar <em>extra</em> que
 400             todavía no llegan a sumar 30 como para restar créditos, deben ser
 401             considerados para futuros cálculos. Finalmente en el archivo de
 402             créditos se guarda un nuevo registro con los datos CREDITOS_NUEVO y
 403             DIAS_RESTO en los campos 2 y 4 respectivamente. El resto de los
 404             campos (exceptuando la fecha, que siempre se guarda con la fecha de
 405             modificación del archivo) quedan intactos.
 406         </p>
 407         <p>
 408             El otro caso en donde se actualiza este archivo (se actualizan los
 409             créditos) es cuando un socio realiza una pregunta. En este caso,
 410             solamente se resta un crédito (campo 2) y pone se resetean los días
 411             sin preguntar (el campo 4 se pone en cero).
 412         </p>
 413         <p>
 414             Finalmente, el último caso en donde se actualiza este archivo (se
 415             recalculan los créditos) es cuando un usuario califica una
 416             respuesta. Se suma a CREDITOS la calificación de dicha respuesta y
 417             si la respuesta está calificada con un valor igual o superior a 2
 418             se suma uno al campo 3 (BONUS) y se verifica si es igual o superior
 419             a 5 (en realidad jamás será superior a 5). Si lo es, se pone en cero
 420             BONUS y se suma 5 CREDITOS.
 421         </p>
 422         <h3><a name="desarrollo_archivos_log_csv">log.*.csv</a></h3>
 423         <p>
 424             Este archivo tiene formato <acronym lang="en"
 425             title="Comma Separated Values">CSV</acronym>. y se crea en
 426             <em>tiempo de ejecución</em>, uno por cada usuario, en el momento
 427             en que se registra en el sistema. El nombre del archivo incluye el
 428             número de registro del socio o código del asesor según el caso
 429             (log.[nro_registro/codigo].csv) y en él se almacena la el log de
 430             actividades (es decir, cada vez que el usuario realiza una acción en
 431             el sistema, se agrega una entrada a este archivo que la describe).
 432             Los campos del archivo son:
 433         <ol>
 434             <li>Timestamp con la fecha en la que se creó la entrada</li>
 435             <li>Descripción de la acción realizada</li>
 436         </ol>
 437                                 <h3><a name="desarrollo_archivos_preguntas_csv">preguntas.csv</a></h3>
 438         <p>
 439             Este archivo tiene formato <acronym lang="en"
 440             title="Comma Separated Values">CSV</acronym>. y se crea en
 441             <em>tiempo de ejecución</em>. A medida que se van dando de alta las
 442                                                 preguntas, se agrega una línea al final. Se guarda toda la información
 443                                                 necesaria para poder operar con las preguntas. Cuando una pregunta se
 444                                                 da de baja, <em>no</em> es eliminada de este archivo. De esta forma,
 445                                                 queda un registro histórico de las preguntas que fueron dadas de alta en
 446                                                 el sistema.
 447                                                 Los campos del archivo son:
 448         <ol>
 449             <li>Id de la pregunta</li>
 450             <li>Id del usuario autor de la pregunta</li>
 451                                                 <li>Timestamp con la fecha de creación de la pregunta</li>
 452                                                 <li>Texto de la pregunta</li>
 453         </ol>
 454                                 <h3><a name="desarrollo_archivos_respuestas_csv">respuestas.csv</a></h3>
 455         <p>
 456             Este archivo tiene formato <acronym lang="en"
 457             title="Comma Separated Values">CSV</acronym>. y se crea en
 458             <em>tiempo de ejecución</em>. Cuando se da de alta una respuesta a una
 459                                                 pregunta, se da de alta un nuevo registro en este archivo. El id de las
 460                                                 respuestas es simplemente el orden en el que fueron loguadas. Se guarda información
 461                                                 de la pregunta que se esta respondiendo para que sea mas sencilla la operatoria con
 462                                                 las respuestas, y pueda trabajar de manera independiente a las preguntas.
 463                                                 Los campos del archivo son:
 464         <ol>
 465             <li>Id de la pregunta que se esta respondiendo</li>
 466             <li>Id del usuario autor de la pregunta que se esta respondiendo</li>
 467                                                 <li>Id del usuario autor de la respuesta</li>
 468                                                 <li>Timestamp con la fecha de creación de la respuesta</li>
 469                                                 <li>Texto de la respuesta</li>
 470         </ol>
 471                                 <h3><a name="desarrollo_archivos_calificacion_csv">calificacion.csv</a></h3>
 472         <p>
 473             Este archivo tiene formato <acronym lang="en"
 474             title="Comma Separated Values">CSV</acronym>. y se crea en
 475             <em>tiempo de ejecución</em>. Cuando un usuario autor de una pregunta
 476                                                 califica las respuestas a dicha pregunta, se da de alta un registro en este archivo.
 477                                                 Luego, se asociara al calificacion a la respuesta correspondiente. Si una respuesta
 478                                                 no aparece en este archivo, es que todavía no fue calificada.
 479                                                 Los campos del archivo son:
 480         <ol>
 481             <li>Id de la respuesta calificada</li>
 482             <li>Puntaje</li>
 483         </ol>
 484                                 <h3><a name="desarrollo_archivos_desactivadas_csv">desactivadas.csv</a></h3>
 485         <p>
 486             Este archivo tiene formato <acronym lang="en"
 487             title="Comma Separated Values">CSV</acronym>. y se crea en
 488             <em>tiempo de ejecución</em>. Cuando un administrador da de baja una pregunta,
 489                                                 simplemente se ingresa el id de la misma en este archivo. A partir de ese momento, el
 490                                                 listador la ignorará al momento de mostrar las preguntas por pantalla.
 491                                                 Los campos del archivo son:
 492         <ol>
 493             <li>Id de la pregunta</li>
 494             <li>Timestamp con la fecha de baja</li>
 495         </ol>
 496         <h3><a name="temas_csv">temas.csv</a></h3>
 497         <p>
 498             Este archivo tiene formato <acronym lang="en"
 499             title="Comma Separated Values">CSV</acronym>. Se va cargando por los administradores durante
 500             la ejecución del sistema.
 501             Los campos del archivo son:
 502         </p>
 503         <ol>
 504             <li>ID que identifica unívocamente a los temas.</li>
 505             <li>Usuario que cargo el mismo.</li>
 506             <li>Nombre del mismo.</li>
 507             <li>Ruta al icono del mismo.</li>
 508             <li>Breve descripción.</li>
 509             <li>Fecha de alta/modificación.</li>
 510         </ol>
 511         <h3><a name="infos_csv">infos.csv</a></h3>
 512         <p>
 513             Este archivo tiene formato <acronym lang="en"
 514             title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
 515             la ejecución del sistema.
 516             Los campos del archivo son:
 517         </p>
 518         <ol>
 519             <li>ID que identifica univocamente a las informaciones.</li>
 520             <li>ID del tema al cual pertenece.</li>
 521             <li>URL (link) a la información otorgada.</li>
 522             <li>Usuario que cargo el mismo.</li>
 523             <li>Breve descripción.</li>
 524             <li>Cantidad de visitas a la URL (link) proporcionada.</li>
 525             <li>Fecha de alta/modificación.</li>
 526         </ol>
 527         <h3><a name="comentarios_csv">comentarios.*.csv</a></h3>
 528         <p>
 529             Este archivo tiene formato <acronym lang="en"
 530             title="Comma Separated Values">CSV</acronym>. Se va cargando por los asesores/socios durante
 531             la ejecución del sistema.
 532             Los campos del archivo son:
 533         </p>
 534         <ol>
 535                 <li>ID que identifica univocamente a las informaciones.</li>
 536             <li>Usuario que cargó el mismo.</li>
 537             <li>Comentario.</li>
 538             <li>Fecha de alta/modificación.</li>
 539         </ol>
 540         <h1><a name="herramientas">Herramientas de desarrollo</a></h1>
 541         <p>
 542             Cada integrante eligió herramientas de desarrollo propias, más allá
 543             de las herramientas obligatorias que había que usar
 544             indefectiblemente para realizar el TP (como PHP y Apache).
 545             A continuación se enumeran las herramientas utilizadas por cada
 546             integrante.
 547         </p>
 548         <h2>Leandro Lucarella</h2>
 549         <dl>
 550             <dt>Navegador</dt>
 551             <dd><p>Mozilla Firefox, w3m</p></dd>
 552             <dt>Editor de texto</dt>
 553             <dd><p>VIM</p></dd>
 554             <dt>Validador</dt>
 555             <dd><p>Herramientas de w3c: tidy y el servicio de validación
 556                 online (http://validator.w3.org/)</p></dd>
 557             <dt>Herramientas de diseño de HTML</dt>
 558             <dd><p>Ninguna</p></dd>
 559         </dl>
 560         <h2>Jonathan Schein</h2>
 561         <dl>
 562             <dt>Navegador</dt>
 563             <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
 564             <dt>Editor de texto</dt>
 565             <dd><p>HTML-Kit, Notepad</p></dd>
 566             <dt>Validador</dt>
 567             <dd><p>Herramientas de w3c: tidy y el servicio de validación
 568                 online (http://validator.w3.org/)</p></dd>
 569             <dt>Herramientas de diseño de HTML</dt>
 570             <dd><p>Ninguna</p></dd>
 571         </dl>
 572         <h2>Sebastián Arena</h2>
 573         <dl>
 574             <dt>Navegador</dt>
 575             <dd><p>Mozilla Firefox, Internet Explorer 6</p></dd>
 576             <dt>Editor de texto</dt>
 577             <dd><p>EmEditor</p></dd>
 578             <dt>Validador</dt>
 579             <dd><p>Herramientas de w3c: tidy y el servicio de validación
 580                 online (http://validator.w3.org/)</p></dd>
 581             <dt>Herramientas de diseño de HTML</dt>
 582             <dd><p>Ninguna</p></dd>
 583         </dl>
 584         <h1><a name="configuracion">Configuración del servidor</a></h1>
 585         <p>
 586             El servidor no debe ser configurado de ninguna forma en particular,
 587             sólo debe tener activado el módulo de PHP y la extensión user_dir de
 588             apache si va a ser instalado en el directorio public_html de un
 589             usuario. El resto de las configuración se realizan desde el mismo
 590             sistema, por lo que no es necesario hacer modificaciones ni a la
 591             configuración del apache ni a la del PHP.
 592         </p>
 593         <p>
 594             Si no estuviera configurado el módulo user_dir, habría que agregar
 595             al apache las siguiente líneas:
 596         </p>
 597         <pre>
 598                         LoadModule userdir_module libexec/mod_userdir.so
 599                         AddModule mod_userdir.c
 600                         UserDir public_html
 601         </pre>
 602         <p>
 603             Si no estuviera configurado el módulo de php, habría que agregar
 604             al apache las siguiente líneas:
 605         </p>
 606         <pre>
 607                         LoadModule php4_module libexec/libphp4.so
 608                         AddModule mod_php4.c
 609                         AddType application/x-httpd-php .php
 610         </pre>
 611         <p>
 612             El archivo php.ini no necesita modificaciones a los valores por
 613             omisión que trae cuando se instala.
 614         </p>
 615         <h1><a name="instalacion">Instalación</a></h1>
 616         <p>
 617             Sólo debe ejecutar el script ./install.sh que se encuentra en el
 618             disquette. El script crea el directorio public_html en el directorio
 619             del usuario actual (si no existiese) y copia los archivos
 620             necesarios, con los permisos pertinentes para que el apache pueda
 621             leer o escribir según corresponda. Una vez instalado, el sistema se
 622             puede acceder en
 623             <a href="http://localhost/~sisdis10/">http://localhost/~sisdis10/</a>
 624             (si se instala con el usuario sisdis10, por supuesto).
 625         </p>
 626         <h1><a name="uso">Modo de uso</a></h1>
 627         <h2><a name="uso_modulo_admin">Modulo de Administración</a></h2>
 628         <p>
 629                 COMPLETAR!
 630         </p>
 631         <h2><a name="uso_modulo_faqs">Modulo de FAQs</a></h2>
 632                 <p>
 633                 COMPLETAR!
 634         </p>
 635         <h2><a name="uso_modulo_info">Modulo de Info</a></h2>
 636         <p>
 637                 El modulo de info permite el ingreso de temas, informaciones y comentarios,
 638                 y para la interaccion con el mismo se definieron distintos menúes en base
 639                 a los roles presentes en la plataforma.
 640                 El siguiente menu es el que se le presenta al asesor o socio.
 641         </p>
 642         <div align="center">
 643             <img src="info.menu.asesor.jpg"
 644                 alt="Captura de pantalla de info.menu.asesor.jpg" />
 645         </div>
 646         <p>
 647                 El siguiente menu es el que se le presenta al administrador.
 648         </p>
 649         <div align="center">
 650             <img src="info.menu.administrador.jpg"
 651                 alt="Captura de pantalla de info.menu.administrador.jpg" />
 652         </div>
 653         <p>
 654                 Desde <a href="#info_ingresarTemas_php">info.ingresarTemas.php</a> el usuario puede ingresar nuevos temas.
 655                 (Solo pueden acceder los usuarios administradores).<br />Los campos a completar son:
 656                 </p>
 657                 <ul>
 658                 <li><strong>Tema</strong>: Nombre del Tema.</li>
 659                 <li><strong>Icono</strong>: Cada Tema tiene un ícono asociado.</li>
 660                 <li><strong>Descripción</strong>: Cada Tema tiene un descripción asociada.</li>
 661                 </ul>
 662                 <p>
 663                 Una vez completados se procede a "Guardar Tema".<br />
 664                 Se mostrará un mensaje indicando si la operación fue exitosa o no.
 665                 En cualquiera de los dos casos se mantienen los datos en los campos, y se
 666                 permite la modificación de lo recien insertado, a modo de correccion de posibles errores
 667                 del usuario al tipear.<br />De retirarse de la página,  o presionar sobre "Nuevo Tema"
 668                 se pierde la posibilidad de modificar (al presionar sobre "Nuevo Tema" se pedirá la confirmación
 669                 antes de cambiar de contexto).
 670         </p>
 671         <p>
 672                 Desde <a href="#info_listarTemas_php">info.listarTemas.php</a> el usuario puede ver la lista de temas disponibles
 673                 para ingresar informaciones. La página se muestra paginada de a 5 temas por vez, se puede acceder a
 674                 las diferentes páginas navegando el menu superior. (La página actual queda marcada en negrita).
 675                 </p>
 676         <p>
 677                 Desde <a href="#info_ingresarInfo_php">info.ingresarInfo.php</a> el usuario puede ingresar nuevas informaciones.
 678                 Los campos a completar son:
 679         </p>
 680                 <ul>
 681                 <li><strong>Tema</strong>: se debe seleccionar el tema de la lista disponible.</li>
 682                 <li><strong>URL</strong>: es la URL hacia la información que se está ingresando.</li>
 683                 <li><strong>Comentario</strong>: una breve descripción de la información provista.</li>
 684                 </ul>
 685                 <p>
 686                 Una vez completados se procede a "Guardar Información".<br />
 687                 Se mostrará un mensaje indicando si la operación fue exitosa o no.
 688                 Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado,
 689                 a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página,
 690                 o presionar sobre "Nueva Información" se pierde la posibilidad de modificar (al presionar sobre
 691                 "Nueva Información" se pedirá la confirmación antes de cambiar de contexto).
 692         </p>
 693         <p>
 694                 Desde <a href="#info_listarInfo_php">info.listarInfo.php</a> el usuario puede ver la lista de informaciones disponibles.
 695                 La página se muestra paginada de a 5 informaciones por vez, se puede acceder a las diferentes
 696                 páginas navegando el menu superior. (La página actual queda marcada en negrita).<br />
 697                 Se despliega el icono del tema al cual pertenece, así como la imagen del usuario que cargó
 698                 dicha información. A continuación se muestra la URL correspondiente, con su comentario.
 699                 Por último el ranking ( que es la cantidad de accesos que hubo a dicha URL ) y se puede
 700                 acceder finalmente a la sección de comentarios sobre la información haciendo click en
 701                 "Ver Comentarios".<br />
 702                 Esta sección está disponible ordenada por ranking de acceso a la URL, o, eligiendo en "Ver Tema",
 703                 se listan las informaciones del tema, y luego dentro de ahi las mismas ordenadas por ranking.
 704         </p>
 705         <p>
 706                 Esta página es accedida desde "Ver Comentarios" que se encuentra disponible para cada información presente.
 707                 La misma muestra los comentarios agregados hasta el momento.
 708                 La página se muestra paginada de a 5 temas por vez, se puede acceder a las diferentes
 709                 páginas navegando el menu superior. (La página actual queda marcada en negrita).
 710                 Se presenta el ícono del tema al cual pertenece la información, y por supuesto el comentario en cuestión.
 711                 Luego se presenta el ícono y apellido del usuario que cargó el comentario (si el usuario que cargó el comentario
 712                 es el mismo que cargó la información entonces se muestra solamente el apellido), y finalmente se muestra el comentario.
 713                 Se puede acceder a cargar un nuevo comentario desde "Ingresar Comentario" (esto solo puede ser realizado por los asesores
 714                 o socios.
 715         </p>
 716         <p>
 717                 Desde <a href="#info_ingresarComentario_php">info.ingresarComentario.php</a> el usuario puede ingresar nuevos comentarios a informaciones existentes.
 718                 El campo a completar es:
 719         </p>
 720         <ul>
 721                         <li><strong>Comentario</strong></li>
 722                 </ul>
 723                 <p>
 724                 Una vez completados se procede a "Guardar Comentario".<br />
 725                 Se mostrará un mensaje indicando si la operacion fue exitosa o no.
 726                 Se mantienen los datos en los campos, y se permite la modificación de lo recién insertado,
 727                         a modo de correccion de posibles errores del usuario al tipear.<br />De retirarse de la página,
 728                         o presionar sobre "Nuevo Comentario" se pierde la posibilidad de modificar (al presionar sobre "Nuevo Comentario"
 729                         se pedirá la confirmación antes de cambiar de contexto).
 730         </p>
 731         <p>
 732                 En <a href="#info_mencionEspecial_php">info.mencionEspecial.php</a> se lista el o los usuarios que hayan publicado informaciones con alto ranking.
 733                 Se suma para cada usuario los rankings de las páginas publicadas, y luego se muestran aquellos que con el
 734                 ranking mas alto ( se muestra mas de uno cuando el ranking es el mismo para varios usuarios ).
 735         </p>
 736     </body>
 737 </html>