Manual completo de FarmaFormula

🔒 Acceso y seguridad

La app está protegida por una única clave de acceso compartida (no hay usuarios individuales). La clave de fábrica es farmacia, pero se puede cambiar desde "¿Olvidaste la clave?" respondiendo a una pregunta de seguridad (por defecto: número de colegiado del farmacéutico titular).

• Si se cambia la clave y se olvida junto con la respuesta de seguridad, no hay forma de recuperarla desde la propia app.
• Visitando la dirección con /?reset al final se borra la clave personalizada guardada en este navegador y vuelve a la de fábrica — útil si un dispositivo se queda con una clave antigua.
• La sesión se mantiene mientras no se pulse "🔒 Salir" (topbar, arriba a la derecha).

📊 Panel de control

Primera pantalla al entrar. Resumen del estado general de la farmacia, sin necesidad de entrar en cada módulo.

Tarjetas de resumen

• Encargos activos — suma de Pendiente + En preparación.
• En elaboración — encargos con estado En preparación.
• Listos para recoger — encargos en estado Listo.
• Alertas stock — principios activos con stock bajo mínimo o próximos a caducar.

Últimos encargos

Los 5 encargos más recientes, con un botón 💰 por fila que abre directamente la calculadora de precio para ese encargo, sin tener que ir a Encargos ni a Elaboración.

Alertas de stock

Lista de principios activos con stock bajo mínimo (🟡) o crítico/caducado (🔴). Si todo está en niveles correctos, se muestra un aviso verde de confirmación en vez de una lista vacía.

Presupuestos pendientes de valorar

Tarjeta que solo aparece si hay algo pendiente — si no hay ninguna solicitud, queda oculta por completo. Son peticiones de presupuesto que llegan desde el formulario web de farmacialeman.es, con el nombre del paciente, médico y las notas de lo que pide (texto libre, sin composición estructurada todavía).

• Botón 💰 — abre la calculadora en modo "presupuesto": muestra la nota de la solicitud como referencia y deja rellenar la composición a mano para calcular un precio con las tarifas oficiales. Al calcular, "Usar este importe" copia el total al campo de importe de esa fila (no lo envía solo).
• Campo Importe (€) — se puede escribir directamente a mano si no hace falta la calculadora.
• Botón Valorar — envía el importe de vuelta a farmacialeman.es y la solicitud desaparece de la lista.

📋 Encargos

Listado completo de encargos, con filtros, edición y control de estado.

Tabla y filtros

Buscador por paciente, fórmula o número de encargo, y filtro por estado. Columnas: Nº, Fecha, Paciente, Médico, Fórmula, Prioridad, Estado, Precio y Acciones.

Ciclo de estados

Cada encargo pasa por cuatro estados en orden: Pendiente → En preparación → Listo → Dispensado.

• ▶ Avanzar estado — pasa al siguiente estado. Al llegar a "Listo" se ofrece avisar al paciente por WhatsApp y se sincroniza automáticamente con farmacialeman.es.
• ◀ Retroceder estado — deshace un avance hecho por error de clic. No aparece en "Pendiente" (no hay estado anterior). No retira un aviso de WhatsApp que ya se haya enviado al llegar a "Listo" — un mensaje ya mandado no se puede deshacer.
• 🔄 Reintentar sincronización — solo visible en Listo/Dispensado; reintenta avisar a farmacialeman.es si esa sincronización falló al marcar el encargo como listo.

Editar un encargo

Botón ✏ abre el modal completo: paciente, DNI/Nº SS, médico prescriptor y colegiado, teléfono, fórmula magistral, composición (filas de principio/cantidad/unidad con autocompletado contra el catálogo), forma farmacéutica, cantidad, prioridad, fecha necesaria, observaciones, prospecto y PNT asociados, e imágenes de receta adjuntas.

• Cargar desde base del catálogo — desplegable arriba del todo: si la fórmula ya existe como Base guardada, rellena automáticamente todos los campos.
• Botón 💰 Precio dentro del modal — abre la calculadora sobre este encargo en concreto.

Eliminar

Botón ✕, pide confirmación antes de borrar.

🧪 Elaboración

Dos pestañas: Cola de trabajo Elaboración activa

Cola de trabajo

Encargos pendientes de fabricar, ordenados por prioridad (Urgente > Alta > Normal). Botón ▶ Iniciar pasa el encargo a "En preparación" y abre la pestaña "Elaboración activa" con el checklist recién reiniciado.

Elaboración activa

Datos del encargo: paciente, forma/cantidad, médico, composición (con badges 💰 Financiable / AR si el principio está en el catálogo oficial) y observaciones. Botón ✏ Editar fórmula abre el mismo modal de edición de Encargos sin salir de esta pantalla — útil si falta completar algún dato mientras se está fabricando; al guardar, esta vista se actualiza sola sin perder el checklist ni lo ya rellenado.

