🛠️ Herramientas Necesarias

Todo lo que necesitas para comenzar a desarrollar con MoneyPenny

Git & GitHub

Herramienta Opcional pero Muy Recomendable

Git no es obligatorio, pero es altamente aconsejable para el desarrollo con MoneyPenny. Te permite construir tu aplicación paso a paso, guardando una copia de seguridad en cada avance que realices.

¿Por qué es importante? Cuando trabajas con agentes de IA, pueden ocurrir errores que sean difíciles de corregir. Con Git, puedes volver atrás fácilmente al último punto estable, recuperando el último paso bien dado y validado por ti. Es tu red de seguridad durante el desarrollo.

¿Qué es Git?

Git es un sistema de control de versiones distribuido que te permite rastrear cambios en tu código, colaborar con otros desarrolladores y mantener un historial completo de tu proyecto.

¿Qué es GitHub?

GitHub es una plataforma de alojamiento de código que utiliza Git. Te permite almacenar tus repositorios en la nube, colaborar con otros desarrolladores, gestionar proyectos y desplegar aplicaciones.

Fork (Cliente Git)

Cliente Git visual para Windows y Mac. Interfaz intuitiva para gestionar repositorios.

Descargar Fork
Crear Cuenta en GitHub

Crea tu cuenta gratuita en GitHub para alojar tus proyectos y colaborar.

Registrarse en GitHub
💡 Tip: También puedes descargar Git directamente desde git-scm.com si prefieres usar la línea de comandos.

PostgreSQL & pgAdmin

Base de Datos Integrada con Agente Especializado

En la mayoría de tus aplicaciones necesitarás almacenar datos en una base de datos. Este esqueleto de MoneyPenny está preparado para trabajar directamente con PostgreSQL y cuenta con un agente especializado para facilitar esta tarea.

Podrás añadir tablas, campos y relaciones de forma sencilla utilizando el agente. Por ejemplo:

@database-migration-agent.md quiero añadir una tabla nueva de propiedades de producto con los campos Alto, Ancho y Largo, en los 3 campos quiero campos decimales con 2 posiciones.

💡 El agente te guiará paso a paso para crear las migraciones, aplicar los cambios y mantener tu base de datos sincronizada con tu modelo de datos.

¿Qué es PostgreSQL?

PostgreSQL es un sistema de gestión de bases de datos relacional de código abierto, potente y altamente escalable. Es conocido por su fiabilidad, robustez de características y rendimiento. Soporta SQL estándar y ofrece características avanzadas como transacciones ACID, índices complejos, claves foráneas, triggers y procedimientos almacenados.

¿Qué es pgAdmin?

pgAdmin es la herramienta de administración gráfica más popular para PostgreSQL. Te permite gestionar tus bases de datos de forma visual: crear tablas, ejecutar consultas SQL, ver datos, gestionar usuarios y mucho más, todo desde una interfaz web intuitiva.

PostgreSQL

Motor de base de datos. Descarga el instalador para tu sistema operativo.

Descargar PostgreSQL
pgAdmin

Herramienta gráfica de administración. Generalmente se incluye con PostgreSQL.

Descargar pgAdmin
⚙️ Instalación: Durante la instalación de PostgreSQL, recuerda la contraseña del usuario postgres que configures. La necesitarás para conectarte a la base de datos. Por defecto, PostgreSQL se ejecuta en el puerto 5432.

Cursor IDE

¿Qué es Cursor?

Cursor es un IDE de última generación diseñado específicamente para el desarrollo moderno de aplicaciones. Está construido sobre Visual Studio Code pero potenciado con Inteligencia Artificial integrada que te ayuda a escribir, editar y depurar código de forma más rápida y eficiente.

Características Principales
  • IA Integrada: Asistente de código con GPT-4, Claude y otros modelos
  • Autocompletado Inteligente: Sugerencias contextuales avanzadas
  • Chat con tu Código: Pregunta sobre tu proyecto y obtén respuestas
  • Generación de Código: Crea funciones completas con lenguaje natural
  • Refactorización Asistida: Mejora tu código automáticamente
  • Debugging Inteligente: Encuentra y corrige errores más rápido
  • Compatible con VS Code: Todas las extensiones funcionan
  • Multi-lenguaje: C#, JavaScript, Python, TypeScript, etc.
Descargar Cursor

IDE potenciado con IA para desarrollo de aplicaciones. Compatible con Windows, Mac y Linux.

Descargar Cursor IDE
Documentación

Aprende a usar Cursor y todas sus características de IA para maximizar tu productividad.

