Vengo hoy aquí, después de mucho tiempo, a dejar anotado el error y la solución (al menos la que he encontrado) para un problema de redondeo de números enteros y decimales que ocurre en PHP.

El problema es de esos que te vuelven un poco loco, de esos que ocurren unas veces sí y otras no. Antes de nada, decir que ya me ocurrió con la versión 7.4 de PHP y ahora me ha ocurrido con la versión 8.2.

El error me ha ocurrido en una aplicación al realizar una operación sencilla: 1.13 *100. El resultado que debiéramos obtener es bastante obvio: 113. Pues no, en PHP los números que tienen una representación finita en base 10 pueden no tener una representación exacta en representación decimal por lo que en este caso el resultado es un “pelín” distinto.

Efectivamente, el resultado no se representa correctamente ya que nos da un 112.99999999999998579. ¿Qué problema puede ocasionarnos esto? pues que si aplicamos un casting a enteros con (int) el resultado obtenido tenemos:

Es decir, donde deberíamos tener un 113 ahora tenemos un 112. Fail total y absoluto.

Solución: Pues después de buscar por internet (he perdido la página donde encontré realmente la solución) resulta que podemos hacer uso de la función bcmul de forma que si lo aplicamos en este ejemplo de la siguiente forma:

Tenemos el resultado correcto:

Otro ejemplo con el que obtenemos un error es con la operación: (3*5)+21%. El resultado correcto de la operación es 18,15 pero si no aplicamos bcmul PHP nos retorna 18,14, más concretamente 18.14999999999999858. Si aplicamos bcmul de forma correcta como he indicado más arriba obtenemos los 18,15 finales que deben ser.

Así que, aunque solo sea para mi mismo, dejo anotado el error y la solución en este artículo porque seguramente en un futuro vuelva por aquí a consultarlo.

Eso es todo, cualquier comentario, sugerencia o corrección es bienvenida.

¡Chimpún!

La consecuencia principal de la impaciencia generada por esa velocidad de nuestras vidas hace que, en general, no tengamos en cuenta los detalles ni el contexto de la realidad y suelen ser estos detalles, casi siempre, los que contienen lo más importante y la esencia de todo lo que nos rodea. Recuerda que, la paciencia te lleva a la esencia de las cosas y esa esencia te lleva a la verdad.

Paciencia pensando problemas y soluciones

El consejo del carpintero: “Mide dos veces, corta una”. Se paciente a la hora de seleccionar una solución para un problema y que las prisas no te lleven a dar por buena la primera que venga a tu cabeza. Hay excepciones, por supuesto, problemas sencillos o problemas para los que experiencias similares ya te han dotado de una capacidad suficiente para tomar decisiones de una forma más acelerada. Pero, en general, resolver un problema medianamente complejo te llevará un tiempo hasta que logres entenderlo lo suficientemente bien como para extraer el contexto necesario que te lleve a la mejor solución. Habrás de comprender el problema desde el punto de vista del cliente o del negocio, sus necesidades y sus objetivos y también, por supuesto, desde el punto de vista tecnológico para saber como implementar la mejor solución posible.

Piénsalo bien, ¿cuántas veces te ha ocurrido que la primera solución que aplicaste a un problema luego resultó no ser tan buena? ¿cuántas veces elegimos mal la tecnología, el framework o el algoritmo?…y lo que es peor, ¿cuál es el coste económico y de recursos de esa mala decisión por no haber tenido la paciencia suficiente para estudiar el par problema-solución de la forma necesaria?

Supongo que la presión diaria de entregar el trabajo pendiente, ‘deadlines’ y compromisos difíciles de asumir hacen que tener la paciencia y serenidad necesarias para comprender problemas y crear soluciones sea complicado. Pero en la medida de lo posible, no debemos permitir que esa presión nos genere una impaciencia contraproducente para nuestros objetivos y los del proyecto.

Paciencia en el entorno laboral

La paciencia en el entorno laboral es un valor personal clave para crear un ambiente de trabajo positivo y productivo. Las relaciones diarias entre personas suelen generar desavenencias que únicamente con las dosis adecuadas de paciencia y empatía se pueden superar sin menoscabar las relaciones personales del grupo.

El impaciente suele trazar planes en su cabeza sobre como deberían desarrollarse los acontecimientos a su alrededor y cuando estos no se cumplen sus expectativas se frustran y comienza a repartir culpas y responsabilidades generando entre los compañeros, en muchas ocasiones, presiones innecesarias debidas únicamente a su impaciencia y la mala gestión de las emociones que conllevan, especialmente la ira. Además, el impaciente suele simplificar los problemas para intentar llegar cuanto antes a la meta pero, en general, esa simplificación es errónea ya que precisamente no ha sabido o no ha querido dedicar el tiempo suficiente para definir el mejor modo de llegar a la solución. El impaciente se frustra y puede llegar a generar un ambiente de trabajo tóxico exigiendo tiempos y trabajos alejados de la realidad.

Por el contrario, ser pacientes ayudará a saber diferenciar lo evitable de lo inevitable y nos hará más fácil vislumbrar los problemas importantes de los no importantes. Ser pacientes, además, mejorará la comunicación con otras personas permitiendo relaciones personales más agradables. Ser pacientes no implica aceptar todo y tener capacidad de sufrimiento infinitas, ser pacientes implica tener pensamientos más racionales con el fin de conocer lo que debe ser aceptado y lo que no y, además, para saber dónde puedes poner un límite dentro de las relaciones personales. Ser pacientes no trata de ser pasivos, trata de saber cuál es el mejor momento para actuar, de forma responsable evitando que las situaciones nos puedan llegar a generar ansiedad.

Aprender requiere ser paciente

La formación y el proceso del aprendizaje es otro punto en el que la paciencia es un valor clave para poder avanzar y afianzar conocimientos que nos aporten una buena base teórica que llevar a la práctica. Ser capaz de centrarnos y permanecer el tiempo necesario en un curso, un libro, un podcast, un simple ejercicio práctico…etc., para interiorizarlo de tal forma que seamos capaces de aplicarlo en problemas/soluciones de la ‘vida real’.

El camino de la formación para alguien que se dedique al desarrollo del software puede ser cansado y estresante si no se mantiene la calma necesaria para diferenciar lo básico y lo importante de lo efímero y la moda tecnológica del momento. Si nos dejamos llevar, si no somos pacientes, iremos pasando de puntillas por materias y conocimientos sin afianzar y sin profundizar en cada uno de ellos, lo cual hará que no podamos asimilarlos para poder aplicarlos en un futuro. Solo leer no te hace aprender. Para aprender hay que dedicar tiempo suficiente y dedicar tiempo suficiente a cualquier tema implica de forma explícita ser paciente.

Paciencia con los que están aprendiendo

Si debemos ser pacientes con nosotros mismos cuando se trata de aprender, habrá que poner especial cuidado y atención cuando sean terceras personas las que están aprendiendo, más aún cuando su aprendizaje dependa directamente de nosotros. Habrá que ser pacientes para facilitar el tiempo y las explicaciones necesarias de forma que interioricen los conocimientos de forma sólida y persistente. Esto, no solo será bueno para ellos sino que con toda seguridad estaremos ‘sembrando’ en esas personas la semilla de la paciencia para que en el futuro sean ellos los pacientes cuando tengan que enseñar a la siguiente generación.

Por el contrario, ser impacientes con alguien que está aprendiendo solo le provocará ansiedad, tensión y frustración lo que a la larga es más que probable que le genere un rechazo hacia las materias o conocimientos que necesita aprender.

La paciencia que debemos mostrar debe partir de la humildad de reconocer que hubo un tiempo pasado en el que fuimos nosotros los que no teníamos el conocimiento necesario para realizar una tarea de la mejor forma posible. Reconocer nuestras propias limitaciones y debilidades nos hará ser más pacientes con las limitaciones y debilidades de los demás.

Muchas gracias por tener la paciencia de leer hasta el final :)

¡Chimpún!

En el código tenía configurado el idioma de la siguiente manera pero esto por sí solo no llegaba a funcionar.

setlocale(LC_ALL, 'es_ES');

Así que lo que hice fue lo siguiente:

Configurar idiomas del sistema

En primer lugar configuraremos los idiomas disponibles en el sistema y el idioma por defecto del mismo. Esto lo haremos mediante el comando dpkg-reconfigure locales. Al ejecutarlo, aparece una aplicación que te guía paso a paso por la configuración.

• En primer lugar seleccionas los idiomas que quieres instalar

• En segundo lugar seleccionas el idioma que quieres por defecto en el entorno del sistema.

Una vez terminada la selección, la información que aparece por consola nos va indicando el proceso de generación de los idiomas.

root@vmixxxxx:~# dpkg-reconfigure locales
Generating locales (this might take a while)...
  en_AG.UTF-8... done
  en_AU.UTF-8... done
  en_BW.UTF-8... done
  en_CA.UTF-8... done
  en_DK.UTF-8... done
  en_GB.UTF-8... done
  en_HK.UTF-8... done
  en_IE.UTF-8... done
  en_IL.UTF-8... done
  en_IN.UTF-8... done
  en_NG.UTF-8... done
  en_NZ.UTF-8... done
  en_PH.UTF-8... done
  en_SG.UTF-8... done
  en_US.UTF-8... done
  en_ZA.UTF-8... done
  en_ZM.UTF-8... done
  en_ZW.UTF-8... done
  es_ES.UTF-8... done
Generation complete.

Reiniciar Apache

En mi caso tuve que reiniciar Apache para que los cambios tuvieran efecto sobre PHP.

~#sudo service apache2 restart

Configurar aplicación PHP

Después de hacer varias pruebas, conseguí que los meses y los días de la semana aparecieran en español añadiendo al principio del código lo siguiente:

setlocale(LC_ALL, 'es_ES.UTF-8');

Estoy seguro que debe haber alguna configuración u opción global de hacer que funcione en todo el sistema y en todos los proyectos PHP instalados en el servidor pero, la verdad, ahora mismo no tengo tiempo de mirarlo 😐

Si sabes como hacerlo, por favor, deja un comentario indicando el proceso y lo añado al artículo. Muchas gracias por adelantado :)

Eso es todo, cualquier comentario, sugerencia o corrección es bienvenida.

¡Chimpún!

Antes de comenzar, unas aclaraciones.

• 1) Cuando hablo del API de Telegram no me estoy refiriendo a la creación de Bot’s, sino al uso del API ‘real’ que ofrece y que te da la oportunidad de crear tu propio cliente de mensajería.
• 2) El objetivo de este artículo es intentar ofrecer al menos un punto de partida inicial para saber más o menos cómo empezar a usar el API de Telegram con PHP. Lo que se suele conocer como ‘saber por dónde van los tiros’…o el post que a mi me hubiera gustado leer cuando empecé.
• 3) Por lo tanto…‘disclaimer’: lo que vas a leer a continuación es parte de mi experiencia con este API. Aún hay partes (muchas) que desconozco y a día de hoy todavía sigo aprendiendo y pegándome (mucho…muchísimo) con él para seguir integrando parte de la aplicación PHP.

