unir/MastersThesis
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Cross references
Some checks failed
build_docker / essential (push) Successful in 1s
Details
build_docker / build_paddle_ocr (push) Successful in 5m6s
Details
build_docker / build_raytune (push) Has been cancelled
Details
build_docker / build_easyocr_gpu (push) Has been cancelled
Details
build_docker / build_doctr (push) Has been cancelled
Details
build_docker / build_doctr_gpu (push) Has been cancelled
Details
build_docker / build_paddle_ocr_gpu (push) Has started running
Details
build_docker / build_easyocr (push) Has been cancelled
Details

Browse Source
This commit is contained in:
Sergio Jimenez Jimenez
2026-02-04 20:43:50 +01:00
parent 868f748a8d
commit e9c937a042
18 changed files with 1118 additions and 820 deletions
Download Patch File Download Diff File Expand all files Collapse all files

413
docs/compliance.md
View File

@@ -1,157 +1,256 @@
# UNIR Style Compliance Checklist
This document lists the UNIR TFE style requirements to verify before final submission.
## Page Layout
| Requirement | Specification | Check |
|-------------|---------------|-------|
| Page size | A4 | ☐ |
| Left margin | 3.0 cm | ☐ |
| Right margin | 2.0 cm | ☐ |
| Top margin | 2.5 cm | ☐ |
| Bottom margin | 2.5 cm | ☐ |
| Header | Student name + TFE title | ☐ |
| Footer | Page number | ☐ |
## Typography
| Element | Specification | Check |
|---------|---------------|-------|
| Body text | Calibri 12pt, justified, 1.5 line spacing | ☐ |
| Título 1 (H1) | Calibri Light 18pt, blue, numbered (1., 2., ...) | ☐ |
| Título 2 (H2) | Calibri Light 14pt, blue, numbered (1.1, 1.2, ...) | ☐ |
| Título 3 (H3) | Calibri Light 12pt, numbered (1.1.1, 1.1.2, ...) | ☐ |
| Título 4 (H4) | Calibri 12pt, bold, unnumbered | ☐ |
| Footnotes | Calibri 10pt, justified, single spacing | ☐ |
| Code blocks | Consolas 10pt | ☐ |
## Document Structure
| Section | Requirements | Check |
|---------|--------------|-------|
| Portada | Title, Author, Type, Director, Date | ☐ |
| Resumen | 150-300 words in Spanish + Palabras clave (3-5) | ☐ |
| Abstract | 150-300 words in English + Keywords (3-5) | ☐ |
| Índice de contenidos | Auto-generated, new page | ☐ |
| Índice de figuras | Auto-generated, new page | ☐ |
| Índice de tablas | Auto-generated, new page | ☐ |
| Cap. 1 Introducción | 1.1 Motivación, 1.2 Planteamiento, 1.3 Estructura | ☐ |
| Cap. 2 Contexto | 2.1 Contexto, 2.2 Estado del arte, 2.3 Conclusiones | ☐ |
| Cap. 3 Objetivos | 3.1 Objetivo general, 3.2 Específicos, 3.3 Metodología | ☐ |
| Cap. 4 Desarrollo | Structure depends on work type | ☐ |
| Cap. 5 Conclusiones | 5.1 Conclusiones, 5.2 Trabajo futuro | ☐ |
| Referencias | APA format, alphabetical order | ☐ |
| Anexos | Code repository URL, supplementary data | ☐ |
## Tables
| Requirement | Specification | Check |
|-------------|---------------|-------|
| Title position | Above the table | ☐ |
| Title format | **Tabla N.** *Descriptive title in italics.* | ☐ |
| Numbering | Sequential (1, 2, 3...), Anexo uses A1, A2... | ☐ |
| Border style | APA: horizontal lines only (top, header bottom, table bottom) | ☐ |
| Source position | Below the table, centered | ☐ |
| Source format | Fuente: Author, Year. or Fuente: Elaboración propia. | ☐ |
| Leyenda (if needed) | Below Fuente, same style (Piedefoto-tabla) | ☐ |
| In TOT index | All tables appear in Índice de tablas | ☐ |
## Figures
| Requirement | Specification | Check |
|-------------|---------------|-------|
| Title position | Above the figure | ☐ |
| Title format | **Figura N.** *Descriptive title in italics.* | ☐ |
| Numbering | Sequential (1, 2, 3...), Anexo uses A1, A2... | ☐ |
| Alignment | Centered | ☐ |
| Source position | Below the figure, centered | ☐ |
| Source format | Fuente: Author, Year. or Fuente: Elaboración propia. | ☐ |
| Leyenda (if needed) | Below Fuente, same style (Piedefoto-tabla) | ☐ |
| In TOF index | All figures appear in Índice de figuras | ☐ |
## Lists
| Requirement | Specification | Check |
|-------------|---------------|-------|
| Bullet lists | Indented 36pt, bullet symbol (·) | ☐ |
| Numbered lists | Indented 36pt, sequential numbers (1, 2, 3...) | ☐ |
| Spacing | Proper First/Middle/Last paragraph spacing | ☐ |
## Citations and References
| Requirement | Specification | Check |
|-------------|---------------|-------|
| Citation format | APA 7th edition | ☐ |
| Single author | (Author, Year) or Author (Year) | ☐ |
| Two authors | (Author1 & Author2, Year) | ☐ |
| Three+ authors | (Author1 et al., Year) | ☐ |
| Reference list | Alphabetical by first author surname | ☐ |
| Hanging indent | 36pt left margin, -36pt text indent | ☐ |
| DOI/URL | Include when available | ☐ |
| No Wikipedia | Wikipedia citations not allowed | ☐ |
| Source variety | Books, journals, conferences (not just URLs) | ☐ |
## SMART Objectives
All objectives must be SMART:
| Criterion | Requirement | Check |
|-----------|-------------|-------|
| **S**pecific | Clearly defined, unambiguous | ☐ |
| **M**easurable | Quantifiable success metric (e.g., CER < 2%) | ☐ |
| **A**ttainable | Feasible with available resources | ☐ |
| **R**elevant | Demonstrable impact | ☐ |
| **T**ime-bound | Achievable within timeframe | ☐ |
## Writing Style
| Requirement | Check |
|-------------|-------|
| Each chapter starts with introductory paragraph | ☐ |
| Each paragraph has at least 3 sentences | ☐ |
| No two consecutive headings without text between them | ☐ |
| No superfluous phrases or repetition | ☐ |
| All concepts defined with pertinent citations | ☐ |
| Spelling checked (Word corrector) | ☐ |
| Logical flow between paragraphs | ☐ |
## Final Checks
| Requirement | Check |
|-------------|-------|
| All cited references appear in reference list | ☐ |
| All references in list are cited in text | ☐ |
| All figures/tables have numbers and titles | ☐ |
| Update all indices (Ctrl+A, F9 in Word) | ☐ |
| Page count: 50-90 pages (excl. cover, indices, annexes) | ☐ |
| Final format: PDF for deposit | ☐ |
## Automated Checks (apply_content.py)
The following are automatically handled by the generation scripts:
- ✓ Table/Figure sequential numbering
- ✓ Anexo items use A1, A2... prefix
- ✓ TC fields for Anexo items (appear in indices)
- ✓ Piedefoto-tabla style for Fuente/Leyenda
- ✓ MsoCaption style for titles
- ✓ APA table borders (horizontal only)
- ✓ MsoBibliography style for references
- ✓ MsoQuote style for blockquotes
- ✓ List paragraph classes (First/Middle/Last)
- ✓ Bold H4 headings (unnumbered)
## Color Palette (UNIR Theme)
| Color | Hex | Usage |
|-------|-----|-------|
| Primary Blue | `#0098CD` | Headings, diagram borders |
| Light Blue BG | `#E6F4F9` | Diagram backgrounds |
| Dark Gray | `#404040` | Body text |
| Accent Blue | `#5B9BD5` | Table headers |
| Light Accent | `#9CC2E5` | Table borders |
---
**Reference:** UNIR TFE Guidelines (`instructions/instrucciones.pdf`, `instructions/plantilla_individual.pdf`)
# Lista de verificación de cumplimiento de estilo UNIR
Este documento reúne los requisitos de estilo del TFE de UNIR a verificar antes de la entrega final.
## Maquetación de página
| Requisito | Especificación | Check |
|-----------|----------------|-------|
| Tamaño de página | A4 | ☐ |
| Margen izquierdo | 3.0 cm | ☐ |
| Margen derecho | 2.0 cm | ☐ |
| Margen superior | 2.5 cm | ☐ |
| Margen inferior | 2.5 cm | ☐ |
| Encabezado | Nombre del estudiante + título del TFE | ☐ |
| Pie de página | Número de página | ☐ |
## Tipografía
| Elemento | Especificación | Check |
|----------|----------------|-------|
| Texto normal | Calibri 12 pt, justificado, interlineado 1.5 | ☐ |
| Título 1 (H1) | Calibri Light 18 pt, azul, numerado (1., 2., ...) | ☐ |
| Título 2 (H2) | Calibri Light 14 pt, azul, numerado (1.1, 1.2, ...) | ☐ |
| Título 3 (H3) | Calibri Light 12 pt, numerado (1.1.1, 1.1.2, ...) | ☐ |
| Título 4 (H4) | Calibri 12 pt, negrita, sin numeración | ☐ |
| Notas al pie | Calibri 10 pt, justificado, interlineado simple | ☐ |
| Bloques de código | Consolas 10 pt | ☐ |
## Estructura del documento
| Sección | Requisitos | Check |
|---------|------------|-------|
| Portada | Título, autor, tipo, director, fecha | ☐ |
| Resumen | 150-300 palabras en español (plantilla) + Palabras clave (3-5); instrucciones mencionan ~150 palabras | ☐ |
| Resumen (contenido) | Debe incluir objetivo, metodología, resultados y conclusiones | ☐ |
| Abstract | 150-300 palabras en inglés + Keywords (3-5) | ☐ |
| Abstract (contenido) | Debe incluir objetivo, metodología, resultados y conclusiones | ☐ |
| Ubicación Resumen/Abstract | Al inicio del documento | ☐ |
| Índice de contenidos | Auto-generado, nueva página | ☐ |
| Índice de figuras | Auto-generado, nueva página | ☐ |
| Índice de tablas | Auto-generado, nueva página | ☐ |
| Índices separados | Contenidos/Figuras/Tablas en índices distintos | ☐ |
| Índices en nueva página | Cada índice comienza en nueva página | ☐ |
| Cap. 1 Introducción | 1.1 Motivación, 1.2 Planteamiento, 1.3 Estructura | ☐ |
| Cap. 2 Contexto | 2.1 Contexto, 2.2 Estado del arte, 2.3 Conclusiones | ☐ |
| Cap. 3 Objetivos | 3.1 Objetivo general, 3.2 Específicos, 3.3 Metodología | ☐ |
| Cap. 4 Desarrollo | Estructura según tipo de trabajo | ☐ |
| Cap. 5 Conclusiones | 5.1 Conclusiones, 5.2 Trabajo futuro | ☐ |
| Referencias | Formato APA, orden alfabético | ☐ |
| Anexos | URL del repositorio y datos complementarios | ☐ |
| Índice de acrónimos | Incluir si se usan acrónimos | ☐ |
| Inicio de capítulos | Cada capítulo comienza en nueva página | ☐ |
## Tablas
| Requisito | Especificación | Check |
|-----------|----------------|-------|
| Posición del título | Encima de la tabla | ☐ |
| Formato del título | **Tabla N.** *Título descriptivo en cursiva.* | ☐ |
| Numeración | Secuencial (1, 2, 3...), Anexos usan A1, A2... | ☐ |
| Bordes | APA: solo líneas horizontales (superior, cabecera, inferior) | ☐ |
| Posición de fuente | Debajo de la tabla, centrada | ☐ |
| Formato de fuente | Fuente: Autor, Año. o Fuente: Elaboración propia. | ☐ |
| Leyenda (si aplica) | Debajo de Fuente, mismo estilo (Piedefoto-tabla) | ☐ |
| En índice de tablas | Todas las tablas aparecen en el índice | ☐ |
## Figuras
| Requisito | Especificación | Check |
|-----------|----------------|-------|
| Posición del título | Encima de la figura | ☐ |
| Formato del título | **Figura N.** *Título descriptivo en cursiva.* | ☐ |
| Numeración | Secuencial (1, 2, 3...), Anexos usan A1, A2... | ☐ |
| Alineación | Centrada | ☐ |
| Posición de fuente | Debajo de la figura, centrada | ☐ |
| Formato de fuente | Fuente: Autor, Año. o Fuente: Elaboración propia. | ☐ |
| Leyenda (si aplica) | Debajo de Fuente, mismo estilo (Piedefoto-tabla) | ☐ |
| En índice de figuras | Todas las figuras aparecen en el índice | ☐ |
## Listas
| Requisito | Especificación | Check |
|-----------|----------------|-------|
| Viñetas | Sangría 36 pt, símbolo de viñeta (·) | ☐ |
| Numeradas | Sangría 36 pt, numeración secuencial (1, 2, 3...) | ☐ |
| Espaciado | Uso correcto de First/Middle/Last | ☐ |
## Citas y referencias
| Requisito | Especificación | Check |
|-----------|----------------|-------|
| Formato de citas | APA 7.ª edición | ☐ |
| Un autor | (Autor, Año) o Autor (Año) | ☐ |
| Dos autores | (Autor1 & Autor2, Año) | ☐ |
| Tres o más | (Autor1 et al., Año) | ☐ |
| Lista de referencias | Orden alfabético por apellido del primer autor | ☐ |
| Sangría francesa | 36 pt margen izquierdo, -36 pt sangría | ☐ |
| DOI/URL | Incluir cuando esté disponible | ☐ |
| Sin Wikipedia | No se permiten citas de Wikipedia | ☐ |
| Variedad de fuentes | Libros, revistas, congresos (no solo URLs) | ☐ |
| Referencias citadas | Toda referencia listada aparece en el texto | ☐ |
| Distribución de citas | La mayoría de citas en Cap. 2 (Estado del arte) | ☐ |
## Objetivos SMART
Todos los objetivos deben ser SMART:
| Criterio | Requisito | Check |
|----------|-----------|-------|
| **S**pecific | Claramente definido, sin ambigüedad | ☐ |
| **M**easurable | Métrica cuantificable (p. ej., CER < 2%) | ☐ |
| **A**ttainable | Factible con los recursos disponibles | ☐ |
| **R**elevant | Impacto demostrable | ☐ |
| **T**ime-bound | Alcanzable en el plazo previsto | ☐ |
## Estilo de redacción
| Requisito | Check |
|-----------|-------|
| Cada capítulo inicia con un párrafo introductorio | ☐ |
| Cada párrafo tiene al menos 3 oraciones | ☐ |
| No hay dos encabezados consecutivos sin texto entre ellos | ☐ |
| Sin frases superfluas ni repetición | ☐ |
| Conceptos definidos con citas pertinentes | ☐ |
| Ortografía revisada (corrector de Word) | ☐ |
| Flujo lógico entre párrafos | ☐ |
## Comprobaciones finales
| Requisito | Check |
|-----------|-------|
| Todas las citas aparecen en la lista de referencias | ☐ |
| Todas las referencias listadas se citan en el texto | ☐ |
| Todas las figuras/tablas tienen número y título | ☐ |
| Actualizar índices (Ctrl+A, F9 en Word) | ☐ |
| Extensión: 50-90 páginas (sin portada, resumen/abstract, índices y anexos) | ☐ |
| Formato final: PDF para depósito | ☐ |
## Comprobaciones automáticas (apply_content.py)
Las siguientes tareas están automatizadas por los scripts de generación.
**Arquitectura modular:**
- `apply_content.py` - Orquestador principal (~300 líneas)
- `content_handlers.py` - Manejadores de bloques de contenido (~400 líneas)
- `markdown_utils.py` - Utilidades de markdown (~150 líneas)
**Funcionalidades automatizadas:**
- ✓ Numeración secuencial de tablas y figuras
- ✓ Anexos con prefijo A1, A2...
- ✓ Campos TC para anexos (aparecen en índices)
- ✓ Estilo Piedefoto-tabla para Fuente/Leyenda
- ✓ Estilo MsoCaption para títulos
- ✓ Bordes APA en tablas (solo horizontales)
- ✓ Estilo MsoBibliography para referencias
- ✓ Estilo MsoQuote para citas textuales
- ✓ Estilos de listas (First/Middle/Last)
- ✓ Encabezados H4 en negrita (sin numeración)
## Paleta de color (tema UNIR)
| Color | Hex | Uso |
|-------|-----|-----|
| Azul primario | `#0098CD` | Encabezados, bordes de diagramas |
| Azul claro (fondo) | `#E6F4F9` | Fondos de diagramas |
| Gris oscuro | `#404040` | Texto principal |
| Azul acento | `#5B9BD5` | Encabezados de tablas |
| Acento claro | `#9CC2E5` | Bordes de tablas |
## Reglas de redundancia entre capítulos
Al tratar el documento como un todo:
| Tipo de repetición | Aceptable | Motivo |
|--------------------|-----------|--------|
| Métricas clave en Resumen y Conclusiones | ✓ Sí | El resumen sintetiza el trabajo |
| Resultados del Cap. 4 resumidos en Cap. 5 | ✓ Sí | Estructura académica estándar |
| Figuras idénticas en capítulo principal y anexo | ✗ No | Usar referencias cruzadas |
| Mismos datos de tablas en varios capítulos | ✗ No | Referenciar tabla previa |
| Párrafos de relleno que repiten encabezados | ✗ No | Eliminar redundancia |
| “Síntesis” intermedia en un capítulo | ⚠ Con cuidado | Solo si el capítulo es largo |
**Antipatrones a evitar:**
- "En este capítulo se presenta..." seguido de "Las siguientes secciones describen..." (el encabezado ya lo indica)
- Diagramas Mermaid idénticos en varios capítulos (usar "Ver Figura N en Capítulo X")
- Repetir métricas exactas (CER 0.79%) más de 3 veces en capítulos principales
## Documento como un todo
Los archivos markdown (00-07) generan un único documento Word. Considerar:
| Aspecto | Guía |
|---------|------|
| Auditoría global | Evaluar redundancia y coherencia tratando 00-07 como un solo documento | ☐ |
| Numeración de tablas/figuras | Secuencial en TODOS los capítulos (no reiniciar por capítulo) |
| Referencias cruzadas | "Ver Tabla X" o "como se describió en la Sección 2.3" |
| Contenido de anexos | Detalles complementarios, no duplicados del cuerpo principal |
| Datos repetidos | Referenciar ubicación, no copiar |
## Reglas por capítulo
### Capítulo 1: Introducción (3-5 páginas)
| Sección | Debe incluir |
|---------|--------------|
| 1.1 Motivación | Identificación del problema, justificación e impacto, referencias previas |
| 1.2 Planteamiento | Enunciado breve del problema, solución propuesta, enfoque |
| 1.3 Estructura | Descripción breve de los capítulos siguientes |
### Capítulo 2: Contexto y Estado del Arte (10-15 páginas)
| Sección | Debe incluir |
|---------|--------------|
| 2.1 Contexto del problema | Estudio profundo del dominio de aplicación |
| 2.2 Estado del arte | Trabajos previos, estudios actuales, comparativas, autores clave |
| 2.3 Conclusiones | Síntesis que conecte con el trabajo a desarrollar |
### Capítulo 3: Objetivos y Metodología
| Sección | Debe incluir |
|---------|--------------|
| 3.1 Objetivo general | Objetivo SMART, efecto observable |
| 3.2 Objetivos específicos | 3-5 objetivos SMART, verbos en infinitivo |
| 3.3 Metodología | Pasos, instrumentos, métodos de análisis |
### Capítulo 4: Desarrollo Específico
Para trabajo híbrido tipo 1 (Experimental) + tipo 3 (Comparativo):
| Sección | Debe incluir |
|---------|--------------|
| 4.1 Planteamiento | Problema, alternativas, criterios de éxito |
| 4.2 Desarrollo | Resultados, mediciones, gráficos, tablas |
| 4.3 Discusión | Significado de los resultados, ventajas/desventajas |
### Capítulo 5: Conclusiones y Trabajo Futuro
| Sección | Debe incluir |
|---------|--------------|
| 5.1 Conclusiones | Síntesis de aportes, **relación con objetivos**, grado de logro |
| 5.2 Líneas de trabajo futuro | Extensiones futuras con justificación |
## Antipatrones de texto de relleno
Eliminar texto introductorio redundante:
| Patrón | Sustituir por |
|--------|---------------|
| "A lo largo de este capítulo se desarrolla..." | Contenido directo |
| "El presente capítulo constituye..." | Contenido directo |
| "Las siguientes secciones describen..." | Contenido directo |
| "Como se mencionó anteriormente..." | Referencia específica o eliminar |
| "### Introducción" bajo un apartado | Eliminar (el encabezado ya introduce) |
Frases de apertura válidas:
- Ir directo al contenido