Ver Documentación
¿Por qué usar Cursor para MoneyPenny?
  • Desarrollo más rápido: La IA te ayuda a escribir código ASP.NET Core más rápido
  • Menos errores: Detecta problemas antes de compilar
  • Aprende mientras codificas: Explica patrones y mejores prácticas
  • Refactorización fácil: Mejora tu código con comandos simples
  • Integración con Git: Control de versiones integrado
  • Debugging avanzado: Encuentra bugs más rápido con ayuda de IA
💡 Tip: Cursor es especialmente útil para trabajar con este proyecto MoneyPenny. Puedes pedirle que te ayude a crear nuevas entidades, controladores, vistas y mucho más usando lenguaje natural.

Inteligencia Artificial

¿Por qué integrar IA en tu aplicación?

La Inteligencia Artificial te permite crear chatbots inteligentes, asistentes virtuales, análisis de texto, generación de contenido, traducción automática, resúmenes, clasificación de datos y mucho más. Integra modelos de lenguaje avanzados para potenciar tu aplicación.

OpenAI (ChatGPT)

GPT-4, GPT-4 Turbo y GPT-3.5. Los modelos más avanzados para conversación, análisis y generación de contenido.

Casos de uso:

  • Chatbots conversacionales
  • Asistentes virtuales
  • Generación de contenido
  • Análisis de sentimientos
  • Traducción y resúmenes
Crear Cuenta en OpenAI
Anthropic (Claude)

Claude 3 Opus, Sonnet y Haiku. Modelos con contextos largos (200K tokens) y razonamiento avanzado.

Casos de uso:

  • Análisis de documentos largos
  • Asistentes de código
  • Investigación y análisis
  • Redacción profesional
  • Procesamiento de datos complejos
Crear Cuenta en Anthropic
Google (Gemini)

Gemini Pro y Ultra. Modelos multimodales de Google con capacidades avanzadas de visión y razonamiento.

Casos de uso:

  • Análisis de imágenes y video
  • Procesamiento multimodal
  • Búsqueda inteligente
  • Asistentes de productividad
  • Análisis de datos visuales
Crear Cuenta en Google AI
Azure OpenAI Service

Acceso a modelos de OpenAI (GPT-4, GPT-3.5, DALL-E) a través de Azure con SLA empresarial y cumplimiento normativo.

Ventajas:

  • Integración nativa con Azure
  • Cumplimiento normativo (GDPR, HIPAA)
  • SLA empresarial del 99.9%
  • Facturación integrada con Azure
  • Redes privadas y seguridad avanzada
Más información sobre Azure OpenAI
Otros Proveedores

Alternativas adicionales para diferentes necesidades y presupuestos.

  • Cohere: Modelos especializados en empresas
  • Hugging Face: Modelos open-source y personalizables
  • Mistral AI: Modelos europeos de alto rendimiento
  • Meta (Llama): Modelos open-source potentes
  • Perplexity: Búsqueda y respuestas con fuentes
📋 Cómo Integrar IA en MoneyPenny

OpenAI:

  1. Crea cuenta en platform.openai.com
  2. Ve a "API Keys" en tu perfil
  3. Click en "Create new secret key"
  4. Copia y guarda la clave (solo se muestra una vez)
  5. Añade créditos en "Billing" para empezar a usar

Anthropic (Claude):

  1. Crea cuenta en console.anthropic.com
  2. Ve a "API Keys"
  3. Genera una nueva clave
  4. Configura límites de gasto

Añade la configuración de IA en tu appsettings.json:

{
  "AI": {
    "OpenAI": {
      "ApiKey": "sk-...",
      "Model": "gpt-4-turbo-preview",
      "MaxTokens": 2000,
      "Temperature": 0.7
    },
    "Anthropic": {
      "ApiKey": "sk-ant-...",
      "Model": "claude-3-opus-20240229",
      "MaxTokens": 4000
    },
    "Google": {
      "ApiKey": "AIza...",
      "Model": "gemini-pro"
    }
  }
}
⚠️ Seguridad: Nunca subas las API Keys a Git. Usa variables de entorno o Azure Key Vault en producción.

Instala los paquetes necesarios:

# OpenAI
dotnet add package OpenAI

# Anthropic (Claude)
dotnet add package Anthropic.SDK

# Google Gemini
dotnet add package Google.Cloud.AIPlatform.V1

# Azure OpenAI
dotnet add package Azure.AI.OpenAI

Ejemplo de servicio para OpenAI:

public class OpenAIService
{
    private readonly OpenAIClient _client;
    private readonly string _model;

    public OpenAIService(IConfiguration config)
    {
        var apiKey = config["AI:OpenAI:ApiKey"];
        _model = config["AI:OpenAI:Model"];
        _client = new OpenAIClient(apiKey);
    }

