Este repositorio contiene una aplicación web y multiplataforma (Web PWA, Windows, Mac OS X, iOS y Android) para facilitar la generación de facturas. Este proyecto debería ayudar a mantener los datos de los clientes, realizar la facturación,...
Los marcos, plataformas, bibliotecas, complementos, conceptos, arquitecturas, técnicas, ... utilizados o probados son los siguientes:
Este proyecto requiere que se instalen las siguientes dependencias de antemano:
Para instalar todas las dependencias necesarias simplemente ejecute:
npm install
Esto también configura la plantilla de mensaje de confirmación de git (y configura el paquete wip para usar commitizen).
Utilice el modelo de ramificación de GitFlow y los nombres predeterminados para las ramas de SourceTree en este proyecto; puede encontrar más información aquí:
En este proyecto (angular) se utilizan confirmaciones convencionales. Pautas de mensajes de confirmación angular .
Se utilizarán para generar automáticamente el registro de cambios con la versión estándar del paquete npm; para hacer esto, simplemente ejecute npm run release
. Esto hará la siguiente tarea:
Puedes usar npm run commit
para obtener un asistente que te ayude a escribir los mensajes de confirmación correctos (esto se hace con commitizen ).
Además, se comprobará que los mensajes de confirmación sean correctos con commitlint (si realmente necesita omitirlo, puede omitir los githooks, pero no debe hacerlo normalmente).
Puede generar una plantilla de mensaje de confirmación de git con npm run prepare-git-commit-template
, esto también se hará durante la instalación de npm.
El encabezado (que consta de tipo , alcance y asunto ) no debe tener más de 72 caracteres.
type(scope?): subject
body?
footer?
Debe ser uno de los siguientes:
src
o test
El alcance podría ser cualquier cosa que especifique el lugar del cambio de confirmación. Estoy usando las siguientes convenciones (ejemplos):
El asunto contiene una descripción sucinta del cambio:
Al igual que en el sujeto , utiliza el imperativo, tiempo presente: "cambiar" no "cambiado" ni "cambios". El cuerpo debe incluir la motivación para el cambio y contrastarla con el comportamiento anterior.
El pie de página debe contener información sobre cambios importantes y también es el lugar para hacer referencia a los problemas de JIRA que cierra este compromiso.
Los cambios importantes deben comenzar con la palabra BREAKING CHANGE:
con un espacio o dos líneas nuevas. El resto del mensaje de confirmación se utiliza para esto.
En este repositorio se utilizan ganchos de git (configurados con husky ) para verificar si hay un código fuente "limpio".
Si los archivos Typecript o SCSS se modifican y se envían, se activa un gancho de confirmación y los archivos preparados se formatean con un formato más bonito. Realiza el formateo/cambios y confirma y envía estos cambios, con la ayuda de bastante rápido .
Comprueba si el mensaje de confirmación de git es un mensaje de confirmación de git convencional; de lo contrario, cancelará la confirmación.
La última confirmación en la rama de lanzamiento debe establecer la versión del proyecto y generar el registro de cambios, esto debe hacerse con npm run release
. Este conjunto es la versión del proyecto , genera el registro de cambios y confirma estos cambios . Puede encontrar más información en el capítulo: Registro de cambios/compromisos convencionales.
En este proyecto, Travis CI está configurado como lint-, test-, e2e-tests- y build-slave. Si todo se probó y se construyó correctamente, Travis CI implementará la aplicación web en FireBase .