Manual de operacion del sistema MaqMinig

1. Acceso y navegacion

1. Abra http://127.0.0.1:8000/ en el computador donde funciona el servicio. La portada corporativa presenta equipos, servicios y contacto. Pulse Acceder al portal o entre directamente al Portal MaqMinig.
2. Para buscar catalogos publicados, pulse Consultar catalogos sin cuenta.
3. Para operar gestion, ingrese su usuario y contrasena en Acceso del personal. Si es una clave temporal, cambiela antes de continuar.
4. Use los enlaces superiores para cambiar de modulo y el menu izquierdo para elegir una opcion. En movil, el menu puede aparecer sobre el contenido.
5. Seleccione la empresa cuando el modulo lo solicite. Compruebe empresa y moneda antes de guardar.
6. Guarde los formularios antes de cambiar de registro, empresa o modulo. Alternar opciones del mismo menu conserva formularios, pero no reemplaza el guardado.
7. Al terminar, use Cerrar sesion. No comparta su cuenta.

127.0.0.1 apunta al propio computador: esta direccion no permite entrar desde otro equipo. El servicio no esta desplegado para Internet. El inicio integrado usa el primer puerto disponible entre 8000 y 8010, normalmente 8000. No abra una segunda instancia para atender la misma base.

Modo de desarrollo sin inicio de sesion: la variable OCR_DEV_AUTH_DISABLED=true permite acceso con rol de administrador, sin clave, solo desde direcciones locales. En ese modo, el boton de acceso de la portada abre directamente Gestion empresarial. No la habilite en equipos compartidos ni en una instancia accesible por red. El valor predeterminado es false.

Para cambiar su clave: Catalogos / Mi cuenta, opcion Cambiar contrasena. No se incluyen claves reales en este manual.

2. Roles y permisos

El OCR se opera desde el panel privado de documentos, visible en Panel general solo para administrador o gerente general. La consulta publica usa informacion ya procesada y no inicia OCR. En modo de desarrollo sin autenticacion, toda conexion local asume administrador; la diferenciacion real de perfiles requiere iniciar sesion.

En Usuarios, el administrador crea cuentas y entrega la clave temporal por un medio privado. Puede activar/desactivar, cambiar rol o restablecer clave. Una ficha de colaborador no crea automaticamente una cuenta de acceso. La separacion por area se aplica a menus, indicadores, paginas y API. Bodega consulta compras y ventas para recibir y despachar; Administracion y Contabilidad consultan ventas para prefacturar. La facturacion disponible es interna, no tributaria.

3. Buscar repuestos y ver dibujos

1. Entre a Asistente tecnica y seleccione el equipo/catalogo correcto.
2. Busque por codigo completo, conservando ceros, o por descripcion. Ejemplos: 5590 0002 88, 5590-0002-88, bomba hidraulica.
3. Revise el nombre del catalogo y la pagina fisica de cada resultado. La busqueda muestra hasta cinco fuentes; acote los terminos si hay muchas coincidencias.
4. Pulse Ver pagina original para cotejar la fuente.
5. Pulse Ver coincidencias en la imagen: el amarillo marca texto/codigos. Revise la posicion, el codigo y la descripcion de la fila.
6. Si hay un despiece candidato, pulse Ver dibujo y localizar llamada. Solo se consultan marcas ya procesadas. Las marcas rojas son posibles etiquetas de posicion, no el contorno de una pieza.
7. Si aparecen varias laminas, cotejelas. Son alternativas del conjunto, no confirmaciones de que la pieza aparezca en todas. Use Ampliar y el desplazamiento interno.
8. Si no se localiza la etiqueta, revise el dibujo manualmente. Una pagina puede tener dibujo sin llamadas o no tener coordenadas disponibles con confianza suficiente.

La consulta es documental, no una conversacion con IA generativa. Reconoce un glosario limitado espanol/ingles. No garantiza sinonimos generales, identificacion por foto ni compatibilidad mecanica.

Ejemplos comprobados en los catalogos originales:

Las paginas se cuentan desde el comienzo del PDF: pueden no coincidir con la numeracion impresa. El historial de consultas se pierde al recargar. Active Combinar con los terminos de la ultima consulta exitosa solo si desea reutilizar esos terminos; no interpreta pronombres ni combina codigos con descripciones anteriores.

4. Cargar, procesar y publicar PDF

Reservado a Administrador y Gerente general. Use un archivo de confianza y compruebe primero que abre completo en un visor PDF.

