= Timbre =

El timbre es una aplicación para timbrar
Se originó como conejillo de indias para explorar tecnologías desconocidas hasta ahora en Sofhouse, en particular

- https://developers.google.com/protocol-buffers/ Protocol Buffers
- http://www.grpc.io GRPC
- https://golang.org Golang
- https://www.android.com Android 

En el momento e escribir este documento, las rama de desarrollo de de los repositorios timbre-porto y timbre-android  y timbre-go es la rama `publico` ie, `git checkout publico`

== Intenciones de Arquitectura ==

La intención de arquitectura de este proyecto es utilizar la herramienta más adecuada para el desarrollo en cada plataforma.
En efecto no busca ser un desarrollo cross-platform, sino una infraestructura para facilitar el desarrollo en múltiples plataformas, cada desarrollo acudiendo a las mejores herramientas, las más adecuadas para ese entorno.

Para mensajes asíncronos entre servidor y cliente se utiliza Firebase Cloud Messaging, enviando ProtoBuffers. la especificación de cuándo se manda qué, no existe, pero todo lo que se manda es un Protobuf definido en timbre-proto.
Si se pregunta esto dónde lo leo, diríjase a `timbre-go/utils/fcm.go` y luego a `timbre-android/.../messaging/FCMService.java`

== Timbre Proto ==

En el repositorio `bitbucket.com/sofhouse/timbre-proto` se encuentran las definiciones de los protocolos de comunicación.
adicionalmente existen scripts para generar código para java, golang, objetive-c y hay trabajo en curso para generar código en typescript con grpc-web, https://github.com/improbable-eng/grpc-web

Este repositorio sirve como la especificación sobre la cual se basarán todas las aplicaciones del sistema. 

== Timbre Android == 

El proyecto de bitbucket.org/android  utiliza las librerías en Java para Android, y androide studio como IDE

{{{
git checkout publico
git submodule init
pushd timbre-proto 
git pull timbre-proto
git checkout publico
popd
}}}

El sistema Gradle https://gradle.org se encarga de instalar dependencias y compilar la especificación en protocol buffers para usar los endpoints desde la aplicación.

El Keystore para la publicación se encuentra en el iMac de David. 

`/Users/jborda/Dev/timbre/net.sofhouse.timbre.jks`

{{{
ambas claves : Timbre2017
kekey alias: timbre-publico-25
}}}

Esta información le será util cuando esté generando APKs firmados para subir una nueva verisón a la playstore.

=== Despliegue ===

Consulte google para los pasos necesarios para genera apks firmados y subir versiones nuevas a la playstore. Esto es estándar para Android Studio.

== Timbre Go ==

Es un servidor que implementa los servicios GRPC definidos en timbre-proto.
Si no sabe en qué entorno trabajar este código, bien pueda instale VSStudio Code con las herramientas para GO. funcionan bastante bien.

El servidor utiliza gorm https://github.com/jinzhu/gorm para definición de modelos.

Aún no hay una propuesta de esquema para manejo de migraciones que alteren los modelos existentes destructivamente. El comando `go run main.go migrate` únicamente migra aditivamente, no destrye ni altera columnas, tablas o incides. 

El código está bastante probado unit-testeado (mostly happy executions).
Utiliza sqlite3 y/o postges según la configuración. 

El readme del proyecto explica lo necesario para ponerlo a andar, probar, compilar.

A diferencia del proyecto Android, cambios a la especificación de timbre-proto no producen una generación de código al hacer build.
Es necesario que en el momento de cambiar los protos, se ejecute en ese repositorio `compile-go.sh` para generar el código en go, y luego si darle commit.

La configuración de llaves para envío de mensajes FCM asíncronos a la aplicación está quemada en el módulo encargado y sería adecuado sacarlo al archivo de configuración.

=== Despliegue ===

Existe un despliegue en tiendas playstore en la cuenta de sofhouse24
Esas apliaciones le pegan al servicio alojado en las oficinas de sofhouse  con el subdominio timbre.sohfouse.net