Ejemplo n.º 1
0
class User(UserMixin, ResourceMixin, db.Model):
    ROLE = OrderedDict([
        ('member', 'Member'),
        ('admin', 'Admin')
    ])

    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)

    # Relationships.
    credit_card = db.relationship(CreditCard, uselist=False,
                                  backref='credit_card',
                                  passive_deletes=True)
    subscription = db.relationship(Subscription, uselist=False,
                                   backref='subscription',
                                   passive_deletes=True)
    invoices = db.relationship(Invoice, backref='invoices',
                               passive_deletes=True)
    descriptions = db.relationship(Create, backref='descriptions',
                                   passive_deletes=True)

    # Authentication.
    role = db.Column(db.Enum(*ROLE, name='role_types', native_enum=False),
                     index=True, nullable=False, server_default='member')
    active = db.Column('is_active', db.Boolean(), nullable=False,
                       server_default='1')
    username = db.Column(db.String(24), unique=True, index=True)
    email = db.Column(db.String(255), unique=True, index=True, nullable=False,
                      server_default='')
    password = db.Column(db.String(128), nullable=False, server_default='')

    # Billing.
    name = db.Column(db.String(128), index=True)
    payment_id = db.Column(db.String(128), index=True)
    cancelled_subscription_on = db.Column(AwareDateTime())
    previous_plan = db.Column(db.String(128))

    # Creating.
    credits = db.Column(db.Integer())
    last_created_on = db.Column(AwareDateTime())

    # Activity tracking.
    sign_in_count = db.Column(db.Integer, nullable=False, default=0)
    current_sign_in_on = db.Column(AwareDateTime())
    current_sign_in_ip = db.Column(db.String(45))
    last_sign_in_on = db.Column(AwareDateTime())
    last_sign_in_ip = db.Column(db.String(45))

    # Additional settings.
    locale = db.Column(db.String(5), nullable=False, server_default='en')

    def __init__(self, **kwargs):
        # Call Flask-SQLAlchemy's constructor.
        super(User, self).__init__(**kwargs)

        self.password = User.encrypt_password(kwargs.get('password', ''))
        self.credits = 10

    @classmethod
    def find_by_identity(cls, identity):
        """
        Find a user by their e-mail or username.

        :param identity: Email or username
        :type identity: str
        :return: User instance
        """
        return User.query.filter(
          (User.email == identity) | (User.username == identity)).first()

    @classmethod
    def encrypt_password(cls, plaintext_password):
        """
        Hash a plaintext string using PBKDF2. This is good enough according
        to the NIST (National Institute of Standards and Technology).

        In other words while bcrypt might be superior in practice, if you use
        PBKDF2 properly (which we are), then your passwords are safe.

        :param plaintext_password: Password in plain text
        :type plaintext_password: str
        :return: str
        """
        if plaintext_password:
            return generate_password_hash(plaintext_password)

        return None

    @classmethod
    def deserialize_token(cls, token):
        """
        Obtain a user from de-serializing a signed token.

        :param token: Signed token.
        :type token: str
        :return: User instance or None
        """
        private_key = TimedJSONWebSignatureSerializer(
            current_app.config['SECRET_KEY'])
        try:
            decoded_payload = private_key.loads(token)

            return User.find_by_identity(decoded_payload.get('user_email'))
        except Exception:
            return None

    @classmethod
    def initialize_password_reset(cls, identity):
        """
        Generate a token to reset the password for a specific user.

        :param identity: User e-mail address or username
        :type identity: str
        :return: User instance
        """
        u = User.find_by_identity(identity)
        reset_token = u.serialize_token()

        # This prevents circular imports.
        from perciapp.blueprints.user.tasks import (
            deliver_password_reset_email)
        deliver_password_reset_email(u.id, reset_token)

        return u

    @classmethod
    def search(cls, query):
        """
        Search a resource by 1 or more fields.

        :param query: Search query
        :type query: str
        :return: SQLAlchemy filter
        """
        if query == '':
            return text('')

        search_query = '%{0}%'.format(query)
        search_chain = (User.email.ilike(search_query),
                        User.username.ilike(search_query))

        return or_(*search_chain)

    @classmethod
    def is_last_admin(cls, user, new_role, new_active):
        """
        Determine whether or not this user is the last admin account.

        :param user: User being tested
        :type user: User
        :param new_role: New role being set
        :type new_role: str
        :param new_active: New active status being set
        :type new_active: bool
        :return: bool
        """
        is_demoting_admin = user.role == 'admin' and new_role != 'admin'
        is_changing_active = user.active is True and new_active is None
        admin_count = User.query.filter(User.role == 'admin').count()

        if is_demoting_admin and admin_count == 1:
            return True

        if is_changing_active and user.role == 'admin' and admin_count == 1:
            return True

        return False

    @classmethod
    def bulk_delete(cls, ids):
        """
        Override the general bulk_delete method because we need to delete them
        one at a time while also deleting them on Stripe.

        :param ids: List of ids to be deleted
        :type ids: list
        :return: int
        """
        delete_count = 0

        for id in ids:
            user = User.query.get(id)

            if user is None:
                continue

            if user.payment_id is None:
                user.delete()
            else:
                subscription = Subscription()
                cancelled = subscription.cancel(user=user)

                # If successful, delete it locally.
                if cancelled:
                    user.delete()

            delete_count += 1

        return delete_count

    def is_active(self):
        """
        Return whether or not the user account is active, this satisfies
        Flask-Login by overwriting the default value.

        :return: bool
        """
        return self.active

    def get_auth_token(self):
        """
        Return the user's auth token. Use their password as part of the token
        because if the user changes their password we will want to invalidate
        all of their logins across devices. It is completely fine to use
        md5 here as nothing leaks.

        This satisfies Flask-Login by providing a means to create a token.

        :return: str
        """
        private_key = current_app.config['SECRET_KEY']

        serializer = URLSafeTimedSerializer(private_key)
        data = [str(self.id), md5(self.password.encode('utf-8')).hexdigest()]

        return serializer.dumps(data)

    def authenticated(self, with_password=True, password=''):
        """
        Ensure a user is authenticated, and optionally check their password.

        :param with_password: Optionally check their password
        :type with_password: bool
        :param password: Optionally verify this as their password
        :type password: str
        :return: bool
        """
        if with_password:
            return check_password_hash(self.password, password)

        return True

    def serialize_token(self, expiration=3600):
        """
        Sign and create a token that can be used for things such as resetting
        a password or other tasks that involve a one off token.

        :param expiration: Seconds until it expires, defaults to 1 hour
        :type expiration: int
        :return: JSON
        """
        private_key = current_app.config['SECRET_KEY']

        serializer = TimedJSONWebSignatureSerializer(private_key, expiration)
        return serializer.dumps({'user_email': self.email}).decode('utf-8')

    def update_activity_tracking(self, ip_address):
        """
        Update various fields on the user that's related to meta data on their
        account, such as the sign in count and ip address, etc..

        :param ip_address: IP address
        :type ip_address: str
        :return: SQLAlchemy commit results
        """
        self.sign_in_count += 1

        self.last_sign_in_on = self.current_sign_in_on
        self.last_sign_in_ip = self.current_sign_in_ip

        self.current_sign_in_on = datetime.datetime.now(pytz.utc)
        self.current_sign_in_ip = ip_address

        return self.save()

    def add_credits(self, plan):
        """
        Add an amount of credits to an existing user.

        :param plan: Subscription plan
        :type plan: str
        :return: SQLAlchemy commit results
        """
        self.credits += plan['metadata']['credits']

        return self.save()
