From 940095a1702996ec8cb53fd3661f5ee482137a1b Mon Sep 17 00:00:00 2001 From: Adrian Flores Cortes Date: Sun, 25 Jan 2026 02:57:51 -0600 Subject: [PATCH] [PROP-CORE-004] feat: Adapt AI roles for diesel mechanics domain - Roles: ADMIN, JEFE_TALLER, MECANICO, CLIENTE - Domain-specific tools (diagnostics, vehicles, OBD codes) - Automotive workshop terminology Co-Authored-By: Claude Opus 4.5 --- src/modules/ai/roles/erp-roles.config.ts | 263 ++++++++--------------- 1 file changed, 86 insertions(+), 177 deletions(-) diff --git a/src/modules/ai/roles/erp-roles.config.ts b/src/modules/ai/roles/erp-roles.config.ts index 500035b..bda9d87 100644 --- a/src/modules/ai/roles/erp-roles.config.ts +++ b/src/modules/ai/roles/erp-roles.config.ts @@ -1,17 +1,17 @@ /** - * ERP Roles Configuration + * ERP Mecánicas Diesel - Roles Configuration * - * Define roles, tools permitidos, y system prompts para cada rol en el ERP. - * Basado en: michangarrito MCH-012/MCH-013 (role-based chatbot) + * Roles específicos para talleres mecánicos de motores diesel. + * Adaptado desde erp-core v1.5.0 (PROP-CORE-004) * - * Roles disponibles: - * - ADMIN: Acceso completo a todas las operaciones - * - SUPERVISOR: Gestión de equipos y reportes de sucursal - * - OPERATOR: Operaciones de punto de venta - * - CUSTOMER: Acceso limitado para clientes (si se expone chatbot) + * Roles: + * - ADMIN: Dueño del taller - acceso completo + * - JEFE_TALLER: Jefe de taller - órdenes, diagnósticos, inventario + * - MECANICO: Mecánico - solo órdenes asignadas + * - CLIENTE: Cliente - estado de su vehículo */ -export type ERPRole = 'ADMIN' | 'SUPERVISOR' | 'OPERATOR' | 'CUSTOMER'; +export type ERPRole = 'ADMIN' | 'JEFE_TALLER' | 'MECANICO' | 'CLIENTE'; export interface ERPRoleConfig { name: string; @@ -19,234 +19,143 @@ export interface ERPRoleConfig { tools: string[]; systemPromptFile: string; maxConversationHistory: number; - allowedModels?: string[]; // Si vacío, usa el default del tenant + allowedModels?: string[]; rateLimit: { requestsPerMinute: number; tokensPerMinute: number; }; } -/** - * Configuración de roles ERP - */ export const ERP_ROLES: Record = { ADMIN: { - name: 'Administrador', - description: 'Acceso completo a todas las operaciones del sistema ERP', + name: 'Dueño del Taller', + description: 'Propietario con acceso completo a todas las operaciones', tools: [ - // Ventas - 'get_sales_summary', - 'get_sales_report', - 'get_top_products', - 'get_top_customers', - 'get_sales_by_branch', - 'create_sale', - 'void_sale', - - // Inventario - 'get_inventory_status', - 'get_low_stock_products', - 'get_inventory_value', - 'adjust_inventory', - 'transfer_inventory', - - // Compras - 'get_pending_orders', - 'get_supplier_info', - 'create_purchase_order', - 'approve_purchase', - + // Órdenes de servicio + 'get_orders_summary', 'get_all_orders', 'void_order', 'get_order_history', // Finanzas - 'get_financial_report', - 'get_accounts_receivable', - 'get_accounts_payable', - 'get_cash_flow', - - // Usuarios y configuración - 'manage_users', - 'view_audit_logs', - 'update_settings', - 'get_branch_info', - 'manage_branches', - - // Reportes avanzados - 'generate_report', - 'export_data', - 'get_kpis', + 'get_financial_report', 'get_accounts_receivable', 'get_accounts_payable', + 'get_cash_flow', 'get_kpis', + // Inventario (refacciones) + 'get_inventory_status', 'get_low_stock_products', 'get_inventory_value', + 'adjust_inventory', 'create_purchase_order', + // Proveedores + 'get_supplier_info', 'approve_purchase', + // Configuración + 'manage_users', 'view_audit_logs', 'update_settings', + 'get_branch_info', 'manage_branches', + // Reportes + 'generate_report', 'export_data', + // TPV + 'configure_terminal', 'get_payment_history', 'process_refund', + // Vehículos + 'get_vehicle_history', 'get_fleet_summary', ], systemPromptFile: 'admin-system-prompt', maxConversationHistory: 50, - rateLimit: { - requestsPerMinute: 100, - tokensPerMinute: 50000, - }, + rateLimit: { requestsPerMinute: 100, tokensPerMinute: 50000 }, }, - SUPERVISOR: { - name: 'Supervisor', - description: 'Gestión de equipos, reportes de sucursal y aprobaciones', + JEFE_TALLER: { + name: 'Jefe de Taller', + description: 'Jefe con gestión de órdenes, diagnósticos y equipo', tools: [ - // Ventas (lectura + acciones limitadas) - 'get_sales_summary', - 'get_sales_report', - 'get_top_products', - 'get_sales_by_branch', - 'create_sale', - - // Inventario (lectura + ajustes) - 'get_inventory_status', - 'get_low_stock_products', - 'adjust_inventory', - + // Órdenes + 'get_orders_summary', 'create_order', 'update_order_status', + 'assign_mechanic', 'get_pending_orders', + // Diagnósticos + 'diagnose_fault_code', 'get_diagnostic_history', 'add_diagnostic_note', // Equipo - 'get_team_performance', - 'get_employee_schedule', - 'manage_schedules', - + 'get_team_performance', 'get_mechanic_schedule', 'manage_schedules', // Aprobaciones - 'approve_discounts', - 'approve_voids', - 'approve_refunds', - + 'approve_discounts', 'approve_additional_work', + // Inventario + 'get_inventory_status', 'get_low_stock_products', 'request_parts', + 'check_part_stock', 'search_parts', + // Cotizaciones + 'create_quote', 'get_quote_history', // Sucursal - 'get_branch_info', - 'get_branch_report', - - // Clientes - 'get_customer_info', - 'get_customer_balance', + 'get_branch_info', 'get_branch_report', ], systemPromptFile: 'supervisor-system-prompt', maxConversationHistory: 30, - rateLimit: { - requestsPerMinute: 60, - tokensPerMinute: 30000, - }, + rateLimit: { requestsPerMinute: 60, tokensPerMinute: 30000 }, }, - OPERATOR: { - name: 'Operador', - description: 'Operaciones de punto de venta y consultas básicas', + MECANICO: { + name: 'Mecánico', + description: 'Mecánico con acceso a órdenes asignadas y diagnósticos', tools: [ - // Productos - 'search_products', - 'get_product_price', - 'check_product_availability', - - // Ventas - 'create_sale', - 'get_my_sales', - 'apply_discount', // Con límite - - // Clientes - 'search_customers', - 'get_customer_balance', - 'register_payment', - - // Inventario (solo lectura) - 'check_stock', - + // Mis órdenes + 'get_my_orders', 'update_order_progress', 'complete_order', + 'add_work_note', 'upload_photos', + // Diagnósticos + 'diagnose_fault_code', 'add_diagnostic_note', 'get_obd_codes', + // Refacciones + 'check_part_stock', 'search_parts', 'request_parts_for_order', + // Vehículo + 'get_vehicle_info', 'get_vehicle_history', // Información - 'get_branch_hours', - 'get_promotions', + 'get_branch_hours', 'get_my_schedule', ], systemPromptFile: 'operator-system-prompt', maxConversationHistory: 20, - rateLimit: { - requestsPerMinute: 30, - tokensPerMinute: 15000, - }, + rateLimit: { requestsPerMinute: 30, tokensPerMinute: 15000 }, }, - CUSTOMER: { + CLIENTE: { name: 'Cliente', - description: 'Acceso limitado para clientes externos', + description: 'Cliente con acceso al estado de su vehículo y órdenes', tools: [ - // Catálogo - 'view_catalog', - 'search_products', - 'check_availability', - - // Pedidos - 'get_my_orders', - 'track_order', - + // Mi vehículo + 'get_my_vehicles', 'get_vehicle_status', 'get_service_history', + // Mis órdenes + 'get_my_orders', 'track_order', // Cuenta - 'get_my_balance', - 'get_my_history', - + 'get_my_balance', 'get_my_invoices', + // Cotizaciones + 'request_quote', 'get_my_quotes', 'approve_quote', // Soporte - 'contact_support', - 'get_store_info', - 'get_promotions', + 'contact_support', 'get_workshop_info', 'get_workshop_hours', + // Recordatorios + 'get_service_reminders', 'schedule_service', ], systemPromptFile: 'customer-system-prompt', maxConversationHistory: 10, - rateLimit: { - requestsPerMinute: 10, - tokensPerMinute: 5000, - }, + rateLimit: { requestsPerMinute: 10, tokensPerMinute: 5000 }, }, }; -/** - * Mapeo de rol de base de datos a ERPRole - */ export const DB_ROLE_MAPPING: Record = { - // Roles típicos de sistema - admin: 'ADMIN', - administrator: 'ADMIN', - superadmin: 'ADMIN', - owner: 'ADMIN', - - // Supervisores - supervisor: 'SUPERVISOR', - manager: 'SUPERVISOR', - branch_manager: 'SUPERVISOR', - store_manager: 'SUPERVISOR', - - // Operadores - operator: 'OPERATOR', - cashier: 'OPERATOR', - sales: 'OPERATOR', - employee: 'OPERATOR', - staff: 'OPERATOR', - + // Administradores + admin: 'ADMIN', administrator: 'ADMIN', owner: 'ADMIN', dueno: 'ADMIN', + // Jefes de taller + jefe_taller: 'JEFE_TALLER', jefe: 'JEFE_TALLER', supervisor: 'JEFE_TALLER', + manager: 'JEFE_TALLER', encargado: 'JEFE_TALLER', + // Mecánicos + mecanico: 'MECANICO', mechanic: 'MECANICO', operator: 'MECANICO', + tecnico: 'MECANICO', technician: 'MECANICO', employee: 'MECANICO', // Clientes - customer: 'CUSTOMER', - client: 'CUSTOMER', - guest: 'CUSTOMER', + cliente: 'CLIENTE', customer: 'CLIENTE', client: 'CLIENTE', guest: 'CLIENTE', }; -/** - * Obtener rol ERP desde rol de base de datos - */ export function getERPRole(dbRole: string | undefined): ERPRole { - if (!dbRole) return 'CUSTOMER'; // Default para roles no mapeados + if (!dbRole) return 'CLIENTE'; const normalized = dbRole.toLowerCase().trim(); - return DB_ROLE_MAPPING[normalized] || 'CUSTOMER'; + return DB_ROLE_MAPPING[normalized] || 'CLIENTE'; } -/** - * Verificar si un rol tiene acceso a un tool - */ export function hasToolAccess(role: ERPRole, toolName: string): boolean { const roleConfig = ERP_ROLES[role]; if (!roleConfig) return false; return roleConfig.tools.includes(toolName); } -/** - * Obtener todos los tools para un rol - */ export function getToolsForRole(role: ERPRole): string[] { const roleConfig = ERP_ROLES[role]; return roleConfig?.tools || []; } -/** - * Obtener configuración completa de un rol - */ export function getRoleConfig(role: ERPRole): ERPRoleConfig | null { return ERP_ROLES[role] || null; }