aekios.md

# AEKIOS - Notes

## Hosting — VPS OVH (UNICO)
> **TODO AEKIOS vive en VPS OVH** (`57.131.46.102`). Raiola YA NO se usa para AEKIOS.
> **SSH**: `ssh ubuntu@57.131.46.102`
> **Rutas VPS**:
> - Web publica: `/home/ubuntu/aekios/aekios.com/` (HTML estatico)
> - Intranet: `/home/ubuntu/aekios/app.aekios.com/` (PHP 8 + MySQL)
> **URLs**:
> - `https://aekios.com` → VPS OVH (A record cambiado 08/04/2026)
> - `https://app.aekios.com` → VPS OVH
> **SSL**: Certificados Let's Encrypt en ambos dominios (nginx)
> **Nginx configs**: `/etc/nginx/sites-enabled/aekios.com` y `app.aekios.com`
> **DB**: MariaDB local `aekios_intranet` | User: `aekios_app` | Pass: `AekiosDB2026!`
> **DNS**: Nameservers en Raiola (`dns1/2/3.raiolanetworks.es`), zona editada via cPanel API en `178.211.133.14:2083` (auth `cgbxwekc:l87s(Ca6vMM;2T`)
> **Email**: Sigue en Raiola (MX record `mail.aekios.com` → `178.211.133.14`). NO tocar.
> **Cuenta AEKIOS (Gmail + OVH)**: `aekiosgroup@gmail.com` / `DAHuWW3@p2vgQs9` (misma pass para ambos)
> **Panel OVH**: https://www.ovh.com/manager/

## Git Repos
- **Intranet repo**: `https://github.com/AekiosTeam/Aekios-app.git`
  - Acceso: `info@aekios.com` / `info@aekios.com123`
  - PAT (AekiosTeam): `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` (scope: repo)
  - Local clone: `C:\Users\alexa\Desktop\PROYECTOS\AEKIOS\Aekios-app`
  - Git config: user `AekiosTeam` / email `info@aekios.com`
- **Demos repos (aekiosgroup)**: `https://github.com/aekiosgroup`
  - PAT (aekiosgroup): `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` (scope: repo)
  - Usado en Demos para listar repos privados y leer READMEs con GPT-5.4 Nano

## Estructura
- PHP 8 + MySQL + Vanilla JS (SPA)
- Secciones: Email (IMAP/SMTP), Drive, Board (Kanban), CRM/Leads, Demos, Proposals
- Auth: Session-based, CSRF token en header X-CSRF-Token
- API pattern: `/api/{module}.php?action={action}`
- Contacto: `info@aekios.com` | Ciudad: Barcelona

## Tablas BD (aekios_intranet)
- `users` - autenticacion + config IMAP/SMTP por usuario
- `leads` - leads del funnel y contact form (industry, team_size, tech_maturity, budget_range, timeline, current_tools JSON, pain_points JSON, ideal_outcome, ai_analysis JSON, interested, company_intel JSON, social_links JSON, gbp_data JSON, northdata JSON, lead_score JSON)
- `lead_activities` - actividades de leads (note/call/email/meeting/task)
- `proposals` - propuestas comerciales vinculadas a leads
- `proposal_phases` - fases de propuesta (auto-generadas desde AI analysis)
- `drive_folders` - carpetas jerarquicas
- `drive_files` - archivos con nombre aleatorio en disco
- `board_columns` - columnas kanban (id, name, position, color)
- `board_tasks` - tareas kanban (id, column_id, project_id FK, title, description, assigned_to, label, label_color, position, due_date, created_by)
- `projects` - proyectos vinculados a leads won
- `personal_projects` - demos/herramientas catalog

## Flujo CRM → Board
- Lead → won → se convierte en "Cliente"
- Cliente puede tener N proyectos
- Cada proyecto puede tener N tareas en el Board (board_tasks.project_id)
- Board tiene filtro por proyecto en toolbar
- Pestaña "Clientes" en CRM muestra leads won con sus proyectos y propuestas

## Flujo Leads (Sales Funnel)
- **form-request.html** (funnel v2 con AI): 10 pasos → AI analysis via `analyze.php` (Claude API) → submit a `/leads.php` → auto-crea draft proposal
- **funnel.html** (funnel v1 sin AI): pasos similares → submit directo a `/leads.php`
- **contact.html**: form simple (nombre, email, empresa, mensaje) → submit a `/leads.php`
- Calendly: `https://calendly.com/aekiosgroup/30min`
- Los funnels envian labels legibles (no codigos internos) gracias a `getLabel()` helper
- leads.php validation: solo exige contact_name, company_name, email (campos funnel opcionales)
- Post-submit: enrichment pipeline en background (social links, GBP, NorthData, company intel, lead scoring)

## Funcionalidades Email
- Carpetas IMAP: listado, crear, eliminar, renombrar (carpetas personalizadas)
- Carpetas sistema protegidas: INBOX, Sent, Drafts, Trash, Junk
- Flag/Star, batch delete, batch move, search

## Edicion directa
- Editar archivos directamente en VPS via SSH. NO hay FTP ni deploy intermediario.
- `ssh ubuntu@57.131.46.102` → editar en `/home/ubuntu/aekios/`