1. Abra Administrar documentos y elija Cargar documento.
2. Seleccione el archivo y pulse Cargar y procesar. No repita la carga por una espera normal.
3. En Documentos / Publicacion, pulse Actualizar lista y revise el estado: pendiente, en procesamiento, completado o fallido. La cola procesa un documento a la vez.
4. Si termino, abra la consulta interna y compare portada, primeras/ultimas paginas y varios codigos reales. Compruebe la cantidad de paginas. Procesado no significa revisado por una persona.
5. Asigne un titulo descriptivo y el equipo exacto. Distinga variantes, revisiones y versiones de una perforadora.
6. Solo despues de comprobar el resultado, active la publicacion y guarde. Compruebe que aparece en el selector de la consulta publica.
7. Para retirar acceso publico, desactive la publicacion y guarde. No se borra el original ni el historial. No se pueden retirar imagenes que alguien ya haya descargado.

Limites configurados en esta instalacion: 60 MB y 1.500 paginas por documento. Los valores efectivos aparecen en la pantalla de carga. Los originales no se modifican. Si hay texto digital, se extrae directamente; si una pagina no tiene palabras digitales, se aplica OCR. En paginas mixtas, el texto digital no implica que tambien se hayan reconocido sus imagenes.

No cargue de nuevo un PDF solo porque cambio el nombre. MT2010 Pdf9 y ST710 Pdf7 son copias identicas de los catalogos ya existentes. Los dos COP 1838 son diferentes: HD y C-version. El archivo Catalogo S7 D 8.pdf esta danado; use la copia valida _Spare Parts Catalog - S7D10.pdf.

Si el trabajo falla, lea el error. Un fallo de pagina invalida el trabajo completo; no se publica un resultado parcial. Corrija la causa antes de volver a cargar. El sistema no elimina automaticamente intentos fallidos.

Resultado de la carga del 20 de octubre de 2026

Los tres documentos nuevos contienen texto digital en todas sus paginas: se extrajeron texto y coordenadas sin degradarlos mediante OCR de imagen innecesario. Hay ocho catalogos publicados tras esta carga. La consulta publica de dibujos no inicia OCR; esta carga no representa una revision humana de todas las piezas ni un reconocimiento de todos los dibujos.

5. Revision humana y recortes

1. Como administrador, abra Catalogos y active Mostrar herramientas tecnicas. Tambien puede seguir Abrir revision del personal desde un resultado visual.
2. Seleccione el catalogo y la pagina; compare texto, codigos y tablas con la imagen original.
3. En Revision humana de esta pagina, registre el estado y las comprobaciones reales. Si requiere correccion, no la marque aceptada.
4. Para confirmar un vinculo, compruebe pagina del dibujo, pagina de lista, posicion y codigo. Guarde la revision solo despues de cotejar esos cuatro datos.
5. Para un recorte, abra el dibujo, active Seleccionar pieza, arrastre el rectangulo y complete codigo, posicion, pagina de lista y revisor. Pulse Guardar recorte asociado.
6. Vuelva a consultar el codigo y revise la asociacion. Si se retira una revision aceptada, deja de respaldar un vinculo confirmado publico.

Un recorte manual no segmenta automaticamente el objeto: puede incluir fondo o piezas vecinas. Nunca acepte automaticamente todas las sugerencias. Algunos formatos COP pueden permitir resaltar texto sin que el parser reconozca su relacion lista/despiece; use revision manual.

6. Configuracion inicial de gestion

1. En Empresas, registre la empresa emisora con sus datos reales y dejela activa.
2. En Panel / Contactos, cree clientes y proveedores por separado. Una misma entidad puede tener ambas fichas; una ficha de proveedor no sirve como cliente de una cotizacion.
3. En Inventario, seleccione la empresa y cree Productos / SKU y Bodegas. Empresa, SKU y unidad del producto no se cambian despues.
4. Si existe stock real inicial, registre una entrada en Ajustes de stock con cantidad, bodega y motivo verificable. No invente saldos de prueba.
5. Verifique los saldos y deje los maestros activos antes de emitir documentos.

Los contactos y productos no se crean automaticamente a partir del OCR. No hay validacion oficial de RUT. Desactivar conserva el historial; no equivale a borrar.

7. CRM, cotizacion y orden de venta

Seguimiento comercial