Ejemplo n.º 2
0
class Coupon(ResourceMixin, db.Model):
    DURATION = OrderedDict([('forever', 'Forever'), ('once', 'Once'),
                            ('repeating', 'Repeating')])

    __tablename__ = 'coupons'
    id = db.Column(db.Integer, primary_key=True)

    # Coupon details.
    code = db.Column(db.String(128), index=True, unique=True)
    duration = db.Column(db.Enum(*DURATION, name='duration_types'),
                         index=True,
                         nullable=False,
                         server_default='forever')
    amount_off = db.Column(db.Integer())
    percent_off = db.Column(db.Integer())
    currency = db.Column(db.String(8))
    duration_in_months = db.Column(db.Integer())
    max_redemptions = db.Column(db.Integer(), index=True)
    redeem_by = db.Column(AwareDateTime(), index=True)
    times_redeemed = db.Column(db.Integer(),
                               index=True,
                               nullable=False,
                               default=0)
    valid = db.Column(db.Boolean(), nullable=False, server_default='1')

    def __init__(self, **kwargs):
        if self.code:
            self.code = self.code.upper()
        else:
            self.code = Coupon.random_coupon_code()

        # Call Flask-SQLAlchemy's constructor.
        super(Coupon, self).__init__(**kwargs)

    @hybrid_property
    def redeemable(self):
        """
        Return coupons that are still redeemable. Coupons will become invalid
        once they run out on save. We want to explicitly do a date check to
        avoid having to hit Stripe's API to get back potentially valid codes.

        :return: SQLAlchemy query object
        """
        is_redeemable = or_(self.redeem_by.is_(None),
                            self.redeem_by >= datetime.datetime.now(pytz.utc))

        return and_(self.valid, is_redeemable)

    @classmethod
    def search(cls, query):
        """
        Search a resource by 1 or more fields.

        :param query: Search query
        :type query: str
        :return: SQLAlchemy filter
        """
        if query == '':
            return text('')

        search_query = '%{0}%'.format(query)

        return or_(Coupon.code.ilike(search_query))

    @classmethod
    def random_coupon_code(cls):
        """
        Create a human readable random coupon code.

        :return: str
        """
        charset = string.digits + string.ascii_uppercase
        charset = charset.replace('B', '').replace('I', '')
        charset = charset.replace('O', '').replace('S', '')
        charset = charset.replace('0', '').replace('1', '')

        random_chars = ''.join(choice(charset) for _ in range(14))

        coupon_code = '{0}-{1}-{2}'.format(random_chars[0:4],
                                           random_chars[5:9],
                                           random_chars[10:14])

        return coupon_code

    @classmethod
    def expire_old_coupons(cls, compare_datetime=None):
        """
        Invalidate coupons that are past their redeem date.

        :param compare_datetime: Time to compare at
        :type compare_datetime: date
        :return: The result of updating the records
        """
        if compare_datetime is None:
            compare_datetime = datetime.datetime.now(pytz.utc)

        Coupon.query.filter(Coupon.redeem_by <= compare_datetime) \
            .update({Coupon.valid: not Coupon.valid})

        return db.session.commit()

    @classmethod
    def create(cls, params):
        """
        Return whether or not the coupon was created successfully.

        :return: bool
        """
        payment_params = params

        payment_params['code'] = payment_params['code'].upper()

        if payment_params.get('amount_off'):
            payment_params['amount_off'] = \
                dollars_to_cents(payment_params['amount_off'])

        PaymentCoupon.create(**payment_params)

        if 'id' in payment_params:
            payment_params['code'] = payment_params['id']
            del payment_params['id']

        if 'redeem_by' in payment_params:
            if payment_params.get('redeem_by') is not None:
                params['redeem_by'] = payment_params.get('redeem_by').replace(
                    tzinfo=pytz.UTC)

        coupon = Coupon(**payment_params)

        db.session.add(coupon)
        db.session.commit()

        return True

    @classmethod
    def bulk_delete(cls, ids):
        """
        Override the general bulk_delete method because we need to delete them
        one at a time while also deleting them on Stripe.

        :param ids: List of ids to be deleted
        :type ids: list
        :return: int
        """
        delete_count = 0

        for id in ids:
            coupon = Coupon.query.get(id)

            if coupon is None:
                continue

            # Delete on Stripe.
            stripe_response = PaymentCoupon.delete(coupon.code)

            # If successful, delete it locally.
            if stripe_response.get('deleted'):
                coupon.delete()
                delete_count += 1

        return delete_count

    @classmethod
    def find_by_code(cls, code):
        """
        Find a coupon by its code.

        :param code: Coupon code to find
        :type code: str
        :return: Coupon instance
        """
        formatted_code = code.upper()
        coupon = Coupon.query.filter(Coupon.redeemable,
                                     Coupon.code == formatted_code).first()

        return coupon

    def redeem(self):
        """
        Update the redeem stats for this coupon.

        :return: Result of saving the record
        """
        self.times_redeemed += 1

        if self.max_redemptions:
            if self.times_redeemed >= self.max_redemptions:
                self.valid = False

        return db.session.commit()

    def apply_discount_to(self, amount):
        """
        Apply the discount to an amount.

        :param amount: Amount in cents
        :type amount: int
        :return: int
        """
        if self.amount_off:
            amount -= self.amount_off
        elif self.percent_off:
            amount *= (1 - (self.percent_off * 0.01))

        return int(amount)

    def to_json(self):
        """
        Return JSON fields to represent a coupon.

        :return: dict
        """
        params = {
            'duration': self.duration,
            'duration_in_months': self.duration_in_months,
        }

        if self.amount_off:
            params['amount_off'] = cents_to_dollars(self.amount_off)

        if self.percent_off:
            params['percent_off'] = self.percent_off,

        return params
