Aller au contenu

Click

CounterClick

Bases: CounterTabsMixin, UseFragmentsMixin, CanViewMixin, SingleObjectMixin, FormView

The click view.

This page is reached from the counter main page, after selecting the user who is purchasing stuff.

Counter access

Who can perform barman actions depends on the type of the counter :

  • for eboutic counters, no barman access at all is granted ; it's just a 404, as there should be only one eboutic, accessible only at /eboutic/
  • office counters are accessible to the board members of the club owning the counter and to users that have been explicitly added to the sellers of this counter.
  • bar counters are accessible to users that have been added to the counter sellers and that are currently logged as barmen on the current device.

The bar case is really tricky, as it doesn't use the usual django auth backend. Barmen must not be logged in as regular users, but as barmen, granting the session some special privileges, even in the case where no regular user is logged in.

This is because of two reasons :

  • we track the barmen connection, for logging, statistics and dick contest purposes. We want to know who was barman, where and when, as barmen are accountable of what happens during their duty.
  • multiple users must be able to log on the same device, while keeping the session anonymous. The bar PC must be a reliable way for any barman to click users, but without requiring a user session. Just imagine if someone who is superuser had to log in with all its privileges on a device everyone can access.

Available items

A counter can have multiple products. A product can have multiple prices. To select what the user can buy, we select all the prices that can be applied to the current customer, among the products of the counter. The price selection logic is described in PriceQuerySet.

On top of that, some additional rules are applied, because alcohol can be sold on counters :

The minor barman case is a little bit unclear, legally speaking, as barmen are volunteers, but the law speaks only of employees and interns. As such, we don't apply the law to its full extent. It would be harsh for young students not to be able to be barmen at the MDE, where no alcohol at all is sold during daytime. However, we restrict items that can be sold as a token of good will.

get_context_data(**kwargs)

Add customer to the context.

Source code in counter/views/click.py 
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
def get_context_data(self, **kwargs):
    """Add customer to the context."""
    kwargs = super().get_context_data(**kwargs)
    kwargs["prices"] = self.prices
    kwargs["formulas"] = ProductFormula.objects.filter(
        result__in=[p.product_id for p in self.prices]
    ).prefetch_related("products")
    kwargs["categories"] = defaultdict(list)
    for price in self.prices:
        kwargs["categories"][price.product.product_type].append(price)
    kwargs["customer"] = self.customer
    kwargs["cancel_url"] = self.get_success_url()

    # To get all forms errors to the javascript, we create a list of error list
    kwargs["form_errors"] = [
        list(field_error.values()) for field_error in kwargs["form"].errors
    ]
    return kwargs

RefillingCreateView

Bases: FragmentMixin, CreateView

This is a fragment only view which integrates with counter_click.jinja