doc

pasosdeJesus · Jul 14, 2014 · 93a29dc · 93a29dc
1 parent af9cf13
commit 93a29dc
Show file tree

Hide file tree

Showing 37 changed files with 190 additions and 14 deletions.
diff --git a/DB_DataObject_SIVeL.php b/DB_DataObject_SIVeL.php
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Clase base para objetos que representan registros/tablas
+ */
 require_once "DB/DataObject.php";
 require_once "aut.php";
 //require_once $_SESSION['dirsitio'] . "/conf.php";

diff --git a/DataObjects/Ffrecuente.php b/DataObjects/Ffrecuente.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Objeto asociado a una tabla de la base de datos.
+ */
 require_once 'DataObjects/Basica.php';
 
 /**

diff --git a/DataObjects/Vinculoestado.php b/DataObjects/Vinculoestado.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Objeto asociado a una tabla de la base de datos.
+ */
 require_once 'DataObjects/Basica.php';
 
 /**

diff --git a/Derechos.txt b/Derechos.txt
@@ -4,7 +4,7 @@
    está registrada como obra de dominio público ante la oficina de
    Derechos de Autor de Colombia desde el 10 de Mayo de 2011. Oramos para
    que no sea utilizado por estructuras armadas. Esta documentación fue
-   actualizada por última vez en 24/08/2013
+   actualizada por última vez en 14/07/2014
 
    En Internet puede consultar la versión más reciente de esta
    documentación en http://sivel.sf.net/1.2/, así como la documentación

diff --git a/Instala.txt b/Instala.txt
@@ -114,7 +114,7 @@ cd /var/www/htdocs/sivel/sitios
 ./nuevo.sh sivel
 
        Este archivo de ordenes copiará los archivo
-       pordefecto/plantilla-conf.php y pordefecto/plantilla-vardb.sh como
+       pordefecto/conf.php.plantilla y pordefecto/vardb.sh.plantilla como
        sivel/conf.php y sivel/vardb.sh cuadrando rutas y usuario de
        PostgreSQL (si requiere cambiar usuario o clave de PostgreSQL edite
        sivel/conf.php). También inicializará la base de datos y los

diff --git a/Novedades.txt b/Novedades.txt
@@ -1,18 +1,95 @@
 Apéndice A. Novedades
 
+   Versión 1.2b2 (Jul.2014)
+
+          + Consulta web ahora incluye filtro Sexo para hacer consultas
+            por género.
+          + Fallas corregidas: En consulta web no autenticada información
+            geográfica correcta. Permite autenticar cuando se actualiza de
+            1.1 a 1.2. Opera con PHP 5.4 y ambiente de adJ 5.5.
+          + Más verificaciones de seguridad inspiradas por OWASP por
+            ejemplo bloquea cuenta que tenga más de 5 intentos fallidos de
+            ingreso (configurable con $GLOBALS['max_intentos_fallidos']).
+            Dos formas de desbloquear: (1) Un administrador va a
+            Administrar->Usuario y elige el usuario bloqueado y pone en
+            blanco campos Intentos fallidos, Testigo para desbloquear y
+            Momento del bloqueo o (2) la cuenta se desbloquea
+            automáticamente después de una hora (o el tiempo especificado
+            en $GLOBALS['segundos_desbloqueo']).
+          + En módulo homónimos nueva opción del menú Otros para examinar
+            listado.
+          + En consulta web y al buscar similares en el módulo mezcla,
+            permite buscar nombres similares al pronunciar en español
+            ---usa soundex en español. En el módulo mezclar al buscar
+            similares emplea soundex para español.
+          + En relatos importa/exporta etiquetas.
+          + Listado de etnias completado con
+            http://www.mineducacion.gov.co/1621/articles-255690_archivo_xl
+            s_listado_etnias.xls. Listado de iglesias mejorado.
+          + Módulo etiquetas permite agregar una columna con etiquetas en
+            consulta web. En conf.php agregar en cwncampos:
+'m_etiquetas' => _('Etiquetas'),
+
+          + En consulta web como tabla color de un caso ahora sólo en el
+            código (no en toda la fila).
+
+   Versión 1.2b1 (Mar.2014)
+
+          + Refinadas relaciones entre personas, posibilida de especificar
+            relación inversa para agregar simultaneamente 2 relaciones al
+            añadir familiares de una víctima.
+          + Almacenamiento de claves más seguro: Cambiado algoritmo de
+            condensado de claves a bcrypt (ver
+            https://www.usenix.org/legacy/events/usenix99/provos/provos_ht
+            ml/node1.html), que usa, si está disponible, el buen generador
+            de números aleatorios de OpenBSD (/dev/random), adJ 5.4 lo
+            configura por defecto para que el servidor web y SIVeL lo
+            puedan usar. Tras actualizar fuentes desde el directorio de su
+            sitio ejecute
+  sudo ../../bin/creaesquema.sh
+
+            Después ingrese como usuario administrador y elija
+            Otros->Actualizar. Posteriormente cada usuario que ingrese con
+            su clave correcta verá por una sóla vez un mensaje que
+            menciona el cambio de condensado para su clave y que le
+            indicará ingresar nuevamente.
+          + Simplificadas tablas de usuarios.
+          + Información geográfica actualizada con DIVIPOLA 2013.
+          + Función soundexesp, agradecimiento a Oliver Mazariegos de
+            Grupo Vesica.
+          + Añadidas variables de configuración para añadir validaciones:
+            $GLOBALS['validaciones_tipicas'],
+            $GLOBALS['gancho_valida_caso'],
+            $GLOBALS['gancho_valida_base'].
+          + Añadido archivo de comandos bin/elimcaso.sh que ayuda a
+            eliminar un caso dado el código
+          + Añadidas variable de configuración para controlar presentación
+            de reporte tabla: $GLOBALS['reptabla_nonacimiento'],
+            $GLOBALS['reptabla_noagresion'],
+            $GLOBALS['reptabla_separa_ubicacion'] (que separa ubicación en
+            2 columnas para municipio y departamento),
+            $GLOBALS['reptabla_separa_nomap'] (que separa nombres y
+            apellidos en 2 columnas) y
+            $GLOBALS['reptabla_tipificacion_breve'] (que presenta
+            tipificación sin código ni supracategoria).
+          + Validaciones: tanto desde el menú Otros->Validar como con el
+            botón Val. y Rep. G al editar un caso se verifica que se hayan
+            duplicado categorias que lo requieren.
+          + Fallas resueltas: Al buscar por consulta detallada en pestaña
+            ubicación no pone automáticamente latitud y longitud.
+            Agradecemos reporte a Miltón Mejía. Permite poner sector
+            social y rango edad en víctimas colectivas.
+
    Versión 1.2a1 (Ago.2013)
 
           + Modulo nuevo desplazamiento para registrar desplazamiento.
             Requiere que en el caso se registren dos o más ubicaciones por
             donde se han desplazado las víctimas. Agradecemos al SJR
             Colombia por financiar este desarrollo de dominio público.
-          + Modulo experimental mezcla para mezclar casos. Ayuda a mezclar
-            dos casos identificados por sus códigos o permite elegir 2
-            casos entre un listado de posibles repetidos. Puede mezclar
-            bien uno en otro o bien crear un caso nuevo con el resultado
-            de la mezcla. Por ser experimental se recomienda examinar caso
-            resultante. Agradecemos a Reiniciar por financiar este
-            desarrollo de dominio público.
+          + Modulo mezcla para mezclar casos: Búsqueda de casos repetidos
+            por mezclar por fecha, departamento o nombres similares.
+            Emplea heurística para mezclar. Soporte de homónimos o nombres
+            similares para excluirlos de búsquedas para mezclar.
           + Usabilidad: agrega automáticamente latitud y longitud al
             elegir departamento o municipio en pestaña Ubicación; control
             AJAX más eficiente para elegir departamento, municipio y clase

diff --git a/PagBaseMultiplePartes.php b/PagBaseMultiplePartes.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Pestaña con siguiente/anterior para capturar caso 
+ */
 require_once 'PagBaseMultiple.php';
 require_once 'ResConsulta.php';
 require_once 'PagUbicacion.php';

