3 \'@sddlmZddlmZddlmZmZddlmZddl m Z ddl m Z ddlmZddlmZdd lmZGd d d ejZGd d d ejZGdddejZdS))Decimal) exceptions)models transaction)Sum)timezone) gettext_lazy)get_unused_code)AUTH_USER_MODEL) get_modelc seZdZdZejedddZejeddZ ej eddd Z ej ed dZ ejd d Zejed ZejedZejddedddiejd d dZGdddZddZddZddZd(ddZfd d!Zed"d#Zed$d%Zed&d'ZZS))AbstractVoucherSeta)A collection of vouchers (potentially auto-generated) a VoucherSet is a group of voucher that are generated automatically. - count: the minimum number of vouchers in the set. If this is kept at zero, vouchers are created when and as needed. - code_length: the length of the voucher code. Codes are by default created with groups of 4 characters: XXXX-XXXX-XXXX. The dashes (-) do not count for the code_length. - start_datetime, end_datetime: defines the validity datetime range for all vouchers in the set. Named) verbose_name max_lengthzNumber of vouchers)rzLength of Code )rdefault DescriptionT) auto_now_addzStart datetimez End datetimezoffer.ConditionalOffer voucher_setOffer offer_typeVoucher) related_namerlimit_choices_to on_deletenullblankc@s(eZdZdZdZdZedZedZdS)zAbstractVoucherSet.MetaTvoucher date_created VoucherSetZ VoucherSetsN) __name__ __module__ __qualname__abstract app_label get_latest_by_rverbose_name_pluralr)r)=/var/www/html/oscar2019/oscar/apps/voucher/abstract_models.pyMeta.s r+cCs|jS)N)name)selfr)r)r*__str__5szAbstractVoucherSet.__str__cCs,|jj}xt||jD] }|jqWdS)zGenerate vouchers for this setN)voucherscountrangeadd_new)r-Z current_countir)r)r*generate_vouchers8s z$AbstractVoucherSet.generate_voucherscCsNtdd}t|jd}|jj|j|||j|j|jd}|j rJ|j j |j |S)zAdd a new voucher to this setrr)length)r,coderusagestart_datetime end_datetime) r r code_lengthobjectscreater, SINGLE_USEr8r9offeroffersadd)r-rr6rr)r)r*r2>s   zAbstractVoucherSet.add_newNcCs(|p tj}|j|ko"|jkSS)z3Test whether this voucher set is currently active. )rnowr8r9)r- test_datetimer)r)r* is_activeOs zAbstractVoucherSet.is_activec sVt|j|jj|_tj0tj|||j|jj|j |j dWdQRXdS)N)r8r9) maxr0r/ratomicsupersaver4updater8r9)r-argskwargs) __class__r)r*rGTs zAbstractVoucherSet.savecCs|jjtdd}|dS)Nnum_basket_additions)resultrM)r/ aggregater)r-valuer)r)r*rL^sz'AbstractVoucherSet.num_basket_additionscCs|jjtdd}|dS)N num_orders)rMrM)r/rNr)r-rOr)r)r*rPcszAbstractVoucherSet.num_orderscCs|jjtdd}|dS)Ntotal_discount)rMrM)r/rNr)r-rOr)r)r*rQhsz!AbstractVoucherSet.total_discount)N) r!r"r#__doc__r CharFieldr'r,PositiveIntegerFieldr0 IntegerFieldr: TextField description DateTimeFieldrr8r9 OneToOneFieldCASCADEr>r+r.r4r2rCrGpropertyrLrPrQ __classcell__r)r))rKr*r s,     r cseZdZdZejeddeddZejeddddedd Zej d d ed d didZ d;\Z Z Z e edfe edfe edffZejeddee dZejedZejedZejedddZejedddZejeddd ed!d"Zejd#ddd ejd$Zejdd%ZGd&d'd'Zd(d)Zd*d+Zfd,d-Z dAbstractVouchera. A voucher. This is simply a link to a collection of offers. Note that there are three possible "usage" modes: (a) Single use (b) Multi-use (c) Once per customer Oscar enforces those modes by creating VoucherApplication instances when a voucher is used for an order. r zIThis will be shown in the checkout and basket once the voucher is entered)r help_textCodeTz$Case insensitive / No spaces allowed)rdb_indexuniquer_zoffer.ConditionalOfferr/Offersrr)rrr Single use Multi-useOnce per customerz Can be used once by one customerz0Can be used multiple times by multiple customersz"Can only be used once per customerZUsage)rchoicesrzStart datetimez End datetimezTimes added to basketr)rzTimes on orderszTotal discountrz0.00)decimal_places max_digitsrzvoucher.VoucherSet)rrrr)rc@s(eZdZdZdZdZedZedZdS)zAbstractVoucher.MetaTrrrVouchersN) r!r"r#r$r%r&r'rr(r)r)r)r*r+s r+cCs|jS)N)r,)r-r)r)r*r.szAbstractVoucher.__str__cCs,t|j|j|j|jkgr(tjtddS)Nz(End date should be later than start date)allr8r9rValidationErrorr')r-r)r)r*cleans zAbstractVoucher.cleancs|jj|_tj||dS)N)r6upperrFrG)r-rIrJ)rKr)r*rGs zAbstractVoucher.saveNcCs(|p tj}|j|ko"|jkSS)z@ Test whether this voucher is currently active. )rrAr8r9)r-rBr)r)r*rCs zAbstractVoucher.is_activecCstj}|j|kS)zJ Test whether this voucher has passed its expiration date )rrAr9)r-rAr)r)r* is_expiredszAbstractVoucher.is_expiredcCsd\}}|j|jkr.|jj }|std}nT|j|jkr@d}nB|j|jkr|js`d}td}n"|jj||dj }|std}||fS) z Test whether this voucher is available to the passed user. Returns a tuple of a boolean for whether it is successful, and a availability message. Fz"This voucher has already been usedTz1This voucher is only available to signed in users)ruserz6You have already used this voucher in a previous order)Frq) r7r= applicationsexistsr' MULTI_USEONCE_PER_CUSTOMERis_authenticatedfilter)r-rr is_availablemessager)r)r*is_available_to_users"     z$AbstractVoucher.is_available_to_usercCsD|jr|jj|||dn|jj||d|jd7_|jdS)z> Records a usage of this voucher in an order. )rorderrr)rr|N)rwrsr<rPrG)r-r|rrr)r)r* record_usages zAbstractVoucher.record_usagecCs|j|d7_|jdS)z= Record a discount that this offer has given discountN)rQrG)r-rr)r)r*record_discountszAbstractVoucher.record_discountcCs|jjdjS)z Returns the first offer's benefit instance. A voucher is commonly only linked to one offer. In that case, this helper can be used for convenience. r)r?rlbenefit)r-r)r)r*rszAbstractVoucher.benefit)rdrerf)N)N)*r!r"r#rRrrSr'r,r6ManyToManyFieldr?r=rurvZ USAGE_CHOICESr7rXr8r9rTrLrP DecimalFieldrrQ ForeignKeyrZrrr+r.rnrGrCrpr{r~ alters_datarr[rr\r)r))rKr*r]nsL                r]c@szeZdZdZejdejdeddZeje ddejeddZ ejd ejed d Z ej dd Z Gd ddZddZdS)AbstractVoucherApplicationz For tracking how often a voucher has been used in an order. This is used to enforce the voucher usage mode in Voucher.is_available_to_user, and created in Voucher.record_usage. zvoucher.Voucherrsr)rrrTUser)rrrrz order.OrderOrder)rr)rc@s$eZdZdZdZedZedZdS)zAbstractVoucherApplication.MetaTrzVoucher ApplicationzVoucher ApplicationsN)r!r"r#r$r%r'rr(r)r)r)r*r+sr+cCstd|j|jdS)Nz '%(voucher)s' used by '%(user)s')rrr)r'rrr)r-r)r)r*r.sz"AbstractVoucherApplication.__str__N)r!r"r#rRrrrZr'rr rrr|rXrr+r.r)r)r)r*rs&    rN)decimalr django.corer django.dbrrdjango.db.modelsr django.utilsrdjango.utils.translationrr'Zoscar.apps.voucher.utilsr oscar.core.compatr oscar.core.loadingr Modelr r]rr)r)r)r*s        `