The Open Event Organizer Server to Manage Events https://open-event-dev.herokuapp.com
Python HTML CSS JavaScript Shell RobotFramework
Permalink
Failed to load latest commit information.
app Add staging config for staging server & cleanup config Jan 23, 2017
docs Changes in commands for bower installation (#2956) Jan 18, 2017
kubernetes Add staging config for staging server & cleanup config Jan 23, 2017
migrations Add staging config for staging server & cleanup config Jan 23, 2017
requirements Update python-pentabarf-xml version Jan 12, 2017
scripts Auto push docs to gh-pages Jan 12, 2017
static Fix storage and gitignore Nov 25, 2016
tests Add staging config for staging server & cleanup config Jan 23, 2017
.bowerrc removed extra contents in .bowerrc Jan 8, 2017
.codeclimate.yml Update references to open_event into app Jul 18, 2016
.coveragerc added .coveragerc, hope to fix coveralls coverage issue (#287) May 12, 2016
.csslintrc chore: add code climate and lint configs Apr 17, 2016
.dockerignore Ignoring test results Aug 19, 2016
.editorconfig add html, js and css configs Jul 19, 2016
.env added docker-compose file, server is running Aug 17, 2016
.eslintignore chore: add code climate and lint configs Apr 17, 2016
.eslintrc chore: add code climate and lint configs Apr 17, 2016
.gitignore Clean up repository root Nov 28, 2016
.travis.yml Added staging branch doc and deploy scripts Jan 21, 2017
Dockerfile improve dockerfile and reduce layers Dec 18, 2016
LICENSE.md add GPLv3 license May 31, 2015
Procfile Re-arrange scripts Nov 28, 2016
README.md Added staging branch doc and deploy scripts Jan 21, 2017
Vagrantfile Changed the length from float to string (#2705) Dec 23, 2016
app.json Re-structure views/routes & cleanup Dec 2, 2016
babel.cfg Implementation of I18N Oct 16, 2016
bower.json Start ticket sales according to event timezone (#2822) Jan 3, 2017
config.py Add staging config for staging server & cleanup config Jan 23, 2017
create_db.py Issue #2867: Fixed invalid argument error in method. Jan 9, 2017
docker-compose.yml added SERVER_NAME config in Docker and updated docs Aug 23, 2016
drop_db.py Update references to open_event into app Jul 18, 2016
manage.py Re-structure views/routes & cleanup Dec 2, 2016
package.json Bump version to 1.0.0-alpha Dec 21, 2016
populate_db.py Add staging config for staging server & cleanup config Jan 23, 2017
requirements.txt Updated Heroku docs, fixed heroku build (#333) May 20, 2016
runtime.txt Updated Heroku docs, fixed heroku build (#333) May 20, 2016

README.md

Open Event Orga Server

The Open Event Orga Server enables organizers to manage events from concerts to conferences and meet-ups. It offers features for events with several tracks and venues. Event managers can create invitation forms for speakers and build schedules in a drag and drop interface. The event information is stored in a database. The system provides API endpoints to fetch the data, and to modify and update it. Organizers can import and export event data in a standard compressed file format that includes the event data in JSON and binary media files like images and audio.

GitHub release Build Status Travis branch Gemnasium Coveralls branch Codacy branch grade Codecov branch Gitter

Communication

Please join our mailing list to discuss questions regarding the project: https://groups.google.com/forum/#!forum/open-event

Our chat channel is on Gitter here: gitter.im/fossasia/open-event-orga-server

Demo version

A demo version is automatically deployed from our repositories:

Installation

The Open Event Orga Server can be easily deployed on a variety of platforms. Detailed platform specific installation instructions have been provided below.

  1. Generic Installation Instructions
  2. Local Installation
  3. Vagrant Installation
  4. Deployment on Google Compute Engine
  5. Deployment on Google Container Engine (Kubernetes)
  6. Deployment on AWS EC2
  7. Deployment on Digital Ocean
  8. Deployment with Docker
  9. Deployment on Heroku

One-click Heroku deployment is also available:

Deploy

Technology Stack

Please get familiar with the components of the project in order to be able to contribute.

Components

External Service Dependencies

OAuth Social Authentication

OAuth is used to get information from Facebook and Google accounts, that enables users to sign in with their respective credentials:

  1. Google - https://accounts.google.com/o/oauth2/auth
  2. Facebook - https://graph.facebook.com/oauth

Twitter

Twitter feed integration is provided in the public event pages.

Required keys can be obtained from https://dev.twitter.com/overview/documentation

Instagram

It is possible to extend the functionality and offer images from Instagram in the event service.

Required keys can be obtained from https://www.instagram.com/developer/authentication/.

Google Maps

Google maps is used to get information about location (info about country, city, latitude and longitude).

Required keys can be obtained from https://maps.googleapis.com/maps/api.

Media Storage - Local/Amazon S3/Google Cloud

Media (like audio, avatars and logos) can be stored either Locally or on Amazon S3 or on Google Storage.

  1. Amazon S3 Setup Instructions
  2. Google Cloud Setup Instructions

Emails - SMTP/Sendgrid

The server can send emails via SMTP or using the sendgrid API.

  1. SMTP can be configured directly at admin/settings
  2. Obtaining Sendgrid API Token.

Heroku API

If the application is deployed on Heroku, we use the heroku API to obtain the latest release and also to display the heroku.

Required token can be obtained from https://devcenter.heroku.com/articles/authentication.

Payment Gateways

For ticket sales the service integrates payment gateways:

  1. Stripe - Obtaining Keys.
  2. Paypal - Obtaining Credentials.

Data Access

REST API

The Open Event Orga Server exposes a well documented REST API that can be used by external services (like the Open Event App generators for example) to access the data.

API Documentation:

Import & Export

Import:

Open Event Orga server supports multiple formats as a valid source for import.

  • A zip archive with JSON (matching the API structure) and binary media files. Read more about this here.
  • The Pentabarf XML format is also supported as a valid import source. (Sample file).

Export:

The event data and the sessions can be exported in various formats.

  • A zip archive with JSON (matching the API structure) and binary media files. Read more about this here.
  • The Pentabarf XML format. (Sample file).
  • The iCal format. (Sample file).
  • The xCal format. (Sample file).

Roles

The system has two kind of role type.

  1. System roles are related to the Open Event organization and operator of the application.
  2. Event Roles are related to the users of the system with their different permissions.

Read more here.

Development

Development Mode

To enable development mode (development Flask config), set APP_CONFIG environment variable to "config.DevelopmentConfig".

export APP_CONFIG=config.DevelopmentConfig

Model updates & migrations

When writing changes to models. Use migrations.

 # To generate a migration after doing a model update
 python manage.py db migrate

 # To sync Database
 python manage.py db upgrade

 # To rollback
 python manage.py db downgrade

When checking in code for models, please update migrations as well.

Testing

Clone the repo and set up the server according to the steps listed. Make sure you have installed are the dependencies required for testing by running

pip install -r requirements/tests.txt

Running unit tests

  • Open Event uses Postgres database for testing. So set DATABASE_URL as a postgres database. Here is an example.
export DATABASE_URL=postgresql://test_user:test@127.0.0.1:5432/opev_test
# format is postgresql://USERNAME:PASSWORD@ADDRESS/DATABASE_NAME
export APP_CONFIG=config.TestingConfig
  • Then go to the project directory and run the following command:
python -m unittest discover tests/unittests/
  • It will run each test one by one.

  • You can also use the following command to run tests using nosetests:

nosetests tests/unittests/

Running robot framework tests

  • Make sure you have FireFox installed
  • Start your local flask server instance.
  • Go to the project directory and Run the tests by using the following command.
robot -v SERVER:{server_name} -v SUPERUSER_USERNAME:{super_user_email_here} -v SUPERUSER_PASSWORD:{super_user_password} tests/robot

Change all the parameters inside {} as per your local server. The final command would look like:

robot -v SERVER:localhost:5000 -v SUPERUSER_USERNAME:test@opev.net -v SUPERUSER_PASSWORD:test_password tests/robot
  • Once the tests are completed, a report and a log would be generated at report.html and log.html respectively in your root directory.

Logging

Certain information is being logged and stored in the database for future reference, resolving conflicts in case of hacks and for maintaining an overview of the system. Read more about logging here.

Internalization (i18n)

Translation status

Open Event is being translated using Weblate, a web tool designed to ease translating for both developers and translators.

If you would like to contribute to translation of Open Event, you need to register on this server.

Once you have activated your account just proceed to the translation section.

Contributions, Bug Reports, Feature Requests

This is an Open Source project and we would be happy to see contributors who report bugs and file feature requests submitting pull requests as well. Please report issues here https://github.com/fossasia/open-event-orga-server/issues

Branch Policy

We have the following branches

  • development All development goes on in this branch. If you're making a contribution, please make a pull request to development. PRs to must pass a build check and a unit-test check on Travis (https://open-event-dev.herokuapp.com - Is running off the development branch. It is hosted on Heroku.)
  • master This contains shipped code. After significant features/bug-fixes are accumulated on development, we make a version update, and make a release. (https://eventyay.com - Is running off the master branch. (whichever is the latest release.) Hosted on Google Cloud Platform (Google Container Engine + Kubernetes).)
  • staging This branch is mainly for testing eventyay server configurations on a staging server without affecting the production environment. Push access is restricted to the devops team.
  • gh-pages This contains the documentation website on http://dev.eventyay.com. The site is build automatically on each commit in the development branch through a script and using travis. It includes the md files of the Readme and /docs folder. It also includes javadocs.

Release Policy

The tentative release policy for now is, (since there is a lot of activity and a lot of bugs), an alpha release every monday and friday (since we see more activity on weekends). So, any bug-fixes will not be reflected at eventyay.com until a new release is made in the master branch.

Contributions Best Practices

Commits

  • Write clear meaningful git commit messages (Do read http://chris.beams.io/posts/git-commit/)
  • Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (More info at https://github.com/blog/1506-closing-issues-via-pull-requests )
  • When you make very very minor changes to a PR of yours (like for example fixing a failing travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterwards so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at https://davidwalsh.name/squash-commits-git )
  • When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.

Feature Requests and Bug Reports

  • When you file a feature request or when you are submitting a bug report to the issue tracker, make sure you add steps to reproduce it. Especially if that bug is some weird/rare one.

Join the development

  • Before you join development, please set up the system on your local machine and go through the application completely. Press on any link/button you can find and see where it leads to. Explore. (Don't worry ... Nothing will happen to the app or to you due to the exploring 😉 Only thing that will happen is, you'll be more familiar with what is where and might even get some cool ideas on how to improve various aspects of the app.)
  • Test the application on your machine and explore the admin area. The test deployment on Heroku will not give you access to the admin section, where you can switch on/off modules, e.g. ticketing and add keys for services, e.g. storage on S3.
  • If you would like to work on an issue, drop in a comment at the issue. If it is already assigned to someone, but there is no sign of any work being done, please free to drop in a comment so that the issue can be assigned to you if the previous assignee has dropped it entirely.

License

This project is currently licensed under the GNU General Public License v3. A copy of LICENSE.md should be present along with the source code. To obtain the software under a different license, please contact FOSSASIA.