next.filmfest.by

Welcome to the workplace for upcoming website for Cinema Perpetuum Mobile short film festival. Our goal is to gracefully replace the existing version with new code feature by feature.

Join our chat https://riot.im/app/#/room/#cpm-dev:matrix.org for questions.

The goal of new website version is to create a user-friendly admin panel for festival volunteers. The feature set is taken from the experience we've gathered during previous festivals.

How to join development and be a part of CPM movement

We welcome all contributors and enhancements that help to make this tool for festival to be awesome. Feel free to jump in and help with things to your liking.

Your freedom is your creativity - being it good design, some bits of code, or another contribution that helps to push the movement. Making a film festival together is a great thing on its own, but to make it worth your time even more we've choosen UNLICENSE to make sure that you can reuse the bits we've created together without restrictions and limitations - being it your commercial projects or open source. If you wanted to learn about programming or creating websites to get a job - that might be your chance.

For experienced, the most straightforward areas to contribute are:

backend written in Django / Wagtail
frontend - a lot can be done here
design / styling
data migration (organize data related to previous festivals in JSON)

Communication

Chat - https://riot.im/app/#/room/#cpm-dev:matrix.org
Board of Chaos- https://trello.com/b/6S00yyl1/next-filmfest-by-public
Meeting Follow Ups (notes, sources for Trello)
- https://github.com/kinaklub/docs/blob/master/MFU_2016_07_19_filmfest.by.md
- https://github.com/kinaklub/docs/blob/master/MFU_2016_07_21_filmfest.by.md

Technology stack

Programming:
- Wagtail
  - Django
    - Python
      - pip/tox/virtualenv
    - HTML5/CSS
    - JavaScript

Deployment:
- Docker Compose
  - Docker
    - Digital Ocean
      - SSH
      - HAProxy
      - PostgreSQL
      - Elasticsearch

Development process

We use github for development. In order to start one needs to fork and clone the repository:

fork kinaklub/next.filmfest.by using github UI

clone forked repository to one's local machine:

git clone git@github.com:yourusername/next.filmfest.by.git

add upstream repository as a remote:

git remote add upstream git@github.com:kinaklub/next.filmfest.by.git

Before starting working on next improvement one usually does the following:

switch to local master:
```
git checkout master
```
pull recent changes from upstream master:
```
git pull upstream master
```
create a new feature branch:
```
git checkout -b branch_name
```
create corresponding branch in one's fork:
```
git push -u origin branch_name
```

After commiting everything to the feature branch one usually does the following:

push the changes to one's fork:
```
git push
```
create a pull request using github UI.

PR review process:

we use Travis CI for launching tests on PRs
we don't merge PRs to master until tests are green
we require the PRs to be reviewed by at least one team member
reviewer adds comment "LGTM" when one think the PR is good to be merged
PRs are usually merged by the authors

Development environment

Install Docker and docker-compose
Don't forget to set DOCKER_HOST environmental variable or add yourself to group docker
Start web contatiner:
```
docker-compose up web
```
Give postgres 20-30 seconds to initialize
Create a local user:
```
docker-compose run web createsuperuser
```
Visit http://127.0.0.1:8000/ in your web browser

Recreating development environment

If one wants to recreate their development environment from scratch and one doesn't care about the existing data in database, one needs to:

stop all the containers:
```
docker-compose stop
```
remove containers
```
docker-compose rm -r
```
rebuild images
```
docker-compose build
```
use quickstart guide above for setting up the development environment

Testing code

The command below is usually enough for local testing:

docker-compose run web test

If Python dependencies have changed recently, one might need to add paramter -r once:

docker-compose run web test -r

staaas/next.filmfest.by