# sickobusiness33-cloud/starmemev2 architecture

> Architecture diagram of the GitHub repository sickobusiness33-cloud/starmemev2, 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/sickobusiness33-cloud/starmemev2
- Repository: https://github.com/sickobusiness33-cloud/starmemev2

## Overview

El repositorio reúne tres productos documentados o sustancialmente representados: STARmeme Bot, Control IA (servidor Python y una implementación Cloudflare en paralelo) y Hootradar. STARmeme detecta y filtra tokens, prepara textos y alerta por Discord; Control IA gestiona proyectos y ejecuciones de asistentes; Hootradar presenta detecciones, radar e inteligencia de mercado. Las relaciones del bot se apoyan en el README; las de las otras aplicaciones, en los extractos y referencias del índice de fuentes. No se infieren conexiones entre productos.

Main entry points: [`control_ia/app.py`](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/app.py) (API y aplicación), [`discord_bot.py`](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/discord_bot.py) (Comandos y alertas), [`sources.py`](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/sources.py) (Fuentes de tokens), [`control_ia_cloudflare/src/autopilot/routes.ts`](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/autopilot/routes.ts) (Rutas Autopilot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_bot["STARmeme Bot"]
  node_bot_entry["Arranque del bot<br/>[main.py]"]
  node_bot_commands["Comandos y alertas<br/>[discord_bot.py]"]
  node_bot_sources["Fuentes de tokens<br/>[sources.py]"]
  node_bot_filters["Filtros de mercado<br/>[filters.py]"]
  node_bot_tweets["Generador de tweets<br/>[tweets.py]"]
  node_bot_state[("Estado de alertas<br/>[state.py]")]
end

subgraph group_control["Control IA Python"]
  node_py_app["API y aplicación<br/>[app.py]"]
  node_py_auth["Autenticación<br/>[auth.py]"]
  node_py_projects["Proyectos<br/>[projects.py]"]
  node_py_runs["Ejecuciones<br/>[runs.py]"]
  node_py_db[("Persistencia<br/>[db.py]")]
  node_py_tools["Herramientas<br/>[tools.py]"]
  node_py_providers["Proveedores IA<br/>[api.py]"]
  node_py_connectors["Conectores<br/>[api.py]"]
  node_py_audit["Auditoría<br/>[audit.py]"]
end

subgraph group_worker["Control IA Cloudflare"]
  node_cf_entry["Rutas API<br/>[index.ts]"]
  node_cf_db[("D1 y acceso a datos<br/>[db.ts]")]
  node_cf_auth["Autenticación<br/>[auth.ts]"]
  node_cf_ai["Enrutador de IA<br/>[router.ts]"]
  node_cf_auto_routes["Rutas Autopilot<br/>[routes.ts]"]
  node_cf_auto_engine["Motor Autopilot<br/>[engine.ts]"]
  node_cf_factory_routes["Rutas Factory<br/>[routes.ts]"]
  node_cf_factory_engine["Motor Factory<br/>[engine.ts]"]
  node_cf_audit["Auditoría<br/>[audit.ts]"]
end

subgraph group_radar["Hootradar"]
  node_web_app["Aplicación web<br/>[App.tsx]"]
  node_web_store["Estado cliente<br/>[store.ts]"]
  node_web_api["Cliente API<br/>[api.ts]"]
  node_radar_server["Servidor HTTP<br/>[server.ts]"]
  node_scanner["Escáner de mercado<br/>[scanner.ts]"]
  node_pipeline["Pipeline de detección<br/>[pipeline.ts]"]
end

node_operator(("Operador Discord"))
node_discord{{"Discord"}}
node_market{{"APIs de mercado"}}
node_radar_user(("Usuario Hootradar"))

node_operator -->|"envía comandos"| node_bot_commands
node_bot_entry -->|"inicia"| node_bot_commands
node_bot_commands -->|"solicita candidatos"| node_bot_sources
node_bot_sources -->|"consulta tokens"| node_market
node_bot_sources -->|"cruza y filtra"| node_bot_filters
node_bot_filters -->|"confirma liquidez"| node_market
node_bot_commands -->|"genera texto"| node_bot_tweets
node_bot_commands -->|"registra alertas"| node_bot_state
node_bot_commands -->|"publica alerta"| node_discord
node_py_app -->|"registra rutas"| node_py_auth
node_py_app -->|"registra rutas"| node_py_projects
node_py_app -->|"registra rutas"| node_py_runs
node_py_app -->|"registra rutas"| node_py_connectors
node_py_app -->|"registra rutas"| node_py_providers
node_py_app -->|"registra rutas"| node_py_tools
node_py_app -->|"registra rutas"| node_py_audit
node_py_auth -->|"consulta y actualiza"| node_py_db
node_cf_entry -->|"monta rutas"| node_cf_auto_routes
node_cf_entry -->|"monta rutas"| node_cf_factory_routes
node_cf_auto_routes -->|"despacha ciclos"| node_cf_auto_engine
node_cf_auto_engine -->|"solicita inferencia"| node_cf_ai
node_cf_factory_routes -->|"llama funciones"| node_cf_factory_engine
node_cf_factory_engine -->|"solicita inferencia"| node_cf_ai
node_cf_auto_routes -->|"registra acciones"| node_cf_audit
node_cf_auto_engine -->|"lee y escribe"| node_cf_db
node_cf_factory_engine -->|"lee y escribe"| node_cf_db
node_radar_user -.->|"usa vistas"| node_web_app
node_web_app -->|"presenta estado"| node_web_store
node_web_app -.->|"obtiene datos"| node_web_api
node_radar_server -->|"consulta escáner"| node_scanner
node_scanner -.->|"procesa snapshots"| node_pipeline

click node_bot_entry "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/main.py"
click node_bot_commands "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/discord_bot.py"
click node_bot_sources "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/sources.py"
click node_bot_filters "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/filters.py"
click node_bot_tweets "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/tweets.py"
click node_bot_state "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/state.py"
click node_py_app "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/app.py"
click node_py_auth "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/auth.py"
click node_py_projects "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/projects.py"
click node_py_runs "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/runs.py"
click node_py_db "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/db.py"
click node_py_tools "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/tools.py"
click node_py_providers "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/providers/api.py"
click node_py_connectors "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/connectors/api.py"
click node_py_audit "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/audit.py"
click node_cf_entry "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/index.ts"
click node_cf_db "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/db.ts"
click node_cf_auth "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/auth.ts"
click node_cf_ai "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/ai/router.ts"
click node_cf_auto_routes "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/autopilot/routes.ts"
click node_cf_auto_engine "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/autopilot/engine.ts"
click node_cf_factory_routes "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/factory/routes.ts"
click node_cf_factory_engine "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/factory/engine.ts"
click node_cf_audit "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/audit.ts"
click node_web_app "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/App.tsx"
click node_web_store "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/store.ts"
click node_web_api "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/lib/api.ts"
click node_radar_server "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/http/server.ts"
click node_scanner "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/engine/scanner.ts"
click node_pipeline "https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/engine/pipeline.ts"

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_bot_entry,node_bot_commands,node_bot_sources,node_bot_filters,node_bot_tweets,node_bot_state toneBlue
class node_py_app,node_py_auth,node_py_projects,node_py_runs,node_py_db,node_py_tools,node_py_providers,node_py_connectors,node_py_audit toneAmber
class node_cf_entry,node_cf_db,node_cf_auth,node_cf_ai,node_cf_auto_routes,node_cf_auto_engine,node_cf_factory_routes,node_cf_factory_engine,node_cf_audit,node_market toneMint
class node_web_app,node_web_store,node_web_api,node_radar_server,node_scanner,node_pipeline toneRose
class node_operator,node_discord,node_radar_user toneIndigo
```

## Components

### STARmeme Bot

- [Arranque del bot](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/main.py): `main.py`
- [Comandos y alertas](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/discord_bot.py): `discord_bot.py`
- [Fuentes de tokens](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/sources.py): `sources.py`
- [Filtros de mercado](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/filters.py): `filters.py`
- [Generador de tweets](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/tweets.py): `tweets.py`
- [Estado de alertas](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/state.py): `state.py`

### Control IA Python

- [API y aplicación](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/app.py): `control_ia/app.py`
- [Autenticación](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/auth.py): `control_ia/auth.py`
- [Proyectos](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/projects.py): `control_ia/projects.py`
- [Ejecuciones](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/runs.py): `control_ia/runs.py`
- [Persistencia](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/db.py): `control_ia/db.py`
- [Herramientas](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/tools.py): `control_ia/tools.py`
- [Proveedores IA](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/providers/api.py): `control_ia/providers/api.py`
- [Conectores](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/connectors/api.py): `control_ia/connectors/api.py`
- [Auditoría](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia/audit.py): `control_ia/audit.py`

### Control IA Cloudflare

- [Rutas API](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/index.ts): `control_ia_cloudflare/src/index.ts`
- [D1 y acceso a datos](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/db.ts): `control_ia_cloudflare/src/db.ts`
- [Autenticación](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/auth.ts): `control_ia_cloudflare/src/auth.ts`
- [Enrutador de IA](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/ai/router.ts): `control_ia_cloudflare/src/ai/router.ts`
- [Rutas Autopilot](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/autopilot/routes.ts): `control_ia_cloudflare/src/autopilot/routes.ts`
- [Motor Autopilot](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/autopilot/engine.ts): `control_ia_cloudflare/src/autopilot/engine.ts`
- [Rutas Factory](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/factory/routes.ts): `control_ia_cloudflare/src/factory/routes.ts`
- [Motor Factory](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/factory/engine.ts): `control_ia_cloudflare/src/factory/engine.ts`
- [Auditoría](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/control_ia_cloudflare/src/audit.ts): `control_ia_cloudflare/src/audit.ts`

### Hootradar

- [Aplicación web](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/App.tsx): `hootradar/web/src/App.tsx`
- [Estado cliente](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/store.ts): `hootradar/web/src/store.ts`
- [Cliente API](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/web/src/lib/api.ts): `hootradar/web/src/lib/api.ts`
- [Servidor HTTP](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/http/server.ts): `hootradar/server/src/http/server.ts`
- [Escáner de mercado](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/engine/scanner.ts): `hootradar/server/src/engine/scanner.ts`
- [Pipeline de detección](https://github.com/sickobusiness33-cloud/starmemev2/blob/main/hootradar/server/src/engine/pipeline.ts): `hootradar/server/src/engine/pipeline.ts`

### Other components

- **Operador Discord**
- **Discord**
- **APIs de mercado**
- **Usuario Hootradar**

## Connections

- Operador Discord → Comandos y alertas: envía comandos (evidence: `README.md`)
- Arranque del bot → Comandos y alertas: inicia (evidence: `main.py`)
- Comandos y alertas → Fuentes de tokens: solicita candidatos (evidence: `README.md`)
- Fuentes de tokens → APIs de mercado: consulta tokens (evidence: `README.md`)
- Fuentes de tokens → Filtros de mercado: cruza y filtra (evidence: `README.md`)
- Filtros de mercado → APIs de mercado: confirma liquidez (evidence: `README.md`)
- Comandos y alertas → Generador de tweets: genera texto (evidence: `README.md`)
- Comandos y alertas → Estado de alertas: registra alertas (evidence: `README.md`)
- Comandos y alertas → Discord: publica alerta (evidence: `README.md`)
- API y aplicación → Autenticación: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Proyectos: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Ejecuciones: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Conectores: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Proveedores IA: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Herramientas: registra rutas (evidence: `control_ia/app.py`)
- API y aplicación → Auditoría: registra rutas (evidence: `control_ia/app.py`)
- Autenticación → Persistencia: consulta y actualiza (evidence: `control_ia/auth.py`)
- Rutas API → Rutas Autopilot: monta rutas (evidence: `control_ia_cloudflare/src/index.ts`)
- Rutas API → Rutas Factory: monta rutas (evidence: `control_ia_cloudflare/src/index.ts`)
- Rutas Autopilot → Motor Autopilot: despacha ciclos (evidence: `control_ia_cloudflare/src/autopilot/routes.ts`)
- Motor Autopilot → Enrutador de IA: solicita inferencia (evidence: `control_ia_cloudflare/src/autopilot/engine.ts`)
- Rutas Factory → Motor Factory: llama funciones (evidence: `control_ia_cloudflare/src/factory/routes.ts`)
- Motor Factory → Enrutador de IA: solicita inferencia (evidence: `control_ia_cloudflare/src/factory/engine.ts`)
- Rutas Autopilot → Auditoría: registra acciones (evidence: `control_ia_cloudflare/src/autopilot/routes.ts`)
- Motor Autopilot → D1 y acceso a datos: lee y escribe (evidence: `control_ia_cloudflare/src/autopilot/engine.ts`)
- Motor Factory → D1 y acceso a datos: lee y escribe (evidence: `control_ia_cloudflare/src/factory/engine.ts`)
- Usuario Hootradar → Aplicación web: usa vistas
- Aplicación web → Estado cliente: presenta estado (evidence: `hootradar/web/src/App.tsx`)
- Aplicación web → Cliente API: obtiene datos
- Servidor HTTP → Escáner de mercado: consulta escáner (evidence: `hootradar/server/src/http/server.ts`)
- Escáner de mercado → Pipeline de detección: procesa snapshots