diff --git a/aut.php b/aut.php
@@ -17,6 +17,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Autenticación
+ */
 require_once "bcrypt.php";
 
 /**

diff --git a/buscaRepetidos.php b/buscaRepetidos.php
@@ -13,6 +13,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Busca repetidos
+ */
 require_once "aut.php";
 require_once $_SESSION['dirsitio'] . '/conf.php';
 require_once "confv.php";

diff --git a/buscarGrupo.php b/buscarGrupo.php
@@ -1,7 +1,7 @@
 <?php
 // vim: set expandtab tabstop=4 shiftwidth=4 foldmethod=marker fileencoding=utf-8:
 /**
- * Permite elegir una persona de la lista de las que están en la base
+ * Permite elegir un grupo de la lista de las que están en la base
  *
  * PHP version 5
  *
@@ -13,6 +13,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Elegir un grupo
+ */
 require_once 'aut.php';
 require_once 'misc.php';
 require_once $_SESSION['dirsitio'] . "/conf.php";

diff --git a/buscarPersona.php b/buscarPersona.php
@@ -13,6 +13,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Elegir una persona
+ */
 require_once 'aut.php';
 require_once $_SESSION['dirsitio'] . "/conf.php";
 require_once "DataObjects/Persona.php";

diff --git a/captura_caso.php b/captura_caso.php
@@ -14,6 +14,9 @@
  * @link      http://www.21st.de/downloads/rapidprototyping.pdf
  */
 
