Onboarding para Nuevos Desarrolladores¶

Bienvenido al equipo de desarrollo del Sistema A3 de A Terceros Inmobiliaria.

Introducción¶

Este proceso te ayudará a integrarte al equipo y estar productivo en el menor tiempo posible. El onboarding típicamente toma 2-4 semanas dependiendo de tu experiencia.

Día 1: Setup Inicial¶

Checklist Administrativo¶

[ ] Recibir equipo (laptop, accesorios)
[ ] Configurar cuentas corporativas:
Correo corporativo @aterceros.com
Slack workspace
Acceso a VPN (si trabajas remoto)
[ ] Firmar documentos legales:
Contrato laboral
Acuerdo de confidencialidad (NDA)
Políticas de seguridad de la información
[ ] Unirse a canales de Slack:
#general - Anuncios de la empresa
#dev-sistema-a3 - Desarrollo del Sistema A3
#sistema-a3-deploys - Notificaciones de deployments
#random - Conversaciones casuales del equipo

Reuniones del Día 1¶

Kick-off con Tech Lead (1 hora)
Visión del Sistema A3
Roadmap actual
Presentación del equipo
Asignación de mentor
Sesión con RH (30 min)
Políticas de la empresa
Beneficios
Horarios y políticas de trabajo remoto
Tour de oficinas (si es presencial)
Espacios de trabajo
Salas de juntas
Áreas comunes

Tareas del Día 1¶

[ ] Solicitar accesos necesarios (ver guía de accesos)
[ ] Leer contexto del negocio inmobiliario
[ ] Configurar entorno de desarrollo local (ver instalación)

Semana 1: Familiarización¶

Lecturas Obligatorias¶

Lee estos documentos en orden para entender el sistema:

Arquitectura del Sistema - Estructura técnica general
Stack Tecnológico - Tecnologías usadas
Guía de Desarrollo - Procesos del equipo
Estándares de Código - Convenciones que seguimos
Guía de PRs - Proceso de code review

Tareas Prácticas¶

[ ] Configurar entorno local completo
Clonar repositorio
Configurar base de datos PostgreSQL
Configurar variables de entorno
Ejecutar migraciones
Levantar servidor local
[ ] Ejecutar tests
Ejecutar suite completa de tests: pytest
Verificar que todos pasen
Entender estructura de tests
[ ] Tu primer Pull Request
Hacer un cambio menor (puede ser en documentación)
Crear branch, commit, push
Abrir PR siguiendo template
Pasar por proceso de code review
[ ] Shadowing: Observar code reviews
Lee PRs recientes del equipo
Observa cómo se dan comentarios
Familiarízate con el estilo de feedback

Conocer el Negocio Inmobiliario¶

Es importante entender el dominio del negocio para desarrollar features correctamente:

[ ] Reunión con stakeholder del departamento de Ventas (1 hora)
Proceso de venta de una propiedad
Qué es un "apartado"
Rol de los asesores (RCs)
[ ] Revisar proceso de workflow de venta completo:
Prospecto → Apartado → Escrituración → Entrega
Leer flujos de trabajo
[ ] Entender términos del negocio:
Leer glosario
Familiarizarse con términos: Casa, Clave, Enganche, Comisión, etc.

Reuniones de la Semana 1¶

Daily Standup (3 veces por semana, 15 min)
Participar como observer
Compartir progreso de onboarding
Pair Programming con Senior Dev (2-3 sesiones de 2 horas)
Revisar código existente
Entender patrones comunes
Preguntar todo lo que no entiendas
Reunión con Product Owner (1 hora)
Entender roadmap del producto
Prioridades actuales
Visión a largo plazo

Semana 2-3: Primeras Contribuciones Reales¶

Objetivos¶

[ ] Cerrar tu primer ticket asignado
Tu mentor te asignará un ticket etiquetado como "good first issue"
Típicamente será un bug fix menor o feature pequeña
Seguir todo el proceso: desarrollo → tests → PR → review → merge
[ ] Participar en code reviews
Revisar PRs de otros desarrolladores
Dar feedback constructivo
Aprender de las revisiones que te hacen
[ ] Asistir a todas las ceremonias del equipo:
Daily Standups (Lu, Mi, Vi)
Sprint Planning (cada 2 semanas)
Tech Sync (semanal)
Retrospectiva (cada 2 semanas)

Módulos para Explorar¶

Dedica tiempo a explorar estos módulos clave:

Inventario - Gestión del catálogo de propiedades
Apartados - Proceso de venta
Tickets - Sistema de tareas
Comprobaciones - Gastos y solicitudes

Lee el código de cada módulo para entender: - Modelos de datos (models.py) - Lógica de vistas (views.py) - Serializers de la API (serializers.py) - Tests (tests/)

Mentorship¶

Mentor asignado: [nombre]
Check-ins: Semanales, cada [día de la semana]
Canal de comunicación: Slack DM o #dev-sistema-a3

Qué esperar del mentor: - Guía técnica sobre el código - Ayuda con dudas de arquitectura - Feedback en tus PRs - Introducción al equipo

Qué se espera de ti: - Hacer preguntas (no hay preguntas tontas) - Tomar iniciativa en tu aprendizaje - Documentar lo que aprendes - Ser proactivo en buscar ayuda cuando te bloquees

