SOFTWARE DE PUNTO DE VENTA

Aplicación para el control de puntos de ventas.

Iniciar

Esta proyecto esta echo en react js con tailwind css.

Algunos recursos para iniciar con este proyecto puedes ver en:

Node Js Entorno de desarrollo para aplicación web o movil usando JavaScript.
React Js Biblioteca para diseñar interfeces de usuario usando JavaScript.
Visual Studio Editor de código para todos tipos de lenguaje de programación.
Bootstrap Framework css para la parte visual.
TypeScript Lenguaje de programación de tipado fuerte.
JavaScript Lenguaje de programación interpretado.
Git Software de control de versiones.
Git Hub Plataforma de alojamiento de proyecto de todo ámbito.

Instalación

Siga los pasos para iniciar el desarrollo:

1. Clona el proyecto o agrague el ssh al repositorio para contribuir en nuevos cambios Git Hub - Software Punto de Venta

1.1. Agregue por ssh para la integración

Generar tu clave ssh para poder contribuir al proyecto.

ssh-keygen -t rsa -b 4096 -C "tu email"

Configuración global del nombre.

git config --global user.name "John Doe"

Configuración global del email.

git config --global user.email johndoe@example.com

Crea una carpeta.

mkdir syssoft-integra-frontend

Moverse a la carpeta.

cd syssoft-integra-frontend

Comando para inicia git.

git init

Comando que agrega la referencia de la rama.

git remote add origin git@github.com:luissince/syssoft-integra-frontend.git

Comando que descarga los archivos al working directory.

git fetch origin master

Comando que une los cambios al staging area.

git merge origin/master

1.2 Clonar al proyecto

Al clonar un proyecto no necesitas crear ninguna carpeta.

git clone https://github.com/luissince/syssoft-integra-frontend.git

2. Instale typescript si su proyecto lo usa

npm install -g typescript

3. Ejecute en la carpeta la clonada npm install para descargar las dependencias del proyecto

npm install

4. Copiar el arhivo de la ruta del EndPoint en .env.env.development.example

cp .env.development.example .env.development

5. Configuración de Variables de Entorno del Front-end

A continuación, se presenta la configuración de las variables de entorno utilizadas en el front-end:

VITE_APP_BACK_END=http://localhost:3002
VITE_APP_APIS_PERU=http://localhost:3002

6. Ejecute npm run dev para iniciar el Front-end

npm run dev

7. Ejecute npm run build para construir le proyecto

npm run build

8. Ejecute npm run preview para tener un preview del proyecto

npm run preview

9. Configuración para Ejecutar GitHub Actions para el CI/CD:

Para ejecutar los workflows de GitHub Actions, asegúrate de que tu usuario tenga los privilegios de ejecución necesarios. A continuación, te proporcionamos algunos pasos para empezar:

9.1. Crea un grupo de Docker:

sudo groupadd docker

9.2. Agrega tu Usuario al Grupo de Docker:

sudo usermod -aG docker $USER

9.3. Aplica los Cambios en el Grupo de Docker:

newgrp docker

9.4. Verifica que tu Usuario esté en el Grupo de Docker:

groups

Asegúrate de que "docker" esté en la lista de grupos.

9.5. Configuración y Uso del Runner:

Para iniciar la creación del runner, ve a Settings del proyecto, luego a Actions, Runners, y selecciona "New self-hosted runner".

Si deseas ejecutar en segundo plano, utiliza los siguientes comandos de configuración:

sudo ./svc.sh status
sudo ./svc.sh install
sudo ./svc.sh start
sudo ./svc.sh stop
sudo ./svc.sh uninstall

Estos comandos te permiten controlar el runner según sea necesario.

9. Punto importante la hacer git push

Cuando realices un git push origin master y desees evitar que se ejecute el flujo de trabajo de GitHub Actions, puedes incorporar [skip ci] o [ci skip] en el mensaje del commit. Esta adición indicará a GitHub Actions que omita la ejecución de los trabajos para ese commit específico.

Por ejemplo, al realizar un commit, puedes utilizar el siguiente comando para incluir [skip ci] en el mensaje del commit:

git commit -m "Tu mensaje del commit [skip ci]"

10. Punto importante al hacer al hacer commit

Si deseas mantener mensajes de commit distintos para desarrollo, prueba y producción, pero sin tener que hacer un commit en la rama de desarrollo antes de probar en la rama de prueba, puedes utilizar la opción --no-ff (no fast-forward) al realizar la fusión en cada rama. Esto te permitirá realizar un commit específico en la rama de prueba (y posteriormente en la rama de producción) incluso si no hubo cambios adicionales en desarrollo.

En la rama desarrollo

git checkout desarrollo
git pull origin desarrollo
# Realiza tus cambios y realiza el commit
git add .
git commit -m "Mensaje de desarrollo"

Cambia a la rama de prueba

git checkout test
git pull origin test
# Fusiona los cambios de desarrollo con un commit específico
git merge --no-ff desarrollo -m "Mensaje de prueba"

El uso de --no-ff asegurará que se cree un nuevo commit, incluso si no hubo cambios adicionales en desarrollo.

luissince / syssoft-integra-frontend

readme