Primeros Pasos

Guía de inicio para nuevos desarrolladores

Bienvenido a la documentación de infraestructura de illanes00. Esta guía te ayudará a configurar tu entorno y comenzar a trabajar con los proyectos.

Prerrequisitos

Antes de comenzar, asegúrate de tener:

  • Acceso SSH a los VPS (solicitar a illanes00)
  • Cuenta GitHub con acceso a github.com/illanes00/
  • Python 3.10+ y Node.js 18+ instalados
  • Git configurado con tu identidad

Configurar SSH

# Agregar a ~/.ssh/config
Host vps-dev
    HostName <IP-proporcionada>
    User illanes00
    IdentityFile ~/.ssh/id_ed25519

Host vps-deploy
    HostName <IP-proporcionada>
    User illanes00
    IdentityFile ~/.ssh/id_ed25519

Verifica la conexión:

ssh vps-dev "echo 'Conectado!'"

Quick Start: Clonar y Ejecutar

# 1. Conectar al servidor de desarrollo
ssh vps-dev

# 2. Ir al proyecto
cd /srv/projects/nombre-proyecto

# 3. Copiar variables de entorno
cp .env.example .env
# Editar .env con valores reales

# 4. Crear entorno virtual (si no existe)
python3 -m venv venv

# 5. Instalar dependencias
venv/bin/pip install -r requirements.txt

# 6. Ejecutar en modo desarrollo
python run.py

Estructura de Proyectos

Todos los proyectos siguen esta estructura estándar:

proyecto/
├── app/                 # Código fuente principal
│   ├── main.py         # Entry point FastAPI
│   └── ...
├── tests/              # Pruebas
├── deploy/             # Configuración de despliegue
│   ├── systemd.service
│   └── caddy.caddy
├── run.py              # Script de ejecución
├── requirements.txt    # Dependencias
├── .env.example        # Template de variables
└── AGENT-CONTEXT.md    # Contexto para IA (symlink)

Próximos Pasos