BEEP is a combination of a bee monitoring (Laravel PHP) framework API + an (Angular JS) app and a (Influx) time series sensor data database. There are also first steps of creating cost efficient measurement hardware.
It's key feature is to integrate a user friendly responsive app for manual inspections with automatically measured sensor data.
Create a login and check the live app at: https://app.beep.nl
You are free to use the BEEP app, it's free and it will be developed further in the near future. If you would like to install it on your own server, or contribute; please read on below.
git clone https://github.com/pvgennip/BEEP.git
Make sure these dependencies are installed on your system:
- Composer - Installation tool for PHP/Laravel dependencies for API
- npm - Installation tool for Javascript/Angular dependencies for App
- Bower
npm install -g bower- Installation tool for front-end dependencies for App
Make the run_actions.sh executable by chmod +x run_actions.sh
Then run it: ./run_actions.sh
This will install all the packages and vendor dependencies that you need at once.
a. Make sure to add your repo to git remote: git remote set url https://github.com/pvgennip/BEEP.git
b. Run ./deploy.sh to update your clone on any server
API
<VirtualHost api.beep.nl:80>
DocumentRoot /var/www/bee/public
ServerName "api.beep.nl"
<Directory /var/www/bee/public/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>
APP
<VirtualHost app.beep.nl:80>
DocumentRoot /var/www/bee/public/webapp
ServerName "app.beep.nl"
<Directory /var/www/bee/public/webapp/>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>
Thank you for considering contributing to the BEEP framework! If you would like to contribute, please fork this repository, edit on your Github account, and finally send Pull Requests to this repository to include new features.
a. Fork this repo
b. Copy /public/webapp/js/lang/en.js to the abbreviation of the new language
c. Translate the part after the colons (:) only: static_language_var: 'this is the translation',
d. Add the language to /public/webapp/index.js supported locales:
$rootScope.supportedLocales = {
"nl":"Nederlands",
"en":"English",
"xx":"New language",
};
e. Create a pull request to merge the language into this repo
Please request access to https://trello.com/b/Eb3CcKES/beep-hive-check-app if you would like to see the roadmap and cooperate.
-
Manual inspection improvement (2018 Q1)
-
Inspection item list dynamically assignable (2018 Q1)
-
Sharing of data amongst bee keepers (in vicinity) (2018 Q2)
-
Hardware weighing scale + audio measurement kit development (2018 Q2+Q3)
-
Integration sensor data / hive inspections (2018 Q3+Q4)
Documentation and manual of the app can be found at http://beep.nl.
If you discover a security vulnerability within BEEP, please send an e-mail to beep@iconize.nl.
The BEEP framework is open-sourced software licensed under the GNU AGPLv3 license.