Presentation

This project provides an on-the-fly point of sale that can be deployed anywhere where a power plug is available. It targets small events such as village fairs that happen to run once a year. The initial focus is to sell food and drinks through tickets that will then be exchanged at the different desks.

The project is build on top of the Raspberry Pi 3 and support all printers that are supported by the python-escpos library.

Documentation

Version numbers

This software uses Semantic Versioning v2.0.0. Version numbers are of the form:

MAJOR.MINOR.PATCH

MAJOR increases with backwards-incompatible API changes.
MINOR increases with functionality added in a backwards-compatible manner.
PATCH increases with backwards-compatible bug fixes.

Any part may also be incremented freely at any time for any reason.

Note: MAJOR version 0 is for initial development and does not follow the MINOR and PATCH schema. Do not expect any stability during this period.

Contributing

Branching

The development of this project follows Vincent Driessen's git branching model.

Note: Initial development (MAJOR version 0) does not follow this branching model. Only the master branch is used.

Commit messages

Git commit messages are better if they follow Tim Pope's recommendations.

Pull requests

Simple changes must be squashed in one commit. Bigger changes may be split over more than one commit, but this kind of changes should be discussed beforehand anyway.

Contributions will be reviewed by the maintainer, who will decide to include it or not, and who may ask for changes in order to keep the project consistent.

Commit messages may be reworded before being merged. Original author's name will be kept and commit will be signed-off. The author name will be added to the list of contributors.

License

This software is licensed under the term of the GPL v3.0 license:

raposfly, a Raspberry Pi Point of Sale on the Fly.
Copyright (C) 2016 Fabien Dubosson <fabien.dubosson@gmail.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

See LICENSE.md for the complete license.

Legal