1. En CRM comercial, cree una oportunidad para un cliente, con responsable, importe estimado, moneda, proxima accion y fecha de seguimiento.
2. Actualice el Kanban: Nueva, Contactada, Calificada, Cotizacion, Negociacion, Ganada o Perdida. Puede arrastrar tarjetas o abrir la ficha y seleccionar la etapa; Perdida exige motivo.
3. Registre llamadas, reuniones y notas. Vincule una cotizacion principal del mismo cliente si corresponde.

Aceptar una cotizacion no mueve automaticamente la oportunidad a Ganada. Actualice ambas cosas.

Emitir cotizacion y convertirla

1. En Cotizaciones, seleccione emisor y cliente activos.
2. Agregue descripciones, cantidades, precios netos, moneda CLP/USD, IVA 19% o exenta, fecha, vigencia y condiciones. Guarde el borrador y revise el total calculado por el servidor.
3. Use la vista del documento y Imprimir / Guardar PDF para entregar la oferta.
4. Marque Enviada cuando realmente la haya enviado por el medio acordado. Ese cambio no manda correo.
5. Registre la aceptacion o rechazo del cliente. Solo los borradores permiten editar importes.
6. En una aceptada, pulse Convertir en orden de venta / Ver orden existente. Se permite una sola orden por cotizacion; no repita para crear otra.
7. En Ventas, gestione Pendiente, En preparacion y, al atender todas las cantidades, Entregada. Los cambios requieren motivo.

El stock no se reserva por cambiar el estado de la venta. La salida se registra mediante despacho. Una venta atendida no se puede anular: las devoluciones no estan implementadas. Numeraciones COT, OV y OC son globales y pueden tener saltos.

8. Solicitudes y compras a proveedores

1. En Solicitudes, seleccione empresa, agregue productos/cantidades, fecha requerida y motivo. Presente la solicitud.
2. Administrador, Gerente general, Bodega o Administracion abre Detalle / Aprobacion y aprueba o rechaza con motivo. La decision es definitiva.
3. Desde una aprobada, use Crear compra vinculada para compras parciales sin superar las cantidades autorizadas. Tambien existen compras directas en Compras.
4. Elija proveedor, productos, moneda, impuesto, cantidades y precios. Revise antes de emitir: las compras se emiten directamente; no tienen borrador ni edicion posterior.
5. Al recibir mercaderia, abra la orden, seleccione la bodega y registre solo lo realmente recibido. Se admiten recepciones parciales.
6. Compruebe recepcion, saldo pendiente y movimientos de inventario.

Emitir la orden no aumenta stock; confirmar recepcion si lo aumenta. Anular una compra parcial cancela el saldo pendiente, no lo recibido ni su stock. Tampoco se generan compras automaticamente desde una orden de venta.

9. Inventario y despachos

• Existencias y movimientos: seleccione empresa y filtre producto/bodega. Un par sin movimientos tiene saldo cero. Revise tambien las paginas siguientes.
• Ajustes de stock: entrada o salida con cantidad y motivo. No hay stock negativo. Para corregir, documente un ajuste; no se eliminan movimientos.
• Transferencias: producto, bodega origen y destino, cantidad y motivo. Deben ser bodegas distintas de la misma empresa.

Atender una venta

1. Abra la orden en Ventas y use Clasificar lineas / Registrar despacho o prestacion.
2. Clasifique cada linea como producto y SKU, o como servicio. Guarde la clasificacion. Queda fija desde la primera cantidad atendida.
3. Seleccione bodega para productos, indique cantidades reales y referencia/motivo, y confirme. Los productos descuentan stock; los servicios solo registran cantidades prestadas.
4. Revise el historial. Cuando todo este atendido, vuelva a Ventas y marque Entregada.

La trazabilidad es por movimiento/documento/producto/bodega, no por lote ni numero de serie. No hay reservas, valorizacion ni devoluciones.

10. Prefacturas, cobros y gastos

Prefacturas y cobros manuales

1. En Finanzas, elija Emitir prefactura, seleccione la orden y pulse Cargar cantidades.
2. Indique cantidades parciales, emision, vencimiento y condiciones/motivo. No supere el saldo disponible.
3. Emita, revise e imprima si corresponde. Este documento no modifica stock ni el estado de la venta.
4. En Detalle / Cobros, registre importe realmente cobrado, fecha, referencia y motivo. No se permite exceder el saldo ni usar una fecha futura.
5. Para corregir un cobro, reviertalo con motivo. Antes de anular una prefactura, revierta todos sus cobros. Antes de anular una venta, anule sus prefacturas.

