MONITOREO Y CONTROL VEHCULAR

www.geosatelital.com

MANUAL DE PROCEDIMIENTOS
PARA EL EQUIPO DE
PROGRAMATICA DE
GEOSATELITAL

rea de Sistemas

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

ndice:

1. Bienvenida
2. Flujo para el equipo de desarrollo
3. Entornos
4. Lenguaje comn - Terminologa
5. Recomendaciones

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Bienvenida

El siguiente documento sirve como gua bsica para conllevar el trabajo en equipo de
la manera ms ordenada posible, la historia de la empresa ha empezado con
personas que atendan mltiples necesidades del negocio, pasando por equipos de
un solo hombre hasta lo que es el da de hoy: Equipos especializados.
Nuestro caso es un equipo de especializado, dedicado al software, el cual en el ltimo
ao ha tendido a crecer tanto a nivel de la exigencia de los requerimientos como el
crecimiento del equipo.
Siendo as, no estamos ajenos a la problemtica de cmo conllevar nuestros flujos de
solucin, procesos y dems, por lo tanto recomendamos tomar esta gua como un
manual acordado del equipo, basado en la experiencia de nuestra rea en particular
Adicionalmente sentirse libre de poder comentarnos cualquier observacin , que
todas sern examinadas.

Att.
Erik Beltran
Jefe de Sistemas

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Flujo para el equipo de desarrollo

Manejo inicial de Issues:

1. Cada desarrollador decide resolver un issue de gitlab, salvo haya una prioridad establecida de cada
issue la resolucin del problema queda a consideracin de cada desarrollador.
2. Una vez tomada un issue, se auto asigna dicha issue , y se agrega la etiqueta En Solucin
3. Se Abre la respectiva Rama en el repositorio (desde gitlab o localmente en sus ramas)
no olvidar pullear todo el repo y hacer checkout a las ramas del issue a solucionar si se hace desde
gitlab la creacin de la rama
4. Una vez solucionado un issue, se pushea localmente a la rama del issue, se retira la etiqueta En
Solucin y se agrega Para Revisin

Convergencia de soluciones:

1. Las issues que estn En Revisin son probadas en ambientes aislados para esa rama en un entorno
local, las issues en revisin deben contener los pasos que se requiere para que una issue pueda ser
revisada.
2. Una vez aprobada la revisin se ejecuta el merge request, y la eliminacin de la rama creada para
ese issue, as como el cerrado del issue
3. Aca pasa a una segunda revisin que es la revisin de integracin con la rama master, en este punto
se puede re-abrir el issue si sucede algo o agregar comentarios si a la solucin le falt detalle.

Incidencias con los Issues

1. Un issue puede ser reabierto bajo estas condiciones:

a. Si hay un error que no amerita tener su propio espacio (detalle/complejidad)

b. Si el incidente causado puede convivir en master sin problemas y no tiene dependencia del
issue
c. El error es demasiado reciente.
d. EL error solo sucede en la integracin con master.
2. Un issue puede tener relaciones con otro y con comentarios directamente al cdigo, llamados
REFERENCIAS

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Mejoramiento del flujo de los issues:

Todo issue no bien entendido es un riesgo para el sistema y el flujo, si algo no queda claro,
consultarlo via slack o comentario y retroalimentarlo para que quede histrico, quedarse en silencio
nunca es una buena decisin
Usen el sistema de comentarios/slack para detallar , solicitar y registrar lo que necesiten

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Entornos
Por regla general poseemos 3 entornos: local , dev y produccin.
El alcance de los desarrolladores llega hasta dev.

Local
Entornos de las computadoras de los desarrolladores, basicamente es un clon del repo, configuracin del
archivo /etc/host apuntando a los siguientes alias :
127.0.0.1 mongo redis tasks panel logcat

Dev
Entorno de integracin, cuando el entorno local no es suficiente o simplemente quieren integrar con lo
existente a nivel de Filesystem.
El Entorno dev solo estara disponible mediante conexion ssh y llaves ssh hacia
geosatelital@devpanel.geosatelital.com por el puerto 22
Es Responsabilidad EXCLUSIVA de cada uno tener sumo cuidado con esta maquina.

Produccin
Maquinas remotas distribuidas segn como se vaya solucionando.

Arquitectura:

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Lenguaje comn - Terminologa

Para hacer mas facil la comunicacion, disponemos de trminos internos que procedemos a explicar

Trmino Descripcin/Significado

Logcat servicio que reciben las coordenadas GPS y las

formatea segn el tipo de GPS

Panel servicio que almacena las coordenadas en la DB y

es acceso frontal al usuario final

SMS-Server Servicio que recibe los SMS a enviar

SUTRAN Servidor que se encarga de enviar informacin al

MTC

PROC Proceso, servidor de proceso, Procesador(servicio)

RU Ruby , directorio de ruby en los repos

BEAN Archivo que se encarga de procesar info desde el

beanstalkd

BIN Archivo que se puede ejecutar por consola o CRON,

LIB Libreria , funciones compartidas, para los BIN, BEAN

y Services

Service Servicio HTTP- API

PY Python, directorio python en los repos

TASK Server Servidor de trabajos, tanto para Beanstalkd como

para los CRON

Nominatim Servidor de informacin geo-reversada

(geo-reverse server) convierte coordenadas en
direcciones

Trama Informacin de los GPS, coordenadas, velocidad,

etc

Av. Tomas Valle N 2196 San Martn de Porres - Lima

 MONITOREO Y CONTROL VEHCULAR
www.geosatelital.com

Recomendaciones

A modo de buenas prcticas, lo primero que se solicita al personal es tener en mente lo delicado que es
nuestro trabajo, es decir tomar conciencia sobre lo que hacemos, hay gente que confa en nosotros y
nuestras plataforma, esto se traduce bsicamente en nuestro cdigo.
Y no es excesivo el comentar que inclusive vidas depende de lo que hacemos y sus resultados

El segundo punto es lo que llam, mejora continua (Trata de dejar a este mundo en mejores condiciones de
como lo encontraste) , si existe la posibilidad de hacer algo mejor, siempre hay que tenerlo presente, esto
alimentara de buen resultado al sistema y a nuestro ser.

Tercero, no vivir con ventanas rotas , a diferencia de mejora continua, esto trata ms de no vivir con errores,
si existe algo que definitivamente est mal, arreglarlo, preguntar como hacerlo, asignarlo o registrarlo, todos
estamos en el mismo barco, el fallo de uno es el fallo de todos y nadie es perfecto.

Cuarto, Compaerismo, se reduce al trato con el resto, confiar en el equipo, confiar en lo que el equipo hace
, ayudar a los que nos piden ayuda, confiar en quienes lo usan , confiar en las personas que se esfuerzan para
que sigan usando nuestro servicio..

Personalmente creo que esos cuatro puntos definen un buen resultado al final por lo tanto recomiendo
tratar de conllevar esto tanto aqu como en cualquier lugar que se encuentren.

Av. Tomas Valle N 2196 San Martn de Porres - Lima