Miroir du site de l'AE UTBM https://ae.utbm.fr
Go to file
Skia 87295ad9b7
Galaxy improvements (#628)
* galaxy: improve logging and performance reporting

* galaxy: add a full galaxy state test

* galaxy: optimize user self score computation

* galaxy: add 'generate_galaxy_test_data' command for development at scale

* galaxy: big refactor

Main changes:
  - Multiple Galaxy objects can now exist at the same time in DB. This allows for ruling a new galaxy while still
    displaying the old one.
  - The criteria to quickly know whether a user is a possible citizen is now a simple query on picture count. This
    avoids a very complicated query to database, that could often result in huge working memory load. With this change,
    it should be possible to run the galaxy even on a vanilla Postgres that didn't receive fine tuning for the Sith's
    galaxy.

* galaxy: template: make the galaxy graph work and be usable with a lot of stars

- Display focused star and its connections clearly
- Display star label faintly by default for other stars to avoid overloading the graph
- Hide non-focused lanes
- Avoid clicks on non-highlighted, too far stars
- Make the canva adapt its width to initial screen size, doesn't work dynamically

* galaxy: better docstrings

* galaxy: use bulk_create whenever possible

This is a big performance gain, especially for the tests.

Examples:

----

`./manage.py test galaxy.tests.GalaxyTest.test_full_galaxy_state`

Measurements averaged over 3 run on *my machine*™:
Before: 2min15s
After: 1m41s

----

`./manage.py generate_galaxy_test_data --user-pack-count 1`

Before: 48s
After: 25s

----

`./manage.py rule_galaxy` (for 600 citizen, corresponding to 1 user-pack)

Before: 14m4s
After: 12m34s

* core: populate: use a less ambiguous 'timezone.now()'

When running the tests around midnight, the day is changing, leading to some values being offset to the next day
depending on the timezone, and making some tests to fail. This ensure to use a less ambiguous `now` when populating
the database.

* write more extensive documentation

- add documentation to previously documented classes and functions and refactor some of the documented one, in accordance to the PEP257 and ReStructuredText standards ;
- add some type hints ;
- use a NamedTuple for the `Galaxy.compute_users_score` method instead of a raw tuple. Also change a little bit the logic in the function which call the latter ;
- add some additional parameter checks on a few functions ;
- change a little bit the logic of the log level setting for the galaxy related commands.

* galaxy: tests: split Model and View for more efficient data usage

---------

Co-authored-by: maréchal <thgirod@hotmail.com>
2023-05-10 12:47:02 +02:00
.github Speed up tests (#638) 2023-05-02 11:00:23 +02:00
accounting Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
api Mise à jour de Black vers la version 23.3 (#629) 2023-04-22 15:32:31 +02:00
club [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
com Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
core Galaxy improvements (#628) 2023-05-10 12:47:02 +02:00
counter [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
doc Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
eboutic Speed up tests (#638) 2023-05-02 11:00:23 +02:00
election Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
forum Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
galaxy Galaxy improvements (#628) 2023-05-10 12:47:02 +02:00
launderette Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
locale/fr/LC_MESSAGES [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
matmat upgrade re_path to path (#533) 2023-01-09 22:07:03 +01:00
pedagogy [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
rootplace [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
sas [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
sith [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
stock Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
subscription Better usage of cache for groups and clubs related operations (#634) 2023-05-02 12:36:59 +02:00
trombi [FIX] Correction de bugs (#617) 2023-05-02 13:07:36 +02:00
.coveragerc coverage: blacklist some files 2017-09-07 11:50:05 +02:00
.envrc Using poetry as a dependency system for development 2021-10-15 16:12:56 +00:00
.gitattributes Add mappings for .po and .jinja files 2019-04-22 18:20:22 +02:00
.gitignore Galaxy improvements (#628) 2023-05-10 12:47:02 +02:00
.mailmap refonte de la boutique en ligne 2022-10-30 12:33:21 +01:00
.readthedocs.yml [FIX] Broken link in readme and license fix (& update) (#591) 2023-04-04 18:39:45 +02:00
CONTRIBUTING.rst documentation: add CONTRIBUTING 2019-10-08 11:08:47 +02:00
LICENSE Apply GPLv3 to Sith, and add header to every concerned file 2017-04-24 17:51:12 +02:00
manage.py [FIX] Broken link in readme and license fix (& update) (#591) 2023-04-04 18:39:45 +02:00
poetry.lock [UPDATE] Bump sentry-sdk from 1.19.1 to 1.21.0 2023-04-26 09:08:06 +00:00
pyproject.toml [UPDATE] Bump sentry-sdk from 1.19.1 to 1.21.0 2023-04-26 09:08:06 +00:00
README.md [FIX] Broken link in readme and license fix (& update) (#591) 2023-04-04 18:39:45 +02:00

This is the source code of the UTBM's student association available at https://ae.utbm.fr/.

All documentation is in the docs directory and online at https://sith-ae.readthedocs.io/. This documentation is written in French because it targets a French audience and it's too much work to maintain two versions. The code and code comments are strictly written in English.

If you want to contribute, here's how we recommend to read the docs:

  • First, it's advised to read the about part of the project to understand the goals and the mindset of the current and previous maintainers and know what to expect to learn.

  • If in the first part you realize that you need more background about what we use, we provide some links to tutorials and documentation at the end of our documentation. Feel free to use it and complete it with what you found helpful.

  • Keep in mind that this documentation is thought to be read in order.

This project is licensed under GNU GPL, see the LICENSE file at the top of the repository for more details.