Los reportes separan CLP y USD. El saldo es el saldo actual de prefacturas emitidas en el periodo, no un cierre historico ni un estado contable. No hay conexion con bancos ni SII.

Gastos

1. En Gastos, seleccione empresa y registre categoria, moneda, importe, fecha, comprobante y motivo. Si corresponde, vincule proyecto o vehiculo de esa empresa.
2. Revise los datos antes de confirmar. Para corregir un gasto, Administrador, Gerente general, Administracion o Contabilidad debe anularlo con motivo y luego se registra el correcto.

La anulacion directa requiere uno de esos perfiles. El historial guarda su identidad como autorizador, fecha y razon. No existe flujo de solicitud y segundo aprobador.

Documentos de compras y bodega

En Compras, abra una orden y pulse Imprimir orden de compra / Guardar PDF. Incluye proveedor, cantidades pedidas originalmente, precios, IVA, total, condiciones y estado actual. No es factura y no registra recepciones.

En Inventario, junto a cada despacho confirmado, pulse Imprimir salida / Prestacion / Guardar PDF. Tambien esta disponible desde los movimientos de tipo despacho. El comprobante muestra cantidades de esa operacion, no el acumulado de la venta, ademas de bodega, usuario, fecha y referencia. Los servicios no descuentan stock; si solo hay servicios se imprime un comprobante de prestacion. No es guia de despacho tributaria. Reimprimir no genera movimientos.

Los despachos anteriores conservan el identificador de bodega; si no guardaron su nombre historico, el documento advierte que muestra el nombre actual de la ficha. Ajustes manuales y transferencias no tienen este formato de salida.

11. Proyectos, colaboradores y flota

Proyectos

En Proyectos, cree la ficha por empresa con responsable, fechas y cliente opcional. Agregue tareas con responsable y vencimiento dentro del periodo del proyecto. Mantenga estados y motivos. El avance considera tareas terminadas sobre tareas no anuladas. Para terminar, debe haber al menos una tarea terminada y ninguna pendiente/en curso. Los proyectos terminados o anulados quedan cerrados.

Colaboradores: Administrador, Gerente general y Administracion

En Colaboradores, complete identificacion, cargo, fechas, domicilio, comuna, region, nacimiento, nacionalidad, contacto, emergencia, AFP y Fonasa/Isapre. Para Isapre indique institucion y, si corresponde, plan; esos campos no aplican a Fonasa. Nacimiento debe ser anterior al ingreso y no futuro. Proteja estos datos personales. No se calculan sueldos ni cotizaciones legales.

Flota

En Flota, registre patente, marca, modelo, ano, VIN/chasis, motor y especificaciones. El VIN exige 17 caracteres y excluye I/O/Q. Revise unidad de cilindrada (cm3) y carga (kg). Asigne usuarios activos y registre uso/mantenimiento sin retroceder kilometraje o fechas ni usar eventos futuros.

12. Rutina y correccion de errores

Al iniciar la jornada

• Compruebe acceso, usuario, empresa y fecha del equipo.
• Revise seguimientos vencidos, solicitudes pendientes, compras por recibir y ventas por atender.
• No use datos de demostracion como operaciones reales.

Antes de confirmar una operacion

• Compruebe empresa, tercero, moneda, cantidades, bodega, impuesto y documento origen.
• Tras una interrupcion de red, consulte el documento/historial antes de iniciar otra operacion: puede haberse guardado aunque no haya llegado la respuesta.
• Ante conflicto por cambios de otro usuario (409), conserve una copia de sus notas, recargue el registro y coteje la version vigente. No sobrescriba a ciegas.

Al cerrar la jornada

• Revise recepciones, despachos, cobros y gastos registrados; concilie con comprobantes reales.
• Guarde documentos necesarios, cierre sesion y compruebe que se cumplio la politica de respaldo.
• No cierre la terminal ni reinicie Windows durante una carga/OCR activa.

13. Inicio, respaldo y soporte tecnico

Seccion para el encargado tecnico. No cambie credenciales ni restaure bases en uso como prueba.

Inicio controlado de esta instalacion

Primero abra /health: si responde correctamente con auth_enabled: true y ocr.ready: true, el servicio ya funciona. No ejecute otra instancia. Si esta detenido, el encargado puede usar PowerShell:

Set-Location D:\Rodrigo\OCR
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\Start-Ocr-Postgres.ps1

