📘 SIG-CM | Sistema Integral de Gestión Comercial y Medios

Este espacio documenta la arquitectura, reglas de negocio y flujos operativos del sistema central de administración, ventas y tesorería.

🎯 Visión General

SIG-CM es una plataforma distribuida diseñada para gestionar el ciclo de vida completo de las ventas publicitarias y de productos físicos, desde la recepción en mostrador (POS) o web, hasta la publicación, facturación y liquidación cruzada entre empresas.

🛠️ Stack Tecnológico

Backend: .NET 10 (C#), REST API, JWT Authentication.
Base de Datos: Microsoft SQL Server (Dapper ORM).
Frontends: React 19, Vite, TailwindCSS, Zustand (State Management).
Reportes: QuestPDF (Generación de actas y tickets nativos).

📚 Índice de Documentación

Navega por las siguientes secciones para entender el comportamiento interno del sistema:

⚙️ Reglas de Negocio (Core)

🏦 Operaciones y Tesorería

📂 Arquitectura del Repositorio (Estructura de Carpetas)

El proyecto utiliza una arquitectura de "Monorepo Lógico", separando claramente el Backend de los distintos clientes Frontend.

📦 SIG-CM
 ┣ 📂 src
 ┃ ┣ 📂 SIG-CM.API             # 🟢 Capa de Presentación (Controladores REST, Middleware, Program.cs)
 ┃ ┣ 📂 SIG-CM.Application     # 🟡 Casos de Uso, DTOs, Interfaces de Servicios y Validaciones (FluentValidation)
 ┃ ┣ 📂 SIG-CM.Domain          # 🔴 Entidades Core (Listings, Users, Orders) e Interfaces de Repositorios
 ┃ ┗ 📂 SIG-CM.Infrastructure  # 🔵 Acceso a Datos (Dapper), Implementación de Servicios, QuestPDF y MercadoPago
 ┃
 ┣ 📂 admin-panel              # 💻 Frontend Gerencial (React 19, Vite, Tailwind)
 ┃ ┣ 📂 src
 ┃ ┃ ┣ 📂 components           # Componentes reutilizables y Modales (ej: ListingDetailModal)
 ┃ ┃ ┣ 📂 pages                # Vistas principales (PricingManager, Dashboard, CategoryManager)
 ┃ ┃ ┣ 📂 services             # Clientes Axios (api.ts) y llamadas al Backend
 ┃ ┃ ┗ 📂 store                # Estado global con Zustand (authStore)
 ┃
 ┗ 📂 counter-panel            # 💻 Frontend de Punto de Venta / Caja (React 19, Vite, Tailwind)
   ┣ 📂 src
   ┃ ┣ 📂 components           # Componentes de POS, Buscadores y Checkout
   ┃ ┣ 📂 hooks                # Custom hooks (useDebounce, useCashSession)
   ┃ ┣ 📂 pages                # Vistas de mostrador (UniversalPosPage, CashRegisterPage, TreasuryPage)
   ┃ ┣ 📂 services             # Clientes Axios (api.ts)
   ┃ ┗ 📂 store                # Estado de Carrito con Zustand (cartStore)

Arquitectura Backend: El backend sigue los principios de la Clean Architecture (Arquitectura Limpia). El dominio (Domain) no tiene dependencias, mientras que la infraestructura (Infrastructure) conoce los detalles de la base de datos (SQL Server + Dapper).

💡 Tip: Si eres un nuevo desarrollador en el equipo, te recomendamos empezar leyendo el Motor de Cotización, ya que es el corazón financiero de la aplicación.

🏠 General

Volver al Inicio

⚙️ Reglas de Negocio

🏦 Operaciones

SIG-CM Wiki Desarrollado para la gestión integral de avisos, mostrador y tesorería. Volver al Repositorio