Skip to content
A web application to manage flea markets in local communities.
Python HTML JavaScript CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
brocante
inscription
locale/fr/LC_MESSAGES
website
.env.example
.gitignore
Procfile
README.md
manage.py
requirements.txt
runtime.txt

README.md

Brocante

A web application to manage Flea Markets in small communities. It is intended to gather people from a community in a physical space to sell their unused items to other people that might find those items useful.

Features

  • Registration form to allow people to request one or more slots in the flea market.
  • Email automatically sent to the user when the registration is finished.
  • Confirmation of request of reservation by email.
  • Assignment of a reservation to a slot and details of the assignment sent by email.
  • Management of slots available.
  • Statistics of the ocupation.
  • Management of a waiting list.

How to Contribute

This project uses the stack Python / Django / PostgreSQL .

To use this project, follow these steps:

Create the database and the necessary permissions:

$ createdb brocante
$ createuser brocante_usr -P
$ psql -d brocante
  # grant connect on database brocante to brocante_usr;
  # revoke connect on database brocante from public;
  # alter user brocante_usr createdb;
  # \q

Clone the project locally from GitHub:

$ mkdir -R ~/python/projects
$ cd ~/python/projects
$ git clone https://github.com/htmfilho/brocante.git

Create a Python virtual environment on Linux:

$ cd brocante
$ python3 -m venv venv
$ source venv/bin/activate

or on Windows:

$ cd brocante
$ python -m venv venv
$ venv\Scripts\activate

Install the dependencies:

[venv] $ pip install -r requirements.txt

Create an .env file based on .env.example and set the environment variables:

[venv] $ cp .env.example .env

On Windows, use the following command:

[venv] $ copy .env.example .env

The following variables must be defined:

SECRET_KEY = ''
RECAPTCHA_PUBLIC_KEY = ''
RECAPTCHA_SECRET_KEY = ''
EMAIL_USE_SSL = True
EMAIL_HOST = ''
EMAIL_PORT = ''
EMAIL_HOST_USER = ''
EMAIL_HOST_PASSWORD = ''

Initialize the database and create a super user for the application:

[venv] $ python manage.py makemigrations
[venv] $ python manage.py migrate
[venv] $ python manage.py createsuperuser

gettext is required for the translation files. Make sure it's installed in your local machine. For Windows users, follow the instructions in the Django documentation. Compiling translations:

[venv] $ python manage.py makemessages -i venv
[venv] $ python manage.py compilemessages

Run the server:

[venv] $ python manage.py runserver

Visit the address http://localhost:8000 to view the registration form, and http://localhost:8000/admin for the administration console.

License: MIT

You can’t perform that action at this time.