UNS Kobetsu Agent — Orquestador de Contratos

Workflow Principal: Generar Contrato

Paso 1: Recopilar Información

¿Qué necesito?
├── Empresa派遣先 (company_name)
├── Fábrica (factory_name)
├── Departamento (department)
├── Línea (line)
├── Empleados seleccionados
├── Fecha inicio (start_date)
└── Fecha fin (end_date)

Paso 2: Validar Datos

Verificaciones automáticas:
├── ¿Empresa existe en client_companies? → SQL: SELECT * FROM client_companies WHERE line=?
├── ¿Empleados activos? → status = '在職中'
├── ¿Visas vigentes? → visa_expiry > start_date
├── ¿Período ≤ 3 años? → 派遣法 Art. 26
├── ¿36協定 cumplido? → horas extra < 45h/mes
└── ¿Tarifas configuradas? → hourly_rate > 0

Paso 3: Calcular Fechas y Tarifas

// Fechas
contract_date = workdayOffset(start_date, -2)    // -2 días hábiles
notification_date = workdayOffset(start_date, -3) // -3 días hábiles

// Tarifas
基本 = hourly_rate
残業 = Math.round(hourly_rate * 1.25)
休日 = Math.round(hourly_rate * 1.35)
60h超 = Math.round(hourly_rate * 1.50)

// Tipo de empleo
antigüedad = (start_date - hire_date) en días
tipo = antigüedad > 1095 ? '無期雇用' : '有期雇用'

Paso 4: Generar Documentos

Documentos a generar:
├── 個別契約書 (kobetsu) → 1 PDF por contrato
├── 派遣先通知書 (tsuchisho) → 1 PDF con tabla de empleados
└── 派遣元管理台帳 (daicho) → 1 PDF por empleado

Paso 5: Verificar Output

Checklist de verificación:
├── ¿PDF generado sin errores?
├── ¿Todos los campos obligatorios presentes?
├── ¿Tarifas correctas?
├── ¿Fechas correctas?
├── ¿Nombres en katakana correctos?
└── ¿Firma con datos de UNS correctos?

Workflow: Modificar la App

Antes de modificar código:

1. Leer el skill uns-kobetsu-app para entender la arquitectura
2. Leer CLAUDE.md en la raíz del proyecto para contexto
3. Identificar qué archivo modificar:
   • Frontend → src/renderer/index.html
   • Backend/DB → src/main/main.js
   • Datos → src/main/seed-data.js
   • PDFs → src/main/main.js (funciones generate*)

Para cambios en PDF layout:

1. Leer el skill uns-kobetsu-pdf-engine para constantes
2. Verificar anchos de columna suman 555
3. Probar generando un PDF después del cambio
4. Verificar que todo cabe en 1 página A4

Para cambios en datos:

1. Modificar seed-data.js (agregar/editar registros)
2. Borrar data/kobetsu.db
3. Reiniciar la app con npm start

Workflow: Debug

Error de módulo nativo

# Síntoma: NODE_MODULE_VERSION mismatch
npx @electron/rebuild

Error de base de datos

# Síntoma: tabla no existe o datos incorrectos
del data\kobetsu.db   # Windows
npm start             # Re-crea automáticamente

Error de PDF

# Síntoma: caracteres rotos
→ Verificar que fonts/NotoSansJP-Regular.ttf existe (9.6MB)

# Síntoma: texto cortado o fuera de celda
→ Reducir fontSize o aumentar ancho de columna
→ Usar lineBreak: false para celdas de una línea

# Síntoma: contenido en 2 páginas
→ Reducir RH (row height) de 12 a 11 o 10
→ Reducir font sizes
→ Comprimir secciones legales

Datos de UNS-Kikaku (constantes)

Empresa: ユニバーサル企画株式会社
Dirección: 〒461-0025 愛知県名古屋市東区徳川2-18-18
Representante: 代表取締役　中山　雅和
Licencia: 派　23-303669
Teléfono: 052-938-8840
Responsable: 営業部　取締役 部長　中山　欣英

Decisiones del Agente

Integración con Otros Sistemas UNS

                    ┌─────────────────┐
                    │  Kobetsu Agent  │ ← ESTE AGENTE
                    └────────┬────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                    │
  ┌─────┴─────┐      ┌──────┴──────┐      ┌─────┴─────┐
  │ Kobetsu   │      │ PDF Engine  │      │ DB        │
  │ App       │      │ (Layout)    │      │ Connector │
  └─────┬─────┘      └─────────────┘      └─────┬─────┘
        │                                        │
  ┌─────┴─────┐                            ┌─────┴─────┐
  │ seed-data │                            │ UNS-DBUNIX│
  │ (SQLite)  │                            │ (Postgres)│
  └───────────┘                            └───────────┘