Mes 1: Integración Completa¶

Objetivos del Mes¶

Al final del primer mes, deberías:

[ ] Haber cerrado 2-3 tickets reales de complejidad baja-media
[ ] Entender la arquitectura general del sistema
[ ] Conocer los procesos del equipo (development, review, deployment)
[ ] Conocer al equipo y sentirte cómodo preguntando
[ ] Haber participado en code reviews activamente
[ ] Asistir a todas las ceremonias del sprint

Evaluación del Mes 1¶

Tu Tech Lead o manager tendrá una reunión 1-on-1 contigo para: - Evaluar tu progreso - Recibir tu feedback sobre el proceso de onboarding - Ajustar expectativas si es necesario - Planear objetivos para el mes 2

Contexto del Negocio¶

Sobre A Terceros Inmobiliaria¶

A Terceros Inmobiliaria es una empresa líder en el sector inmobiliario en México, especializada en la venta de viviendas residenciales. Opera en múltiples plazas (ciudades) del país.

El Sistema A3¶

El Sistema A3 es el ERP interno que gestiona todas las operaciones de la empresa:

Ventas: Gestión de inventario, apartados, clientes
RH: Checador, gestión de personal, nómina
Finanzas: Comprobaciones, provisiones, pagos
Operaciones: Tickets, acuerdos, seguimiento de tareas

Usuarios del sistema: - ~500 usuarios activos - Desde asesores de ventas hasta gerencia - Personal de RH, finanzas, operaciones

Datos manejados: - Miles de propiedades en catálogo - Decenas de miles de clientes - Cientos de transacciones diarias

Departamentos Clave¶

Departamento	Qué Hace	Módulos que Usa
Ventas	Venta de propiedades	Inventario, Apartados, Clientes, Prospectos
RH	Gestión de personal	Usuarios, RH, Checador, Comprobaciones
Finanzas	Control financiero	Comprobaciones, Apartados (comisiones)
Operaciones	Seguimiento y soporte	Tickets, Acuerdos
TI	Desarrollo y soporte técnico	Todos los módulos

Recursos Internos¶

Documentación¶

Esta documentación: Referencia técnica completa
Wiki interna: [URL de wiki interna si existe]
Grabaciones de trainings: [URL si existe]

Contactos de Emergencia¶

Rol	Nombre	Contacto	Para qué
Tech Lead	`[nombre]`	`[email/slack]`	Decisiones técnicas, escalaciones
Product Owner	`[nombre]`	`[email/slack]`	Requerimientos, prioridades
DevOps	`[nombre]`	`[email/slack]`	Infraestructura, deployments
IT Support	`[nombre]`	`[extensión/email]`	Problemas de equipo, accesos

Canales de Slack¶

Canal	Propósito
`#dev-sistema-a3`	Desarrollo general, dudas técnicas
`#sistema-a3-urgente`	Incidencias críticas (usar con moderación)
`#sistema-a3-deploys`	Notificaciones de deployments
`#general`	Anuncios de la empresa
`#random`	Conversaciones casuales

Tips para Nuevos Desarrolladores¶

Técnicos¶

Lee código antes de escribir: Entiende los patrones existentes
Pregunta antes de asumir: Si no estás seguro, pregunta
Documenta lo que aprendes: Ayuda a los que vengan después
Ejecuta tests frecuentemente: No esperes a hacer el PR
Usa el debugger: No solo prints (aunque también funcionan)

De Comunicación¶

Participa en Slack: Es el canal principal de comunicación
Asiste a daily standups: Comparte tu progreso y blockers
Pide ayuda cuando te bloquees: No más de 30 min atascado antes de preguntar
Sé visible: Comparte lo que estás aprendiendo
Da feedback: En retros, en 1-on-1s, ayuda a mejorar el proceso

De Cultura¶

Horarios flexibles: Coordina con tu equipo tus horarios
Trabajo remoto: Está permitido (según políticas de RH)
Enfoque en resultados: Más importante que horas sentado
Cultura de aprendizaje: Está bien no saber, no está bien no preguntar
Work-life balance: El equipo respeta tu tiempo personal

Preguntas Frecuentes¶

¿Cuánto tiempo toma estar productivo?¶

Típicamente 3-4 semanas para tu primer ticket real, 2-3 meses para sentirte completamente cómodo con el código base.

¿Qué hago si no entiendo algo?¶

Pregunta en #dev-sistema-a3, a tu mentor, o directamente al Tech Lead. No hay preguntas tontas.

¿Cuándo puedo empezar a hacer code reviews?¶

Desde la semana 2. Incluso si eres junior, tu perspectiva de "ojos frescos" es valiosa.

¿Qué hago si cometo un error?¶

Todos cometemos errores. Notifica inmediatamente, aprende de él, y sigue adelante. Tenemos staging para probar y rollback si es necesario.

¿Cómo avanzo en mi carrera aquí?¶

Habla con tu Tech Lead sobre tu plan de carrera. Hay oportunidades de crecer técnicamente o hacia roles de liderazgo.

Siguiente Paso: Comienza con solicitar accesos y luego sigue con la guía de instalación.

¡Bienvenido al equipo! 🎉