    public async Task<string> ChatAsync(string prompt)
    {
        var response = await _client.GetChatCompletionsAsync(
            new ChatCompletionsOptions
            {
                Messages = {
                    new ChatMessage(ChatRole.System, "Eres un asistente útil."),
                    new ChatMessage(ChatRole.User, prompt)
                },
                Model = _model,
                MaxTokens = 2000
            }
        );
        
        return response.Value.Choices[0].Message.Content;
    }
}

public class ChatController : Controller
{
    private readonly OpenAIService _aiService;

    public ChatController(OpenAIService aiService)
    {
        _aiService = aiService;
    }

    [HttpPost]
    public async Task<IActionResult> SendMessage(string message)
    {
        var response = await _aiService.ChatAsync(message);
        return Json(new { response });
    }
}
💡 Casos de Uso Prácticos
  • Chatbot de Soporte: Responde preguntas frecuentes automáticamente
  • Asistente de Ventas: Ayuda a los clientes a encontrar productos
  • Generación de Contenido: Crea descripciones de productos, emails, etc.
  • Análisis de Sentimientos: Analiza opiniones de clientes
  • Resumen de Documentos: Extrae información clave de textos largos
  • Traducción Automática: Traduce contenido a múltiples idiomas
  • Clasificación de Datos: Categoriza tickets, emails, comentarios
  • Agentes Personalizados: Crea asistentes especializados para tu negocio
💰 Costos Aproximados (2026)
OpenAI GPT-4:
  • Input: $0.03 / 1K tokens
  • Output: $0.06 / 1K tokens
Claude 3 Opus:
  • Input: $0.015 / 1K tokens
  • Output: $0.075 / 1K tokens
Gemini Pro:
  • Gratis hasta 60 req/min
  • Luego: $0.0005 / 1K tokens

Nota: Los precios pueden variar. Consulta la documentación oficial de cada proveedor.

Microsoft Azure

¿Qué es Microsoft Azure?

Microsoft Azure es una plataforma de computación en la nube que ofrece servicios de infraestructura (IaaS), plataforma (PaaS) y software (SaaS). Te permite desplegar aplicaciones web, bases de datos, servicios de IA, almacenamiento y mucho más. Es ideal para alojar tu aplicación ASP.NET Core en producción.

Crear Cuenta en Azure

Azure ofrece una cuenta gratuita con $200 USD de crédito para los primeros 30 días y servicios gratuitos durante 12 meses, además de más de 55 servicios siempre gratuitos.

Crear Cuenta Gratuita en Azure
📋 Pasos para Crear tu Suscripción de Azure

  1. Visita azure.microsoft.com/free
  2. Haz clic en "Comenzar gratis" o "Cuenta gratuita"
  3. Inicia sesión con tu cuenta de Microsoft (Outlook, Hotmail, etc.) o crea una nueva

Información requerida:

  • Datos personales: Nombre, país, número de teléfono
  • Verificación de identidad: Verificación por SMS o llamada telefónica
  • Tarjeta de crédito/débito: Solo para verificación de identidad (no se cobrará)
  • Acuerdo: Acepta los términos y condiciones
💳 Nota: La tarjeta es solo para verificación. No se te cobrará a menos que actualices manualmente a un plan de pago después de que expire el período de prueba.

  1. Una vez completado el registro, accede al Portal de Azure
  2. Verás el panel principal con acceso a todos los servicios
  3. Tu suscripción gratuita estará activa y lista para usar

Servicios principales que puedes usar:

  • App Service: Para desplegar tu aplicación ASP.NET Core
  • Azure Database for PostgreSQL: Base de datos PostgreSQL administrada
  • Azure Storage: Almacenamiento de archivos y blobs
  • Azure Active Directory: Gestión de identidades y acceso

Para desplegar MoneyPenny en Azure:

  1. En el Portal de Azure, busca "App Services"
  2. Haz clic en "Crear" y selecciona "Aplicación web"
  3. Configura:
    • Grupo de recursos (crea uno nuevo)
    • Nombre de la aplicación (será tu URL: nombre.azurewebsites.net)
    • Stack de runtime: .NET 10 (LTS)
    • Sistema operativo: Linux o Windows
    • Región: Elige la más cercana a tus usuarios
  4. Crea una base de datos PostgreSQL en "Azure Database for PostgreSQL"
  5. Configura las cadenas de conexión en la configuración de la aplicación
  6. Despliega desde Visual Studio, VS Code o GitHub Actions
🎁 Beneficios de la Cuenta Gratuita:
  • $200 USD de crédito para explorar servicios durante 30 días
  • Servicios gratuitos durante 12 meses (App Service, Database, Storage, etc.)
  • Más de 55 servicios siempre gratuitos
  • No se cobra automáticamente después del período de prueba