Registro de calidad: Nº de lote, temperatura (°C), humedad (%) y farmacéutico responsable.

Checklist de elaboración — 10 pasos fijos iguales para cualquier fórmula: verificar prescripción, comprobar identidad del paciente, preparar materiales, pesar/medir con balanza calibrada, preparar la mezcla, verificar homogeneidad, ajustar pH/características, envasar, etiquetar (RD 175/2001) y registrar en el libro de fórmulas magistrales.

Finalizar

Botón ✓ Finalizar elaboración: si quedan pasos sin marcar, pide confirmación antes de seguir. Guarda lote/farmacéutico/temperatura/humedad, marca el encargo como "Listo", avisa a farmacialeman.es/WhatsApp y descuenta stock automáticamente.

🧫 Principios activos (Stock)

Esta sección del menú es la vista de inventario — no es un catálogo aparte, sino los principios activos del catálogo que tienen stock registrado.

Filtro por estado: Todos / Stock OK / Stock bajo / Crítico. Columnas: principio activo, stock actual, unidad, mínimo, caducidad y estado.

• Crítico — stock agotado o por debajo del 50% del mínimo, o ya caducado.
• Bajo — por debajo del mínimo (pero por encima del 50%), o caduca en menos de 30 días.
• OK — cualquier otro caso.

Editar/eliminar y "+ Añadir principio activo" abren el mismo modal completo que en Catálogos → Principios activos — los datos de precio/financiación y de inventario viven en el mismo formulario.

🏷️ Etiquetado

Generador de etiquetas de un solo uso, independiente de Encargos.

Formulario con vista previa en vivo: paciente, fórmula/composición, forma farmacéutica, cantidad, nº de lote, fecha de elaboración y caducidad, posología, médico prescriptor y observaciones. Cada campo actualiza la vista previa al momento.

Botón 🖨️ Imprimir etiqueta lanza directamente la impresión del navegador.

📄 Prospectos y PNTs

Dos secciones del menú (Prospectos y PNTs) que funcionan igual, solo cambia qué tipo de documento gestionan.

Tabla: nombre, tipo de fórmula, fecha y acciones (👁 ver, ✏ editar, ✕ eliminar). Botón "+ Nuevo" para crear uno desde cero.

Dos modos de edición

• 📝 Editor de texto — editor visual (Quill) con formato, títulos, listas, colores, etc. Permite importar un .docx o .pdf existente para pegarlo directamente en el editor.
• 📄 PDF directo — subir un PDF ya maquetado tal cual, sin pasar por el editor.

Al ver un documento (👁), si es un PDF se muestra embebido en la propia página; si es HTML antiguo se muestra con los mismos estilos de impresión que usa el editor.

📦 Cajas (Kajica)

Diseño e impresión de las cajas troqueladas para envasar las fórmulas magistrales.

"Kajica" es el nombre de la línea de troqueles predefinidos de fábrica — 13 plantillas de serie (formatos desde A4 hasta A3), cada una con la imagen real del troquel y las coordenadas exactas (en mm) de cada cara imprimible.

Columna izquierda

• Encargo — desplegable para precargar los datos desde un encargo existente, o rellenarlos a mano: fórmula, paciente, DNI, médico, colegiado, cantidad/forma, composición, posología, advertencias, lote y caducidad.
• Plantilla de caja — elegir una de las 13 Kajica de serie, o crear una nueva a medida con "+ Nueva plantilla" (alto/ancho/profundidad de la cara en mm; la app calcula si el troquel desplegado cabe en una hoja A4 apaisado y bloquea el guardado si no cabe).
• Acciones — 🖨️ Generar PDF, 👁 Actualizar vista previa, 💾 Guardar configuración (solo en este navegador, no en el servidor).

Columna derecha — Vista previa

Pestañas Troquel Caras: el troquel muestra el dibujo a escala con todas las caras superpuestas y clicables; al hacer clic en una cara se abre un editor con contenido personalizado (opcional), tamaño de letra y alineación.

Generar PDF

Produce un PDF de dos páginas: la caja troquelada lista para imprimir y recortar, y una segunda página "Ficha de fórmula magistral" en A4 con todos los datos en formato tabla. El archivo se nombra caja_<fórmula>_<lote>.pdf.

🕒 Historial

Vista de todos los encargos (no solo los ya finalizados), del más reciente al más antiguo, con buscador por paciente, fórmula o lote.

Columnas: Nº, fecha, paciente, fórmula, lote, farmacéutico responsable y estado.

