En este post escribiré los detalles del código fuente para mi sistema gratuito para restaurantes. Te enseñaré a compilarlo y te enseñaré algunos de sus detalles para tenerlo en tu plataforma favorita.

El programa está hecho con Vue, Buefy, Golang, SQLite3. Utiliza JWT para la autentificación, Gorilla para crear la API REST y NSIS para el instalador.

Recuerda que, como está hecho con Go, C y Node, puede compilar en cualquier plataforma que soporte Go y C. Así que puedes compilar en Linux, Android, Mac, Windows, Raspberry Pi, servidores de internet y cualquier otra que soporte estos lenguajes.

Instalando herramientas

Vas a necesitar Node, Golang y C. Puedes usar cualquier editor. Yo utilizo VSCode pero incluso con Vim funciona (yo he programado con él en Termux). Aquí te dejo unos tutoriales:

Instala NPM: https://parzibyte.me/blog/2018/09/27/instalar-npm-node-js-windows/

Instala Go: https://parzibyte.me/blog/2017/12/07/instalar-configurar-go-golang-en-windows-10/

Instala el compilador de C: https://parzibyte.me/blog/2021/08/23/instalar-gcc-msys2-compilador-c-cpp/

Debes agregar cada carpeta contenedora del ejecutable a la PATH. Algunos lo hacen automáticamente y en los que no, yo indico cómo hacerlo en el post.

Para comprobar que has hecho todo correctamente abre un símbolo del sistema y ejecuta los comandos que se ven a continuación (node -v, gcc -v y go version). Debe aparecer una salida parecida a lo siguiente:

Si aparece que no se reconoce como un comando externo o interno, por favor revisa que lo hayas instalado correctamente y agregado a la PATH. No continúes si estas herramientas no funcionan.

Para el caso de Linux, Raspberry y Android solo busca las equivalencias para instalar el sistema. Igualmente escribiré tutoriales para ello en el futuro.

Contenido del código fuente (estructura)

Cuando descargues el código fuente tendrás una carpeta con el siguiente contenido:

Básicamente se divide en 3 cosas: el lado del cliente, servidor y scripts que empaquetan o crean el instalador.

El lado del cliente es todo lo que está en la carpeta principal (excluyendo los generadores de instaladores o similares) y el lado del servidor está en la carpeta api.

Ejecutando en modo de desarrollo

Nota: si usas Windows, no uses PowerShell; utiliza CMD.

Cuando se hacen pruebas y modificaciones se necesita ejecutar en modo desarrollo. Debemos compilar el lado del cliente y del servidor pero en modo desarrollo.

Lado del cliente

Comenzamos instalando las dependencias del lado del cliente con npm install. Esto solo se debe hacer una vez, y nos servirá para modo desarrollo y producción. Recuerda que estamos del lado del cliente.

Lo siguiente es iniciar el servidor de desarrollo (se detiene con CTRL + C). Para ello se ejecuta npm run serve:

Ya puedes visitar la ruta que se indica en la terminal. Te va a dar errores porque la API no está en funcionamiento, pero volveremos ahí más tarde.

Lado del servidor

Abre otra terminal y navega a api.

Primero ejecuta go mod tidy para que se descarguen las dependencias. Esto solo se debe hacer una vez, ya sea en modo producción o desarrollo.

Luego compila con: go build -tags desarrollo y espera a que se compile. Asegúrate de que compiló correctamente, si marca errores, corrígelos).

Ahora ejecuta sistema_restaurante.exe (o su equivalente si estás en otra plataforma).

Se debe ver así al menos en Windows:

Fíjate en que el firewall pide permisos; debes dárselos. También revisa la terminal, el programa en Golang fue ejecutado y ha avisado que el primer usuario fue creado además de explicar que ya está escuchando en localhost:5000.

Revisando compilación

Ahora sí abre o refresca la ruta que te dio el comando npm run serve y ya deberías poder iniciar sesión. Si quieres puedes abrir la consola de depuración, ver los detalles de la red y confirmar que la petición se ha hecho a donde el servidor está escuchando.

Ya puedes modificar el código a tu antojo. En el lado del cliente los cambios se aplicarán inmediatamente tan pronto guardes.

En el lado del servidor debes detener el servidor, volver a compilar y volver a ejecutar (si quieres puedes usar el makefile ejecutando make prod pero eso queda fuera de este tutorial).

