General POS es un proyecto base para un módulo de Punto de Venta (POS) diseñado para ser altamente paramétrico, adaptable a las necesidades de diversas empresas. El objetivo es que este proyecto crezca y se convierta en una solución robusta y flexible, adecuada para una amplia gama de negocios.
En construcción 🚧
- Creación de Productos: En construcción.
- Gestión de categorías y subcategorías: Backlog.
- Control de inventario: Backlog.
- Definición de precios y descuentos: Backlog.
- Configuración de impuestos: Backlog.
- Carga de imágenes y descripciones detalladas: Backlog.
Para comenzar a utilizar el proyecto, sigue estos pasos:
- Clona el repositorio en tu máquina local:
git clone https://github.com/tu_usuario/general-pos.git
- Instala las dependencias necesarias utilizando pnpm:
pnpm install
- Configurar base de datos con prisma:
Proceso pendiente de parametrizar
- Inicia el proyecto:
pnpm dev
Este proyecto ha sido desarrollado utilizando las siguientes tecnologías:
- Next.js: Framework de React para aplicaciones web modernas con soporte para renderizado en el servidor.
- TypeScript: Superconjunto de JavaScript que agrega tipado estático, mejorando la calidad del código.
- TailwindCSS: Framework de CSS para construir interfaces de usuario modernas y responsivas.
- shadcn: Conjunto de componentes y utilidades estilizadas para Next.js y TailwindCSS.
- Prisma: ORM para bases de datos, compatible con TypeScript, que simplifica las consultas y el manejo de datos.
- Zod: Librería de validación y parsing para TypeScript, usada para validar esquemas de datos.
- React Hook Form: Librería para manejar formularios de manera eficiente en React.
- NextAuth.js: Solución de autenticación para Next.js, compatible con OAuth, JWT, y más.
- Bcrypt: Herramienta para la encriptación de contraseñas, asegurando la seguridad de los datos sensibles.
Este proyecto tiene la intención de ser comercializado en el futuro. Por lo tanto, no se aceptan contribuciones externas en este momento. El repositorio se hace público para que las personas interesadas puedan observar su progreso.
Este proyecto está licenciado bajo los términos de la GNU General Public License v3.0. Esto significa que:
- Puedes utilizar, modificar y distribuir el software, siempre y cuando cualquier versión modificada o distribuida también esté licenciada bajo la misma licencia.
- Si distribuyes el software (modificado o no), debes incluir una copia de esta licencia.
- Este software se proporciona "tal cual", sin garantía de ningún tipo, expresa o implícita.
Para más detalles, puedes consultar el texto completo de la GPLv3.