# ivan-malaver/guayacan-erp architecture

> Architecture diagram of the GitHub repository ivan-malaver/guayacan-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ivan-malaver/guayacan-erp
- Repository: https://github.com/ivan-malaver/guayacan-erp

## Overview

Guayacán ERP is a farm-management platform with an Angular frontend, Django app modules, and separate agent and IoT services. The visible user journey is login, session-protected navigation to a lazy-loaded module, and (for the sampled modules) a provisional page listing planned use cases; the route catalogs describe production, sales, finance, people, and other farm workflows, but do not demonstrate their completed execution. A separate agent-service path validates incoming Meta signatures and queues webhook messages. Backend implementation details are not shown, so links from frontend modules to backend apps are omitted.

Main entry points: [`guayacan-erp/frontend/src/app/app.routes.ts`](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/app.routes.ts) (Protected route map), [`guayacan-erp/frontend/src/app/shared/modulo-pendiente.component.ts`](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/shared/modulo-pendiente.component.ts) (Use-case catalog page), [`guayacan-erp/servicios/agentes/app/main.py`](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/main.py) (Agent webhooks), [`guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts`](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts) (Farm setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_routes["Protected route map<br/>[app.routes.ts]"]
  node_login["Login screen"]
  node_session["Session service<br/>[sesion.service.ts]"]
  node_guard["Session guard<br/>[sesion.guard.ts]"]
  node_errors["Error handling<br/>[errores.ts]"]
  node_farmctx["Farm context<br/>[finca.service.ts]"]
  node_pending["Use-case catalog page"]
end

subgraph group_farm["Farm operations"]
  node_coremod["Farm setup<br/>[nucleo.routes.ts]"]
  node_production["Production"]
  node_iot["IoT operations<br/>[iot.routes.ts]"]
  node_adoption["Adoption<br/>[adopcion.routes.ts]"]
end

subgraph group_business["Business workflows"]
  node_people["People and training<br/>[personal.routes.ts]"]
  node_sales["Sales"]
  node_finance["Finance<br/>[finanzas.routes.ts]"]
  node_strategy["Strategy"]
  node_ai["AI capabilities<br/>[ia.routes.ts]"]
  node_training["Training"]
end

subgraph group_integrations["Integration services"]
  node_agentwebhook["Agent webhooks<br/>[main.py]"]
  node_signature["Meta signature check<br/>[firmas.py]"]
  node_orchestrator["Message orchestrator<br/>[orquestador.py]"]
end

node_user(("ERP user"))
node_channel(("Social messaging channels"))

node_user -->|"signs in"| node_login
node_routes -->|"routes to"| node_login
node_routes -->|"protects routes"| node_guard
node_routes -->|"lazy loads"| node_coremod
node_routes -->|"lazy loads"| node_production
node_routes -->|"lazy loads"| node_iot
node_routes -->|"lazy loads"| node_adoption
node_routes -->|"lazy loads"| node_people
node_routes -->|"lazy loads"| node_sales
node_routes -->|"lazy loads"| node_finance
node_routes -->|"lazy loads"| node_strategy
node_routes -->|"lazy loads"| node_ai
node_routes -->|"lazy loads"| node_training
node_coremod -->|"shows catalog"| node_pending
node_production -->|"shows catalog"| node_pending
node_iot -->|"shows catalog"| node_pending
node_adoption -->|"shows catalog"| node_pending
node_people -->|"shows catalog"| node_pending
node_sales -->|"shows catalog"| node_pending
node_finance -->|"shows catalog"| node_pending
node_ai -->|"shows catalog"| node_pending
node_training -->|"shows catalog"| node_pending
node_channel -->|"sends webhooks"| node_agentwebhook
node_agentwebhook -->|"validates signature"| node_signature
node_agentwebhook -->|"queues messages"| node_orchestrator

click node_routes "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/app.routes.ts"
click node_login "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/ingreso.component.ts"
click node_session "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/sesion.service.ts"
click node_guard "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/sesion.guard.ts"
click node_errors "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/errores/errores.ts"
click node_farmctx "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/finca/finca.service.ts"
click node_pending "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/shared/modulo-pendiente.component.ts"
click node_coremod "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts"
click node_production "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/produccion/produccion.routes.ts"
click node_iot "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/iot/iot.routes.ts"
click node_adoption "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/adopcion/adopcion.routes.ts"
click node_people "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/personal/personal.routes.ts"
click node_sales "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/comercial/comercial.routes.ts"
click node_finance "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/finanzas/finanzas.routes.ts"
click node_strategy "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/estrategia/estrategia.routes.ts"
click node_ai "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/ia/ia.routes.ts"
click node_training "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/formacion/formacion.routes.ts"
click node_agentwebhook "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/main.py"
click node_signature "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/firmas.py"
click node_orchestrator "https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/orquestador.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routes,node_login,node_session,node_guard,node_errors,node_farmctx,node_pending,node_user toneBlue
class node_coremod,node_production,node_iot,node_adoption toneAmber
class node_people,node_sales,node_finance,node_strategy,node_ai,node_training toneMint
class node_agentwebhook,node_signature,node_orchestrator toneRose
class node_channel toneIndigo
```

## Components

### Access and navigation

- [Protected route map](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/app.routes.ts): `guayacan-erp/frontend/src/app/app.routes.ts`
- [Login screen](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/ingreso.component.ts): `guayacan-erp/frontend/src/app/core/auth/ingreso.component.ts`
- [Session service](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/sesion.service.ts): `guayacan-erp/frontend/src/app/core/auth/sesion.service.ts`
- [Session guard](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/auth/sesion.guard.ts): `guayacan-erp/frontend/src/app/core/auth/sesion.guard.ts`
- [Error handling](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/errores/errores.ts): `guayacan-erp/frontend/src/app/core/errores/errores.ts`
- [Farm context](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/core/finca/finca.service.ts): `guayacan-erp/frontend/src/app/core/finca/finca.service.ts`
- [Use-case catalog page](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/shared/modulo-pendiente.component.ts): `guayacan-erp/frontend/src/app/shared/modulo-pendiente.component.ts`

### Farm operations

- [Farm setup](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts): `guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts`
- [Production](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/produccion/produccion.routes.ts): `guayacan-erp/frontend/src/app/features/produccion/produccion.routes.ts`
- [IoT operations](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/iot/iot.routes.ts): `guayacan-erp/frontend/src/app/features/iot/iot.routes.ts`
- [Adoption](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/adopcion/adopcion.routes.ts): `guayacan-erp/frontend/src/app/features/adopcion/adopcion.routes.ts`

### Business workflows

- [People and training](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/personal/personal.routes.ts): `guayacan-erp/frontend/src/app/features/personal/personal.routes.ts`
- [Sales](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/comercial/comercial.routes.ts): `guayacan-erp/frontend/src/app/features/comercial/comercial.routes.ts`
- [Finance](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/finanzas/finanzas.routes.ts): `guayacan-erp/frontend/src/app/features/finanzas/finanzas.routes.ts`
- [Strategy](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/estrategia/estrategia.routes.ts): `guayacan-erp/frontend/src/app/features/estrategia/estrategia.routes.ts`
- [AI capabilities](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/ia/ia.routes.ts): `guayacan-erp/frontend/src/app/features/ia/ia.routes.ts`
- [Training](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/frontend/src/app/features/formacion/formacion.routes.ts): `guayacan-erp/frontend/src/app/features/formacion/formacion.routes.ts`

### Integration services

- [Agent webhooks](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/main.py): `guayacan-erp/servicios/agentes/app/main.py`
- [Meta signature check](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/firmas.py): `guayacan-erp/servicios/agentes/app/firmas.py`
- [Message orchestrator](https://github.com/ivan-malaver/guayacan-erp/blob/main/guayacan-erp/servicios/agentes/app/orquestador.py): `guayacan-erp/servicios/agentes/app/orquestador.py`

### Other components

- **ERP user**
- **Social messaging channels**

## Connections

- ERP user → Login screen: signs in
- Protected route map → Login screen: routes to (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Session guard: protects routes (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Farm setup: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Production: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → IoT operations: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Adoption: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → People and training: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Sales: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Finance: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Strategy: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → AI capabilities: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Protected route map → Training: lazy loads (evidence: `guayacan-erp/frontend/src/app/app.routes.ts`)
- Farm setup → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/nucleo/nucleo.routes.ts`)
- Production → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/produccion/produccion.routes.ts`)
- IoT operations → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/iot/iot.routes.ts`)
- Adoption → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/adopcion/adopcion.routes.ts`)
- People and training → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/personal/personal.routes.ts`)
- Sales → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/comercial/comercial.routes.ts`)
- Finance → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/finanzas/finanzas.routes.ts`)
- AI capabilities → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/ia/ia.routes.ts`)
- Training → Use-case catalog page: shows catalog (evidence: `guayacan-erp/frontend/src/app/features/formacion/formacion.routes.ts`)
- Social messaging channels → Agent webhooks: sends webhooks (evidence: `guayacan-erp/servicios/agentes/app/main.py`)
- Agent webhooks → Meta signature check: validates signature (evidence: `guayacan-erp/servicios/agentes/app/main.py`)
- Agent webhooks → Message orchestrator: queues messages (evidence: `guayacan-erp/servicios/agentes/app/main.py`)