Ejemplo n.º 3
0
class Invoice(ResourceMixin, db.Model):
    __tablename__ = 'invoices'
    id = db.Column(db.Integer, primary_key=True)

    # Relationships.
    user_id = db.Column(db.Integer,
                        db.ForeignKey('users.id',
                                      onupdate='CASCADE',
                                      ondelete='CASCADE'),
                        index=True,
                        nullable=False)
    user = db.relationship('User')

    # Invoice details.
    plan = db.Column(db.String(128), index=True)
    receipt_number = db.Column(db.String(128), index=True)
    description = db.Column(db.String(128))
    period_start_on = db.Column(db.Date)
    period_end_on = db.Column(db.Date)
    currency = db.Column(db.String(8))
    tax = db.Column(db.Integer())
    tax_percent = db.Column(db.Float())
    total = db.Column(db.Integer())

    # De-normalize the card details so we can render a user's history properly
    # even if they have no active subscription or changed cards at some point.
    brand = db.Column(db.String(32))
    last4 = db.Column(db.String(4))
    exp_date = db.Column(db.Date, index=True)

    def __init__(self, **kwargs):
        # Call Flask-SQLAlchemy's constructor.
        super(Invoice, self).__init__(**kwargs)

    @classmethod
    def search(cls, query):
        """
        Search a resource by 1 or more fields.

        :param query: Search query
        :type query: str
        :return: SQLAlchemy filter
        """
        from perciapp.blueprints.user.models import User

        if query == '':
            return text('')

        search_query = '%{0}%'.format(query)
        search_chain = (User.email.ilike(search_query),
                        User.username.ilike(search_query))

        return or_(*search_chain)

    @classmethod
    def parse_from_event(cls, payload):
        """
        Parse and return the invoice information that will get saved locally.

        :return: dict
        """
        data = payload['data']['object']
        plan_info = data['lines']['data'][0]['plan']

        period_start_on = datetime.datetime.utcfromtimestamp(
            data['lines']['data'][0]['period']['start']).date()
        period_end_on = datetime.datetime.utcfromtimestamp(
            data['lines']['data'][0]['period']['end']).date()

        description = ''
        for key, value in settings.STRIPE_PLANS.items():
            if value.get('id') == plan_info['id']:
                description = value.get('statement_descriptor')

        invoice = {
            'payment_id': data['customer'],
            'plan': plan_info['nickname'],
            'receipt_number': data['receipt_number'],
            'description': description,
            'period_start_on': period_start_on,
            'period_end_on': period_end_on,
            'currency': data['currency'],
            'tax': data['tax'],
            'tax_percent': data['tax_percent'],
            'total': data['total']
        }

        return invoice

    @classmethod
    def parse_from_api(cls, invoice):
        """
        Parse and return the invoice information we are interested in.

        :param invoice: Stripe invoice result
        :type invoice: dict
        :return: dict
        """
        plan_info = invoice['lines']['data'][0]['plan']
        date = datetime.datetime.utcfromtimestamp(invoice['created'])

        description = ''
        for key, value in settings.STRIPE_PLANS.items():
            if value.get('id') == plan_info['id']:
                description = value.get('statement_descriptor')

        invoice = {
            'plan': plan_info['nickname'],
            'description': description,
            'next_bill_on': date,
            'amount_due': invoice['amount_due'],
            'interval': plan_info['interval']
        }

        return invoice

    @classmethod
    def prepare_and_save(cls, parsed_event):
        """
        Potentially save the invoice after argument the event fields.

        :param parsed_event: Event params to be saved
        :type parsed_event: dict
        :return: User instance
        """
        # Avoid circular imports.
        from perciapp.blueprints.user.models import User

        # Only save the invoice if the user is valid at this point.
        id = parsed_event.get('payment_id')
        user = User.query.filter((User.payment_id == id)).first()

        if user and user.credit_card:
            parsed_event['user_id'] = user.id
            parsed_event['brand'] = user.credit_card.brand
            parsed_event['last4'] = user.credit_card.last4
            parsed_event['exp_date'] = user.credit_card.exp_date

            del parsed_event['payment_id']

            invoice = Invoice(**parsed_event)
            invoice.save()

        return user

    @classmethod
    def upcoming(cls, customer_id):
        """
        Return the upcoming invoice item.

        :param customer_id: Stripe customer id
        :type customer_id: int
        :return: Stripe invoice object
        """
        invoice = PaymentInvoice.upcoming(customer_id)

        return Invoice.parse_from_api(invoice)

    def create(self,
               user=None,
               currency=None,
               amount=None,
               credits=None,
               coupon=None,
               token=None):
        """
        Create an invoice item.

        :param user: User to apply the subscription to
        :type user: User instance
        :param amount: Stripe currency
        :type amount: str
        :param amount: Amount in cents
        :type amount: int
        :param credits: Amount of credits
        :type credits: int
        :param coupon: Coupon code to apply
        :type coupon: str
        :param token: Token returned by JavaScript
        :type token: str
        :return: bool
        """
        if token is None:
            return False

        customer = PaymentCustomer.create(token=token, email=user.email)

        if coupon:
            self.coupon = coupon.upper()
            coupon = Coupon.query.filter(Coupon.code == self.coupon).first()
            amount = coupon.apply_discount_to(amount)

        charge = PaymentCharge.create(customer.id, currency, amount)

        # Redeem the coupon.
        if coupon:
            coupon.redeem()

        # Add the credits to the user.
        user.credits += credits

        period_on = datetime.datetime.utcfromtimestamp(charge.get('created'))
        card_params = CreditCard.extract_card_params(customer)

        self.user_id = user.id
        self.plan = '&mdash;'
        self.receipt_number = charge.get('receipt_number')
        self.description = charge.get('statement_descriptor')
        self.period_start_on = period_on
        self.period_end_on = period_on
        self.currency = charge.get('currency')
        self.tax = None
        self.tax_percent = None
        self.total = charge.get('amount')
        self.brand = card_params.get('brand')
        self.last4 = card_params.get('last4')
        self.exp_date = card_params.get('exp_date')

        db.session.add(self)
        db.session.add(user)
        db.session.commit()

        return True
Ejemplo n.º 4
0
class Subscription(ResourceMixin, db.Model):
    __tablename__ = 'subscriptions'
    id = db.Column(db.Integer, primary_key=True)

    # Relationships.
    user_id = db.Column(db.Integer, db.ForeignKey('users.id',
                                                  onupdate='CASCADE',
                                                  ondelete='CASCADE'),
                        index=True, nullable=False)
    user = db.relationship('User')

    # Subscription details.
    plan = db.Column(db.String(128))
    coupon = db.Column(db.String(128))

    def __init__(self, **kwargs):
        # Call Flask-SQLAlchemy's constructor.
        super(Subscription, self).__init__(**kwargs)

    @classmethod
    def get_plan_by_id(cls, plan):
        """
        Pick the plan based on the plan identifier.

        :param plan: Plan identifier
        :type plan: str
        :return: dict or None
        """
        for key, value in settings.STRIPE_PLANS.items():
            if value.get('id') == plan:
                return settings.STRIPE_PLANS[key]

        return None

    @classmethod
    def get_new_plan(cls, keys):
        """
        Pick the plan based on the plan identifier.

        :param keys: Keys to look through
        :type keys: list
        :return: str or None
        """
        for key in keys:
            split_key = key.split('submit_')

            if isinstance(split_key, list) and len(split_key) == 2:
                if Subscription.get_plan_by_id(split_key[1]):
                    return split_key[1]

        return None

    def create(self, user=None, name=None, plan=None, coupon_code=None,
               token=None):
        """
        Create a recurring subscription.

        :param user: User to apply the subscription to
        :type user: User instance
        :param name: User's billing name
        :type name: str
        :param plan: Plan identifier
        :type plan: str
        :param coupon_code: Coupon code to apply
        :type coupon_code: str
        :param token: Token returned by JavaScript
        :type token: str
        :return: bool
        """
        if token is None:
            return False

        coupon = None
        if coupon_code:
            coupon_code = coupon_code.upper()
            coupon = Coupon.query.filter(Coupon.code == coupon_code).first()

            # The user bypassed the JS and input an invalid coupon code.
            if not coupon:
                return False

        customer = PaymentCustomer.create(token, user.email)
        PaymentSubscription.create(customer.id, coupon_code, plan)

        # Update the user account.
        user.payment_id = customer.id
        user.name = name
        user.previous_plan = plan
        user.credits = add_subscription_credits(user.credits,
                                                Subscription.get_plan_by_id(
                                                    user.previous_plan),
                                                Subscription.get_plan_by_id(plan),
                                                user.cancelled_subscription_on)
        user.cancelled_subscription_on = None

        # Set the subscription details.
        self.user_id = user.id
        self.plan = plan

        # Attach and redeem the coupon.
        if coupon:
            self.coupon = coupon_code
            coupon.redeem()

        # Create the credit card.
        credit_card = CreditCard(user_id=user.id,
                                 **CreditCard.extract_card_params(customer))

        db.session.add(user)
        db.session.add(credit_card)
        db.session.add(self)

        db.session.commit()

        return True

    def update(self, user=None, coupon_code=None, plan=None):
        """
        Update an existing subscription.

        :param user: User to apply the subscription to
        :type user: User instance
        :param coupon_code: Coupon code to apply
        :type coupon_code: str
        :param plan: Plan identifier
        :type plan: str
        :return: bool
        """
        coupon = None
        if coupon_code:
            coupon_code = coupon_code.upper()
            coupon = Coupon.query.filter(Coupon.code == coupon_code).first()

            if not coupon:
                return False

        PaymentSubscription.update(user.payment_id, coupon_code, plan)

        user.previous_plan = user.subscription.plan
        user.subscription.plan = plan
        user.credits = add_subscription_credits(user.credits,
                                                Subscription.get_plan_by_id(
                                                    user.previous_plan),
                                                Subscription.get_plan_by_id(plan),
                                                user.cancelled_subscription_on)

        if coupon:
            user.subscription.coupon = coupon_code
            coupon.redeem()

        db.session.add(user.subscription)
        db.session.commit()

        return True

    def cancel(self, user=None, discard_credit_card=True):
        """
        Cancel an existing subscription.

        :param user: User to apply the subscription to
        :type user: User instance
        :param discard_credit_card: Delete the user's credit card
        :type discard_credit_card: bool
        :return: bool
        """
        PaymentSubscription.cancel(user.payment_id)

        user.payment_id = None
        user.cancelled_subscription_on = datetime.datetime.now(pytz.utc)
        user.previous_plan = user.subscription.plan

        db.session.add(user)
        db.session.delete(user.subscription)

        # Explicitly delete the credit card because the FK is on the
        # user, not subscription so we can't depend on cascading deletes.
        # This is for cases where you may want to keep a user's card
        # on file even if they cancelled.
        if discard_credit_card:
            db.session.delete(user.credit_card)

        db.session.commit()

        return True

    def update_payment_method(self, user=None, credit_card=None,
                              name=None, token=None):
        """
        Update the subscription.

        :param user: User to modify
        :type user: User instance
        :param credit_card: Card to modify
        :type credit_card: Credit Card instance
        :param name: User's billing name
        :type name: str
        :param token: Token returned by JavaScript
        :type token: str
        :return: bool
        """
        if token is None:
            return False

        customer = PaymentCard.update(user.payment_id, token)
        user.name = name

        # Update the credit card.
        new_card = CreditCard.extract_card_params(customer)
        credit_card.brand = new_card.get('brand')
        credit_card.last4 = new_card.get('last4')
        credit_card.exp_date = new_card.get('exp_date')
        credit_card.is_expiring = new_card.get('is_expiring')

        db.session.add(user)
        db.session.add(credit_card)

        db.session.commit()

        return True
