opinions-assemble

A server app that allows registering attendees to an assembly and facilitates voting for motions presented.

A server app that allows registering attendees to an assembly and facilitates voting for motions presented.

Installation

Requisites

• PHP 5.6.4 or higher
• PHP Extensions:
  • OpenSSL
  • PDO
  • Mbstring
  • Tokenizer
  • XML
• Composer 1.4 or later (be sure to follow the instructions to install
• A MySQL or MariaDB database server running. (It could work on PostgreSQL, but it hasn't been tested.)

OS X & Linux:

1. Download the latest release https://github.com/andresrs/opinions-assemble/releases.
2. Unzip the package.
3. Copy .env.example to .env and modify it to match the configuration of the server.
4. Upload the contents of the folder to your server.
5. Run the install.sh script.
6. Configure a cron job to run the following command php /path/to/your/project/artisan schedule:run >> /dev/null 2>&1.
7. Access it through the HTTP server address. For example, http://yourserver.tld/ or http://127.0.0.1/
8. Head to http://yourserver.tld/install and follow the instructions.
9. Create and upload a CSV file containing the following columns:
   1. Name
   2. ID that will be used to identify the attendees
   3. E-mail that the attendees may receive messages

Troubleshooting

• Make sure the storage folder and everything in it is writable by the web server user.
• Make sure to configure or disable SELinux.

Development setup

Currently using a basic Lando development setup. After installing it, just run lando start.

When jobs are waiting to run, manually run lando php artisan queue:work --once

Release History

• 1.0
  • Upload attendee list
  • Register attendees that arrive at the assembly
  • Attendees sign in to vote on motions presented
  • Present motions to be voted on
    • Attendees will have 20 minutes to submit their votes
  • Show results for all the motions voted

Resources

• How to write a great README for your GitHub project by Dan Bader
• HTML5Boilerplate and http://www.initializr.com/.
  • Updated to jQuery 3.2.1 and Bootstrap 3.3.7.
• Laravel 5.4 from scratch

Meta

Andres Rosado - [email protected]

Distributed under the BSD 3-clause license. See LICENSE for more information.

https://github.com/andresrs/opinions-assemble