¿Para qué usar el API de Telegram? Problema a resolver

Contexto inicial

Uno de los clientes para los que trabajo desde hace años como profesional autónomo es una academia de formación que prepara oposiciones, principalmente de Educación. Actualmente, estudian en ella algo más de 600 alumnos divididos en 65 grupos. Por un lado, antes de la integración con Telegram, la forma natural de comunicarse con los alumnos y los grupos era vía Whatsapp. Por otro lado, llevo desarrollándoles desde hace más de cinco años una aplicación PHP (Laravel) con la que prácticamente gestionan todo el negocio: alumnos, grupos, profesores, clases, exámenes, documentación, facturación, contabilidad, mensajería interna, calendarios…etc, etc.

Problema

La tarea de comunicación a través de Whatsapp era totalmente manual y resultaba muy tediosa, complicada y daba lugar a muchos errores. Imaginad tener que crear y/o gestionar casi de forma manual cientos y cientos de contactos, crear los grupos, meter a cada contacto en cada grupo…y luego, conforme pasa el curso, eliminar a los que se dan de baja, gestionar los cambios de grupo, nuevas altas, envíos de mensajes a los alumnos casi personalizados…etc., y esto, además, con cada nuevo curso académico. En definitiva, se dedicaba muchísimo tiempo en la gestión de las comunicaciones con sus alumnos tanto que, podríamos decir, había una persona dedicada casi en exclusiva a esta tarea.

Misión

La misión era simple, que no sencilla. Se trataba de poder gestionar y automatizar toda la comunicación con los grupos y alumnos de forma directa y transparente desde la aplicación PHP a través de una aplicación móvil de mensajería (la que fuera). Dicha automatización debería incluir, por ejemplo:

• Grupo nuevo en PHP -> canal de difusión privado nuevo en app mensajería.
• Alumno nuevo en PHP -> contacto nuevo en app mensajería.
• Alumno entra en un grupo -> contacto entra al canal privado del grupo.
• Alumno sale de un grupo -> contacto sale del canal privado del grupo.
• Alumno cambia de grupo -> contacto sale del canal privado del primer grupo y entra al segundo.
• …etc, etc.

En resumen, toda la gestión de contactos y de grupos/canales, envío de mensajes de texto, envío de mensajes con archivos adjuntos, lectura de los mismos, notificaciones…etc., todo, se debería poder hacer desde la aplicación PHP.

Búsqueda de soluciones

Whatsapp

Al ser Whatsapp la aplicación de mensajería que se estaba utilizando en la academia fue la primera que valoramos. A ver, es cierto que Whatsapp tiene un API para desarrolladores pero no es abierto. Tienes que solicitar permiso para usarlo (lo hicimos en su día) y ni nos contestaron. Whatsapp tiene sus partners y son empresas muy potentes y son con ellos con los que tienes que ‘negociar’ y ni si quiera en el caso de llegar a un acuerdo te dan acceso completo al API. Whatsapp, de forma sencilla pero totalmente insuficiente para nuestro objetivo permite el envío de mensajes de texto simples.

Otras aplicaciones de mensajería

Valoramos las posibilidades de usar otras aplicaciones como Line pero las descartamos también por el bajo uso de esta aplicación en nuestro país y por el API que proporcionaban que, honestamente, por algún motivo que no recuerdo descartamos en su momento.

Aplicación propia

Contactamos con un desarrollador que tenía experiencia en este tipo de aplicaciones de mensajería con academias de formación. Nos comentó que por un lado tenían cierto grado de complejidad y, además, su experiencia fue ‘mala’ porque los alumnos no se instalaban estas aplicaciones, no les generaban mucha confianza, deshabilitaban notificaciones…etc. Así que la descartamos

Telegram

Telegram, no sólo cumple con todas nuestras necesidades de comunicación, sino que además tiene muchísimas más posibilidades de integración gracias a su API totalmente abierta. Tal es así que, si quisieras, podrías programarte tu propio cliente de mensajería completo usando su infraestructura. Una maravilla, la verdad. Además, su uso está relativamente extendido, es conocida y el funcionamiento básico es similar a Whatsapp.

Como comenté, no se trata de usar los Bots de Telegram ya que estos ofrecen una funcionalidad útil, aunque limitada, para unos casos que no resolvían nuestros problemas. Usar el API directamente es bastante más avanzado, potente…y complicado, la verdad. Ya aviso, e insisto, al menos para mi, ha sido y está complicado integrar dicho API con la aplicación PHP y sobre todo entender (a nivel de programación) como funciona Telegram y el flujo que usa en sus operaciones.

Primeros pasos

Crear aplicación en Telegram

Lo primero de todo, claro está, es tener una cuenta de Telegram y para ello nos descargaremos la aplicación en un teléfono.

Después iniciaremos sesión como desarrolladores a través del siguiente enlace https://my.telegram.org/auth. El acceso será mediante un número de teléfono con Telegram al que llegará un código de inicio de sesión.

Después haremos click en el enlace API development tools y crearemos nuestra aplicación. Los datos que tendremos de la misma serán el ‘api_id’, el ‘api_hash’, ‘title’ y ‘short name’.

Instalar MadelineProto

Para integrarnos con el API de Telegram necesitamos implementar su protocolo de comunicación segura llamado MTProto. Por fortuna, salvo que queramos hacerlo y probablemente morir en el intento, no tenemos que implementar dicho protocolo desde cero en nuestra aplicación ya que hay una librería para PHP que ya lo hace. Esta librería se llama MadelineProto y es básicamente otro API que hace transparente (o casi) la comunicación de nuestra aplicación PHP con Telegram. Una maravilla, la verdad. Tiene una documentación bastante buena, el proyecto está actualizado e incluso tienen un canal en Telegram en el que se resuelven muchas dudas.

Antes de instalarlo, echa un vistazo a sus requerimientos. Una vez cumplidos, para instalar MadelineProto en nuestro proyecto PHP con composer basta ejecutar el siguiente comando:

composer require danog/madelineproto

Recomiendo encarecidamente la lectura de su documentación para conocer como utilizarla porque tampoco es que sea sencilla. A partir de aquí voy a suponer que le has echado un vistazo y que sabes más o menos como funciona o al menos te suena.

Nota

En mi caso tengo integrado MadelineProto en un proyecto con Laravel, lo digo por todo el código que sigue a continuación en el artículo. Habrá cosas específicas de Laravel pero bueno, en el fondo, esto sería lo de menos.

Iniciar sesión en Telegram con PHP y MadelineProto

Una vez instalado MadelineProto, supongamos que tenemos nuestra aplicación PHP y una ruta hacia un código similar al siguiente con el cual podremos iniciar sesión en Telegram.

Al ejecutar el código nos saldrá un ‘wizard’ que nos guiará paso a paso en el proceso. Debería ser algo similar a lo que sigue:

• Paso 1: En primer lugar deberemos indicar api_id y el api_hash que obtuvimos al crear la aplicación. Podemos hacerlo de forma manual o automática. Si elegimos ‘Automatically’, únicamente tendremos que poner el número de teléfono con el que creamos la aplicación…así que esta será nuestra opción:

• Paso 2: Indicamos el número de teléfono con el que creamos la aplicación.

• Paso 3: Nos llegará un mensaje de aviso a nuestro Telegram con un código de inicio de sesión

• Paso 4: Introduciremos el código recibido.

• Paso 5: A continuación nos preguntará si queremos iniciar sesión como ‘user’ o como ‘bot’. En nuestro caso, como ‘User’.

• Paso 6: Volvemos a introducir el número de teléfono.

• Paso 7: Y recibiremos ahora otro mensaje con el código de inicio de sesión.

• Paso 8: A continuación indicamos el código recibido

• Paso 9: …y si todo ha ido bien, veremos que en la carpeta de nuestro proyecto tenemos creados los archivos de sesión de MadelineProto.

Primera solicitud al API de Telegram con PHP

La primera petición que podemos hacer, por ejemplo, para probar el correcto de la conexión con Telegram es solicitar nuestros datos. Para este cometido vamos a utilizar la funcion getSelf(). El código es el siguiente:

Este va a ser el formato general de uso del API de Telegram. Instanciar MadelineProto, configurar la petición y procesar la respuesta.

MadelineProto puede configurarse de forma que las peticiones se realicen de forma asíncrona lo cual mejora el rendimiento y el procesamiento de peticiones en paralelo. Al instanciar MadelineProto podemos pasar un array de configuración. Existen decenas de configuraciones distintas para que cada uno use el API de la forma que más le convenga. Los distintos valores de configuración están descritos en esta página. Probablemente te habrá llamado la atención el uso de la palabra reservada yield, te recomiendo leer la documentación oficial sobre generadores en PHP.

La respuesta que nos retorna esta llamada es la siguiente:

Como podemos observar, contiene toda la información referente a mi perfil. La inmensa mayoría de respuestas de peticiones al API son en formato json y contienen gran cantidad de información.

Otras llamadas al API de Telegram desde PHP

A continuación, indicaré de forma resumida algunos ejemplos de otros tipos de peticiones que he conseguido realizar para implementar una gestión más completa de la comunicación con Telegram. Teniendo en cuenta el código anterior los ejemplos irían dentro de la llamada al método loop:

return $this->madelineProto->loop(function () { 
     ...
     ejemplos de código
     ...
});

Crear un canal

Crear un canal en Telegram es sencillo. Basta con indicar un título y la descripción del mismo al utilizar el método createChannel. También podríamos especificar otra configuración como crear un supergrupo, la geolocalización…etc.

$response = yield $this->madelineProto->channels->createChannel([
    'title' => 'título del canal',
    'about' => 'texto con alguna descripción'
]);

En la respuesta, Telegram nos retorna muchos datos, para mi el dato más importante en el channel_id que es el que me guardo para usar más tarde en otras operaciones con el canal creado.

Invitar a participantes a un canal

Usaremos la función inviteToChannel. Aunque la llamada sea sencilla, en función de nuestras necesidades la podemos complicar un poco. La definición de la llamada es como sigue:

$response = yield $this->madelineProto->channels->inviteToChannel( ['channel' => InputChannel, 'users' => [InputUser, InputUser], ]);

Debemos especificar el canal y un array de participantes a incluir. La especificación del canal se puede hacer de múltiples formas tal y como indica la documentación de InputChannel. En nuestro caso la forma más sencilla sería especificarlo de la forma ‘channel#ID’ siendo ID el valor que nos hubiera devuelto, por ejemplo, la llamada a crear un canal en el anterior ejemplo.