Ejemplo n.º 5
0
class Create(ResourceMixin, db.Model):
    GENDER = OrderedDict([('men', 'Men'), ('women', 'Women'),
                          ('unisex', 'Unisex')])

    CATEGORY = OrderedDict([('clothing', 'Clothing'), ('shoes', 'Shoes')])

    SUBCATEGORY = OrderedDict([
        ('tops', 'Tops'), ('t-shirts & singlets', 'T-shirts & Singlets'),
        ('shirts & polos', 'Shirts & Polos'), ('dresses', 'Dresses'),
        ('skirts', 'Skirts'), ('pants', 'Pants'), ('jeans', 'Jeans'),
        ('shorts', 'Shorts'), ('swimwear', 'Swimwear'),
        ('sweats & hoodies', 'Sweats & Hoodies'),
        ('coats & jackets', 'Coats & Jackets'),
        ('suits & blazers', 'Suits & Blazers'),
        ('jumpsuits & playsuits', 'Jumpsuits & Playsuits'),
        ('sweaters & cardigans', 'Sweaters & Cardigans'),
        ('sleepwear', 'Sleepwear'), ('underwear & socks', 'Underwear & Socks'),
        ('tights', 'Socks & Tights'), ('base layers', 'Base Layers'),
        ('onesies', 'Onesies'), ('ankle boots', 'Ankle Boots'),
        ('dress shoes', 'Dress Shoes'), ('boots', 'Boots'), ('flats', 'Flats'),
        ('heels', 'Heels'), ('sneakers', 'Sneakers'), ('sandals', 'Sandals'),
        ('performance shoes', 'Performance Shoes'), ('wedges', 'Wedges'),
        ('casual shoes', 'Casual Shoes'), ('slippers', 'Slippers'),
        ('sunglasses', 'Sunglasses'), ('bags', 'Bags'),
        ('jewellery', 'Jewellery'), ('ties & cufflinks', 'Ties & Cufflinks'),
        ('watches', 'Watches'), ('scarves & gloves', 'Scarves & Gloves'),
        ('headwear', 'Headwear'), ('wallets', 'Wallets'), ('belts', 'Belts')
    ])

    __tablename__ = 'descriptions'
    id = db.Column(db.Integer, primary_key=True)

    # Relationships.
    user_id = db.Column(db.Integer,
                        db.ForeignKey('users.id',
                                      onupdate='CASCADE',
                                      ondelete='CASCADE'),
                        index=True,
                        nullable=False)
    user = db.relationship('User')

    # Create details
    title = db.Column(db.String(100))
    gender = db.Column(db.Enum(*GENDER, name='gender', native_enum=False),
                       index=True,
                       nullable=False)
    category = db.Column(db.Enum(*CATEGORY, name='category',
                                 native_enum=False),
                         index=True,
                         nullable=False)
    subcategory = db.Column(db.Enum(*SUBCATEGORY,
                                    name='subcategory',
                                    native_enum=False),
                            index=True,
                            nullable=False)
    detail1 = db.Column(db.String(500))
    detail2 = db.Column(db.String(200))
    detail3 = db.Column(db.String(200))
    detail4 = db.Column(db.String(200))
    detail5 = db.Column(db.String(200))
    sent1 = db.Column(db.String(300))

    sent1_2 = db.Column(db.String(300))
    sent1_3 = db.Column(db.String(300))
    sent1_4 = db.Column(db.String(300))
    sent1_5 = db.Column(db.String(300))
    sent1_6 = db.Column(db.String(300))
    sent1_7 = db.Column(db.String(300))
    sent1_8 = db.Column(db.String(300))
    sent1_9 = db.Column(db.String(300))
    sent1_10 = db.Column(db.String(300))
    sent1_11 = db.Column(db.String(300))
    sent1_12 = db.Column(db.String(300))
    sent1_13 = db.Column(db.String(300))
    sent1_14 = db.Column(db.String(300))
    sent1_15 = db.Column(db.String(300))
    sent1_16 = db.Column(db.String(300))
    sent1_17 = db.Column(db.String(300))
    sent1_18 = db.Column(db.String(300))
    sent1_19 = db.Column(db.String(300))
    sent1_winner = db.Column(db.String(300))

    sent2 = db.Column(db.String(300))
    sent2_2 = db.Column(db.String(300))
    sent2_3 = db.Column(db.String(300))
    sent2_4 = db.Column(db.String(300))
    sent2_5 = db.Column(db.String(300))
    sent2_6 = db.Column(db.String(300))
    sent2_7 = db.Column(db.String(300))
    sent2_8 = db.Column(db.String(300))
    sent2_9 = db.Column(db.String(300))
    sent2_10 = db.Column(db.String(300))
    sent2_11 = db.Column(db.String(300))
    sent2_12 = db.Column(db.String(300))
    sent2_13 = db.Column(db.String(300))
    sent2_14 = db.Column(db.String(300))
    sent2_15 = db.Column(db.String(300))
    sent2_16 = db.Column(db.String(300))
    sent2_17 = db.Column(db.String(300))
    sent2_18 = db.Column(db.String(300))
    sent2_19 = db.Column(db.String(300))
    sent2_winner = db.Column(db.String(300))

    sent3 = db.Column(db.String(300))
    sent3_2 = db.Column(db.String(300))
    sent3_3 = db.Column(db.String(300))
    sent3_4 = db.Column(db.String(300))
    sent3_5 = db.Column(db.String(300))
    sent3_6 = db.Column(db.String(300))
    sent3_7 = db.Column(db.String(300))
    sent3_8 = db.Column(db.String(300))
    sent3_9 = db.Column(db.String(300))
    sent3_10 = db.Column(db.String(300))
    sent3_11 = db.Column(db.String(300))
    sent3_12 = db.Column(db.String(300))
    sent3_13 = db.Column(db.String(300))
    sent3_14 = db.Column(db.String(300))
    sent3_15 = db.Column(db.String(300))
    sent3_16 = db.Column(db.String(300))
    sent3_17 = db.Column(db.String(300))
    sent3_18 = db.Column(db.String(300))
    sent3_19 = db.Column(db.String(300))
    sent3_winner = db.Column(db.String(300))

    description = db.Column(db.String(3000))

    def __init__(self, **kwargs):
        # Call Flask-SQLAlchemy's constructor.
        super(Create, self).__init__(**kwargs)

    def save_and_update_user(self, user):
        """
        Commit the description and update the user's information.

        :return: SQLAlchemy save result
        """
        self.save()

        user.credits -= 1
        user.last_created_on = tzware_datetime()
        return user.save()

    def to_json(self):
        """
        Return JSON fields to represent a description.

        :return: dict
        """
        params = {
            'title': self.title,
            'category': self.category,
            'subcategory': self.subcategory,
            'detail1': self.detail1,
            'detail2': self.detail2,
            'detail3': self.detail3,
            'detail4': self.detail4,
            'detail5': self.detail5,
            'description': self.description,
        }

        return params