Guía Vinculación Colaborador nuevo

sfwMED — Guía de incorporación de colaborador nuevo

Requisitos y configuración paso a paso

PREREQUISITOS — Instalar en la máquina del colaborador

1. Visual Studio 2022 Community (gratis)

• Descargar: https://visualstudio.microsoft.com/es/downloads/
• Durante la instalación seleccionar:
  • ✅ ASP.NET y desarrollo web
  • ✅ Desarrollo de escritorio de .NET
• Versión mínima: Visual Studio 2022 17.8

2. .NET 8 SDK

• Descargar: https://dotnet.microsoft.com/download/dotnet/8.0
• Verificar instalación:

  dotnet --version
  
  

  Debe mostrar 8.x.x

3. Git

• Descargar: https://git-scm.com/download/win
• Durante instalación: opciones por defecto están bien
• Verificar:

  git --version
  
  

4. ZeroTier One

• Descargar: https://www.zerotier.com/download/
• Instalar y unirse a la red del equipo:

  zerotier-cli join NETWORK_ID
  
  

  (El NETWORK_ID lo da el administrador — John)
• Verificar conectividad:

  ping 192.168.193.153
  
  

  Debe responder

5. pgAdmin 4 (opcional pero recomendado)

• Descargar: https://www.pgadmin.org/download/
• Para consultar la BD de desarrollo directamente

CONFIGURACIÓN INICIAL — Una sola vez

Paso 1 — Configurar identidad Git

git config --global user.email "tu@email.com"
git config --global user.name "Tu Nombre"

Paso 2 — Clonar el repositorio

cd C:\desarrollo
git clone http://192.168.193.153:3000/sigfilasweb/sfwMedicamentos.git
cd sfwMedicamentos

Paso 3 — Crear rama de trabajo personal

Cada colaborador trabaja en su propia rama, nunca directamente en main o develop:

git checkout develop
git checkout -b feature/tu-nombre-tarea

Ejemplo:

git checkout -b feature/juan-modulo-convenios

Paso 4 — Abrir el proyecto en Visual Studio

• Abrir Visual Studio
• Archivo → Abrir → Proyecto o Solución
• Seleccionar sfwMedicamentos.sln

Paso 5 — Agregar referencia a la librería sfwdm_conectarSQL_Agnostico

La librería NO está en el repo (es un proyecto separado). El administrador (John) debe entregar el archivo:

sfwdm_conectarSQL_Agnostico.dll

Copiarlo a una carpeta del proyecto, por ejemplo:

C:\desarrollo\sfwMedicamentos\Libs\sfwdm_conectarSQL_Agnostico.dll

En Visual Studio → clic derecho en Dependencias → Agregar referencia → buscar el .dll

Paso 6 — Crear appsettings.Development.json

Este archivo NO está en el repositorio (está en .gitignore). Cada colaborador crea el suyo con sus credenciales:

Crear el archivo appsettings.Development.json en la raíz del proyecto:

{
  "ConnectionStrings": {
    "Postgres": "Host=192.168.193.153;Port=5432;Database=sfwdispensarmedicamentos;Username=postgres;Password=PASSWORD_QUE_DA_EL_ADMIN"
  }
}

La contraseña la entrega el administrador (John) de forma segura.

Paso 7 — Verificar que compila y conecta

• Presionar F5 en Visual Studio
• Debe abrir el navegador con la aplicación corriendo
• Debe conectar a la BD del servidor de desarrollo
• Si la BD no está disponible verá la página de aviso del middleware

FLUJO DE TRABAJO DIARIO

Al iniciar el día — actualizar código

git checkout develop
git pull origin develop
git checkout feature/tu-nombre-tarea
git merge develop

Durante el desarrollo — guardar avances

git add .
git commit -m "sfwMED: descripción del cambio"
git push origin feature/tu-nombre-tarea

Al terminar una tarea — crear Pull Request

1. Abrir http://192.168.193.153:3000/sigfilasweb/sfwMedicamentos
2. Clic en Pull Requests → Nuevo Pull Request
3. Base: develop ← Compare: feature/tu-nombre-tarea
4. Descripción del cambio
5. Asignar revisor (John)
6. Clic Crear Pull Request

John revisa y aprueba el Pull Request

• Revisa el código en Gitea
• Si está bien → Merge a develop
• Si hay correcciones → agrega comentarios

REGLAS DEL EQUIPO

✅ Siempre trabajar en rama feature/xxx
✅ Commits descriptivos en español
✅ Pull Request para todo lo que va a develop
✅ Nunca push directo a main
✅ Siempre hacer pull de develop antes de empezar
✅ ZeroTier debe estar activo para conectar a la BD
✅ No subir appsettings.Development.json al repo
✅ No subir contraseñas en ningún archivo

CONTACTO Y ACCESOS

SOLUCIÓN DE PROBLEMAS FRECUENTES

No conecta a la BD → Verificar que ZeroTier está activo → Hacer ping a 192.168.193.153 → Verificar contraseña en appsettings.Development.json

Error al hacer push → Verificar que estás en tu rama feature/xxx, no en main → Hacer pull antes de push

Visual Studio no encuentra la librería → Verificar que sfwdm_conectarSQL_Agnostico.dll está referenciada → Solicitar DLL actualizada al administrador

Conflictos al hacer merge → Comunicar al administrador antes de resolver → Nunca forzar un push con --force