aiworker/docs

AiWorker - Documentación

Sistema de orquestación de agentes IA (Claude Code) para automatización del ciclo completo de desarrollo.

Índice de Documentación

01. Arquitectura

• Overview General
• Stack Tecnológico
• Flujo de Datos
• Modelo de Datos

02. Backend

• Estructura del Proyecto
• Database Schema (MySQL)
• MCP Server
• Integración con Gitea
• Sistema de Colas
• API Endpoints

03. Frontend

• Estructura del Proyecto
• Componentes Principales
• Gestión de Estado
• Kanban Board
• Consolas Web

04. Kubernetes

• Setup del Cluster
• Estructura de Namespaces
• Deployments
• Gitea en K8s
• Networking y Ingress

05. Agentes Claude Code

• Pods de Agentes
• Herramientas MCP
• Comunicación con Backend
• Ciclo de Vida

06. Deployment

• CI/CD Pipeline
• GitOps con ArgoCD
• Preview Environments
• Staging y Producción

Quick Start

# Instalar dependencias
cd backend && bun install
cd ../frontend && bun install

# Iniciar servicios locales (Docker Compose)
docker-compose up -d

# Iniciar backend
cd backend && bun run dev

# Iniciar frontend
cd frontend && bun run dev

Stack Tecnológico

• Frontend: React 19.2 + TailwindCSS + Vite
• Backend: Bun 1.3.6 + Express + TypeScript
• Database: MySQL 8.0
• Cache/Queue: Redis
• Git Server: Gitea (auto-alojado)
• Orchestration: Kubernetes
• CI/CD: ArgoCD + GitHub Actions
• Agents: Claude Code (Anthropic)

Versiones

• React: 19.2
• Bun: 1.3.6
• Node: 20+ (para compatibilidad)
• MySQL: 8.0
• Kubernetes: 1.28+
• Gitea: latest

Contribución

Esta es una documentación viva que se actualiza según evoluciona el proyecto.