Acuerdos para el desarrollo web entre sedes Clicks & Bricks

Acuerdos para el desarrollo web entre sedes Clicks & Bricks

1. Manejo de las ramas

Para cada proyecto nuevo que generemos se trabajará con la siguiente estructura de ramas:

[pic 1]

Donde:

• Master: Será nuestra rama de desarrollo, en la cual se realizarán las pruebas de todos los desarrollos antes del despliegue a Pre.
• Pre: Será nuestra rama para los despliegues al ambiente de pre-producción y de donde se crearán todas las ramas hijas para la realización de los desarrollos que antes de ser subidas deberán ser testeadas de forma local y en el servidor de desarrollo.
• Staging: Esta será una rama estable prácticamente una copia del ambiente de producción en donde se realizará el control de versiones y de la cual se sacará alguna rama para algún pase excepcional de ser necesario.
• Pro: Es el ambiente de producción.

1. Estándares de código

El estándar de código que seguiremos para el desarrollo web será el PSR, del cual adjunto unos enlaces:

• psr-1: http://www.php-fig.org/psr/psr-1/es/
• psr-2: http://www.php-fig.org/psr/psr-2/es/
• psr-3: http://www.php-fig.org/psr/psr-3/es/
• psr-4: http://www.php-fig.org/psr/psr-4/

Es importante poder realizar el tema de formateo de código automatizado dependiendo del IDE que se esté usando.

1. Estándares en los nombre de las ramas y en los commits

Para la creación de las ramas no tendremos ningún problema, pues el proceso se realiza desde jira manteniendo como prefijo el código del ticket y luego una pequeña descripción de la tarea.

Para el tema de registrar los commits seguiremos los siguientes estándares:

"$tipo ($modulo): $identificador $mensaje"

Donde:

• $tipo: Es alguno de los siguientes valores:

• feat: Para implementaciones de nuevas características o historias de usuario o mejoras
• fix: Para correcciones de bugs.
• docs: Para documentación.
• style: Formato, puntuación
• refactor: Para cuando hay que refactorizar código o cambian alguna implementación sin modificar el API
• test: Para agregar o modificar tests
• chore: Para mantenimientos generales

Estos tipos fueron tomados del estándar de commits de Angular: https://goo.gl/WIkppA

• $modulo: Es algún módulo interno de sus aplicaciones, sirve para identificar de una manera más precisa donde fue realizado el cambio.
• $identificador: Es el id del ticket de JIRA
• $mensaje: Es un mensaje claro y descriptivo de lo que contiene el commit.

1. Sobre las tecnologías a usar

Dentro del área de desarrollo web estaremos usando diferentes herramientas, tanto para el desarrollo web en sí, como para la implementación de ambientes de desarrollo y el control de buenas prácticas en el código.

Creación de ambientes de desarrollo en local: Docker 1.9.0

        Desarrollo de servicios REST: Phalcon 2.0.8

...