{"id":29916512,"url":"https://github.com/exequiel65/mercado-gestion","last_synced_at":"2026-04-08T20:03:17.352Z","repository":{"id":307751163,"uuid":"1030596536","full_name":"Exequiel65/Mercado-gestion","owner":"Exequiel65","description":"🛒 Mercado Gestión es una plataforma modular y escalable para la gestión de e-commerce multi-tenant. Pensada para adaptarse a negocios de distintos tamaños, permite administrar múltiples tiendas, usuarios, productos, ventas y más, desde un solo panel de control.","archived":false,"fork":false,"pushed_at":"2025-08-23T00:46:21.000Z","size":778,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-23T01:29:42.512Z","etag":null,"topics":["csharp","entity-framework-core","jwt","minio","minio-s3","minio-storage","nestjs","netcore","react","react-router","shadcn-ui","sql-server","typeorm","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Exequiel65.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-01T23:33:56.000Z","updated_at":"2025-08-23T00:46:24.000Z","dependencies_parsed_at":"2025-08-02T01:35:58.673Z","dependency_job_id":null,"html_url":"https://github.com/Exequiel65/Mercado-gestion","commit_stats":null,"previous_names":["exequiel65/mercado-gestion"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Exequiel65/Mercado-gestion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exequiel65%2FMercado-gestion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exequiel65%2FMercado-gestion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exequiel65%2FMercado-gestion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exequiel65%2FMercado-gestion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Exequiel65","download_url":"https://codeload.github.com/Exequiel65/Mercado-gestion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Exequiel65%2FMercado-gestion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31571601,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","entity-framework-core","jwt","minio","minio-s3","minio-storage","nestjs","netcore","react","react-router","shadcn-ui","sql-server","typeorm","typescript"],"created_at":"2025-08-02T05:00:51.873Z","updated_at":"2026-04-08T20:03:17.329Z","avatar_url":"https://github.com/Exequiel65.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 Mercado Gestión\n\n**Mercado Gestión** es una plataforma administrativa modular para la gestión integral de tiendas online y físicas. Diseñada para escalar desde un e-commerce simple hasta una solución de tipo ERP, Mercado Gestión ofrece herramientas para manejar productos, inventario, ventas, compras, usuarios, clientes y mucho más.\n\n\u003e ⚠️ Este proyecto está en desarrollo (versión 2), y se encuentra abierto para revisión técnica y colaboración.\n\n## V1\nLa primera versión de **Mercado Gestión** fue diseñada para ofrecer una base sólida para la gestión de una tienda online y su administración interna, orientada a modelos multi-tenant.\n\n![Arquitectura v1](./docs/assets/arquitectura-v1.png)\n\n### ✅ Características implementadas\n\n- **Autenticación y Autorización**\n  - Sistema basado en JWT y roles\n  - Soporte para múltiples tiendas (`Store`) y negocios (`Business`)\n  - Usuarios `superadmin` (acceso global) y `admin` (acceso por tienda)\n\n- **Gestión de productos**\n  - ABM de productos con imágenes, descripciones y estados (`isActive`, `hasDiscount`, etc.)\n  - Categorías anidadas (categoría, subcategoría, hijo)\n  - Selector de categorías jerárquico\n  - Soporte para stock (embebido en producto)\n  - Editor enriquecido para descripciones (Tiptap)\n\n- **Gestión de usuarios**\n  - Listado paginado de usuarios\n  - Creación, edición y asignación de roles\n  - Gestión de imágenes de perfil\n\n- **Gestión de negocio y tienda**\n  - Información del negocio (nombre, dirección, logo, redes sociales)\n  - Datos configurables por tenant\n  - Editor visual de secciones de la tienda (para el home)\n\n- **Multi-tenant por dominio**\n  - Validación por dominio entrante\n  - Cada tenant puede tener una configuración y diseño propio\n\n- **Panel administrativo**\n  - Panel privado desarrollado en React 19 + Vite\n  - Librería de componentes [shadcn/ui](https://ui.shadcn.com/)\n  - Formularios reactivos con `react-hook-form` y validación con Zod\n  - Interfaz clara, modular y centrada en la experiencia del administrador\n\n### ⚙️ Stack tecnológico\n\n- **Frontend:** React 19, Vite, TailwindCSS, shadcn/ui\n- **Formularios:** React Hook Form, Zod\n- **Editor de texto:** Tiptap\n- **Backend:** ASP.NET 8, C#, Entity Framework, SQL Server\n- **Arquitectura:** Hexagonal.\n- **Infraestructura:** Docker Compose\n- **Autenticación:** Identity (solo para UserManager), JWT tokens\n- **Imágenes:** Carga y almacenamiento en base64 (adaptable a CDN o bucket)\n- **Almacenamiento** Implementacion de S3 (En este caso usamos una imagen de docker llamada Minio, permite las mismas funcionaldiades que s3 pero es autohosteada)\n\n---\n\n## 🚀 Implementación - Versión 2 (en desarrollo)\n\nLa segunda versión de **Mercado Gestión** busca escalar la plataforma modularmente, orientándose a una gestión integral del negocio. Esta versión pone el foco en separar responsabilidades, mejorar la trazabilidad y expandir las funcionalidades hacia modelos de gestión más robustos, como mayoristas o negocios con vendedores.\n\n### 🧱 Nuevos módulos\n\n- **Inventario**  \n  - Independiente de los productos  \n  - Gestión de stock por lotes: altas, bajas, movimientos  \n  - Registro de historial de modificaciones (usuario, fecha, motivo)\n  - Filtros por producto, lote, fecha, usuario\n\n- **Ventas y compras**\n  - Vistas diferenciadas para administradores y vendedores\n  - Registro de ventas y compras por tienda\n  - Soporte a ventas minoristas y ventas por mayor\n  - Gestión de usuarios con permisos limitados (vendedor)\n\n- **Proveedores**\n  - ABM de proveedores con datos de contacto y productos vinculados\n  - Historial de compras a cada proveedor\n\n- **Facturación**\n  - Generación de comprobantes básicos (presupuesto, ticket, factura)\n  - Posibilidad de integración futura con AFIP o sistemas externos\n\n- **Catálogo público**\n  - Interfaz pública para mostrar productos sin necesidad de login\n  - Posible carrito sin gestión de stock ni pagos en esta etapa\n\n- **Contabilidad**\n  - Registro básico de ingresos y egresos\n  - Vinculación con ventas, compras y facturación\n  - Reportes generales\n\n- **Gestión de clientes**\n  - Registro de clientes por venta o de forma manual\n  - Historial de compras y facturación\n  - (Futuro: posible módulo CRM)\n\n### 🏗️ Objetivo de la V2\n\n\u003e Crear una plataforma extensible y modular de gestión administrativa, orientada a negocios que requieren no solo una tienda online, sino herramientas para organizar su operación interna, ya sea de manera minorista, mayorista o mixta.\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexequiel65%2Fmercado-gestion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexequiel65%2Fmercado-gestion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexequiel65%2Fmercado-gestion/lists"}