# Módulo v9 - Estudios de seguridad

## Alcance

Agrega al aplicativo una opción para registrar y generar estudios de seguridad nivel 1.

El estudio sigue el formato aportado por Mandatos y contiene:

- Fecha del estudio.
- Nombre consultado.
- Documento.
- Fecha de expedición del documento.
- Tipo de prospecto: laboral, civil, prestación de servicios u otro.
- Observación inicial o cargo.
- Validaciones judiciales.
- Sanciones nacionales.
- Información pública.
- Validación documental.
- Concepto final.

## Importante

El módulo no automatiza el ingreso a portales externos ni realiza consultas por scraping. La consulta sigue siendo manual. El sistema deja botones para abrir las fuentes y campos para registrar resultado, observación y evidencia.

Esto evita fallas por captcha, restricciones de sesión, términos de uso, indisponibilidad de portales o tratamiento inadecuado de datos personales.

## Archivos

- `security_studies.php`: página principal del módulo.
- `includes.php`: menú actualizado y creación automática de tablas.
- `database/migration_v9_estudios_seguridad.sql`: migración SQL.
- `templates/estudio_seguridad_plantilla.docx`: plantilla Word con marcadores.
- `docs/MARCADORES_ESTUDIO_SEGURIDAD.md`: lista de marcadores usados en Word.

## Instalación

1. Subir `security_studies.php` a la raíz del aplicativo.
2. Reemplazar `includes.php` con copia previa de seguridad.
3. Subir `templates/estudio_seguridad_plantilla.docx`.
4. Ejecutar `database/migration_v9_estudios_seguridad.sql` en phpMyAdmin.
5. Entrar a `https://talentohumano.mandatosabogados.com/security_studies.php`.

## Campo nuevo en colaboradores

Se agrega el campo:

`collaborators.fecha_expedicion_documento`

Cuando se diligencia un estudio de seguridad asociado a un colaborador, la fecha de expedición se guarda también en la ficha del colaborador.
