# Little Bock Little Bock est un logiciel de brassage en ligne et un site communautaire pour brasseurs dédié à la création de recettes de bières maison. Fonctionnalités incluses dans Little Bock : * Créateur de recette * Partage de recettes * Gestion des équipements de brassage * Gestion des stocks * Journal de brassage * Suivi de fermentation * Gestion du conditionnement * Calendrier des fermentations * Formulaire de dégustation # Changelog Journal des modifications ## 1.12.0 - 23-12-2021 ### 🔥 Ajouts * API : Possibilité de communiquer avec Little Bock via une API REST : [Documentation](/api) ## 1.11.0 - 26-10-2021 ### 🔥 Ajouts * Traçabilité : Possibilité d'ajouter un numéro de lot pour chaque élément du stock et pour chaque ingrédient d'une recette ou d'une recette d'un brassin. ### 👍 Améliorations * Brassins : Possibilité de modifier la recette d'un brassin sans modifier la recette d'origine. * Brassins : Possibilité de copier un brassin (seuls la recette du brassin et le journal de brassage seront copiés). * Consommables : Ajout du champ "Notes". * Recettes : Augmentation de la limite de chargement d'une image. * Évènements : Changement de la dimension de l'image à préférer (960px x 540px). ## 1.10.5 - 17-09-2021 ### 👍 Améliorations * Affichage de l'efficacité de la brasserie pour chaque recette. * Affichage de l'efficacité d'empâtage et de l'efficacité de la brasserie mesurées pour chaque brassin. ### 🔥 Ajouts * Outil de calcul d'efficacité : [Efficacité de brassage](https://www.littlebock.fr/outil-brassage/calculateur-efficacite-brasserie) ## 1.10.4 - 10-09-2021 ### 🐛 Corrections * Ajustement du calcul de la densité initiale : Avant la mise à jour, le volume du moût pour le calcul était celui après transfert dans le fermenteur, maintenant c'est celui avant transfert. ## 1.10.3 - 05-08-2021 ### 🔥 Ajouts * Page "Tendances" : Affichage des 36 recettes les plus populaires lors des 60 derniers jours. ### 👍 Améliorations * Possibilité d'attribuer des labels aux recettes. * Possibilité de filtrer les recettes par labels. * Ajout d'un bouton "Base de données commune" dans le formulaire de création d'un profil d'eau. * Amélioration du système de liste (stocks, équipements, etc.). ### 🐛 Corrections * Correction tri par date dans les listes ## 1.10.2 - 29-07-2021 ### 👍 Améliorations * Possibilité de définir un seuil d'alerte de quantité faible pour chaque élément des stocks : matières premières, consommables, conditionnements vides et bières conditionnées. ## 1.10.1 - 14-07-2021 ### 🔥 Ajouts * Comptes certifiés ## 1.10.0 - 16-06-2021 ### 🔥 Ajouts * Gestions des coûts : * Possibilité de choisir sa devise (dans les paramètres généraux). * Possibilité de renseigner le coût unitaire et total pour chaque partie du stock (matières premières, consommables et conditionnements vides). * Possibilité de renseigner le coût unitaire pour chaque ingrédient d'une recette. * Affichage des coûts pour une recette (par ingrédient et le coût total). * Affichage de la ventilation des coûts par brassin. ### 👍 Améliorations * Ajout des boutons "Ajouter" et "Retirer" dans le stock de matières premières. * Une bière conditionnée est maintenant liée à un conditionnement vide et non à un type de conditionnement (changement dans le formulaire de création de bières conditionnées). * Possibilité de définir un type de conditionnement comme "Usage unique". Cela permet d'affiner la gestion des coûts. * Possibilité de choisir l'unité "Paquet" pour une levure (en plus de "g" et "ml"). ## 1.9.0 - 19-05-2021 ### 🔥 Ajouts * Gestion des évènements brassicoles. ## 1.8.8 - 24-02-2021 ### 👍 Améliorations * Possibilité de renseigner une DLUO pour les matières premières du stock. ## 1.8.7 - 23-02-2021 ### 👍 Améliorations * Possibilité d'associer un fermenteur (ou un fût) à un brassin. * Affichage des notes (via popover) dans les listes suivantes : matières premières, conditionnements vides, bières conditionnées, fermenteurs, fûts (Kegs) et profils d'eau. ### 🐛 Corrections * Correction Journal de brassage : prise en compte des retours à la ligne dans l'affichage des notes. ## 1.8.6 - 22-02-2021 ### 🐛 Corrections * Notifications lors d'une réponse à un commentaire. * Couleur icone brassin si EBC supérieur à 100. ## 1.8.5 - 11-02-2021 ### 👍 Améliorations * Possibilité de connecter un Brew Bubbles avec Little Bock. ## 1.8.4 - 08-02-2021 ### 👍 Améliorations * Possibilité d'importer des profils d'eau via d'autres applications (ex: moneaudebrassage.fr) ## 1.8.3 - 21-01-2021 ### 👍 Améliorations * Edition recette : possibilité de choisir le type d'ajout d'un fermentescible (empâtage, ébullition, hors flamme, primaire, secondaire ou embouteillage). * Edition recette : possibilité de définir un fermentescible comme non fermentescible. * Edition recette : affichage de la densité après ébullition, si différente de la DI (utile le cas d'un ajout de fermentescible après ébullition). * Possibilité d'ajouter manuellement une mesure dans le suivi de fermentation d'un brassin. * Affichage de la DI estimée et la DF estimée dans le graphique "Suivi de fermentation". ### 🐛 Corrections * Correction bug empâtage : Erreur de calcul de la DI lors d'un empâtage multipalier. * Correction redimensionnement recette : redimensionnement du volume d'ébullition. ## 1.8.2 - 07-12-2020 ### 🐛 Corrections * Correction bug Floaty : Erreur lors de la récupération des données par Little Bock. ## 1.8.1 - 20-11-2020 ### 👍 Améliorations * Possibilité de modifier le moyen de paiement pour l'abonnement Premium dans la partie "Mon compte". ### 🐛 Corrections * Correction de bugs mineurs pour la gestion du conditionnement. ## 1.8.0 - 14-11-2020 ### 🔥 Ajouts * Gestion des stocks de consommables. * Gestion des stocks de conditionnements vides. * Gestion des stocks de bières conditionnées. * Gestion du conditionnement depuis un brassin. * Paramètre général pour autoriser un stock négatif. * Gestion des types de conditionnement. * Lien rapide pour retirer une bière du stock. * Création du Changelog (journal des modifications). ### 👍 Améliorations * Amélioration du code interne. ### 🐛 Corrections * Pouvoir supprimer une recette sauvegardée lorsque le propriétaire a changé la visibilité de cette recette en "Privée". * Correction de bugs mineurs. ## 1.7.3 - 25-10-2020 ### 🔥 Ajouts * Objet connecté [Floaty](https://youtu.be/EsuszT7ymvg). Possibilité de suivre la fermentation d'un brassin avec l'hydromètre Floaty. ## 1.7.2 - 16-10-2020 ### 🔥 Ajouts * Possibilité de souscrire un abonnement Premium au mois. ### 👍 Améliorations * Mise à jour du système de paiement Stripe : dernière version, redirection vers une page hébergée chez Stripe, 3D secure. ## 1.7.1 - 29-09-2020 ### 🐛 Corrections * Correction lors de la suppression d'un objet connecté. ## Anciennes versions Non documentées # API REST API Vous pouvez utiliser l'API de Little Bock pour créer des appels afin d'obtenir les données dont vous avez besoin pour intégrer Little Bock à votre système. ## Avertissement L'API n'étant pas encore finalisée, des changements peuvent être faits et la rendre non compatible avec votre implémentation. ## Authentification Pour vous authentifier, il vous faudra passer la clé API de votre compte Little Bock dans le `header` de chaque requête via la variable `X-AUTH-TOKEN`. L'API est accessible seulement en HTTPS pour des raisons de sécurité. L'API est seulement disponible pour les comptes Premium. ### Exemple ``` curl --request GET 'https://www.littlebock.fr/api/recipes' --header 'X-AUTH-TOKEN: 782e2cc1bb62168dff8cf633f7e24012523f6bc06175ab5e1fccce98d7bacbf43a54ff61c7d0f555d809bc1c2ad188e70b2c' ``` ### Générer une clé API Il est possible de générer une seule clé API par compte utilisateur Little Bock. Pour communiquer avec l'API, il vous faudra obligatoirement une clé API. Pour générer une clé API, vous pouvez le faire via la page "Mon compte", onglet "API", bouton "Générer ma clé API" : [Mon compte](https://www.littlebock.fr/profil/api-settings) Si vous pensez que votre clé API est compromise (un tiers non autorisé en à connaissance), vous pouvez la regénérer via le bouton "Regénérer". ## Rate limit Une limite est fixée à 150 requêtes par heure et par clé API. Cette valeur peut changer. Chaque réponse de l'API contient les valeurs suivantes dans le `header` : * `X-RateLimit-Remaining` : Nombre d'appels restant * `X-RateLimit-Retry-After` : Date (timestamp) de remise à zéro de votre consommation * `Retry-After` : Date (timestamp) de remise à zéro de votre consommation * `X-RateLimit-Limit` : Nombre maximum d'appels à l'API par heure Code HTTP d'erreur en cas de limite atteinte : `429 Too Many Requests` ## Contact Si vous avez des questions relatives à l'API ou des difficultés pour l'utiliser, vous pouvez envoyer un message via ce formulaire : [Formulaire de contact](https://www.littlebock.fr/contact) ## Documentation La documentation complète de l'API est disponible ici : [Documentation API](https://www.littlebock.fr/api/docs) # Statut Statut de l'application web Little Bock ## 23-03-2021 ### 🟢 Opérationnel * **21h30** : OVH a tenu ses prévisions concernant le redémarrage du datacenter SBG3. Toutes les données sont telles que nous les avons laissées. Il n'y a donc pas eu de pertes de données. **Nous pouvons réutiliser l'application comme avant cet incident.** **Concernant l'application de backup (**[**http://backup.littlebock.fr/**](http://backup.littlebock.fr/)**), elle sera arrêtée le 31/03/2021. Après cette date, elle ne sera plus disponible.** Si vous avez créé de nouvelles données dessus, vous avez jusqu'à cette date pour les copier sur l'application de production (). **Actions à venir :** * Mise en place d'un nouveau système de sauvegardes automatiques journalières. Stockage chez un autre prestataire (peut-être Gandi.net). Aujourd'hui les sauvegardes sont faites chez OVH, il y aura donc une réplication des données chez deux hébergeurs. * Définir un plan de secours en cas de perte de serveur (remise en service rapide). L'objectif est d'obtenir un déploiement rapide de l'application en cas de besoin. ## 22-03-2021 ### 🟢 Opérationnel * **22h00** : Nous pouvons réutiliser l'application comme avant l'incident. Plus d'informations à venir. ## 15-03-2021 ### 🔴 Incident - Version dégradée * **18h00** : La production de Little Bock est toujours inaccessible. Concernant la situation avec OVH, le serveur de Little Bock se trouve dans le datacenter SBG3. Ce dernier n'a pas brulé, mais il a été arrêté (coupure de courant) afin de ne pas endommager le matériel suite à l'intervention des pompiers. J'ai reçu un e-mail d'OVH avec la mention "Récupérable" à propos de l'instance du serveur. À voir si leurs engagements seront possibles. Le redémarrage de SBG3 est prévu semaine prochaine (date qui peut évoluer). La remise en production de Little Bock se fera lorsque l'incident OVH sera terminé. En attendant, j'ai installé une version dégradée de Little Bock avec une sauvegarde de la base de données qui date du 06/02/2021 : . **Attention : toutes les données créées ou modifiées dans cette version seront supprimées lors de la remise en production de l'application. Cette version est uniquement faite pour consulter les données et utiliser les outils de brassage.** Les images ne sont pas disponibles. Vous pouvez exporter vos recettes au format BeerXML. L'infrastructure montée via AWS pour cette version n'est pas encore stable, soyez indulgent si ce service n'est pas opérationnel à 100%. ## 12-03-2021 ### 🔴 Incident * **11h50** : L'installation de l'infrastructure AWS est en cours. Le rétablissement du service est en bonne voie et il est prévu pour début de semaine prochaine (le 15/03 ou le 16/03). ## 11-03-2021 ### 🔴 Incident * **18h30** : Pour faire un retour sur la situation. J'ai passé la journée à essayer de monter une infrastructure avec AWS (Amazon). J'ai avancé, mais l'application n'est pas encore opérationnelle. Cela prend du temps car je ne veux pas monter un serveur temporaire, mais obtenir une solution qui durera dans le temps. Pour le moment je ne peux pas donner de date pour le rétablissement du service (soit demain, soit début de semaine prochaine). Concernant les données, j'ai une sauvegarde qui n'était pas chez OVH et qui date du 06/02/2021. Dans le court terme, je voudrais rétablir le service avec cette sauvegarde. Une fois qu'OVH redémarrera ses datacenter (d'ici une à deux semaines), je pourrai évaluer les pertes ou non. Si jamais je peux récupérer les données chez OVH, je les réintégrerai à la production qui sera en cours d'utilisation. * **8h00** : Tentative d'installation des services AWS. ## 10-03-2021 ### 🔴 Incident * **17h30** : Migration de l'hébergement de Little Bock vers un nouveau prestataire. * **9h00** : L'accès à Little Bock est impossible. Cause : incendie dans un datacenter OVH. Je ne peux rien faire tant que l'incident n'est pas terminé côté OVH et que je n'ai pas toutes les informations. # Recette ## Comment trouver la recette qui me convient ? Grâce au formulaire de recherche présent sur cette page : [Trouver une recette de bière](https://www.littlebock.fr/recettes-bieres/), vous pouvez cibler précisément le profil de bière que vous recherchez (méthode de brassage, style, type, etc...). Une fois la recherche effectuée, il ne vous reste plus qu'à choisir la recette qui vous plait le plus parmi la nouvelle liste de recettes qui s'est affichée. ## Comment créer une recette à partir de zéro ? Pour cela il vous faudra aller sur la page suivante : [Créer une recette de bière](https://www.littlebock.fr/recettes-bieres/creer). Un tutoriel vidéo a été réalisé par [La caisse à outils](https://www.facebook.com/lacaisseaoutils23/), vous pouvez le consulter ici : ## Comment adapter les quantités de la recette à mon volume de brassage ? Sur une fiche de recette publique vous pouvez adapter les quantités à votre volume final souhaité. Pour cela il vous suffit de cliquer sur le bouton "Ajuster les quantités" présent à côté du volume de la recette. ## Comment imprimer ma fiche de brassage ? Vous pouvez imprimer la recette en cliquant sur le bouton "Imprimer" présent sur la page de la recette. ## Qu'est-ce qu'un fichier BeerXML ? Pour faire simple et sans rentrer dans les détails, un fichier dit de type BeerXML est un document qui contient toutes les informations nécessaires à l'élaboration d'une recette (ingrédients, méthode d'empâtage, fermentation, etc...). Les éditeurs de logiciels de brassage se sont mis d'accord pour créer un standard d'interprétation de recette entre chaque logiciel. Il en résulte qu'il est désormais possible d'exporter sa recette de bière (un fichier avec une extension en .xml) et de l'importer dans n'importe quel autre logiciel de brassage. ## Comment créer une recette depuis un fichier BeerXML ? Tout d'abord, il vous faudra exporter votre recette à partir de votre logiciel de brassage. La procédure peut différer d'un logiciel à un autre, mais elle devrait ressembler à cela : sélectionnez votre recette, cliquez sur l'option "Exporter", choisissez le répertoire d'enregistrement, sélectionnez le type de fichier .xml. À présent vous possédez votre recette au format BeerXML. Pour l'importer dans le site Little Bock rien de plus simple : allez sur la page [Partager une recette](https://www.littlebock.fr/recettes-bieres/creer), cliquez sur le bouton "Choisissez un fichier...", sélectionnez le fichier de votre recette et cliquez sur le bouton "Importer". La page devrait se recharger avec toutes les informations de votre recette ! # Calendrier ## Comment ajouter mon calendrier Little Bock à mon gestionnaire de calendriers (Google Agenda, iCalendar, Outlook, etc.) ? Afin de visualiser votre calendrier de brassage dans votre gestionnaire de calendriers préféré (Google Agenda, iCalendar, Outlook, etc.), vous devez aller dans votre gestionnaire et ajouter un nouveau calendrier à partir de l'URL fournit ici : [Calendrier](https://www.littlebock.fr/calendrier/).\ Le principe est simple, Little Bock fournit un lien (URL) unique contenant tous les évènements de votre calendrier. Ainsi, en ajoutant ce lien à votre gestionnaire, vous pourrez voir votre calendrier de brasage avec ses évènements aux côtés de vos autres calendriers. Il se peut qu'il y ait un temps de latence entre la modification des évènements sur Little Bock et l'affichage dans votre gestionnaire. Sur certains gestionnaires, comme Google Agenda par exemple, cela peut prendre jusqu'à 12h avant que la synchronisation se fasse.\ Vous trouvez ci-après des liens vers le support des principaux gestionnaires : [Google Agenda](https://support.google.com/calendar/answer/37100?co=GENIE.Platform%3DDesktop\&hl=fr), [Calendrier Apple](https://support.apple.com/fr-fr/HT202361), [Outlook](https://support.office.com/fr-fr/article/importer-un-calendrier-ou-s-y-abonner-dans-outlook-com-cff1429c-5af6-41ec-a5b4-74f2c278e98c) # Dégustations ## **Comment récolter des dégustations sur ma recette ?** Chacune de vos recettes a un formulaire de dégustation qui lui est propre. Pour obtenir le lien de ce formulaire il vous suffit d'aller dans [Mes recettes](https://www.littlebock.fr/brasserie/recettes), de sélectionner une recette et de cliquer sur le bouton"Lien du formulaire de dégustation".\ Vous pouvez alors soit copier le lien et le partager à vos amis (par vos propres moyens, ex : e-mail, messagerie instantanée), soit télécharger le QR Code du lien, l'imprimer et le coller sur vos bouteilles. Personnellement, nous avons pour habitude d'intégrer le QR Code à l'étiquette de la bouteille. Le QR Code n'a pas besoin d'être imprimé en grand pour être correctement lu par le lecteur. ## **Est-il possible d'ajouter une dégustation à une recette que j'ai reproduite ?** Le seul moyen d'effectuer une dégustation est dans le cas où le brasseur vous a transmis le lien du formulaire (ou que vous soyez le brasseur de la recette). Vous ne pouvez pas effectuer une dégustation d'une recette que vous avez reproduite chez vous, car avec une même recette le résultat final peut être bien différent. Vous pouvez toujours [Ajouter votre propre recette](https://www.littlebock.fr/recettes-bieres/creer) avec vos changements, vos remarques et vos dégustations. ## **Comment voir toutes les dégustations que j'ai reçues ?** Vous pouvez accéder à la liste de vos dégustations reçues pour une recette dans [Mes recettes](https://www.littlebock.fr/brasserie/recettes), sélectionnez une recette et cliquez sur le menu"Dégustations reçues". ## **Comment ajouter ma dégustation à ma recette ?** Tout comme vos amis, vous avez le droit de donner votre avis sur le résultat de votre bière (c'est même essentiel pour se perfectionner). Pour effectuer votre dégustation, il vous suffit d'aller dans [Mes recettes](https://www.littlebock.fr/brasserie/recettes), de sélectionner une recette et de cliquer sur le bouton"Ajouter ma dégustation". Ce bouton sera caché si vous avez déjà effectué votre dégustation. ## **Est-ce que les dégustations récoltées sont publiques ?** Seule la partie"Impression générale" n'est pas publique. Cette partie est seulement destinée au brasseur de la recette afin que le dégustateur soit le plus objectif possible.\ En revanche, les autres perceptions du dégustateur seront publiques (apparence, arômes et sensations en bouche). ## **Comment voir toutes les dégustations que j'ai effectuées ?** Vous pouvez accéder à la liste de vos dégustations effectuées dans [Mes dégustations](https://www.littlebock.fr/brasserie/degustations). # Brasseurs ## **Comment retrouver un brasseur ?** Vous pouvez rechercher un brasseur dans [Brasseurs](https://www.littlebock.fr/brasseurs/). # Mon compte ## **Comment modifier mon mot de passe ?** Vous pouvez modifier votre mot de passe dans [Mon compte](https://www.littlebock.fr/profil/) en cliquant sur le bouton"Changer mot de passe". ## **Comment modifier mes préférences de notification ?** Vous pouvez modifier vos préférences de notification dans [Mon compte](https://www.littlebock.fr/profil/) en cliquant sur le bouton"Modifier profil". ## **Comment modifier mon adresse e-mail ou mon nom d'utilisateur ?** Vous pouvez modifier votre adresse e-mail ou votre nom d'utilisateur dans [Mon compte](https://www.littlebock.fr/profil/) en cliquant sur le bouton"Modifier profil". # Stock - Conditionnement ## Comment gérer mon stock pour le conditionnement des brassins ? Une vidéo explicative est disponible ici : \ Cette vidéo est un replay d'un live réalisé en collaboration avec Louis de La Caisse à outils.