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