Miroir du site de l'AE UTBM https://ae.utbm.fr
Go to file
2016-12-25 19:52:14 +01:00
accounting tests for accounting 2016-12-25 12:09:32 +01:00
api Fixed markdown api issue 2016-09-06 21:59:13 +02:00
club Add news moderation tool 2016-12-23 18:40:37 +01:00
com Clean migrations for news system 2016-12-24 02:12:46 +01:00
core Refactor elections 2016-12-25 19:52:14 +01:00
counter Prevent users that have never subscribed to subscribe on Eboutic 2016-12-20 23:27:54 +01:00
doc final correction 2016-11-07 01:53:32 +01:00
eboutic Prevent users that have never subscribed to subscribe on Eboutic 2016-12-20 23:27:54 +01:00
election Refactor elections 2016-12-25 19:52:14 +01:00
launderette Allow to delete a launderette slot 2016-12-15 16:11:43 +01:00
locale/fr/LC_MESSAGES Add notification with a fresh new 2016-12-23 20:11:27 +01:00
rootplace Big refactor: remove Subscriber class 2016-12-10 01:58:30 +01:00
sas Add overwrite mode and change compressed size width in picture resizing 2016-12-19 16:20:50 +01:00
sith Election bdd + first view 2016-12-25 19:52:14 +01:00
subscription Big refactor: remove Subscriber class 2016-12-10 01:58:30 +01:00
.gitignore Add Whoosh index 2016-12-20 14:46:08 +01:00
.gitlab-ci.yml Fix CI 2016-11-08 19:27:04 +01:00
CONTRIBUTING.md Fix contributing.md and fix quantity display on eticket 2016-11-06 23:15:43 +01:00
Doxyfile Update Doxyfile 2016-06-22 14:52:53 +02:00
LICENSE Add license 2016-06-21 00:42:33 +02:00
manage.py First commit: basic users 2015-11-18 09:44:06 +01:00
migrate.py Store file moderator 2016-12-12 17:23:06 +01:00
README.md README updated 2016-09-20 13:18:05 +02:00
requirements.txt Add Whoosh index 2016-12-20 14:46:08 +01:00
TODO.md Add basic refill support 2016-06-26 20:07:29 +02:00

Sith AE

Get started

To start working on the project, just run the following commands:

git clone https://ae-dev.utbm.fr/ae/Sith.git
cd Sith
virtualenv --clear --python=python3 env
source env/bin/activate
pip install -r requirements.txt
./manage.py setup

To start the simple development server, just run python3 manage.py runserver

Generating documentation

There is a Doxyfile at the root of the project, meaning that if you have Doxygen, you can run doxygen Doxyfile to generate a complete HTML documentation that will be available in the ./doc/html/ folder.

Dependencies:

See requirements.txt

You may need to install some dev libraries like libmysqlclient-dev, libssl-dev, libjpeg-dev, or zlib1g-dev to install all the requiered dependancies with pip. You may also need mysql-client.

The development is done with sqlite, but it is advised to set a more robust DBMS for production (Postgresql for example)

Misc about development

Controlling the rights

When you need to protect an object, there are three levels:

  • Editing the object properties
  • Editing the object various values
  • Viewing the object

Now you have many solutions in your model:

  • You can define a is_owned_by(self, user), a can_be_edited_by(self, user), and/or a can_be_viewed_by(self, user) method, each returning True is the user passed can edit/view the object, False otherwise.
    This allows you to make complex request when the group solution is not powerful enough.
    It's useful too when you want to define class-wide permissions, e.g. the club members, that are viewable only for Subscribers.
  • You can add an owner_group field, as a ForeignKey to Group. Second is an edit_groups field, as a ManyToMany to Group, and third is a view_groups, same as for edit.

Finally, when building a class based view, which is highly advised, you just have to inherit it from CanEditPropMixin, CanEditMixin, or CanViewMixin, which are located in core.views. Your view will then be protected using either the appropriate group fields, or the right method to check user permissions.