De forma similar, los participantes tienen que estar especificados según el tipo InputUser. Aquí nos podríamos encontrar con dos variantes:

• La primera es que fueran contactos conocidos y ya hubiéramos obtenido anteriormente sus ‘userId’ de Telegram en alguna otra operación. En este caso no tendríamos más que especificar un array de usuarios del tipo ‘user#ID’, de la forma:

$inputUsers = ['user#123', 'user#456', 'user#789', ...]

• La segunda es que sean contactos ‘anónimos’, es decir, no los tengamos aún en nuestra ‘agenda’ y desde Telegram no hubiéramos interactuado nunca con ellos. En este caso tendremos que importarlos previamente usando la llamada a importContacts. Para esto, deberíamos hacer algo parecido a lo siguiente:

//supongamos que hemos recibido una petición POST la siguiente información:
$_POST['channel_id'] = 123456;
$_POST['participants = [
 ['phone'=>'6123','first_name'=>'Manu','second_name'=>'Pijierro'
 ['phone'=>'6456','first_name'=>'Leo','second_name'=>'Messi'],
 ['phone'=>'6789','first_name'=>'Cris','second_name'=>'Ronaldo'],
];

//obtenemos nuestro propio ID
$me = yield $this->madelineProto->getSelf();

//configuramos la identificación del canal al que vamos a invitar
$channelKey = 'channel#'.$_POST['channel_id'];

//configuramos el array para la llamada a importContacts
$inputContacts = [];
foreach ($POST['participants] as $participant){
    $inputContacts[] = [
        '_'           => 'inputPhoneContact',
        'client_id'   => $me['id'],
        'phone'       => $participant['phone'],
        'first_name'  => $participant['first_name'],
        'second_name' => $participant['second_name']
    ];
}

//importamos los contactos a nuestra 'agenda'
$contacts = yield $this->madelineProto->contacts->importContacts(['contacts' => $inputContacts]);

//...y con la información recibida, construímos el array con los  userId
$keyUsers = [];
foreach ($contacts['users'] as $contact) {
    $keyUsers[] = 'user#'.$contact['id'];
}

//Finalmente, invitamos a los contactos al canal
return yield $this->madelineProto->channels->inviteToChannel(['channel' => $channelKey, 'users' => $keyUsers]);

Advertencia importante. Con esta operación podríamos invitar a cualquier número de teléfono aunque sea anónimo. Hay que tener en cuenta que los contactos podrían tener configurado su Telegram para no ser invitados de forma anónima a ningún canal o configuraciones de privacidad similares por lo que no podríamos obtener el resultado esperado.

Expulsar a un contacto de un canal

No hay un método de expulsión como tal, si no que lo que hay que hacer es configurar que puede y que no puede hacer un usuario en nuestro canal. Para expulsarlo, haremos uso del método editBanned especificando el ‘channelId’, ‘userId’ y configurando un atributo llamado ‘banned_rights’ con todo a true.

Enviar un mensaje a un contacto

Para enviar un mensaje haremos uso del método sendMessage. Tiene multitud de posibilidades de configuración pero básicamente y simplificando podríamos enviarlo de la siguiente forma:

$response = yield $this->madelineProto->messages->sendMessage([
      'peer'       => $peer,
      'message'    => 'mensaje a enviar',
      'parse_mode' => 'Markdown'
  ]);

Como en casos anteriores, ‘peer’ (el destinatario) es de tipo InputPeer de forma que si tenemos el userId del contacto podremos utilizarlo y si no habría que importarlo. ‘parse_mode’ indicaría si el marcado del texto es HTML o Markdown. En la respuesta de sendMessage vienen decenas de campos con información del mensaje, el emisor y el receptor. Ahí ya utilizaríamos los que sean útiles para nuestra tarea (yo suelo guardar, como mínimo, el message[‘id’] para posteriores operaciones sobre el mismo.

Enviar un mensaje a un canal

De igual forma que en el caso anterior solo que el InputPeer debe hacer referencia a un canal, es decir, si antes era ‘user#123456’ en este caso podría ser un ‘channel#98765’.

Obtener información de todos los contactos

Esta es una operación bastante útil para obtener todos los contactos de tu Telegram. Con getContacts puedes saber que información guardas de cada uno de ellos.

$response =  yield $this->madelineProto->contacts->getContacts();

Obtener información de un contacto

Si lo que quieres es toda la información de un solo contacto hay que llamar a getFullInfo. $inputPeer es del tipo InputPeer y deberás configurarlo con el userId o bien obtener previamente su información de contacto si fuera alguien anónimo para ti, como hemos visto anteriormente.

$responseContact =  yield $this->madelineProto->getFullInfo($inputPeer);

Otras operaciones…

Los ejemplos anteriores creo que ya son suficientes para hacerse una idea de como funciona el API de Telegram y como interactuar con él desde MadelineProto. En mi caso tengo implementada bastante más funcionalidad como enviar mensajes con archivos, mostrar el contenido de los archivos y/o descargarlos, mostrar información completa de los canales, obtener el historial de mensajes de un contacto…en definitiva, cualquier operación que vaya siendo necesaria para que la comunicación sea completa.

Obtener actualizaciones desde Telegram

Todas las operaciones anteriores tiene una única dirección, es decir, son realizadas desde nuestra aplicación PHP con destino a Telegram pero, ¿qué ocurre cuando ocurre algo en Telegram? ¿cómo nos enteramos en nuestra aplicación PHP que alguien nos ha contestado a un mensaje? ¿cómo obtenemos todas las actualizaciones que se han producido?

Ahora mismo estoy desarrollando esta funcionalidad por lo que lamentablemente no tengo muy claro como lo haré finalmente. Cuando la termine escribiré otro artículo para compartir la solución. MadelineProto tiene documentada toda esta ‘movida’ a las que llamada Updates.

Como he comentado anteriormente, aunque he conseguido resolver muchas cuestiones, todavía me encuentro desarrollando muchas partes de la comunicación entre PHP y Telegram. No obstante, si necesitas ayuda y crees que puedo ayudarte de alguna forma en tu proyecto no tienes más que contactar conmigo y a ver si podemos solucionar algo :)

Como siempre, cualquier sugerencia, corrección, comentario…etc., será enormemente agradecido y bienvenido.

¡Chimpún!

Bibliografía

• MadelineProto
• Api de Telegram

Hace varios días he actualizado Zahoribo a la versión 1.2.0., cuyo histórico de novedades puede seguirse a través de esta página.

En esta ocasión dichas novedades vienen de la mano de una actualización del histórico de boletines indexando más años, nueva funcionalidad y algunas correcciones.

Indexadas más de 1.200.000 páginas nuevas

Se han añadido aproximadamente 1.200.000 páginas nuevas correspondientes a los años 2006,2007,2008 y 2009 de los boletines principales del buscador: BOE, BORME, DOE y boletines provinciales de Cáceres y Badajoz. Se puede hacer un seguimiento del contenido indexado a través del calendario de la aplicación.

Problemas en la sala de máquinas

Aunque desde el punto de vista técnico queda pendiente escribir un artículo más amplio sobre como está organizado el buscador, en esta ocasión diré que la actualización de contenidos ha supuesto un nuevo reto porque el índice del servidor en el que se ha realizado la operación había llegado a uno de sus límites. Al intentar indexar el contenido se generaba el siguiente error:

too many string attributes (current index format allows up to 4 GB).

Antes de añadir este 1,2 millones de páginas el índice estaba dividido en 4 partes. Tras el error, he tenido que dividirlo en 5, para que el tamaño de cada índice estuviera por debajo de esos 4 GB. Es una solución temporal hasta que reorganice el servidor y la configuración del motor de búsqueda.

Métricas

En el momento de indexar este contenido, la noche del 26 al 27 de Julio, teníamos los siguientes datos:

• servidor 1: 1.119.507 páginas dividas en dos índices. Dichos índices ocupan un total de 6,2 GB y el tiempo de indexado son aproximadamente 20 minutos. Este servidor tiene 2 cores, 4 GB de memoria RAM y disco SSD.
• servidor 2: 4.593.410 páginas divididas en cinco índices. Dichos índices ocupan un total de 34 GB y el tiempo de indexado son aproximadamente 115 minutos. Este servidor tiene 4 cores, 8 GB de RAM y disco SSD.

La base de datos completa ocupa 17 GB.

Listado de plenos de ayuntamientos

Para tener una visión global del contenido que hay indexado por cada ayuntamiento he añadido en la vista del calendario unos enlaces sobre el nombre de las poblaciones que te llevan a una pantalla con el listado de documentos, plenos…etc., correspondiente a cada consistorio.

Otras mejoras y correcciones

He intentado hacer más simpática la pantalla para cuando la plataforma está en modo mantenimiento quedando de la siguiente manera:

Antes esta página era un texto sin apenas formato y sin personalidad ninguna. Ahora creo que queda mucho mejor.

Además, he solucionado un error relacionado con el contenido que se mostraba al hacer clic en los enlaces de los correos electrónicos enviados en las alertas. Antes se mostraba el contenido correcto de la alerta…y otros resultados correspondientes a otras fechas, lo cual generaba mucho ruido. Ahora únicamente se muestran únicamente los resultados de la alerta quedando mucho más limpio y productivo.

Y hasta aquí las mejoras más importantes de esta versión 1.2.0 de Zahoribo. Cualquier comentario, duda, sugerencia o corrección será bienvenido.

¡Chimpún!

Pero ya basta, este artículo no va de tirar más flores. Todo lo contrario, hoy me gustaría escribir sobre esa cara “B” de los proyectos personales. De lo que esconden, del coste personal y profesional que conllevan y que no siempre es tan positivo como pudiera parecer.

Seguramente mucho de lo escrito puede resultar muy de Captain Obvious pero os puedo asegurar que cuando uno se mete en un jaleo así se hace difícil establecer la frontera entre lo asumible y lo inasumible.

El tamaño sí importa

Que no te engañen los que dicen que no. El tamaño (o alcance) del proyecto importa, y mucho, sobre todo si es una única persona la que desarrolla y la que se ocupa de todo, como suele ser lo normal en proyectos personales.

A mí personalmente Zahoribo se me ha hecho muy extenso en todos los sentidos, demasiado, a veces hasta pesado. Pensar y programar todo el back y todo el front incluyendo ‘el javascript, el diseño, el responsive y la usabilidad’, gestionar y administrar los servidores, configurar el motor de búsqueda, investigar sobre los boletines, programar todo el indexado diario…etc etc etc. Demasiadas áreas para una sola persona y demasiado complejas algunas de ellas como para conocerlas y llevarlas a cabo correctamente. Al final, uno termina conformándose con hacerlas de forma que no dé mucha vergüenza ajena cuando vean la luz.

Si vas a llevar a cabo un proyecto personal, valora y mide el alcance de tu proyecto o al menos de aquella parte que quieras terminar primero. Valora también buscar compañeros de viaje. Gente que te ayude, que te apoye, que resuelva y si puede ser que conozca áreas que no tú no domines.

¡Ah!, y aunque resulte obvio, piensa bien las característica que te gustaría incluir en la primera versión. Cualquier funcionalidad por pequeña que creas que sea siempre se hará más larga de lo calculado en un primer momento. Hay que dedicar tiempo a pensarla, diseñarla para que más o menos encaje en el diseño de forma decente, programarla, probarla..corregirla…reprogramarla si fuera necesario…etc., a mí me ha pasado varias veces. Hay funcionalidad que una vez terminada la tirado a la basura porque no me convencía.

En resumen, personalmente, a día de hoy creo que no volvería a llevar a cabo un proyecto con un alcance medio-grande como Zahoribo de forma solitaria. A día de hoy considero que estaría desarrollada más o menos hasta la mitad de la plataforma de todas las ideas que tenía en un principio. Y ojo, únicamente estoy hablando del proyecto desde el punto de vista técnico, es decir, realizando trabajos para la solución técnica del problema. Si además añadimos tareas de negocio relacionadas con intentar crear un producto…eso ya si que, al menos para mi, se presenta como una tarea imposible para una sola persona dentro del concepto de proyecto personal.

La presión del fullstack

El término “fullstack development” cada vez me genera más estrés. Si hay alguien que no lo conoce le dejo esta búsqueda de Google. Cualquier enlace de los aparecidos explicará más o menos el mismo concepto.

No sé cuáles serán las expectativas de la mayoría cuando piensa en el término fullstack pero yo personalmente veo muy complejo saber y ser bueno en todo. La tecnología, los lenguajes, los frameworks, las herramientas…etc., cambian y evolucionan tan rápidamente que me parece increíble poder estar al día y desarrollar con solvencia en cualquiera de los ámbitos referidos.

En mi caso con Zahoribo, he lidiado con las muchas áreas de conocimiento que engloban un proyecto así pero reconozco que, por ejemplo, las he pasado canutas con parte del diseño y de la gestión de los servidores. Son áreas en las que me defiendo a base de googlear y stackoverflowear mucho…pero yo no me atrevería a poner en mi currículum que soy fullstack. Ni la vida ni la mente me da para tener tanto conocimiento.

Libros y tutoriales

Aún así, en un intento por hacer las cosas lo mejor posible e intentar mejorar mis áreas de conocimiento para el desarrollo de software en general y Zahoribo en particular, me he leído el famoso libro de usabilidad “No me hagas pensar” de Steve Krug. Sobre el motor de búsqueda me leí su documentación y el libro de Sphinx Search, Además, seguí el curso de Javascript del canal de Ada Lovecode y varios vídeos con tutoriales sobre CSS, Bootstrap 4 y CSS Flexbox. La verdad que ha sido enriquecedor.

Para terminar este apartado me gustaría mostrar mi admiración, respeto y reconocimiento para todos ellos que de verdad sean desarrolladores fullstack.

Dedicación: horas, horas…y más horas

Ni siquiera sé cuántas han sido exactamente, pero han sido muchas. Diría que demasiadas. Diría, incluso, que si hubiera llevado un control exacto del tiempo dedicado probablemente habría tirado la toalla hace tiempo y creo que nunca hubiera terminado Zahoribo. Digo que son muchas teniendo en cuenta que es un proyecto personal, que puede que no me dé nada o solo disgustos en el peor de los casos.

Seguro que voy a decir otra obviedad pero hay que tener en cuenta que los proyectos personales salen del tiempo libre de cada uno. Y tiempo libre significa sacrificar tiempo de familia, tiempo de ocio personal o tiempo de descanso. En mi caso han sido muchos días de muchas semanas levantándome a horas intempestivas para dedicarle al menos una o dos horas diarias aumentando esta cantidad los fines de semana. He sacrificado mucho y ahora mismo estoy en un punto en el que no sé si he hecho bien o mal.

Es difícil justificar de forma continuada durante semanas o meses en el entorno familiar o en el círculo de amistades, el tiempo dedicado a un proyecto sobre cuyo final recae una alta incertidumbre. Soportar la presión no es fácil y hacer entender a personas no relacionadas con el mundo del software que a veces programar puede ser también un hobbie puede resultar bastante complicado…y cansado.

…si hasta la redacción de este artículo me ha llevado fácilmente algo más de cuatro horas…

Una línea de meta cada vez más lejos

El paso del tiempo hace que los proyectos personales parezcan no tener fin. Lo que al principio veías asumible y cercano vas notando que con el paso de las semanas todo se complica y el objetivo se aleja. Lo difícil sigue siendo difícil y lo fácil se convierte en difícil, eso es así.

El paso del tiempo hace que asalten todo tipo de dudas personales y profesionales. ¿Estaré haciendo bien?, ¿conseguiré terminarlo?, ¿quedará algo decente o será una chapuza?, ¿valdrá la pena el tiempo invertido?…Todas estas dudas y muchas otras surgen conforme avanza el tiempo de desarrollo. Dudas que se vuelven más intensas cuando, por ejemplo, llegas a callejones sin salidas y tienes que reprogramar algunas partes de la aplicación o te das cuenta que has recorrido un camino equivocado y toca seguir invirtiendo más tiempo. A veces pasa y frustra mucho.

El paso del tiempo hace que la motivación decrezca. Recuerdo las primeras semanas, estaba deseando tener un rato libre para dedicarle al proyecto. Sin embargo, ha habido semanas en las que realmente se me ha atragantado y no encontraba ni la motivación ni la fuerza mental suficiente para programar en él. No ver resultados a corto plazo y de manera continua facilita la pérdida del interés y la motivación y, por lo tanto, es difícil mantener la intensidad y la concentración en un proyecto personal a largo plazo.

El paso del tiempo hace que transites por rachas positivas y negativas de ánimo respecto al objetivo marcado. Supongo que como todo en la vida, en un período largo de tiempo, da tiempo, valga la redundancia, a pasar por épocas positivas en las que todo marcha bien y ves la salida del túnel y épocas negativas, en las que te preguntas ¿qué ******* estoy haciendo con mi vida?

El perfeccionismo es otro enemigo que aleja la meta. Creo que ser demasiado perfeccionista puede hacer que conviertas un proyecto personal en algo infinito. A poco que te lo propongas, seguro que siempre encuentras motivos para dedicar más tiempo a mejorarlo. No seas tan exigente y busca un punto intermedio que te ponga entre lo perfecto e imperfecto y lo finito y lo infinito. Seguro que lo hay.

Por último, si estás desarrollando un proyecto personal y te encuentras en alguna fase de estas…mucho ánimo, de todo se sale :) …ya llegarán tiempos mejores. No te fuerces y descansa.

Síndrome del impostor

A continuación, dos párrafos muy personales.

Creo que cuando alguien presenta un proyecto propio al resto del mundo en cierto modo es un salto al vacío en el que queda expuesto de forma personal y profesional. Ese salto da vértigo, la verdad. En esos días previos a la presentación es fácil dejarse llevar por pensamientos del tipo “vaya chapu me está quedando”, “esto no va a ir bien”, “seguro que se cae”, “el diseño se verá mal”, “que vergüenza”, “otros lo harían mucho mejor”, “todo funcionará mal”, “¿cómo vas a enseñar esto?”…etc. Lo peor de estos pensamientos es el desgaste que produce protegerse uno mismo de sus propios pensamientos. Es curioso, pero es así. Supongo que tengo una idea bastante asumida de que todo el mundo sabe mucho de todo y yo mucho de poco y/o incluso poco…de poco, en comparación con el resto.

Pero, una vez superado ese salto al vacío anterior, por suerte y en mi caso llegan las enhorabuenas y los ‘cracks’. Es como irse al otro extremo, de pensar que todo va a salir mal a parecer que todo es perfecto gracias a que uno es un “crack”. “Eres un crack”, “vaya crack”, “menudo crack”…¿yo?, ¿seguro?, ¿has mirado bien?, ¿crack yo?, ¿de verdad?. Y es justo aquí cuando aparece el síndrome del impostor con más fuerza. Honesta y sinceramente no creo que sea ningún crack ni por este proyecto ni por ningún otro. Que va. Ni por asomo. Ni en sueños. Yo me conozco, sé dónde están mis límites y hasta dónde llegan mi conocimiento y experiencia. No sé que tipo de expectativas ha generado todo esto sobre mí en lo personal y en lo profesional pero sí sé que no deberían ser nada especiales. Me da cierto reparo que algún día no pueda cumplir con estas expectativas que se han generado en torno a mi persona como profesional por el éxito, mayor o menor, siempre relativo, que puedan tener proyectos como Zahoribo.

A fin de cuentas, yo lo único que hago es dedicarle mucho tiempo a la programación, que me gusta mucho, y ya está, tampoco tiene, ni tengo, mucho más misterio. Así que ‘vamo a calmarno’.

Como dijo Sócrates:

Solo sé que no sé nada

La corona de espinas

Desarrollar y finalizar un proyecto personal de programación con “éxito” (lo entrecomillo porque el significado de éxito es bastante subjetivo y depende de cada uno), es algo así como colocarse una corona de espinas. Te coronas, si, pero ojo a las marcas y las consecuencias que deja. El tiempo, el esfuerzo, los pensamientos, las dudas,…son espinas de esa corona que tienes que aprender a sobrellevar de la mejor manera posible. Tras el “éxito” que pueda tener un proyecto de este tipo, hay un coste personal y profesional muchas veces oculto e infravalorado que desgasta mucho al programador y a su entorno.

Pero si llegas al final te alegras y el pensamiento de que todo ha merecido la pena gana lugar en tu mente. Y al final llegas sobre todo porque no queda otra, porque no hay plan ‘B’, porque sacas fuerzas y ánimo para continuar, porque lees, porque te documentas, porque pruebas y lo intentas una y otra vez y sobre todo porque tienes un objetivo y un compromiso que cumplir contigo mismo y, además, porque llega el momento en el que te encuentras en un punto de no retorno en el que sabes que ya no hay marcha atrás y solo queda continuar y terminar. Y también porque en el camino aprendes mucho y aprender es bonito. Y también porque te das cuenta que tu proyecto ayuda a la gente y construir cosas para ayudar a los demás también es bonito.

No quisiera terminar sin enviar un fuerte abrazo y un recuerdo a todos esos programadores y sus respectivos proyectos personales que se quedaron a medias y no vieron la luz. Zahoribo también va dedicado a vosotros.

Y hasta aquí esta reflexión sobre lo que puede suponer llevar a cabo un proyecto personal. Cómo siempre, cualquier comentario, duda, sugerencia y/o corrección son bienvenidos. Gracias por llegar hasta aquí.

¡Chimpún!

Créditos

• Imagen del Captain Obvius extraída de aquí: https://inciclopedia.org/wiki/Capit%C3%A1n_Obvio
• Imaen ‘plan vs reality’ extraída de aquí: https://planningengineer.net/your-plan-and-the-reality/

En esta ocasión tiene que ver con el supervisor configurado en un servidor en el que está funcionado la aplicación de un cliente.

Problema

Todo viene porque el servidor Apache se ha caído dos o tres veces en una semana después de estar meses y meses sin caerse. Para estos casos, instalé un supervisor que levantara Apache en caso de caída…pero, supervisor tampoco funcionó.

Aunque entiendo que principalmente debería resolver que es lo que hizo que Apache cayera, en este caso, he investigado el motivo por el que supervisor no funcionó.

Primeramente, lo que intenté fue reiniciar el servicio de supervisor

root@********:/etc/supervisor/conf.d# /etc/init.d/supervisor restart
[….] Restarting supervisor (via systemctl): supervisor.serviceJob for supervisor.service failed. See ‘systemctl status supervisor.service’ and ‘journalctl -xn’ for details.
 failed!

por algún oscuro no conseguía reiniciar, así que tiré de otro comando para comprobar el status:

root@*********:/etc/supervisor/conf.d# systemctl status supervisor.service
* supervisor.service — LSB: Start/stop supervisor
 Loaded: loaded (/etc/init.d/supervisor)
 Active: failed (Result: exit-code) since jue 2020–07–23 16:25:58 CEST; 2min 12s ago
 Process: 14944 ExecStop=/etc/init.d/supervisor stop (code=exited, status=0/SUCCESS)
 Process: 14949 ExecStart=/etc/init.d/supervisor start (code=exited, status=2)

jul 23 16:25:58 ********* systemd[1]: Starting LSB: Start/stop supervisor…
jul 23 16:25:58 ********* supervisor[14949]: Starting supervisor: Error: Another program is already listening on a port that one of our HTTP servers is configure…pervisord.
jul 23 16:25:58 ********* supervisor[14949]: For help, use /usr/bin/supervisord -h
jul 23 16:25:58 ********* systemd[1]: supervisor.service: control process exited, code=exited status=2
jul 23 16:25:58 ********* systemd[1]: Failed to start LSB: Start/stop supervisor.
jul 23 16:25:58 ********* systemd[1]: Unit supervisor.service entered failed state.
Hint: Some lines were ellipsized, use -l to show in full.

Este mensaje ya decía algo más. ‘Another program’ se estaba ejecutando o estaba activo y hacía que supervisor estuviera bloqueado.

Solución

Como en estos temas de servidores no soy experto (bueno, y en casi nada realmente), me toca googlear y documentarme para buscar posibles soluciones a este problema. Tras varias lecturas y pruebas, di con este hilo en stackoverflow, en el que a un problema similar sugerían una posible solución eliminando el siguiente archivo :

sudo unlink /var/run/supervisor.sock

Puedes leer más sobre la configuración de supervisor y sobre este archivo de configuración a través de este enlace.

Posteriormente, solo quedó reiniciar supervisor.

#/etc/init.d/supervisor restart

Y volver a comprobar el estado del mismo para comprobar que supervisor quedaba activo:

#systemctl status supervisor.service
* supervisor.service - LSB: Start/stop supervisor
   Loaded: loaded (/etc/init.d/supervisor)
   Active: active (running) since jue 2020-07-23 16:34:11 CEST; 47s ago
  Process: 14944 ExecStop=/etc/init.d/supervisor stop (code=exited, status=0/SUCCESS)
  Process: 15097 ExecStart=/etc/init.d/supervisor start (code=exited, status=0/SUCCESS)
   CGroup: /system.slice/supervisor.service
           |-  507 /usr/bin/python /usr/bin/supervisord -c /etc/supervisor/supervisord.conf
           `-15102 /usr/bin/python /usr/bin/supervisord -c /etc/supervisor/supervisord.conf

Eso si, queda pendiente de ver porque Apache se cae…pero esto será para otro artículo.

Cualquier sugerencia, corrección o comentario será bienvenido.

¡Chimpún!

¿Quieres saber más?, sigue leyendo.

Casi 1.500.000 páginas más indexadas

Se han añadido aproximadamente 1.500.000 páginas más de contenido indexado en los últimos siete días. Los boletines y fechas añadidas han sido los siguientes:

• BOE: Desde 01–01–2010 hasta el 31–12–2013.
• BORME: Desde el 01–01–2010 hasta el 31–12–2013.
• D.O.E.: Desde el 01–01–2010 hasta el 31–12–2011.
• Boletín Provincia Badajoz: Desde 01–01–2010 al 31–12–2014.
• Boletín Provincia Cáceres: Desde 01–01–2010 al 31–12–2011.

De esta manera queda normalizado el histórico de los boletines más importantes comenzando todos estos el 1 de Enero de 2010 hasta hoy. Pero esto no termina aquí, en los próximos días seguiremos añadiendo años al histórico.

Mejorando el algoritmo de búsqueda

Este ha sido un cambio importante por todo lo que implica a la hora de usar la plataforma. A partir de hoy Zahoribo se esfuerza en obtener resultados de búsqueda lo más exactos posibles. Ahora cuando el usuario realiza una búsqueda lo prioritario es encontrar exactamente lo que ha escrito, posteriormente cosas parecidas pero en el mismo orden y por último nos conformamos con que al menos existan las palabras buscadas. Lo explicamos a continuación.

¿Cómo funcionaba antes?

Hasta ayer, cuando un usuario realizaba una búsqueda sin utilizar ningún modificador de búsqueda avanzada, por ejemplo:

ayudas individuales

Zahoribo llevaba a cabo la opción de búsqueda menos estricta, es decir, buscaba páginas que tuvieran al menos las dos palabras, en cualquier orden y utilizando lexemas. Gracias a las característica de búsquedas por raíz (lexemas), equivaldría a buscar lo siguiente:

ayud individu

dejándose al usuario la opción de utilizar modificadores para encontrar resultados más precisos.

Esto hacía que, ante la misma fecha de publicación, pudiera aparecer una página que tuviera al principio la palabra ‘ayuda’ y al final la palabra ‘individual’ antes que una página que tuviera realmente ‘ayudas individuales’ en su contenido. La forma que tenía el usuario de mejorar este resultado pasaba porque leyera el manual de uso y aplicara los consejos 2 y 3 para buscar palabras y frases exactas

¿Cómo funciona ahora?

Tal y cómo hemos comentado, desde hoy Zahoribo se esfuerza en encontrar exactamente lo que ha buscado el usuario y se lo ofrece en primer lugar.

Siguiendo con el ejemplo anterior, si usuario buscara lo siguiente:

ayudas individuales

el algoritmo de búsqueda, internamente, puede llegar a realizar hasta tres búsquedas teniendo en cuenta un máximo de 1000 resultados :

1. En primer lugar hace una búsqueda por frase y palabra exacta:

“=ayudas =individuales”

de manera que se buscan páginas con esas palabras escritas exactamente así (sin lexemas) y además tienen que estar en ese orden. Es decir, encontrar exactamente eso.

2. En segundo lugar, siempre que no se hayan alcanzado los anteriores 1000 resultados, hace una búsqueda por frase exacta:

“ayudas individuales”

de manera que ahora se buscan páginas con esas palabras escritas por su raíz (lexemas) “ayud individu” pero teniendo que existir al menos en ese orden.

3. Por último, y siempre que entre las dos búsquedas anteriores no se hayan alcanzado los 1000 resultados, se realiza una búsqueda ‘normal’:

ayudas individuales

que es la búsqueda menos estricta, es decir, se buscan páginas con esas palabras escritas por su raíz (lexemas) sin tener en cuenta el orden en el que aparecen. Es suficiente con que existan.

Es importante destacar que Zahoribo tomará el mando de la búsqueda siempre y cuando el usuario no use modificadores de búsqueda avanzada, búsquedas anidadas o agrupe resultados. En estos casos, será el usuario el que decida el tipo de búsqueda a realizar ayudándose de los modificadores disponibles.

En resumen: Zahoribo buscará primero exactamente las palabras buscadas, luego buscará aquello que se le parezca pero al menos esté en el mismo orden escrito y finalmente buscará páginas que contengan al menos las palabras buscadas.

Otras modificaciones

En esta versión 1.1.0. se han llevado a cabo otras modificaciones menores.

Quitada la forma de ordenar resultados por relevancia

Se ha quitado de los filtros la posibilidad de ordenar resultados por relevancia. El motivo es que no tenía mucho sentido esta funcionalidad en el conjunto de datos existente y el tipo de búsqueda realizadas y, además, tampoco quedaba claro para el usuario que era más relevante y que era menos relevante. El propio concepto de relevancia no es algo simple ni inmediato y serían necesarias muchas variables para proporcionar búsquedas con cierta relevancia, tal y como hace Google por ejemplo.

Quitado enlace ‘ver más’ en resultados concretos del Boletín Provincial de Badajoz

En la parte inferior de cada resultado de páginas individuales hay un enlace ‘ver más’ en el que al hacer clic se despliega el contenido de la página completo. El contenido del Boletín Provincial de Badajoz anterior al 5 de diciembre de 2019 no contiene archivos PDF’s con los anuncios y páginas individuales, sino que cada boletín diario era un único texto html que podían corresponderse con varias, decenas o centenares de páginas haciendo que mostrarse desplegado fuera inviable. Se ha sustituido el enlace ‘ver más’ por un enlace al boletín original.

Mejorado el resaltado de palabras en los resultados

El resaltado con fondo amarillo en los resultados de búsqueda se ha mejorado para las búsquedas sobre resultados de búsquedas anteriores. Antes solo se resaltaba la búsqueda actual. Ahora se resalta el contenido de todas las búsquedas que se vayan haciendo de manera recursiva.

Internamente, a nivel de programación y configuración de índices se han realizado muchos cambios pero esto será en otro artículo con una orientación más técnica.

De momento, esto es todo. Cualquier consideración, duda, sugerencias, corrección…será bienvenida.

¡Chimpún!

Bibliografía

• La imagen que ilustra el artículo es original de Ricardo Arce y puede conseguirse aquí: https://unsplash.com/photos/cY_TCKr5bek

¿Quieres conocer de qué se trata? ¿cómo funciona? ¿cómo puede ayudar a personas y empresas? Sigue leyendo que te lo cuento pero antes, te dejo un índice del contenido de este artículo:

1. ¿Qué es Zahoribo?
2. Problemas del mundo real que resuelve
3. ¿Cómo resuelve estos problemas Zahoribo?
4. ¿A quién se los resuelve?
5. ¿Qué contenido indexa?
6. ¿Cómo funciona el indexado de contenido?
7. ¿Cómo funciona el buscador?
8. Búsquedas avanzadas
9. Otras secciones productivas de Zahoribo
10. Telegram y extensiones para navegadores
11. Funcionalidad para usuarios registrados
12. Tecnología
13. Proceso de desarrollo
14. Reflexión personal
15. Futuro del proyecto
16. Agradecimientos
17. Próximos artículos
18. Actualizaciones

1. ¿Qué es Zahoribo?

Zahoribo se trata de un buscador en boletines oficiales cuya misión principal es simple y directa:

Organizar la información oficial y hacer que sea útil y accesible para todos

En esencia se comporta como un pequeño ‘Google’ dentro de una temática muy específica como es la información oficial y pública existente en nuestras administraciones.

Zahoribo es una herramienta de búsqueda de información honesta y transparente que nace con un claro compromiso de servicio público para mejorar la vida de las personas y las empresas en la medida de lo posible.

Zahoribo nace con el compromiso de mejorar de forma significativa la productividad del mayor número de personas posible.

Se trata de una herramienta que procura aportar el mayor beneficio posible a la sociedad.

¿De dónde viene el nombre de Zahoribo?

Zahoribo viene de la palabra zahorí que se suele emplear para referirse a personas que son capaces de encontrar lo que está oculto, especialmente manantiales subterráneos. Además, en las hurdes extremeñas los zajorilis hurdanos eran considerados hombres sabios, buenos, justos, e incluso con ciertas facultades para la adivinación o la videncia.

De zahorí hemos cogido el concepto de buscador de cosas ocultas y le hemos añadido el sufijo bo, de boletín, para formar el nombre completo Zahoribo, un buscador en boletines.

2. Problemas del mundo real que resuelve

Como es bien sabido, en España tenemos multitud de entidades públicas de ámbito nacional, regional y local. La inmensa mayoría de estas entidades publican con una periodicidad casi diaria boletines con información relativa a sus competencias. Esta información tiene carácter público y oficial, es decir, es accesible y de obligado cumplimiento e interés para cada persona o empresa de este país.

Entonces, ¿cuáles son los problemas a resolver? Muchos, pero principalmente los tres siguientes:

• La cantidad de información. Son miles de páginas diarias las que se publican entre todos los boletines y esto hace virtualmente imposible a una persona estar al tanto de todo lo que se publica.
• Fuentes de información diversas y no normalizadas. Cada boletín es accesible a través de la página web oficial de cada administración. Una persona que quisiera encontrar información de su interés tendría que ir ‘saltando’ de página web en página web realizando la misma búsqueda una y otra vez con la consiguiente pérdida de tiempo. Además, cada web tiene su propia forma personalizada de acceder a la información lo cual dificulta el acceso entre varias fuentes.
• Buscadores oficiales que no funcionan como deberían. Por ejemplo, basta ilustrar con el buscador del Diario Oficial de Extremadura para darse cuenta del poco cariño que se ha puesto en su desarrollo y experiencia de usuario. Y eso cuando existe, porque hay contenido público en el que cual directamente no se puede buscar. Por ejemplo, la información de los plenos de los ayuntamientos suele estar ‘colgada’ en forma de archivos PDF’s cuya búsqueda en ellos de forma eficiente es prácticamente imposible.

¿Y en qué se traduce todo esto? pues al final se trata también de dinero. Cada uno de los problemas expuestos anteriormente, de forma directa, hace que las personas y empresas que buscan información pública pierdan tiempo y la pérdida de tiempo se traduce la mayoría de las veces en pérdida de dinero. Y, de forma indirecta, cada uno de los problemas puede suponer la pérdida de oportunidades en forma de ayudas, subvenciones, oportunidades laborales, anuncios y publicaciones de interés para empresas y particulares…etc., que son publicadas diariamente en cada uno de los boletines.

3. ¿Cómo resuelve estos problemas Zahoribo?

Zahoribo es un buscador pensado para solucionar de la mejor forma posible los problemas mencionados anteriormente.

• Centralizar y normalizar la información de manera que exista un único lugar con toda la información que cada día se publica en los distintos boletines. Esto supone una gran ventaja para los usuarios ya que evitan ir ‘saltando’ de administración en administración buscando sus intereses.
• Configurar un motor de búsqueda potente, rápido y fiable. Zahoribo está funcionando sobre Sphinx Search, un software libre que básicamente lo que hace es crear índices para acceder de forma muy rápida a los datos.
• Filtros potentes de información: Buscar entre millones de página puede ser una tarea complicada. Zahoribo ha desarrollado una serie de filtros simples y avanzados para realizar búsquedas que nos lleven con éxito hasta la información deseada de forma rápida y eficiente
• Funcionalidad que ayuda al usuario: como las alertas, gracias a las cuales Zahoribo busca tus intereses por ti cada día entre todo lo que se publica y te envía un correo electrónico con las novedades encontradas. O los marcadores que te ayudan a guardar en tu lista de favoritos los boletines, anuncios o páginas que más te interesen. O las etiquetas, que son palabras que etiquetan resultados de búsqueda en tiempo real ayudándote a clasificar los resultados obtenidos.
• Experiencia de usuario: hemos intentado que el uso del buscador sea lo más sencillo posible para cualquier persona y la presentación de la información clara y simple.

4. ¿A quién se los resuelve?

Teóricamente todos los ciudadanos y empresas son usuarios potenciales e interesados en Zahoribo. Ya que la información oficial que publica cada administración es de obligado conocimiento y cumplimiento por parte de cada ciudadano y cada empresa.

Pero, si aún concretamos más, y pensando en usuarios de uso diario tenemos por ejemplo a cualquier persona que trabaje en la administración pública, empresas como asesorías fiscales, laborales, consultorías de todo tipo, empresas o profesionales relacionadas con el mundo legal, personas o empresas pendientes de publicaciones relacionadas con ayudas, subvenciones o puestos de trabajo…etc., sindicatos, asociaciones, fundaciones,…etc. En realidad, como hemos dicho anteriormente, cualquiera puede ser usuario potencial de Zahoribo.

5. ¿Qué contenido indexa?

Actualmente Zahoribo indexa cada día el contenido de los siguientes boletines oficiales:

• Boletines de ámbito nacional: Boletín Oficial del Estado (BOE) y su anexo de notificaciones que suman miles y miles de páginas cada día y el Boletín Oficial del Registro Mercantil (BORME).
• Boletines de ámbito regional: el Diario Oficial del Extremadura (DOE), el Boletín Oficial de la Provincia de Badajoz, el Boletín Oficial de la Provincia de Cáceres.
• Boletines de ámbito local: De momento están recogidos los plenos de los ayuntamientos de Cáceres, y los pueblos de Fregenal de la Sierra y Fuente del Maestre de la provincia de Badajoz.

Hasta la fecha, Zahoribo tiene entre sus objetivos principales información oficial y pública extremeña. En un futuro no muy lejano lo más probable es que abarque otras comunidades autónoma.

Puedes seguir el calendario de Zahoribo para revisar el contenido indexado.

6. ¿Cómo funciona el indexado de contenido?

La mayoría de los boletines se publican todos los días laborales y alguno, dependiendo de la ocasión, en fines de semana, festivos, etc. Se suelen publicar a primeras horas de la mañana y, es posible, que durante un día, y debido a motivos de urgencia e importancia, una administración publique más de un boletín sin esperar al día siguiente, los llamados boletines extras.

Teniendo esto en cuenta, Zahoribo, cada día desde las 06:00 horas, en intervalos de 15 minutos y hasta las 09:00 horas accede a cada publicación para revisar si hay alguna publicación nueva. Si la hay la obtiene, procesa cada página extrayendo la información en ella contenida y la indexa. Además, desde las 09:00 hasta las 23:59 de cada día, durante cada hora se buscan esos boletines extras que pudieran aparecer a lo largo de la jornada.

Zahoribo cuenta a día de hoy (22 de Junio de 2020) con algo más de tres millones de páginas indexadas.

7. ¿Cómo funciona el buscador?

El funcionamiento es sencillo y similar a como funciona un buscador como Google.

La página inicial de Zahoribo tiene un buscador en el cual iniciar el proceso de búsqueda de contenido. Además cuenta con una primera batería de filtros muy simples para seleccionar.

Una vez se realice una búsqueda, se presenta la página con los resultados obtenidos en el que aparece en la parte de la izquierda la sección de los filtros que se pueden utilizar y en la parte derecha los resultados obtenidos. Cada resultado corresponde a una página y se indica el boletín y el anuncio al que pertenece, la fecha, enlaces a los mismos, un pequeño extracto que contiene el texto buscado y además la búsqueda realizada resaltada en amarillo. También es posible desplegar el contenido para ver el resultado ‘en bruto’ de la página.

Dependiendo de los filtros aplicados la página puede variar en contenido pero será significativamente similar a esta vista mostrada.

8. Búsquedas avanzadas

Zahoribo funciona gracias a Sphinx Search, un potente motor de búsqueda que además de rapidez en la búsqueda proporciona un sinfín de posibilidades para filtrar de forma muy avanzada millones de páginas de texto.

Aunque puedes acceder a nuestro manual de uso para leer más sobre estas búsquedas avanzadas, a continuación te exponemos algunas de las cosas que se pueden hacer:

• Buscar palabras exactas: los motores de búsqueda suelen buscar por lexemas, esto es, buscar por la raíz de la palabra. Si buscas subvención, en realidad se buscará subvenc y devolverá resultados que contengan palabras como subvención, subvenciones, subvencionable…etc. Pero con Zahoribo es posible buscar palabras exacta. En este caso valdría buscar =subvención para encontrar resultados que tuvieran esa palabra exactamente.
• Buscar frases exactas: de igual forma, escribiendo las palabras clave entre comillas dobles se puede buscar contenido que tenga todas las palabras buscadas y en el mismo orden.
• Excluir palabras: se pueden hacer búsquedas que no contengan alguna palabra en concreto. Por ejemplo, puedes buscar ayuda -educacion y se obtendrán resultados que contenga la palabra ayuda pero no contenga educación.
• Buscar unas palabras u otras: es decir, puedes realizar búsquedas ‘or’ de forma que devuelva resultados si existe una palabra u otra. Sirve muy bien para buscar sinónimos, por ejemplo, se puede buscar coches | vehículos y se obtendrán resultados que contengan la palabra coches o vehículos.
• Al menos una palabra: se pueden hacer búsquedas e indicar que deban encontrarse resultados que incluyan una o varias de las palabras buscadas.
• Agrupar búsquedas: usando paréntesis se pueden agrupar búsquedas de forma que podemos hacer lo siguiente: (ayudas educación) | (ayudas movilidad) lo que nos daría resultados que tuvieran ayudas educación o ayudas movilidad.
• Buscar en campos específicos: cada resultado está organizado en varios campos. El @tema, @asunto y @contenido. Se pueden hacer búsquedas individuales en cada uno de ellos y/o combinarlas. Por ejemplo @tema consejería educación @contenido ayudas nos daría resultados que tuvieran consejería de educación en el campo tema y ayudas en el contenido de la página en si.
• Búsquedas anidadas: para buscar entre millones de páginas hace falta, en ocasiones, filtrar mucho, por eso, Zahoribo incorpora funcionalidad para poder buscar entre resultados de búsquedas anteriores de forma recursiva.

Si quieres más posibilidades de búsqueda y más ejemplos de uso te recordamos que puedes seguir el manual del usuario.

9. Otras secciones productivas de Zahoribo

Zahoribo es básicamente un buscador de contenido pero, además, hemos querido ampliar las funcionalidades que facilitan la organización de los boletines y la búsqueda de contenido.

• Resumen diario: en esta sección se puede ver cada día un resumen de los boletines y anuncios publicados. El objetivo es que en una misma pantalla puedas revisar lo más importante del día. Además desde este resumen diario se puede acceder a un buscador de boletines por fecha o por boletín, número y año.
• Calendario: como su propio nombre indica es un calendario en el que se indican todos los boletines publicados por día y mes. El objetivo es que se pueda acceder fácilmente a uno de ellos por día y mes y además que el usuario pueda hacerse una idea visual de cuál y cuándo se ha publicado un boletín.
• Manual del usuario: Zahoribo por defecto funciona de forma potente y precisa pero es posible aumentar dicha potencia y calidad de los resultados de búsqueda. Hemos creado un amplio manual del usuario en el que se explica como funciona el buscador y una serie de consejos para poder realizar búsquedas avanzadas.

10. Telegram y extensiones para navegadores

Zahoribo es accesible desde otras aplicaciones. Para facilitar a los usuarios las búsquedas rápidas en nuestro contenido hemos desarrollado para las siguientes plataformas:

Telegram

Se ha creado un bot llamado @zahoribot. Una vez añadido como contacto, puedes realizar búsquedas con el comando /buscar contenido de la búsqueda.

Extensiones para Chrome y Firefox

Tanto para el navegador Chrome como para el navegador Firefox hemos creado extensiones para hacer búsquedas rápidas de contenido sobre Zahoribo. Si quieres instalar y probar estas extensiones solo tienes que hacer clic en los siguientes enlaces y añadirlas a tu navegador favorito.

• Instalar extensión para Chrome
• Instalar extensión para Firefox

Una vez instaladas podrás utilizarlas para realizar búsquedas rápidas y obtener resultados resumidos con un enlace hacia los resultados expandidos.

11. Funcionalidad para usuarios registrados

El posible usar Zahoribo de forma anónima para buscar contenido. No hay problema. Ahora bien, como usuario registrado tendrás funcionalidad extra que podrás aprovechar para sacar mayor rendimiento a tus búsquedas.

Alertas

Las alertas no son más que un mecanismo que te permite ahorrar tiempo dejando que Zahoribo busque por ti y para ti todo aquello que te interesa cada día con los nuevos boletines que se publiquen. El usuario define una búsqueda clave y si se encuentra contenido se envía un correo electrónico al usuario con los resultados de búsqueda.

Etiquetas

Un usuario registrado también puede crear etiquetas. Las etiquetas no son más que palabras (se pueden añadir hasta tres sinónimos) que ayudan a clasificar y a dar mayor contexto a cada resultado de búsqueda en tiempo real.

Una vez creada una etiqueta, cada resultado de búsqueda se etiquetará con la palabra principal si contiene esa palabra o cualquiera de sus sinónimos.

Marcadores

Los marcadores son elementos favoritos de un usuario que puede guardar junto a una descripción. Estos elementos pueden ser boletines, anuncios o páginas.

Para añadir un marcador únicamente hay que hacer clic en el icono correspondiente.

Y, si fuera necesario, indicar una descripción al mismo nos servirá para recordar el motivo por el que lo añadimos a nuestros marcadores favoritos:

Posteriormente se pueden revisar en el panel privado de cada usuario y tenerlos siempre disponibles y además en cada búsqueda si aparece un boletín, anuncio o página marcada se mostrará visible.

12. Tecnología

Desarrollar un buscador que busque entre millones de páginas y que cada día se actualice con varias miles más ha supuesto para mi un reto tecnológico importante. Próximamente en este blog se publicará un artículo mucho más detallado con información técnica sobre la arquitectura y el indexado pero a modo de resumen tenemos los siguientes elementos:

• Dos servidores Linux.
• Programado con Laravel 6.0, un framework PHP y base de datos con MySql.
• En cada uno de los servidores hay una instancia de Sphinx Search funcionando. Ambas instancias están configuradas como índices distribuidos teniendo uno de ellos información hasta el 31 de diciembre de 2019 y el servidor principal al que accede al usuario con información desde el 1 de enero de 2020 siendo el que se actualiza diariamente.

13. Proceso de desarrollo

Comencé a programar en el proyecto allá por noviembre de 2019 creo recordar. Una primera versión inicial no fue costosa conseguirla. El objetivo era poder mostrar el potencial de un buscador de este tipo. Con esa primera versión inicial hablé con varias personas usuarias del Diario Oficial de Extremadura. Todas me dijeron que la idea y el funcionamiento eran muy buenos, así que digamos que pude validar la idea original.

Esta fórmula he ido aplicándola en sucesivas rondas. Aplicaba mejoras y las enseñaba. Con el feedback recibido intentaba mejorar el producto y así sucesivamente. En todo este tiempo he hablado con personas que pertenecen tanto a entidades públicas como privadas y todas se han visto interesadas en una plataforma de este tipo. Aún así he dado algunos tumbos que me han hecho programar funcionalidad…para luego quitarla.

La parte que más me ha costado ha sido el diseño de la aplicación, tres versiones he hecho hasta que he llegado a la versión final (de momento). Además, reconozco que la parte de diseño es algo en lo que no soy bueno y por lo tanto tampoco he podido hacer mucho más que dejarlo decente, o eso espero.

También me ha llevado algún tiempo entender bien como funciona un motor de búsqueda, su uso, configuración y optimización para que los resultados fueran los mejores.

Durante el desarrollo he leído al menos dos libros para intentar que el resultado fuera el mejor posible. Uno ha sido Introduction to Search with Sphinx, y el clásico No me hagas pensar de Steve Drug.

La publicación de la primera versión supone un punto y seguido en este proyecto cuyo futuro está lleno de novedades.

14. Reflexión personal

Zahoribo es un proyecto personal. 100% personal. Todo lo que se ve y lo que no se ve lo he programado yo solo. La programación de la parte pública y privada de usuarios, la configuración de los servidores, la configuración del motor de búsqueda, el funcionamiento del propio buscador, el diseño de la página, la redacción de los textos, la distribución de la información, la programación de las extensiones para Chrome y Firefox, la interacción con el bot de Telegram, la redacción de este mismo post …etc. Todo.

Es un proyecto bonito, a mi me me gusta mucho…si no fuera así, no creo que hubiera podido finalizar y publicar la primera versión. No solo me gusta por la temática, la tecnología, el reto que ha supuesto para mi y todo lo que implica sino que además creo que Zahoribo honestamente puede ayudar a mucha gente.

Aún así, el coste personal ha sido alto. Me ha llevado muchas horas el desarrollo y he tardado más de seis meses en publicar la primera versión y dando ‘gracias’ al mes en el que por el coronavirus los proyectos profesionales que llevo como autónomo se pararon casi todos. Ese mes lo aproveché para tirar horas de desarrollo en Zahoribo. Desde entonces, muchos días de muchas semanas levantándome muy temprano para aprovechar un par de horas diarias, o más, al proyecto y no quitar tiempo de desarrollo a mis clientes en mi trabajo de autónomo.

Cualquier cambio, funcionalidad, configuración o incluso la redacción de este mismo artículo suponen una gran cantidad de horas que a veces es complicado asumir y justificar ante el entorno familiar, eso es así. No he medido el tiempo de desarrollo y creo que si lo hubiera medido no me habría hecho nada bien. Los proyectos personales los veo más como desarrollos en los que disfrutar sin la presión del tiempo…aunque esa presión la sienta uno de manera inconsciente cuando ve que se alargan las jornadas de programación.

A decir verdad, llevar a cabo de forma individual un proyecto grande como este es muy cansado física y mentalmente. En un período tan largo de desarrollo supone atravesar distintas fases de ánimo. Días que piensas que todo va a ir bien y días en los que piensas que el final queda muy lejos y no vas a tener ni tiempo ni energía para terminarlo. Hoy por hoy me pensaría volver a llevar un desarrollo así yo solo, lo más probable es que buscara compañeros de viaje.

Pero bueno, una vez hecho, al final merece la pena, una vez lo terminas ves que todo tiene sentido (o al menos lo piensas así) y uno se siente orgulloso de lo que ha conseguido. Construir herramientas tecnológicas que ayudan a otras personas aporta mucha satisfacción personal. Atrás quedaron las noches sin dormir, las horas y horas leyendo Stackoverflow y otros foros similares para buscar ayuda a problemas a los que nunca me había enfrentado.

También es justo decir que Zahoribo me ha hecho aprender mucho.

Espero que Zahoribo ayude a otras personas. Aunque sea a una sola, con que haga la vida más fácil a una sola persona me daré por satisfecho.

15. Futuro del proyecto

El futuro del proyecto pasa ahora mismo por darle visibilidad y por llegar a cuantas más personas e instituciones sea posible. Además, una vez descanse, que será pronto, iré añadiendo más funcionalidad que tengo pendiente de incluir para mejorar las búsquedas y la funcionalidad que ayude al usuario.

También pasa por incluir más información, más boletines, más ayuntamientos, más información pública para ponerla a disposición de todas las personas. Este ’nicho’ es muy amplio y la cantidad de información por analizar todavía es enorme. Poco a poco.

Además, quedan algunos retos técnicos por llevar a cabo como es el desarrollo de un API para poder consultar Zahoribo desde cualquier otra aplicación o la integración con procesadores de lenguaje natural para poder hacer búsquedas más ‘humanas’ y no únicamente por palabras. Igualmente, poco a poco.

A raíz de Zahoribo, también he observado una serie de necesidades en empresas y entidades públicas a las cuáles daré una solución tecnológica en las próximas semanas, a ver que tal sale. De momento son solo ideas…me las guardo y cuando las ejecute y lleve a cabo hablaré de ellas. A mi me gusta más hacer que hablar.

Y, finalmente, ojalá pudiera convertir Zahoribo en un producto. Conseguir que alguien pague (aunque sea poco) por su uso. Haber aportado una solución a los problemas de personas y empresas y que estas consideren adecuado pagar por esa solución. Esto será otro frente que tendré que atacar muy pronto y enfrentarme a otro paradigma al cual no me he enfrentado nunca. La venta de un producto digital.

16. Agradecimientos

Como he comentado anteriormente, el 100% del proyecto lo he llevado en solitario, pero también es cierto que hay personas que me han dado su opinión muchas veces y a las que he preguntado quizás más de lo debido. Gracias por sus aportes y por aguantarme a Ricardo (que además me proporcionó una idea de fuente para el título muy buena y mejoras y correcciones a algunos textos) y a Civantos.

Y también, en general, a todos los que desarrollan software libre y crean herramientas maravillosas para que otros podamos llevar a cabo nuestros proyectos, especialmente a los creadores de Laravel y Sphinx Search.

17. Próximos artículos

En próximos artículos del blog explicaré de forma detallada aspectos más técnicos del proyecto sobre como funciona el indexado diario, el buscador, como se configura Sphinx para obtener los mejores resultados o para funcione de forma distribuida.

18. Actualizaciones

• Artículo escrito el 30 de Junio de 2020 que explica la actualización del algoritmo de búsquedas y otras actualizaciones de la versión 1.1.0. Haz clic aquí para leerlo.

Y esto es todo de momento, queda oficialmente publicada la versión 1.0.0 de Zahoribo.

Cualquier comentario, duda, sugerencia o corrección será bienvenida. Gracias por llegar hasta el final del artículo :)

¡Chimpún!

Una de las ideas más extendidas que existen alrededor de la figura del autónomo es que no tiene un horario definido. En el fondo tiene parte de razón ya que se es autónomo veinticuatro horas al día durante los siete días de la semana, y más aún cuando hablamos de sectores laborales como el desarrollo de software en el que priman labores intelectuales, ¿quién no ha estado pensando sin descanso en la solución a un problema en su ‘tiempo libre’? La mente no para.

En esta nueva etapa como ‘freelance’, una de las cosas que me planteé casi desde un principio era gestionar de la mejor forma posible el tiempo de mi día a día, el tiempo de mi vida. Tengo mi casa con mujer e hija de cinco años, tengo una vida profesional que me apasiona, una vida ‘personal’ con actividades que me gustaría seguir haciendo, una vida social fuera de las tres anteriores y sobre todo, un límite máximo de veinticuatro horas al día para gestionar mis prioridades. Esta palabra es muy importante en todo este tema, prioridades. Es definitiva, el objetivo es ser dueño de mi tiempo y liderarlo para sacar de cada minuto la mayor satisfacción posible.

Tiempo limitado, tiempo suficiente

Seguro que has pensado alguna vez, o al menos escuchado, “…yo no tengo tiempo…”, “…imposible, no puedo, me faltan horas al día…”. Uno de mis primeros cambios en la gestión del tiempo fue ser plenamente consciente del límite de veinticuatro horas que tiene un día. Me sirvió para quitarme de la cabeza ideas como la anterior “…me faltan horas…”, que lo único que me aportaban era pensar en que si yo tuviera más horas al día, podría hacer más cosas. Cuando, precisamente, es al contrario, no me faltaban horas para hacer todo lo que yo quería, sino que lo que tenía que hacer era definir realmente lo que yo quería a través de establecer una serie de prioridades personales y profesionales. Me hacía falta tener claro lo que de verdad me aportaba valor a mi vida que siempre, siempre, siempre, tiene que ver con lo que de verdad me apasiona. Una vez definido, solo quedaba encajar esas prioridades en veinticuatro horas diarias. El tiempo es finito, es el que es. El tiempo no se puede gestionar, va pasando, lo que si puedes hacer es gestionar tus intereses y prioridades y como las vas adaptando a ese paso del tiempo.

Orden y progreso

Este es el lema de la bandera de Brasil: “Orden y progreso”. Así de primeras suena bien, ¿verdad? Hace ya mucho tiempo que me llamó la atención esta frase y de manera interna la voy repitiendo de manera consciente y constantemente en muchas situaciones de mi vida, normalmente cuando tengo la sensación de pérdida de control de la actividad que esté realizando. Cuando programo y veo que me estoy liando…paro, pongo orden, y progreso poco a poco nuevamente.

Orden y progreso es un término que proviene de una frase de Auguste Comte, exponente de la ideología y filosofía del positivismo: «L’amour pour principe et l’ordre pour base; le progrès pour but» — « El amor por principio, el orden por base, el progreso por fin», en francés.

En mi opinión, la gestión del tiempo necesita el desarrollo de dos habilidades personales: orden y compromiso. Orden significa saber colocar cada prioridad personal y profesional en el momento en el que le corresponde en el tiempo. Compromiso significa mantener un contrato contigo mismo de cumplimiento del orden establecido, es decir, ser consciente de que tienes un deber que cumplir de forma que lo mantengas en el tiempo hasta el punto justo en el que seas capaz de generar un hábito correcto de vida. Entendiendo por correcto aquel que satisfaga a cada uno de manera persona y profesional.

Un calendario

Tenía claras las prioridades y tenía claro el objetivo, pero sentía que todas estas ideas relacionadas con la gestión del tiempo las tenía que plasmar de alguna forma. La costumbre hizo que lo primero que hiciera fuera buscar aplicaciones para el móvil, encontré varias y ninguna me convencía. La casualidad hizo que hace ya varias semanas me tuviera que sentar con mi hija para hacer su calendario de actividades semanal. ¡Eureka!. Eso es, un calendario, un simple calendario en un papel situado en un lugar muy visible en mi mesa de trabajo haría que tuviera siempre presenta el ‘roadmap’ de mi día a día.

Este calendario lo tengo pegado en la pared, casi a la altura de los ojos encima de mi mesa de trabajo diario. Es como un vigilante, hace que no me desvíe en el día a día sobre que debo hacer y cuando. Está diseñado pensando en todas esas prioridades que considero me aportan más valor en mi día a día y las mejores horas para hacerlas. Antes de comentar algunos detalles del mismo, es necesario entender un par de cuestiones: Si, me levanto muy temprano. Me encanta, aprovecho muy bien el tiempo a esas horas algo intempestivas. Claro que, por otro lado, me acuesto muy temprano también.

Algunos detalles del mismo son los siguientes:

• Color naranja, tiempo dedicado a formación: La primera hora del día. Creo que, profesionalmente, soy una persona que siempre está en constante período formativo. Pero ahora, además, quería establecer un tiempo diario de formación principalmente por dos motivos. El primero, como ya comenté, orden. Además, no únicamente estableciendo un orden temporal de dedicación, sino que además, orden siguiendo cursos con un sentido y objetivo definidos. El segundo, tener la seguridad de que mi compromiso con la formación es lo suficientemente importante como para dedicarle al menos una hora al día como mínimo. La formación de hoy estoy seguro que me dará de comer en el medio y/o largo plazo.
• Color azul, tiempo dedicado a trabajo: Lo he dividido en tres bloques. Creo que esto me viene bien. La experiencia me dice que, de modo general, incluido yo, trabajar durante muchas horas seguidas suele tener como consecuencia una pérdida de rendimiento conforme pasa el tiempo. El descanso mental es necesario. Por eso, prefiero dividir este tiempo y cada bloque estar con las menores distracciones y máxima concentración posible. El tiempo de trabajo implica, por supuesto, programación, gestión comercial, facturación…etc.
• Color rosa, Inés: Mi hija. Para mi, sin duda, las mejores horas de cada día. Llevarla al cole y recogerla a mediodía. Además, este año como aliciente tenemos un remolque para la bici que usamos todos los días. Es que lo tengo que poner, no me aguanto:

• Color verde, deporte: Im-pres-cin-di-ble. Tener un rato de actividad física diaria en una profesión como la nuestra en la que pasamos demasiadas horas sentados debería ser obligatorio para todos. El cuerpo es nuestro vehículo de vida y mantenerlo con un buen estado de salud nos proporcionará la suficiente fuerza y energía para el día a día. Siendo autónomo, si cabe, tiene un poco más de importancia ya que dependes exclusivamente de ti mismo y mantenerte sano es clave personal y profesionalmente.

Dos detalles más: Celdas en blanco…básicamente, tiempo de familia o tiempo para otras tareas que surjan. El domingo es libre, me permito hacer laboralmente lo que yo quiera o necesite hasta las 11:00, incluso no hacer nada si no fuera necesario.

Mejorando la toma de decisiones

Tener un horario para mi ha implicado compromiso de cumplirlo. Como cuando íbamos al cole, gracias a tener un horario podíamos planificar las asignaturas o tareas del día siguiente. Ahora es parecido.

De manera explícita, con una decisión he evitado múltiples decisiones diarias, es decir, una vez decidido el horario he dejado de estar tomando decisiones cada mañana sobre como va a ser mi día a día. Ya no hace falta pensar que hago mañana, a que hora lo hago, como compagino mi vida personal y profesional, cuando llevo a cabo las tareas pendientes…etc.. La decisión ya está tomada. La división ya está hecha. Para mi, planificar, significa reducir estrés. Generar hábitos, significa crear un sistema que proporcione la tranquilidad de estar haciendo lo que se debe cuando se debe, es decir, la tranquilidad de estar haciendo lo correcto en el momento oportuno.

Ser flexible

Eso si, hay que ser prácticos y flexibles. Si la carga de trabajo aumenta por el motivo que sea para cumplir con plazos de entrega se puede modificar el horario, aumentar horas o reducirlas de algún sitio pero siempre teniendo en mente que debe ser de manera puntual. De nada sirve tener un horario si no se va a cumplir. Si adquieres el compromiso debes hacer el esfuerzo por llevarlo a cabo. Pero si las circunstancias llevan a tener que modificarlo, se hace y, en cuanto se pueda, se vuelve a la rutina.

Tres semanas

He querido escribir este artículo después de tres semanas cumpliendo con el horario y las prioridades que fijé en su momento. He de decir que la sensación de aprovechamiento del tiempo que tengo es muy muy muy alta porque he conseguido llevar todo lo que me gusta en mi vida…a cada día.

Entre 21 y 66 días dicen que es necesario realizar una actividad para generar un hábito. Tres semanas cumpliendo un compromiso para seguir comprometido con él mucho tiempo más.

Eso es todo por el momento. Como siempre, cualquier comentario, sugerencia, correción…etc., son bienvenidos.

¡Chimpún!

Bibliografía

• https://es.wikipedia.org/wiki/Orden_y_progreso
• https://pijamasurf.com/2017/06/cuanto_tiempo_se_necesita_para_formar_un_habito_aqui_la_respuesta/