Guía Técnica

Conceptos y herramientas del equipo, simple y visual. Tocá un tema para abrirlo.

14 temas · Actualiza Bahía

Código, hosting y publicación

Plataformas del equipo

Conceptos clave

Actualiza Bahía · guía interna · explicaciones simples, sin tecnicismos

Repositorio

¿Qué es un repositorio?

En GitHub, un repositorio ("repo") es la carpeta de un proyecto.

📦

Una caja por proyecto. Adentro vive todo: archivos, código e historial de cambios.

📄

Los archivos

Todo lo que el proyecto necesita para funcionar.

🕘

El historial

Cada cambio, con fecha y autor. Podés volver atrás.

📖

El README

La presentación: lo primero que se ve al abrirlo.

🌿

Las ramas

Versiones para probar sin romper la principal (main).

📍 Tu caso

actualizabahia-dev / erosmina: la cuenta y el proyecto. Adentro está toda la tienda.

Un proyecto = un repo. Otra app va en otro repo aparte.

Git vs GitHub

Git vs GitHub

Se parecen en el nombre, pero son dos cosas que trabajan juntas.

🛠️

Git — la herramienta

Un programa en tu PC que guarda el historial de cambios. Funciona sin internet.

☁️

GitHub — el sitio web

La página donde subís ese proyecto para guardarlo en la nube y compartirlo.

📸 Fácil de recordar

Git es la cámara (saca las fotos de cada cambio). GitHub es el Instagram donde subís el álbum.

Git en tu compu para guardar · GitHub en internet para respaldar y trabajar en equipo.

Pushear

¿Qué es pushear?

Pushear (push) es subir los cambios de tu PC al repositorio en internet.

⬆️

Hacés cambios y, cuando estás listo, los empujás a GitHub para que queden en la nube.

✏️

1 · Editás

Cambiás archivos en tu compu.

📌

2 · Commit

Guardás una "foto" del cambio con un mensaje.

🚀

3 · Push

Subís esa foto a GitHub. Ya está en la nube.

💬 En criollo

Commit = sacar la foto del cambio. Push = mandarla al álbum compartido en internet.

Una vez pusheado, herramientas como Vercel publican el cambio solas.

Vercel

¿Qué es Vercel?

Toma el código de tu proyecto y lo convierte en una web online con su dirección.

🌐

Es el hosting: el lugar donde vive tu web para que cualquiera la abra.

📦

GitHub

Tu código en el repositorio.

Vercel

Lo toma, lo arma y lo publica.

🔗

Tu web online

Una dirección lista para compartir.

Publica solo

Cada vez que pusheás, actualiza la web sola.

↩️

Volver atrás

Si algo sale mal, volvés a la versión anterior con un clic.

📍 Ya lo usás

Erosmina está en Vercel. Por eso tiene una dirección como erosmina.vercel.app.

GitHub guarda el código · Vercel lo convierte en web usable.

Hosting

¿Qué es el Hosting?

Es el lugar donde "vive" una web para estar siempre online.

🏠

Es el alquiler del local de tu web: el espacio en internet donde queda prendida 24/7.

PlataformaMejor paraLo usamos en
▲ VercelApps modernasErosmina
🌍 CloudflareBarato, seguridadLanding, Doña Celia, P2P
🎛️ GHLBots y CRMTodos los bots

💡 Regla de oro

El hosting va en cuentas oficiales de Actualiza, nunca personales. Así el proyecto no depende de nadie.

GitHub guarda · el hosting pone online · el dominio es la dirección para llegar.

Dominio y DNS

Dominio y DNS

El dominio es la dirección de tu web. El DNS la conecta con el servidor.

🌐

El dominio es el nombre fácil (erosmina.com). El DNS lo traduce a la dirección real.

🏷️

Dominio

El nombre que comprás y escribís en el navegador. tunegocio.com

📖

DNS

La "guía" que dice a qué servidor llevar ese nombre.

📞 Como la agenda del celular

El dominio es el nombre del contacto; el DNS lo convierte en el número real para que la llamada llegue.

Hoy se usa erosmina.vercel.app (gratis) · con dominio propio se apunta el DNS al hosting.

GoHighLevel

¿Qué es GoHighLevel?

La plataforma central del equipo: junta CRM, bots y automatizaciones del cliente.

🎛️

Es la central de comando del cliente: contactos, mensajes, turnos y seguimientos, juntos.

🤖

Bots (Conversation AI)

Responde por WhatsApp o web con la info del cliente.

👥

CRM

La base de todos los contactos y en qué etapa están.

⚙️

Workflows

Mensajes que salen solos, recordatorios, derivaciones.

📅

Calendarios

Reserva de turnos conectada al bot.

🏢 En criollo

Es tener recepcionista, agenda, base de clientes y vendedor automático, todo en una herramienta 24/7.

El equipo trabaja en una subcuenta GHL · un proyecto = una subcuenta del cliente.

Cloudflare

¿Qué es Cloudflare?

Otra plataforma para publicar webs y apps. El "otro hosting" del equipo.

🌍

Una red gigante que aloja y acelera webs en todo el mundo, con un plan gratis generoso.