Compilando para producción

Una vez que hayas terminado de hacer cambios en el sistema ya puedes compilar para producción. En ese modo los archivos del cliente se optimizan. Para ello detén la API y el cliente.

Luego ejecuta npm run build en el cliente, espera a que acabe de compilar y tendrás la webapp en la carpeta dist. No la pierdas de vista.

Sumas de verificación

Para evitar la modificación de los archivos en el lado del cliente, el servidor verifica las sumas de verificación. Esas sumas de verificación están en checksum_archivos.go en un mapa que se ve así:

Una vez que has generado la carpeta dist, debes calcular el SHA 256 de cada archivo y colocarlos en el mapa. Si tú no quieres hacer esta verificación entonces deja ubicacionesConHash vacío o deshabilita la verificación en la línea 39 hasta la 41 dentro de main.go (si hay un problema con las sumas de verificación, el error estará en el log o en la terminal).

Ve al lado del servidor en la carpeta api y ejecuta go build -tags produccion -o restaurante_prod.exe. Espera a que compile y no pierdas de vista a restaurante_prod.exe.

Distribuyendo

Ahora solo resta distribuir la carpeta dist junto con restaurante_prod.exe. Ambos deben estar en el mismo lugar.

Nota: si usas Windows puedes hacer que el ejecutable no tenga ventana, para ello agrega las banderas -ldflags "-H windowsgui" por ejemplo go build -o restaurante_prod.exe -tags produccion -ldflags "-H windowsgui"

Scripts de compilación

Junto al código vas a recibir crear_instalador.py y empaquetar.py. Debes invocarlos pasándole la arquitectura, por ejemplo:

python crear_instalador.py 64

Por el momento solo funcionan en Windows; recuerda que debes tener makensis en la PATH para crear el instalador. Por otro lado, empaquetar recibe igualmente la arquitectura y crea un zip del sistema, pero tú debes cambiar la PATH en caso de que quieras compilar para 32 bits.

Por ello es que estos scripts son un bonus en el código, ya que no te garantizo su funcionamiento pero si los sabes configurar podrás crear el instalador y/o empaquetar la app. Yo los uso y funcionan bien, pero no te los puedo garantizar, por eso son un simple extra.

Compilando en otras arquitecturas

Como lo dije al inicio, este código del sistema para restaurantes compila en donde sea que compile Go y C. La carpeta dist puede ser generada en otra arquitectura; lo que importa es el código del servidor.

Se necesita el compilador de C porque SQLite3 debe compilar la librería, y el compilador de Go porque todo el servidor está escrito en ese lenguaje.

Yo he compilado en Ubuntu, Android, Raspbian y Windows. También puedes hacerlo en internet. Ya solo recuerda que por ejemplo si no usas Windows no debes especificar -H windowsgui y el nombre de salida no necesita tener la extensión .exe.

Solución de errores

Si ocurre un error en la API, el mismo estará en la respuesta HTTP. Puedes revisar lo que devuelve la API, revisar el log (que tiene el formato de año-mes.log) y la terminal donde ejecutas el cliente y/o el servidor. Ahí aparecerán todos los errores, solo es cuestión de que los corrijas en caso de que existan.

Obviamente yo he probado y compila bien. Estos errores pueden aparecer cuando tú hagas modificaciones.

Descarga del código fuente

El programa compilado es totalmente gratuito y no tiene límites para nadie, en ninguna plataforma. Sin embargo, el código fuente no está disponible de manera gratuita.

Para descargar el código fuente el costo es de 3000 pesos mexicanos (MXN). En caso de que te interese, primero considera que:

1. Yo te envío el código fuente tal y como está. He probado que funciona.
2. Al obtener el código fuente no obtienes soporte. Solo obtienes esta guía y los posibles vídeos que publique en este post. Puedo darte ayuda si quieres, pero sería por un costo extra.
3. Si cuentas con el código fuente, el mismo no recibirá actualizaciones. Tendrás la versión que existía en la fecha que me contactaste.

En caso de estar de acuerdo con lo mencionado arriba procede al pago como se indica en:

https://parzibyte.me/blog/pagos-venta-software/

No olvides escribir tu correo en el concepto como se indica en la página previamente enlazada. Yo te contactaré en un plazo de 36 horas una vez recibido el pago.