================================================================================ EMPRESAS / COMPAÑÍAS - ARDUMAKER Guía Completa para IAs y Sistemas ================================================================================ VERSIÓN: 1.0 FECHA: 13 de febrero de 2026 PROPÓSITO: Contexto completo sobre la gestión de empresas en ArduMaker ================================================================================ ¿QUÉ ES UNA EMPRESA EN ARDUMAKER? ================================================================================ Una empresa (company) es un ESPACIO DE TRABAJO aislado. Cada empresa representa un cliente, proyecto o contexto independiente. Fue diseñado para freelancers y equipos que manejan múltiples clientes. Analogía: Empresa = Workspace = Proyecto = Cliente Beneficio principal: ✓ Separar configuraciones, servicios, pagos y accesos por cliente ✓ No necesitas recordar IPs, contraseñas ni servicios por separado ✓ Todo centralizado en un solo panel ================================================================================ ARQUITECTURA JERÁRQUICA ================================================================================ Usuario (cuenta personal) │ ├── Empresa A (cliente 1) │ ├── VPS (uno o más) │ ├── WhatsApp API (uno o más números) │ ├── Router IA (una o más API keys) │ ├── Gestión de pagos única │ └── Métodos de pago asociados │ ├── Empresa B (cliente 2) │ ├── VPS ... │ ├── WhatsApp API ... │ └── ... │ └── Empresa N ... Cada empresa tiene sus propios recursos, completamente aislados. ================================================================================ CREAR UNA EMPRESA ================================================================================ URL: https://ardumaker.com/companies Pasos: 1. Ir a /companies 2. Click en "Crear compañía" 3. Ingresar un nombre 4. La empresa se crea inmediatamente Si solo tienes UNA empresa: → Se auto-selecciona y redirige al dashboard automáticamente. Si tienes VARIAS empresas: → Se muestra un listado para elegir con cuál trabajar. → Puedes buscar por nombre con el buscador integrado. API: POST /api/v1/user/company/list/ Body: { "name": "Mi Empresa" } GET /api/v1/user/company/list/ → Lista todas las empresas del usuario autenticado. ================================================================================ DASHBOARD DE LA EMPRESA ================================================================================ Al entrar a una empresa, el dashboard presenta estos tabs: ┌─────────────┬───────────────────────────────────────────────────────────────┐ │ Tab │ Descripción │ ├─────────────┼───────────────────────────────────────────────────────────────┤ │ VPS │ Listado de servidores VPS de la empresa (1 a 100+) │ │ WhatsApp │ Números de WhatsApp API asociados │ │ Router IA │ API keys de OpenRouter para acceder a 200+ modelos IA │ │ Pagamentos │ Gastos mensuales, historial de movimientos, saldo │ │ Config │ Métodos de pago, miembros, permisos, eliminación │ └─────────────┴───────────────────────────────────────────────────────────────┘ ================================================================================ TAB: VPS ================================================================================ Muestra todos los VPS asociados a la empresa. Cada VPS es una instancia LXD aislada con Ubuntu. Desde aquí puedes: ✓ Ver el estado de cada VPS ✓ Crear nuevos VPS seleccionando un plan ✓ Acceder al detalle de cada VPS Para más detalles sobre VPS, descarga: VPS_ARDUMAKER.txt ================================================================================ TAB: WHATSAPP ================================================================================ Muestra los números de WhatsApp API asociados. IMPORTANTE: La API de WhatsApp NO se activa automáticamente. Debes contactarnos para configuraciones previas. En menos de un día queda activa. Una vez activa, puedes: ✓ Enviar y recibir mensajes vía API ✓ Configurar webhooks ✓ Ver conversaciones y chats Para más detalles sobre la API, descarga: API_WHATSAPP_ARDUMAKER.txt ================================================================================ TAB: ROUTER IA ================================================================================ Gestión de API keys para OpenRouter. Con un solo click generas una key que da acceso a 200+ modelos de IA. Modelos disponibles incluyen: - GPT-4, GPT-4o, GPT-3.5 - Claude 3.5, Claude 3 - Gemini Pro, Gemini Ultra - Llama 3, Mixtral - Y muchos más ================================================================================ TAB: PAGAMENTOS (FACTURACIÓN) ================================================================================ Vista de gastos y movimientos financieros: ┌─────────────────────────────────────────────┐ │ Saldo actual: $XX.XX USD │ │ Gastos del mes: $XX.XX USD │ │ │ │ Historial de movimientos: │ │ - 2026-02-10 VPS Plan Basic -$5.00 │ │ - 2026-02-08 Recarga saldo +$20.00 │ │ - 2026-02-05 WhatsApp msgs -$2.30 │ └─────────────────────────────────────────────┘ Funcionamiento: - A medida que se consumen servicios, se debita del saldo - Si no hay saldo suficiente, se cobra a la tarjeta asociada - Cada empresa tiene su gestión de pagos independiente ================================================================================ TAB: CONFIGURACIÓN ================================================================================ Secciones disponibles: 1. MÉTODOS DE PAGO ───────────────── - Agregar tarjetas de crédito/débito - Ver tarjetas asociadas - Eliminar métodos de pago 2. MIEMBROS DEL EQUIPO ────────────────────── Roles disponibles: ┌──────────┬────────────────────────────────────────────────────────┐ │ Rol │ Permisos │ ├──────────┼────────────────────────────────────────────────────────┤ │ Miembro │ Acceso a todo EXCEPTO gestión de gastos y pagos. │ │ │ NO puede crear nuevos gastos ni gestionar pagos. │ ├──────────┼────────────────────────────────────────────────────────┤ │ Admin │ Acceso COMPLETO a todo, incluidos pagos y gastos. │ └──────────┴────────────────────────────────────────────────────────┘ - Puedes invitar usuarios por email o username - Cada miembro tiene acceso solo a las empresas donde fue agregado 3. ELIMINAR EMPRESA ─────────────────── IMPORTANTE — Acción IRREVERSIBLE: Requisitos para eliminar: ✓ Saldo positivo O se cobra la deuda pendiente al momento ✓ Confirmación múltiple (3 checkboxes) Al eliminar se destruye: ✗ Todos los VPS asociados ✗ Todos los números de WhatsApp ✗ Todo el historial y datos ✗ Toda la configuración → NO HAY FORMA DE RECUPERAR ESTA INFORMACIÓN ================================================================================ API REST - ENDPOINTS DE EMPRESAS ================================================================================ Base URL: https://api.ardumaker.com Autenticación: Cookie: Authorization=Token_xxxxx (Se obtiene al hacer login) LISTAR EMPRESAS ─────────────── GET /api/v1/user/company/list/ Respuesta: { "success": true, "data": [ { "id": 1, "name": "Mi Empresa", "slug": "mi-empresa", "members": [...], "admins": [...], "avatar_url": "/media/...", "alerta": false, "pay_paused": false, "servicios_pausados_por_mora": false } ] } CREAR EMPRESA ───────────── POST /api/v1/user/company/list/ Body: { "name": "Nueva Empresa", "member_ids": [2, 3], // opcional "admin_ids": [1] // opcional } DETALLE DE EMPRESA ────────────────── GET /api/v1/user/company/{id}/ ACTUALIZAR EMPRESA ────────────────── PATCH /api/v1/user/company/{id}/ Body: { "name": "Nuevo Nombre" } ELIMINAR EMPRESA ──────────────── DELETE /api/v1/user/company/{id}/ Nota: Se cobra deuda pendiente antes de eliminar. SUBIR FOTO/AVATAR ───────────────── POST /api/v1/user/company/{id}/photo/ Content-Type: multipart/form-data Body: photo= ================================================================================ API REST - MÉTODOS DE PAGO ================================================================================ LISTAR MÉTODOS DE PAGO ────────────────────── GET /api/v1/user/company/{id}/pays/ Respuesta: { "success": true, "data": { "stripe_customer_id": "cus_xxxx", "payment_methods": [ { "id": "pm_xxxx", "brand": "visa", "last4": "4242", "exp_month": 12, "exp_year": 2027, "is_default": true } ] } } AGREGAR MÉTODO DE PAGO ────────────────────── POST /api/v1/user/company/{id}/pays/ Body: { "token": "tok_xxxx" } El token se obtiene desde Stripe.js en el frontend. ELIMINAR MÉTODO DE PAGO ─────────────────────── DELETE /api/v1/user/company/{id}/pays/ Body: { "payment_method_id": "pm_xxxx" } ================================================================================ CAMPOS IMPORTANTES DE UNA EMPRESA ================================================================================ ┌────────────────────────────────────┬────────────────────────────────────┐ │ Campo │ Descripción │ ├────────────────────────────────────┼────────────────────────────────────┤ │ id │ ID único de la empresa │ │ name │ Nombre visible │ │ slug │ Identificador URL-friendly │ │ members │ Array de miembros (rol básico) │ │ admins │ Array de administradores │ │ avatar_url │ URL de la foto de la empresa │ │ alerta │ Si tiene alertas activas │ │ alerta_mensaje │ Mensaje de la alerta │ │ pay_paused │ Si los pagos están pausados │ │ servicios_pausados_por_mora │ Si los servicios fueron pausados │ │ saldo_negativo_autorizado │ Monto de deuda permitido │ │ stripe_customer_id │ ID del cliente en Stripe │ │ whatsapp_permission │ Si tiene permiso para WhatsApp │ └────────────────────────────────────┴────────────────────────────────────┘ ================================================================================ FLUJO COMPLETO PARA UNA IA ================================================================================ 1. AUTENTICARSE → Login y obtener cookie de sesión 2. LISTAR EMPRESAS GET /api/v1/user/company/list/ → Obtener la empresa con la que se quiere trabajar 3. SELECCIONAR EMPRESA → Usar el ID de la empresa para todas las operaciones siguientes 4. OPERAR CON SERVICIOS → VPS: GET /api/v1/user/company/{id}/vps/ → WhatsApp: GET /api/v1/whatsapp/ (con headers específicos) → Router IA: GET /api/v1/user/company/{id}/router-ia/ → Pagos: GET /api/v1/user/company/{id}/pays/ 5. GESTIONAR EQUIPO → PATCH /api/v1/user/company/{id}/ → Agregar member_ids o admin_ids ================================================================================ REGLAS DE NEGOCIO IMPORTANTES ================================================================================ 1. Un usuario puede tener MÚLTIPLES empresas 2. Cada empresa es un espacio AISLADO 3. Los servicios NO se comparten entre empresas 4. Si pay_paused es true, se puede crear VPS sin método de pago 5. Si hay alerta activa, se muestra un banner en el dashboard 6. La eliminación cobra deudas pendientes automáticamente 7. WhatsApp requiere activación manual (contactar equipo) 8. Los miembros NO pueden gestionar pagos ni crear gastos 9. Solo los admins tienen acceso completo 10. Las empresas se ordenan por alertas/deuda primero en el listado ================================================================================ CASOS DE USO TÍPICOS ================================================================================ FREELANCER CON 3 CLIENTES: → Crea 3 empresas (una por cliente) → Cada cliente tiene su VPS, pagos y equipo separado → El freelancer es admin en las 3 AGENCIA CON EQUIPO: → Una empresa principal → Agrega miembros del equipo como "miembro" → Solo el dueño y co-admins gestionan pagos → Los devs acceden a VPS y servicios sin ver costos STARTUP CON AMBIENTES: → Empresa "Producción" con VPS de producción → Empresa "Desarrollo" con VPS de desarrollo → Equipos diferentes con accesos diferentes ================================================================================ RESUMEN RÁPIDO ================================================================================ ✓ Empresa = Espacio de trabajo aislado ✓ Cada empresa tiene sus propios VPS, WhatsApp, Router IA y pagos ✓ Roles: Admin (todo) y Miembro (todo menos pagos) ✓ Crear empresa: POST /api/v1/user/company/list/ ✓ Listar empresas: GET /api/v1/user/company/list/ ✓ Eliminar es irreversible y cobra deudas pendientes ✓ Diseñado para freelancers y equipos multi-cliente ✓ URL principal: https://ardumaker.com/companies ================================================================================ FIN DEL DOCUMENTO - EMPRESAS ARDUMAKER v1.0 ================================================================================