Botón ⬇ Exportar CSV (también disponible en la topbar general) descarga un CSV con todos los encargos y todos sus campos (paciente, DNI, médico, fórmula, forma, cantidad, prioridad, estado, lote, farmacéutico), independientemente del filtro de búsqueda aplicado en pantalla.

🗂️ Catálogos

Cinco pestañas: Pacientes Médicos Principios activos Bases Tarifas oficiales

Pacientes y Médicos

Listados simples compartidos con farmacialeman.es (ver Sincronización) — editar o dar de alta desde cualquiera de los dos sistemas actualiza el dato en ambos al momento. Pacientes: nombre, DNI/Nº SS, teléfono. Médicos: nombre, nº de colegiado, especialidad.

Principios activos

El catálogo maestro de sustancias — es la misma tabla que alimenta la vista de Stock. Columnas visibles en la tabla: nombre, sinónimos, unidades habituales, precio €/g·mL, stock, estado y uso autorizado/condiciones (nada queda escondido dentro del modal).

Financiable significa que el principio está en la Tabla B-I oficial de la Región de Murcia y tiene precio público — si solo tiene precio privado, se marca como "no financiable" en la calculadora de precio.

Bases

Plantillas de fórmula reutilizables (con o sin paciente concreto asociado): nombre, paciente, médico, fórmula magistral, composición, forma, cantidad, y prospecto/PNT asociados. Se aplican desde el modal de Encargos con "Cargar desde base del catálogo → Aplicar", rellenando todos los campos de golpe.

Tarifas oficiales

Los datos que alimentan la calculadora de precio, tal y como los fija el Concierto SMS-COFRM (Anexo B, BORM nº98 29/04/2022):

• Configuración — Factor P (€, se revisa cada año por el COFRM) e IVA de fórmulas magistrales (%). Editable desde aquí, no hay que tocar código cuando cambie.
• Excipientes (B-II) — nombre, precio, cantidad base ("fracción") y nota.
• Formas farmacéuticas (B-III) — nombre, máximo por receta, coeficiente de complejidad galénica y nota. Si el coeficiente queda vacío, la forma aparece "Pendiente COFRM" y no se puede usar en el cálculo hasta que se rellene.
• Envases (B-IV) — categoría, nombre y precio.

💰 Calculadora de precio

Calcula el precio oficial de una fórmula magistral según las tarifas de la Región de Murcia. Se abre desde varios sitios: el botón 💰 en el Panel, en el modal de Encargos, en Elaboración activa, o al "Valorar" un presupuesto pendiente.

• El excipiente se cobra por fracción completa: si la cantidad total supera la "cantidad base" del excipiente, se redondea hacia arriba al siguiente múltiplo entero, no de forma proporcional.
• La fórmula se marca "💰 Financiable por el SMS" solo si todos los principios de la composición tienen precio oficial (Tabla B-I) — basta con que uno solo use precio privado para que el resultado pase a "⚠ No financiable — precio orientativo".
• Si un principio no tiene ni precio oficial ni privado en el catálogo, o su cantidad/unidad no es válida, se excluye del cálculo y aparece un aviso explicando por qué — el cálculo no se bloquea, se hace con lo que sí tiene datos.

Dos modos

• Sobre un encargo real (Panel, Encargos, Elaboración) — la composición se lee automáticamente del encargo; el resultado se puede guardar con "Guardar en el encargo" (queda el total y el desglose completo guardados en ese encargo).
• Sobre un presupuesto pendiente (farmacialeman.es todavía no tiene composición estructurada) — se muestra la nota de la solicitud como referencia y hay que rellenar la composición a mano. El botón pasa a llamarse "Usar este importe": copia el total calculado al campo de importe de esa solicitud en el Panel, pero no lo envía — hay que pulsar "Valorar" aparte para confirmarlo.

🔄 Sincronización con farmacialeman.es

Cómo se mueve un encargo entre farmacialeman.es (captación de pacientes) y farmaformula.es (fabricación).

📶 Modo offline y datos locales

La app guarda una copia de los datos en este navegador (localStorage) para poder mostrar algo aunque falle la conexión.

• Si falla la conexión con la base de datos propia de FarmaFormula, aparece un banner naranja cubriendo toda la app: "Sin conexión al servidor — mostrando datos locales. Los cambios no se guardarán en la base de datos". El punto junto al reloj se pone rojo.
• Si solo falla el servicio externo de pacientes/médicos de farmacialeman.es (pero la base de datos propia va bien), aparece un banner más discreto que no bloquea el resto de la app — se puede seguir trabajando con encargos, elaboración, etc. con normalidad.
• La conexión se revisa automáticamente cada 60 segundos.
• El botón "↺ Sincronizar" de la topbar, además de traer encargos nuevos de farmacialeman.es, recarga todos los datos propios y los presupuestos pendientes.