📱 Smart Field Auditor (Auditor de Campo Inteligente)

Smart Field Auditor es una solución móvil integral de inspección técnica desarrollada sobre Microsoft Power Platform, diseñada para inspectores y auditores en campo que supervisan maquinaria industrial, infraestructuras, vehículos y obras de construcción en tiempo real.

La herramienta combina captura de datos asistida por Inteligencia Artificial (OCR), telemetría ambiental en tiempo real (coordenadas GPS y clima vía API REST) y un backend automatizado que compila y archiva informes técnicos en formato PDF dentro de OneDrive / SharePoint.

---

📸 Capturas de Pantalla (Flujo de la App)

Paso 0: Catálogo de Activos	Paso 1: Verificación OCR + GPS	Paso 2: Registro de Evidencias

---

🚀 Características Principales

• Flujo Asistido (Wizard UI/UX): Proceso guiado en 2 fases con cálculo de progreso (50% y 100%) y métricas visuales agrupadas por nivel de severidad (Crítico, Aviso, Leve).
• Reconocimiento Óptico de Caracteres (AI Builder): Modelo de visión artificial integrado para leer etiquetas industriales y placas metálicas en vivo, validando el número de serie de forma desatendida.
• Telemetría Ambiental (API REST Externa): Captura de geolocalización GPS y consumo de endpoints meteorológicos (OpenWeatherMap API) para registrar temperatura y condiciones ambientales en el momento exacto de la auditoría.
• Arquitectura Híbrida de Medios (Power Fx): Desacoplamiento de colecciones en memoria que separa el renderizado visual (FotoVista) de la carga Base64 pura (FotoBinaria), optimizando la transferencia JSON hacia la nube.
• Generación Automatizada de Reportes Técnicos: Orquestación cloud mediante Power Automate para transformar matrices de datos en informes PDF listos para distribución técnica.

---

🏗️ Arquitectura de la Solución

┌─────────────────────────────────────────────────────────────┐
│             Dispositivo Móvil (Campo)                       │
│  • AI Builder (OCR Serial Tag)  • Cámara Nativa             │
│  • Power Fx State Management (Clean Collections Engine)     │
└──────────────────────────────┬──────────────────────────────┘
                               │
            ┌──────────────────┴──────────────────┐
            ▼                                     ▼
┌───────────────────────────┐         ┌───────────────────────┐
│   Power Apps Canvas App   │         │  External REST API    │
│  • UI Responsive          │◄────────┤  • GPS Geocoding      │
│  • JSON Payload Packager  │ (HTTP)  │  • OpenWeatherMap     │
└─────────────┬─────────────┘         └───────────────────────┘
              │ 
              │ JSON Envelope (Metadata + Base64 Array)
              ▼
┌─────────────────────────────────────────────────────────────┐
│           Power Automate Cloud Flow (Instant V2)            │
│  • Parse JSON (Typed Schema Validation)                     │
│  • Base64 Decode (dataUriToBinary processing)               │
│  • HTML Template Compilation & PDF Rendering                │
└──────────────┬──────────────────────────────┬───────────────┘
               │                              │
               ▼                              ▼
┌───────────────────────────┐   ┌─────────────────────────────┐
│    Microsoft Dataverse    │   │    OneDrive / SharePoint    │
│  • 1:N Relational Model   │   │  • PDF Technical Reports    │
│  • Auditoría e Históricos │   │  • Evidencias Binarias      │
└───────────────────────────┘   └─────────────────────────────┘

⚡ Flujo de Automatización (Power Automate)

---

🗄️ Modelo Relacional de Datos (Microsoft Dataverse)

El almacenamiento centralizado se estructura mediante relaciones 1:N consistentes para auditoría y trazabilidad:

Tabla / Entidad	Descripción	Atributos Clave
Activos (cr_activo)	Catálogo físico de equipos o zonas a inspeccionar.	ActivoID (PK), Nombre, NumeroSerie, Zona, Estado, Categoria
Inspecciones (cr_inspeccion)	Sesiones de inspección realizadas por los técnicos.	InspeccionID (PK), ActivoID (FK), Inspector, Fecha, Resultado, GPS_Lat, GPS_Long, Clima
Evidencias (cr_evidencia)	Fotografías, notas técnicas y severidad asignada.	EvidenciaID (PK), InspeccionID (FK), Titulo, Zona, Severidad, FotoURL

---

🛠️ Stack Tecnológico

• Power Apps (Canvas App): Formularios personalizados y gestión de estados con Power Fx (ClearCollect, ForAll, JSON, DropColumns, Mid).
• Power Automate: Flujos instantáneos V2, parseo de payloads JSON complejos y manipulación de binarios de imagen.
• AI Builder: OCR preentrenado para lectura automatizada de identificadores.
• Microsoft Dataverse: Capa transaccional con integridad referencial.
• Power Platform CLI (pac): Pipeline ALM para desempaquetar la solución y permitir control de versiones en Git.

---

📦 Estructura del Repositorio

Solución desempaquetada y versionada mediante pac solution unpack:

SmartFieldAuditor/
├── docs/                           # Documentación visual y capturas de pantalla
│   └── img/
│       ├── home.png                # Catálogo de activos
│       ├── step1.png               # Paso 1: OCR y GPS
│       ├── step2.png               # Paso 2: Evidencias y resumen
│       ├── report-preview.png      # Documento PDF final
│       └── flow-diagram.png        # Arquitectura del flujo en Power Automate
├── src/
│   ├── CanvasApps/                 # Código fuente YAML de pantallas y controles
│   ├── Entities/                   # Esquemas XML de las tablas de Dataverse
│   ├── Other/                      # Declaración de dependencias y relaciones
│   ├── Workflows/                  # Definiciones JSON de los flujos de nube
│   └── customizations.xml          # Configuración completa de la solución
├── .gitignore                      # Exclusión de binarios y cachés
└── README.md                       # Documentación técnica

---

⚙️ Ciclo de Vida y Despliegue (ALM)

Requisitos Previos

• Visual Studio Code con terminal PowerShell.
• Power Platform CLI instalada (winget install Microsoft.PowerAppsCLI o vía extensión oficial).
• Entorno de desarrollo con Dataverse y AI Builder activados.

1. Reempaquetar la Solución

Para compilar el código fuente descomprimido en un artefacto importable:

pac solution pack --zipfile "SmartFieldAuditor.zip" --folder "src"

2. Importar en un Entorno de Destino (Pruebas / Producción)

pac solution import --path "SmartFieldAuditor.zip"

---

🔧 Guía de Configuración y Variables de Entorno

Al importar la solución en un nuevo entorno:

1. Crear Conexiones:
   • Conector de Dataverse (autenticación de usuario actual).
   • Conector de OneDrive for Business o SharePoint con permisos de escritura para el guardado de PDFs.
2. Clave de API REST (Clima):
   • Configurar la variable de entorno cr_OpenWeatherApiKey con una API Key válida de OpenWeatherMap.
3. Ruta de Almacenamiento:
   • Definir la variable de entorno cr_RutaInformes apuntando a la carpeta de OneDrive o biblioteca de documentos de SharePoint designada.

---

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.