📄

Pages

Publica páginas (como Vercel). Acá vive la landing de Actualiza.

⚙️

Workers

Pequeños programas en su red. Eventos P2P funciona acá.

🛡️

Seguridad

Protege de ataques. Por eso a veces pide "verificar que sos humano".

⚖️ Cloudflare vs Vercel

Hacen cosas parecidas. Vercel es más cómodo para apps; Cloudflare es más barato a escala y fuerte en seguridad.

Landing, Doña Celia y P2P en Cloudflare · Erosmina en Vercel.

Sheets como CMS

Google Sheets como CMS

Un CMS es "lo que usa el cliente para editar su contenido". El truco: usar una planilla.

📊

La planilla manda: la web lee los datos de Google Sheets. El cliente edita y la web se actualiza sola.

✏️

El cliente edita

Cambia un precio en la planilla.

📊

La planilla guarda

Es la fuente de la verdad.

🛒

La web se actualiza

Muestra el precio nuevo, sin redeploy.

📋 Como el menú de un restaurante

La planilla es la pizarra de precios. La web siempre lee de ahí. Cambiás la pizarra y todos ven el precio nuevo.

Caso real: Erosmina lee 2 planillas (catálogo y envíos) sin tocar el código.

Mercado Pago

¿Qué es Mercado Pago?

El servicio para cobrar online en Argentina. El equipo lo usa en vez de Stripe.

💳

Es la caja registradora online: el cliente paga con tarjeta, dinero en cuenta o transferencia.

🇦🇷

Local

Tarjetas, cuotas, dinero en cuenta y QR.

🔗

Link / botón de pago

Se integra a la web o se manda un link para cobrar.

🔌

Tiene API

Las apps se conectan (con su API Key) para cobrar automático.

🌎 ¿Por qué no Stripe?

Stripe es el estándar mundial, pero en Argentina conviene Mercado Pago: lo usa todo el mundo y maneja la plata local.

Varios proyectos cobran por alias/transferencia + comprobante para arrancar simple.

Claude Code

¿Qué es Claude Code?

La herramienta de IA con la que trabaja el equipo. Le pedís en español y construye por vos.

🤝

Es un programador asistente: entiende lo que pedís, escribe el código y maneja Git, GitHub y los deploys.

💬

Hablás en español

No necesitás saber programar.

🧠

Tiene memoria

Recuerda tus proyectos y preferencias.

📱

Desde el celular

Se usa por SSH desde el teléfono, no solo en la PC.

👷 Como un empleado técnico

Vos decís qué hacer; Claude Code sabe el cómo y lo ejecuta. Esta misma guía la hizo así.

Arma bots GHL, webs, documentos y automatizaciones · siempre confirma antes de acciones importantes.

API

¿Qué es una API?

La forma en que dos programas se hablan. Le pedís algo a otro servicio y te responde.

🔌

Es un enchufe estándar: conectás tu app a otro servicio (Google, un banco, una IA) y le pedís datos o acciones.

🙋

Tu app pide

"Convertí esta foto en texto"

🧠

El servicio responde

La API de Gemini hace el trabajo.

Recibís el resultado

El texto listo, en segundos.

🍽️ Como un mozo

Vos pedís un plato. El mozo (la API) lleva tu pedido a la cocina y te trae la comida. No entrás a la cocina.

El equipo usa APIs todo el tiempo: Gemini (OCR), GHL, Google Sheets, Mercado Pago.

API Key

¿Qué es una API Key?

La llave secreta que te identifica al usar una API. Demuestra permiso y a quién cobrarle.

🔑

Es tu contraseña personal para usar un servicio. Quien la tiene, lo usa a tu nombre.

Ejemplo: AIzaSyD-x9f2...K3mQ
(una clave de Google AI / Gemini)

✅ Sí

  • Guardarla segura (secrets / variables de entorno)
  • Usar cuentas oficiales de Actualiza
  • Borrarla y crear otra si se filtró

⛔ No

  • Pegarla en el código que se sube a GitHub
  • Mandarla por chat o mail
  • Compartirla en un HTML público

🏧 Como el PIN de tu tarjeta

La API es el cajero; la API Key es tu PIN. Si alguien lo consigue, gasta de tu cuenta.

Van como "secrets": ej. GEMINI_API_KEY · nunca dentro del código del repo.

Base de datos

¿Qué es una Base de Datos?

Donde una app guarda su info ordenada: clientes, pedidos, productos. La memoria del sistema.

🗄️

Es un fichero ordenado: guarda los datos en tablas (filas y columnas) para buscarlos rápido.

PedidoClienteTotalEstado
#001Romina$8.500Entregado
#002Juan$12.300En camino

Cada fila es un registro, cada columna un dato.

🔎

Busca rápido

"Todos los pedidos de hoy" en un instante.

🔒

Es confiable

No se pierde la info si se apaga la app.

📇 Como un fichero gigante

Un mueble con fichas perfectamente ordenadas donde encontrás cualquier dato al instante. Pero digital y para millones de fichas.

Ej: La Esquina usa una base de datos (Prisma) para pedidos · GHL ya trae la suya para el CRM.