No publique el puerto a Internet ni use --host 0.0.0.0. La opcion de ejecucion PowerShell del comando anterior solo se aplica a ese proceso. No imprima ni comparta el contenido de la credencial. Mantenga la terminal abierta; para detener normalmente, espere el fin del documento activo y pulse Ctrl + C. Una terminacion forzada puede dejar el trabajo activo fallido; los pendientes permanecen en cola.

La configuracion local .env define OCR_MAX_PAGES=1500 y OCR_MAX_UPLOAD_MB=60. Requiere reiniciar la unica instancia para aplicar cambios. Las variables del proceso prevalecen sobre el archivo. Compruebe limites en /v1/capabilities. No ejecute un worker antiguo contra la misma base.

Respaldo: PostgreSQL y originales

Esta instalacion usa PostgreSQL. El comando catalog_ocr.backup documentado para SQLite no respalda la gestion PostgreSQL. Copiar solo los PDF tampoco respalda resultados, usuarios, revisiones ni operaciones empresariales.

1. Acuerde una ventana sin operaciones. Termine el trabajo activo y detenga la aplicacion. Mantenga PostgreSQL disponible para realizar el volcado.
2. Genere un respaldo completo de la base catalog_ocr en 127.0.0.1:5433 mediante pg_dump de PostgreSQL 17, formato personalizado, incluyendo todas las tablas y secuencias. Use autenticacion segura, sin poner claves en nombres de archivo ni comandos compartidos.
3. Copie toda la carpeta de datos D:\Rodrigo\OCR\data, incluidos originales en uploads, junto al volcado de la misma ventana. No borre ni renombre originales internos.
4. Conserve tambien configuracion y procedimiento de instalacion. Resguarde credenciales por separado con acceso restringido. No coloque respaldos en carpetas publicas de la aplicacion.
5. Compruebe integridad de archivos y haga una restauracion de prueba en una base/carpeta separadas, con acceso restringido y fuera de la instancia activa. Verifique catalogos, resultados, usuarios, cotizaciones, ventas, compras, stock, pagos y revisiones.
6. Reinicie el servicio y compruebe /health. Mantenga otra copia protegida fuera del equipo.

Frecuencia recomendada: diaria cuando hay operaciones y antes de cambios importantes. Asigne responsable y retencion; no existe tarea automatica de respaldo configurada por este manual. La restauracion productiva requiere un procedimiento del encargado tecnico, no sobrescribir una carpeta en uso.

Informacion para solicitar soporte

Entregue fecha/hora, modulo, numero o ID del documento, accion realizada y mensaje exacto. Para OCR agregue nombre del PDF y pagina fisica. No envie contrasenas, fichas personales ni documentos completos a terceros sin autorizacion.

14. Limites y funciones pendientes

• Sin identificacion por fotografia, reconocimiento de contornos ni garantia automatica de compatibilidad.
• Sin PDF buscable nuevo: se conserva el PDF original y el texto extraido en el sistema.
• Sin conversion automatica de catalogo en maestro de productos/precios.
• Sin reservas, lotes, series, devoluciones ni valorizacion de inventario.
• Sin SII/DTE, facturas tributarias, bancos, conciliacion ni contabilidad formal.
• Sin calculo de remuneraciones legales, liquidaciones, AFP o salud: solo antecedentes de colaboradores.
• Sin costeo/presupuesto de proyectos ni compras automaticas desde ventas.
• Sin envio automatico de correo por marcar una cotizacion como enviada.
• Sin despliegue publico seguro ni respaldo automatico por defecto.
• Busqueda visual (enlace de posiciones con dibujos) validada solo en ST710, MT2010, ST1030, Boomer 281 y Boomer S1D. En COP 1838 (HD y C) y Simba S7 D funciona la busqueda de texto con resaltado, pero los enlaces a dibujos no estan validados.
• Sin respaldo automatico de PostgreSQL: haga pg_dump y copie la carpeta de datos periodicamente.
• La clave temporal de administrador debe cambiarse antes de exponer el sistema fuera de este equipo.
• No se pueden borrar ni ocultar registros de carga fallidos: quedan en Documentos solo como historial (por ejemplo el primer intento de Simba S7 D).
• Solo una instancia del servidor puede funcionar por base de datos; una segunda con limites antiguos toma trabajos de la cola y los hace fallar.
• Archivo pendiente: Catalogo S7 D 8.pdf esta danado y no se puede procesar; se requiere una copia nueva.

Este manual describe lo disponible, no sustituye procedimientos tecnicos del fabricante ni asesoramiento legal, tributario o laboral.