Operaciones de licencia en la administración Cloud
Los administradores autorizados de la plataforma HandyCafe pueden gestionar el acceso comercial de un cliente desde la página de detalle del cliente. La página empieza con un resumen de la cuenta, el estado del perfil, el estado de conexión en vivo y el número de licencias Genesis. Cada licencia Genesis tiene una tarjeta de operaciones que muestra su plan actual, los límites de PC y de consolas, el saldo de IA, el saldo de miembro, el acceso a los complementos y el estado en Stripe.
Las herramientas antiguas y de beta se mantienen en una sección desplegable aparte. La actividad de ping y los cambios de perfil están disponibles en Diagnóstico e historial de cambios. Así el flujo actual de Genesis queda a la vista sin eliminar las herramientas de soporte más antiguas.
Ver todas las licencias Genesis
Abre Licencias en el panel de administración interno. La pestaña Genesis se abre de forma predeterminada y muestra solo los planes Free y Genesis vigentes. Las concesiones históricas de beta permanecen en la pestaña Beta aparte.
Las tarjetas de resumen muestran el número total de licencias y cuántas son activas, de pago y gratuitas. La lista se puede buscar por café, cuenta, correo electrónico, plan o clave de licencia. Los administradores también pueden filtrar por tipo de plan o por estado. Cada fila muestra la capacidad, el acceso a Cloud y Cafetería, el saldo de IA, la validez y el estado. Selecciona Gestionar para abrir el espacio de trabajo del cliente y realizar operaciones de plan, servicio, crédito y facturación.
Crear la primera licencia Genesis
Cuando una cuenta no tiene ninguna licencia Genesis, la página de detalle del cliente muestra un formulario de creación de licencia en lugar de un resultado vacío. Selecciona un plan Genesis activo y una fecha de caducidad futura. Revisa el plan, la caducidad y el país en el diálogo de confirmación. Selecciona Crear licencia para asignarla directamente a la cuenta del cliente.
La cuenta debe tener un nombre de café y un país antes de la creación. Selecciona Editar perfil para agregar los datos que falten. El plan define tanto el límite de PC como el de consolas. La fecha de caducidad seleccionada es válida hasta el final de ese día UTC.
Operaciones disponibles
- Asignar un plan Genesis. Las licencias manuales reciben la capacidad y la fecha de caducidad del plan seleccionado. Las suscripciones gestionadas por Stripe siguen las reglas normales de mejora y reducción de plan, incluidos los cargos inmediatos o los cambios programados.
- Gestionar Cloud y Cafetería. El derecho de acceso a Cloud se actualiza en la licencia. Activar Cafetería también aprovisiona o reactiva el inquilino correspondiente en
handy.cafe; desactivarla suspende ese inquilino. Los dos servicios nunca se sincronizan mientras se mantiene un bloqueo de la base de datos. - Conceder crédito de IA. La sección de operaciones de crédito muestra el saldo de IA actual de la licencia seleccionada antes de que un administrador introduzca un importe de recarga. Conceder crédito agrega crédito prepago en USD al monedero de IA y registra una entrada de auditoría.
- Conceder crédito de miembro. Agrega crédito de bonificación a la cuenta de miembro de HandyCafe que tiene la misma dirección de correo electrónico. La operación no está disponible cuando no existe ningún miembro coincidente.
- Cambiar la próxima fecha de facturación. En las suscripciones de Stripe, la fecha se actualiza en Stripe y después se sincroniza con la suscripción y la licencia locales. Primero hay que cancelar cualquier cambio de plan programado.
- Reembolsar un pago. El administrador selecciona un cargo de Stripe reembolsable, elige un motivo de Stripe, escribe una explicación interna obligatoria y confirma el reembolso. Reembolsar no cancela la suscripción ni retira el acceso al producto.
Seguridad y comportamiento de la auditoría
Cada acción que modifica datos requiere confirmación en el panel. Las operaciones de backend de alto impacto están restringidas por la clave de la API de administración, validan la propiedad de los cargos de Stripe y escriben un registro de auditoría que solo admite añadir entradas. El historial de pagos se carga únicamente cuando se solicita y se limita a los cargos recientes. Los reembolsos usan una clave de idempotencia única para evitar envíos duplicados accidentales.
Si una licencia antigua ya no tiene una clave en texto plano recuperable, el aprovisionamiento automático de Cafetería se detiene de forma segura y el panel informa que un administrador debe resolver primero la credencial de la licencia.
Prefijos de país en las licencias
Las nuevas claves de licencia vinculadas a una cuenta usan el código de país de dos letras del perfil completado del cliente, como GEN-TR-... para una licencia Genesis creada por un administrador o HC-TR-... para una licencia de cuenta sin plan asociado. La creación desde administración se detiene cuando el perfil no tiene un país válido. El sistema nunca crea una clave GEN-XX-... ni HC-XX-....
Actualizar el campo de país de una licencia existente no rota su clave activa en silencio. Los administradores deben coordinar la corrección del país y la rotación de la clave porque el servidor instalado tiene que volver a iniciar sesión después de que cambie su credencial.