+/**
+ * Ficha para capturar casos (también utilizable para buscar).
+ */
 require_once "aut.php";
 require_once "confv.php";
 require_once $_SESSION['dirsitio'] . "/conf.php";

diff --git a/completaActos.php b/completaActos.php
@@ -13,6 +13,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Completa categorias replicadas
+ */
 require_once "aut.php";
 require_once $_SESSION['dirsitio'] . '/conf.php';
 require_once "confv.php";

diff --git a/consulta_web_cat.php b/consulta_web_cat.php
@@ -16,6 +16,9 @@
  * Acceso: CONSULTA PÚBLICA
  */
 
+/**
+ * Consulta de categoria para consulta web
+ */
 require_once "aut.php";
 require_once $_SESSION['dirsitio'] . "/conf.php";
 require_once "misc.php";

diff --git a/doc/confv.empty b/doc/confv.empty
@@ -13,7 +13,7 @@ PROYECTO=docsivel
 # Nombre del proyecto
 #
 
-PRY_VERSION="1.2b1"
+PRY_VERSION="1.2a1"
 # Versión
 #
 

diff --git a/importaRelato.php b/importaRelato.php
@@ -13,6 +13,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Importa relato
+ */
 require_once "aut.php";
 require_once $_SESSION['dirsitio'] . "/conf.php";
 $aut_usuario = "";

diff --git a/json_busca.php b/json_busca.php
@@ -15,6 +15,9 @@
  */
 
 
+/**
+ * Busca y retorna información de una tabla en formato JSON
+ */
 require_once "aut.php";
 require_once $_SESSION['dirsitio'] . "/conf.php";
 require_once 'misc.php';

diff --git a/json_persona.php b/json_persona.php
@@ -14,6 +14,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Listado de nombres de personas en base de datos en formato JSON
+ */
 require_once 'misc.php';
 require_once 'misc_importa.php';
 require_once 'aut.php';

