Documentación de Base de Datos - Módulo Títulos de Propiedades
titulos_propiedades - Títulos de Propiedad
Almacena el documento catastral de la propiedad asociada a un reporte de tasación, incluyendo la imagen del certificado de título y todos los metadatos extraídos. Soporta extracción automática mediante IA con revisión manual posterior.
| Campo | Descripción | Tipo | Nullable |
|---|---|---|---|
| id | Identificador único del título | INTEGER (PK) | ✗ |
| image_path | Ruta del archivo de imagen del certificado en storage | VARCHAR(500) | ✗ |
| is_current | Indica si es el título vigente (solo uno activo por reporte) | BOOLEAN | ✗ |
| extraction_status | Estado del proceso de extracción: pending, extracted, verified | VARCHAR(50) | ✗ |
| extracted_at | Fecha y hora en que la IA procesó el documento | TIMESTAMP | ✓ |
| verified_at | Fecha y hora en que el usuario verificó los datos extraídos | TIMESTAMP | ✓ |
| verified_by_user_id | Usuario que realizó la verificación manual | INTEGER (FK) | ✓ |
| deleted_at | Fecha de eliminación lógica (soft delete) | TIMESTAMP | ✓ |
| libro | Número de libro del registro de títulos (ej: “1204”) | VARCHAR(20) | ✓ |
| folio | Número de folio del registro (ej: “157”) | VARCHAR(20) | ✓ |
| matricula | Número de matrícula único del inmueble (ej: “3000349899”) | VARCHAR(50) | ✗ |
| designacion_catastral | Designación catastral completa (ej: “DC:11.3,PARCELA:67-B-326-004-19871”) | VARCHAR(255) | ✓ |
| fecha_inscripcion | Fecha y hora de inscripción del título en el registro | DATETIME | ✓ |
| municipio | Municipio donde está ubicado el inmueble | VARCHAR(100) | ✓ |
| provincia | Provincia donde está ubicado el inmueble | VARCHAR(100) | ✓ |
| oficina_registro | Oficina del Registro de Títulos que emitió el certificado | VARCHAR(150) | ✓ |
| superficie_m2 | Superficie total del inmueble en metros cuadrados | DECIMAL(12,2) | ✓ |
| viene_de | Referencia del título anterior (ej: “L.746, F.64”) | VARCHAR(50) | ✓ |
| tipo_inmueble | Clasificación del inmueble: solar, apartamento, casa, parcela, local | VARCHAR(50) | ✓ |
| origen_derecho | Forma en que se adquirió el derecho (ej: “Venta”, “Constitución de Condominio”, “Redención de Acciones”) | VARCHAR(100) | ✓ |
| notario | Nombre del notario que legalizó el acto de origen | VARCHAR(150) | ✓ |
| fecha_acto_origen | Fecha del acto jurídico mediante el cual se adquirió el inmueble | DATE | ✓ |
| condominio_nombre | Nombre del condominio al que pertenece la unidad (si aplica) | VARCHAR(150) | ✓ |
| unidad_funcional | Código de la unidad funcional dentro del condominio (ej: “E108”) | VARCHAR(50) | ✓ |
| bloque | Número o código de bloque dentro del condominio | VARCHAR(20) | ✓ |
| nivel | Nivel o piso de la unidad dentro del edificio | VARCHAR(20) | ✓ |
| raw_extraction | Respuesta completa sin procesar devuelta por la IA al analizar el documento | JSONB | ✓ |
| confidence_scores | Puntajes de confianza por campo extraído (ej: {"matricula": 0.98, "superficie_m2": 0.91}) | JSONB | ✓ |
owners_titulos - Propietarios del Título
Almacena los propietarios registrados en el certificado de título. Permite múltiples propietarios por título (personas físicas, empresas, fideicomisos) y registra el orden en que aparecen en el documento.
| Campo | Descripción | Tipo | Nullable |
|---|---|---|---|
| id | Identificador único del propietario | INTEGER (PK) | ✗ |
| titulo_propiedad_id | Referencia al título al que pertenece este propietario | INTEGER (FK) | ✗ |
| nombre_completo | Nombre completo o razón social del propietario | VARCHAR(255) | ✗ |
| tipo_owner | Tipo de titular: persona_fisica, empresa, fideicomiso | VARCHAR(50) | ✗ |
| tipo_id | Tipo de documento de identidad: cedula, pasaporte, rnc | VARCHAR(30) | ✓ |
| id_number | Número del documento de identidad personal | VARCHAR(50) | ✓ |
| rnc | Registro Nacional del Contribuyente (para empresas y fideicomisos) | VARCHAR(20) | ✓ |
| order | Orden de aparición del propietario en el documento | INTEGER | ✗ |
sectores_titulo - Sectores del Título
Registra los sectores que conforman la unidad inmobiliaria en títulos de condominios. Aplica cuando el inmueble está compuesto por múltiples sectores (propios, comunes de uso exclusivo, parqueos, terrazas, etc.).
| Campo | Descripción | Tipo | Nullable |
|---|---|---|---|
| id | Identificador único del sector | INTEGER (PK) | ✗ |
| titulo_propiedad_id | Referencia al título al que pertenece este sector | INTEGER (FK) | ✗ |
| codigo_sector | Código identificador del sector según el registro (ej: “SP-62-01-001”, “SE-14-02-003”) | VARCHAR(50) | ✓ |
| tipo_sector | Clasificación del sector: propio, comun_exclusivo, comun_general, parqueo, terraza, patio | VARCHAR(50) | ✗ |
| descripcion | Descripción del uso del sector (ej: “Casa”, “Parqueo”, “Meseta A/A”) | VARCHAR(150) | ✓ |
| superficie_m2 | Superficie del sector en metros cuadrados | DECIMAL(10,2) | ✗ |