Skip to content

Latest commit

 

History

History
141 lines (99 loc) · 13.4 KB

README.md

File metadata and controls

141 lines (99 loc) · 13.4 KB
Raw
Open E-Label icon

GitHub License ASP.NET Core Docker Image Lokalise progress PRs Welcome

Open E-Label

Open-source solution for electronic labels on wine bottles.

The Open E-Label project aims to provide a standardized and open-source solution for QR Code labeling on products sold within the European Union. This initiative seeks to enhance transparency, efficiency, and information accessibility in the wine industry.

Electronic labels provide allergy, energy, ingredient and nutritional information to consumers.

We believe that technology to provide non-commercial nutrition information to benefit consumers should be made available for free.

🧾 Features

  • Electronic Labeling: Replacing traditional paper labels with electronic labels, promoting sustainability and reducing waste.
  • Multilingual Support: Ensuring labels can be displayed in multiple languages to accommodate diverse consumers within the EU.
  • Regulatory Compliance: Adhering to EU regulations regarding wine labeling, providing a platform that streamlines compliance for wineries.

📖 EU Regulations

Regulations (EU) of the European Parliament and of the Council:

  • EU 2021/2117 amending Regulations:
    • EU 1308/2013 establishing a common organisation of the markets in agricultural products
    • EU 1151/2012 on quality schemes for agricultural products and foodstuffs
    • EU 251/2014 on the definition, description, presentation, labelling and the protection of geographical indications of aromatised wine products (aromatised wine labelling)
    • EU 228/2013 laying down specific measures for agriculture in the outermost regions of the Union
  • EU 1169/2011 provision of food information to consumers (food labelling)
  • EU 2019/934 regards wine-growing areas where the alcoholic strength may be increased...
  • EU 2019/33 regards applications for protection of designations of origin, geographical indications and traditional terms in the wine sector

Notes

  • C/2023/1190 Questions and answers on the implementation of new EU wine labelling provisions
  • Guidance document Guidance document on the tolerances for nutrition labelling purposes
  • Guidance table Guidance document tolerances: Simplified summary table

📱How to Use

  1. Scan the QR code on the wine bottle with a QR code scanner.
  2. The E-label for the wine will be displayed on your device.
  3. You can switch between languages using the language selection option on the E-label.

🏃 Build & Run locally

To build the Open E-Label project using Visual Studio, follow these steps:

  1. Clone this repository to a local folder
  2. Open ELabel.sln solution with Visual Studio
  3. Build and start the project

🚀 Deployment

The web app can be deployed using the published Docker image. Here are the steps to run it with Docker compose:

1 Create a new directory and download docker-compose.yml sample:

mkdir elabel && cd elabel
wget https://raw.githubusercontent.com/filipecarneiro/ELabel/main/docker-compose.yml

2 Write your passwords to an .env file (change to your own passwords!):

echo "MSSQL_SA_PASSWORD=MyStrongPassword" >> .env
echo "ADMIN_PASSWORD=MyAdminPassword" >> .env

3 Start all containers:

docker-compose pull
docker-compose up -d

4 View Logs:

docker-compose logs -f

db will take some time in the first start, so the app will restart a couple of times. Be patient!

When you see something like Now listening on: http://[::]:8080 on the log, open your browser with the server name or IP address.

🙋 Contributing

Contributions are welcome! Please read our contributing guidelines before getting started.

Translation

Translations for Open E-Label are managed through Lokalise, an online translation management tool.

Click the link below to join the project! Even if your language is completely translated, extra proofreading is a big help! Please feel free to review the existing translations, and vote for alternatives that might be more appropriate.

For more information about the translation editor and tools, please see the Lokalise translate and collaborate documents.

Translations are downloaded from Lokalise on every release. Check the current localization statistics.

⚖️ License

Open E-Label is open-source under the MIT license. See the LICENSE file for more information.