Conceptos Fundamentales
Antes de entrar a cualquier guía conviene entender el vocabulario y cómo encajan las piezas. En Cannahub casi todo se explica en relación con otra cosa: un miembro pertenece a una organización, dispensa en una filial, tiene una membresía, y lo que dispensa es un producto que salió de un cultivo de una cepa. Esta página define cada término en orden de dependencia —de lo más general a lo más específico— para que puedas leer el resto sin tropezar con palabras sueltas.
No hace falta memorizar esta página. Usala como diccionario: cada vez que una guía menciona un término en negrita azul, te trae acá, a su definición. Es el punto de partida recomendado antes de Empieza aquí.
Mapa del dominio
Este es el modelo mental completo. Las flechas se leen como "da origen a" o "depende de". Si entendés este diagrama, entendés la plataforma.
Cómo leer el mapa
Hay tres grandes bloques: la estructura (organización, filial, roles), las personas (miembro, membresía, REPROCANN) y la producción (cepa, cultivo, cosecha, stock, producto). Todo converge en la dispensación: el momento en que un miembro recibe su producto.
Organización
La organización (también llamada tenant en términos técnicos) es tu club: la entidad principal de toda la plataforma. Cannahub es multi-tenant, lo que significa que muchas organizaciones conviven en el mismo sistema pero totalmente aisladas entre sí: los datos de un club nunca se mezclan con los de otro.
En Argentina, un club de cannabis se constituye legalmente como asociación civil sin fines de lucro. La organización en Cannahub representa a esa asociación: tiene un nombre, un logo, una moneda, un idioma, métodos de pago y un conjunto de módulos habilitados (dispensario, miembros, cultivos, doctores, etc.) según su licencia.
Todo lo demás —cada miembro, cada planta, cada pedido— pertenece a una organización.
Filial
Una filial es una sede física de la organización: un local con su propia dirección, su propio stock y sus propias opciones de entrega (retiro en el lugar, delivery, envío por correo). Una organización puede tener una o varias filiales.
La distinción importa porque el inventario se gestiona por filial: un producto puede tener 200 g disponibles en la filial Centro y 0 g en la filial Norte. Cuando un miembro hace un pedido, lo hace contra una filial.
Organización vs. Filial
Pensalo así: la organización es la asociación civil (la persona jurídica); la filial es cada dirección donde efectivamente se atiende y se guarda producto. Configurás una organización una vez; agregás filiales a medida que crecés.
Roles
Un rol define qué puede hacer cada persona dentro de la app. Los principales son:
| Rol | Para quién | Qué hace |
|---|---|---|
| ROOT / ADMIN | Dueño / dirección | Acceso total a la operación del club |
| STAFF / Secretario / Tesorero | Personal administrativo | Miembros, pedidos, cobranzas (según el cargo) |
| GROWER (Cultivador) | Encargado de cultivo | Cultivos, plantas, espacios, tareas |
| TRIMMER | Post-cosecha | Manicura, secado y curado |
| DOCTOR | Profesional médico | Pacientes, turnos y prescripciones |
| MEMBER (Miembro) | Socio del club | Dispensar en el dispensario, ver su perfil |
Los roles operativos (permisos en el software) son distintos de los cargos de la comisión directiva de la asociación civil (Presidente, Secretario, Tesorero, Vocal, Revisor de cuentas). Una misma persona puede tener un cargo legal y un rol operativo. La matriz completa de permisos está en la Configuración del Club.
Miembro
Un miembro (o socio) es la persona que consume en el club. Es la entidad central de la operación diaria. Un miembro no está siempre "activo": atraviesa un ciclo de estados que el club controla:
| Estado | Significado |
|---|---|
| INVITED | Invitado, todavía no se registró |
| IN_REVIEW | Se registró; el club revisa su solicitud |
| APPROVED | Aprobado, completando su activación |
| IN_PROGRESS | Activación en curso (firma, REPROCANN, etc.) |
| ACTIVE | Operativo, con acceso completo al dispensario |
| DEBTOR | Deudor: pago de membresía vencido, dispensario bloqueado |
| INACTIVE | Suspendido o dado de baja |
Entender estos estados es clave porque determinan qué puede hacer el miembro: solo un miembro ACTIVE puede dispensar. El detalle de las transiciones está en Gestionar Miembros.
Membresía
La membresía es el nivel de socio (por ejemplo: Básico, Plata, Oro). No es lo mismo que el estado del miembro: el estado dice si está activo o no; la membresía dice qué plan tiene.
Cada nivel define límites y beneficios: cuántos gramos puede retirar por mes, cuántos pedidos, qué descuento aplica y qué precios ve. La membresía tiene su propio ciclo de pago (mensual) con estados PAID / PENDING / EXPIRED. Como el club es una asociación sin fines de lucro, la "cuota" de membresía es el aporte del socio. Más detalle en Membresías.
Cepa
Una cepa (o genética) es una variedad de cannabis: Blue Dream, OG Kush, etc. Es información botánica y médica, no un artículo para dispensación. Una cepa describe su tipo (sativa / índica / híbrida), sus cannabinoides (THC, CBD…), sus terpenos, sus efectos y sus datos de cultivo.
La cepa es el puente entre la producción (qué se cultiva) y la dispensación (qué se ofrece): tanto los cultivos como los productos se vinculan a una cepa.
Producto y fracción
El producto es lo que el miembro efectivamente dispensa en el dispensario. Un producto está vinculado a una cepa y se dispensa en fracciones, que técnicamente son variantes: por ejemplo, la misma flor puede ofrecerse como fracción de 1 g, 3,5 g o 5 g, cada una con su precio, su SKU y su stock propio.
Cepa vs. Producto
La cepa es la genética (el "qué es"). El producto es el artículo dispensable que sale de esa genética (el "qué dispenso"), y la fracción es la presentación (1 g, 3,5 g…). Una cepa puede dar lugar a varios productos; un producto tiene varias fracciones.
Dispensación
La dispensación es el acto de entregar producto a un miembro: se materializa en un pedido. Es el corazón del dispensario y el punto donde se cruzan casi todas las entidades: un miembro ACTIVE, con una membresía que le fija un cupo mensual, dispensa productos (fracciones) de una filial, y cada entrega queda registrada para cumplimiento (cuenta contra su cupo y queda en la auditoría).
El flujo operativo completo está en Gestionar el Dispensario.
Cultivo
El cultivo es el proceso productivo: hacer crecer las plantas de una cepa hasta obtener producto. Cada cultivo avanza por un ciclo de vida de 9 etapas, siempre hacia adelante:
Del ideado (IDEATING) al terminado (FINISHED), pasando por propagación, vegetación, floración, cosecha, secado, manicura y curado. El cultivo vive en espacios (salas) con luces y sensores, y se opera con tareas. Ver Gestionar Cultivos.
Cosecha y stock
La cosecha es el resultado de un cultivo: se registra su peso húmedo y seco. Un cultivo puede producir una o varias cosechas. Una vez curado, ese material pasa a stock, y desde el stock se crea el producto que se dispensa en el dispensario.
Esta es la cadena que conecta el cultivo con la dispensación:
REPROCANN
REPROCANN es el Registro del Programa de Cannabis del Ministerio de Salud de Argentina. Es la habilitación legal que autoriza a una persona al uso medicinal de cannabis. En la práctica, cada miembro necesita un código REPROCANN vigente para poder acceder al dispensario.
Cannahub guarda el código y su fecha de vencimiento en el expediente del miembro, y monitorea los vencimientos con alertas (30, 15 y 0 días). Un REPROCANN vencido puede llevar a la suspensión automática del miembro. Es, junto con la membresía, uno de los dos requisitos para dispensar.
Protocolos y tareas
Una tarea es una acción concreta del trabajo diario del club: regar, fertilizar, inspeccionar, cosechar. Se asigna a un integrante del equipo, tiene fecha y estado, y al completarse puede pedir foto y registrar horas.
Un protocolo de cultivo (o plan de tareas) es una plantilla reutilizable: define qué tareas se hacen en cada etapa del cultivo, con qué frecuencia y con qué objetivos de ambiente y nutrición. Al asignar un protocolo a un cultivo, el sistema genera automáticamente todas las tareas. Ver Tareas y Equipo y Protocolos de Cultivo.
Glosario rápido
| Término | En una línea |
|---|---|
| Organización / Tenant | Tu club (la asociación civil). La entidad raíz. |
| Filial | Una sede física con su stock y entregas. |
| Rol | Qué puede hacer cada persona en la app. |
| Miembro | El socio que consume; atraviesa estados. |
| Membresía | El nivel/plan del socio, con cupos y beneficios. |
| Cepa | La genética (información botánica y médica). |
| Producto / Fracción | El artículo dispensable y su presentación (1 g, 3,5 g…). |
| Dispensación | Entregar producto a un miembro (un pedido). |
| Cultivo | Producir plantas por 9 etapas de vida. |
| Cosecha / Stock | El resultado del cultivo y su inventario. |
| REPROCANN | La habilitación legal del uso medicinal. |
| Protocolo / Tarea | Plantilla de trabajo y la acción concreta. |
Próximos Pasos
Ya tenés el vocabulario. Ahora seguí la ruta de aprendizaje pensada para vos: