Documentación del Sistema A3

Bienvenido a la documentación técnica del Sistema A3, el ERP interno de A Terceros Inmobiliaria.

Sobre el Sistema A3

El Sistema A3 es el software propietario desarrollado internamente para gestionar todas las operaciones de A Terceros Inmobiliaria. Integra y automatiza los procesos del negocio inmobiliario en una plataforma web centralizada.

Funcionalidades Principales

• Inventario de Propiedades: Control completo del catálogo de viviendas
• Proceso de Ventas: Gestión desde prospección hasta cierre
• Clientes: Base de datos centralizada con integración SAP
• Recursos Humanos: Gestión de personal, checador y solicitudes
• Finanzas: Comprobaciones, provisiones y solicitudes de pago
• Tickets y Acuerdos: Sistema de tareas y seguimiento
• Reportes: Generación de informes PDF y Excel
• Dashboard: KPIs y analytics en tiempo real

Contexto Corporativo

Propósito

Esta documentación es para el equipo de desarrollo interno de A Terceros Inmobiliaria y desarrolladores externos contratados que requieren acceso autorizado al sistema.

Audiencia

• Desarrolladores del equipo de TI de A Terceros
• Desarrolladores externos con contrato vigente
• Nuevos miembros del equipo durante onboarding
• Personal de otros departamentos que colabora con TI (usuarios avanzados)

Confidencialidad

El Sistema A3 es software propietario y confidencial de A Terceros Inmobiliaria. El acceso a este repositorio y documentación requiere autorización y firma de acuerdos de confidencialidad.

Arquitectura Técnica

Stack Tecnológico

• Backend: Django 3.2 + Django REST Framework
• Base de Datos: PostgreSQL 12.3+
• Frontend: SPA con JavaScript + Bootstrap
• Almacenamiento: AWS S3 para archivos y media
• Deployment: Heroku con escalabilidad automática
• Integración ERP: SAP HANA API

Integraciones Empresariales

• SAP HANA: Sincronización de clientes y datos financieros
• Web Push: Notificaciones en tiempo real
• AWS S3: Almacenamiento de documentos y anexos
• API RESTful: Endpoints para integraciones internas

Seguridad

• Sistema de grupos y permisos granular (9 grupos según roles corporativos)
• Workflows de aprobación multi-nivel
• Auditoría completa de cambios
• Autenticación Django con tokens para API

Primeros Pasos

Para Nuevos Desarrolladores

1. Onboarding: Proceso de incorporación al equipo
2. Solicitar Accesos: Permisos necesarios para desarrollo
3. Instalación: Configurar entorno de desarrollo local
4. Configuración: Variables de entorno y servicios
5. Base de Datos: Setup de PostgreSQL

Comprender el Sistema

1. Arquitectura General: Estructura técnica del sistema
2. Módulos: Conocer cada módulo funcional
3. Guía de Desarrollo: Estándares y procesos del equipo

Documentación por Área

Para Desarrolladores del Sistema

• Arquitectura

Estructura técnica y componentes del sistema

• Módulos

Funcionalidades por módulo de negocio

• API

Endpoints REST y referencia de la API

• Modelos

Estructura de datos y relaciones de BD

Para Desarrollo y Mantenimiento

• Guía de Desarrollo

Procesos y estándares del equipo

• Estándares de Código

Convenciones y buenas prácticas

• Testing

Pruebas con pytest y cobertura

• Agentes IA

Normas para AI code agents

Para Usuarios Finales

• Grupos y Permisos

Roles corporativos y niveles de acceso

• Flujos de Trabajo

Procesos comunes por departamento

• Generación de Reportes

Exportar informes PDF y Excel

• Panel de Administración

Configuración del sistema (administradores)

Módulos del Sistema

El Sistema A3 está organizado en módulos especializados por área de negocio:

Módulo	Descripción	Departamento
Inventario	Catálogo de propiedades y disponibilidad	Ventas
Apartados	Proceso completo de venta	Ventas
Clientes	Base de datos de clientes	Ventas/Finanzas
Tickets	Sistema de tickets y acuerdos	Todos
Comprobaciones	Gastos y solicitudes de pago	Finanzas/RH
Recursos Humanos	Gestión de personal y checador	RH
Usuarios	Perfiles y autenticación	TI/RH
Dashboard	KPIs y analytics	Gerencia
Reportes	Generación de informes	Todos

Ver listado completo de módulos disponibles.

Stack Tecnológico

graph TB
    A[Cliente Web] --> B[Django 3.2]
    B --> C[PostgreSQL 12.3+]
    B --> D[AWS S3]
    B --> E[SAP HANA API]
    B --> F[Web Push Service]

    style B fill:#092e20
    style C fill:#336791
    style D fill:#FF9900

Soporte y Desarrollo

Reportar Problemas

• Bugs en Producción: Crear ticket en [sistema interno de incidencias] con prioridad alta
• Bugs en Desarrollo: Crear issue en GitHub con template "Bug Report"
• Incidencias Críticas: Notificar en canal Slack #sistema-a3-urgente y mencionar a [Tech Lead]

Desarrollo de Features

• Nuevas Funcionalidades: Coordinar con Product Owner [nombre] antes de implementar
• Pull Requests: Seguir guía de PRs y obtener aprobación
• Documentación: Actualizar docs junto con cambios de funcionalidad

Canales de Comunicación Interna

• Slack - #dev-sistema-a3: Desarrollo general, dudas técnicas
• Slack - #sistema-a3-urgente: Incidencias críticas de producción
• Slack - #sistema-a3-deploys: Notificaciones de deployments
• GitHub Issues: Tracking de bugs y features
• Reuniones: Planning bi-semanal, daily standups

Contactos del Equipo

• Tech Lead: [nombre] - [email]
• Product Owner: [nombre] - [email]
• DevOps: [nombre] - [email]
• Soporte TI: [email o extensión]

Sobre A Terceros Inmobiliaria

A Terceros Inmobiliaria es una empresa líder en el sector inmobiliario. El Sistema A3 es la plataforma tecnológica propietaria que impulsa las operaciones diarias de la empresa, desde la gestión de inventario hasta el cierre de ventas y administración de recursos humanos.

---

Siguiente Paso: Si eres nuevo en el equipo, comienza con la guía de onboarding. Si ya tienes acceso, revisa la guía de instalación para configurar tu entorno local.