Conceptos
Cinco palabras de Merez se usan a diario como si fueran lo mismo, y ninguna lo es. Cada una existe en el código con un nombre propio, y confundirlas hace pedir lo que no toca: subir de plan cuando bastaba encender un módulo, o recargar cuando el problema era otro.
Aquí va cada palabra en una frase y, después, lo que la separa de las demás.
Las cinco, de una en una
Sección titulada «Las cinco, de una en una»Sitio — La cuenta y el sitio web a la vez: es el Site, y todo lo demás cuelga de su site_id. Por eso un sitio no comparte nada con otro, ni contenido ni credenciales.
Plan — Lo que está contratado: qué módulos vienen incluidos, cuánto almacenamiento y qué bolsa de créditos. Es el Plan (plan_key), y su término tiene fecha de inicio y de fin.
Módulo — Una capacidad concreta que se enciende o se apaga, el Module con su key. Decide dos cosas a la vez: si la sección aparece en el menú y si la API responde.
Crédito — La unidad con la que se paga lo que se mide y las apps sueltas. Vive en el CreditLedger (CreditLedgerEntry), solo se mueve en enteros, y cada movimiento dice contra qué bolsa se imputó: quota, balance o billable.
Persona — Un registro de una persona del negocio del cliente, Person (persons), con su organización y su rol (user, contact, decision_maker, accountant). No inicia sesión: no es una cuenta.
En qué se diferencian
Sección titulada «En qué se diferencian»| Palabra | Clave | Qué es | Qué no es | Dónde se ve |
|---|---|---|---|---|
| Sitio | Site / site_id |
El cliente y su sitio web, en una sola fila | No es el plan ni el dominio | Selector de sitio (staff); Ajustes → Sitio público |
| Plan | Plan / plan_key |
Lo contratado y su vigencia | No es una llave que abra todo | Ajustes → Plan |
| Módulo | Module / key |
Una capacidad encendible | No es un plan, ni un módulo de curso | Ajustes → Apps y capacidades |
| Crédito | CreditLedgerEntry |
Unidad de consumo y de compra | No es dinero, ni el cupo del plan | Ajustes → Créditos |
| Persona | Person |
Alguien del negocio del cliente | No es usuario, ni lead, ni aprendiz | Operación → Contactos → Personas |
Los cuatro cruces que importan
Sección titulada «Los cuatro cruces que importan»Plan contra módulo. El plan trae módulos incluidos; el módulo es la capacidad suelta. Un módulo que no está en tu plan se enciende igual, pagando su importe con créditos, sin cambiar de plan. Cambiar de plan es para cuando ya lo usas todos los meses.
Módulo de plataforma contra módulo de curso. Son dos cosas distintas que en español se llaman igual: Module es el entitlement que enciende una sección de Merez, y CourseModule es un capítulo dentro de un curso de Formación.
Crédito contra cupo. El cupo es la bolsa que el plan entrega cada periodo; el crédito es la unidad. Se gasta primero el cupo (quota) y después tu saldo (balance); lo que no alcanza ninguna de las dos queda a facturar (billable), y la acción se ejecuta igual.
Persona contra usuario, lead y aprendiz. Son cuatro registros distintos, y ninguno se convierte en otro por su cuenta:
- Usuario (
User): tiene cuenta y contraseña, y entra al panel por una membresía (site_user) como dueño o como miembro. - Persona (
Person): un contacto del negocio, con roles y organización; se gestiona en Contactos. - Lead (
Lead): alguien que dejó sus datos o pidió una cotización; su ficha vive en Operación → Leads. - Aprendiz (
Learner): quien cursa una formación; entra con código de acceso, no con cuenta de panel.
Una nota sobre los nombres
Sección titulada «Una nota sobre los nombres»Las claves de plan y de módulo siguen en español aunque el resto del código esté en inglés: raiz, semilla, cosecha, a-medida, crm, blog, formacion. Son identificadores de negocio, y una clave cambiada hace desaparecer una sección del panel sin dar error. Los valores de estado, en cambio, ya están en inglés: draft, published, payment_review.