diff --git a/misc_importa.php b/misc_importa.php
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Funciones para importar relatos
+ */
 require_once "DataObjects/Presponsable.php";
 
 /**

diff --git a/modulos/anexos/DataObjects/Anexo.php b/modulos/anexos/DataObjects/Anexo.php
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Definicion  para la tabla anexo.
+ */
 require_once 'DB/DataObject.php';
 
 /**

diff --git a/modulos/belicas/DataObjects/Combatiente.php b/modulos/belicas/DataObjects/Combatiente.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Objeto asociado a una tabla combatiente
+ */
 require_once 'DB_DataObject_SIVeL.php';
 require_once 'DataObjects/Filiacion.php';
 require_once 'DataObjects/Organizacion.php';

diff --git a/modulos/belicas/DataObjects/Combatiente_presponsable.php b/modulos/belicas/DataObjects/Combatiente_presponsable.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Objeto asociado a una tabla combatiente_presponsable
+ */
 require_once 'DB_DataObject_SIVeL.php';
 
 /**

diff --git a/modulos/desplazamiento/PagDesplazamiento.php b/modulos/desplazamiento/PagDesplazamiento.php
@@ -1,7 +1,7 @@
 <?php
 // vim: set expandtab tabstop=4 shiftwidth=4 foldmethod=marker fileencoding=utf-8:
 /**
- *Página del multi-formulario para capturar caso (captura_caso.php).
+ * Página del multi-formulario para capturar caso (captura_caso.php).
  *
  * PHP version 5
  *
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Página del multi-formulario para capturar caso (captura_caso.php).
+ */
 require_once 'PagBaseMultiple.php';
 require_once 'ResConsulta.php';
 require_once 'PagUbicacion.php';

diff --git a/modulos/etiquetas/DataObjects/Caso_etiqueta.php b/modulos/etiquetas/DataObjects/Caso_etiqueta.php
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Definición de objeto tabla caso_etiqueta
+ */
 require_once 'DB/DataObject.php';
 require_once 'HTML/QuickForm/Action.php';
 

diff --git a/modulos/etiquetas/DataObjects/Etiqueta.php b/modulos/etiquetas/DataObjects/Etiqueta.php
@@ -15,6 +15,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Objeto asociado a una tabla de la base de datos.
+ */
 require_once 'DataObjects/Basica.php';
 
 /**

diff --git a/modulos/etiquetas/PagEtiquetas.php b/modulos/etiquetas/PagEtiquetas.php
@@ -1,7 +1,7 @@
 <?php
 // vim: set expandtab tabstop=4 shiftwidth=4 foldmethod=marker fileencoding=utf-8:
 /**
- *Página del multi-formulario para capturar caso (captura_caso.php).
+ * Página del multi-formulario para capturar caso (captura_caso.php).
  *
  * PHP version 5
  *
@@ -14,6 +14,9 @@
  * Acceso: SÓLO DEFINICIONES
  */
 
+/**
+ * Página del multi-formulario para capturar caso (captura_caso.php).
+ */
 require_once 'PagBaseSimple.php';
 require_once 'Caso_etiqueta.php';
 require_once 'misc.php';

diff --git a/modulos/mapag/caso_detalles_sivel_remote.php b/modulos/mapag/caso_detalles_sivel_remote.php
@@ -1,7 +1,7 @@
 <?php
 // vim: set expandtab tabstop=4 shiftwidth=4 foldmethod=marker fileencoding=utf-8:
 /**
- * Detalls de un caso
+ * Detalle de un caso
  *
  * PHP version 5
  *
@@ -15,6 +15,9 @@
  * @link      http://sivel.sf.net
  */
 
+/**
+ * Detalle de un caso
+ */
 require_once "../../misc.php";
 require_once "mapag_misc.php";
-Original file line number
+Diff line change
@@ Expand Up / @@ -15,6 +15,9 @@ @@
      * Acceso: SÓLO DEFINICIONES
      */
+    /**
+     * Objeto asociado a una tabla de la base de datos.
+     */
     require_once 'DataObjects/Basica.php';
     /**
@@ Expand Down @@