django-bom 1.235__py3-none-any.whl

bom/models.py

@@ -0,0 +1,756 @@
+from __future__ import unicode_literals
+
+import logging
+from math import ceil
+
+from django.conf import settings
+from django.contrib.auth import get_user_model
+from django.contrib.auth.models import Group
+from django.core.cache import cache
+from django.core.validators import MaxValueValidator, MinValueValidator
+from django.db import models
+from django.utils import timezone
+
+from djmoney.models.fields import CURRENCY_CHOICES, CurrencyField, MoneyField
+from social_django.models import UserSocialAuth
+
+from .base_classes import AsDictModel
+from .constants import (
+    CONFIGURATION_TYPES,
+    CURRENT_UNITS,
+    DISTANCE_UNITS,
+    FREQUENCY_UNITS,
+    INTERFACE_TYPES,
+    MEMORY_UNITS,
+    NUMBER_CLASS_CODE_LEN_DEFAULT,
+    NUMBER_CLASS_CODE_LEN_MAX,
+    NUMBER_CLASS_CODE_LEN_MIN,
+    NUMBER_ITEM_LEN_DEFAULT,
+    NUMBER_ITEM_LEN_MAX,
+    NUMBER_ITEM_LEN_MIN,
+    NUMBER_SCHEME_INTELLIGENT,
+    NUMBER_SCHEME_SEMI_INTELLIGENT,
+    NUMBER_SCHEMES,
+    NUMBER_VARIATION_LEN_DEFAULT,
+    NUMBER_VARIATION_LEN_MAX,
+    NUMBER_VARIATION_LEN_MIN,
+    PACKAGE_TYPES,
+    POWER_UNITS,
+    ROLE_TYPES,
+    SUBSCRIPTION_TYPES,
+    TEMPERATURE_UNITS,
+    VALUE_UNITS,
+    VOLTAGE_UNITS,
+    WAVELENGTH_UNITS,
+    WEIGHT_UNITS,
+)
+from .csv_headers import PartsListCSVHeaders, PartsListCSVHeadersSemiIntelligent
+from .part_bom import PartBom, PartBomItem, PartIndentedBomItem
+from .utils import increment_str, listify_string, prep_for_sorting_nicely, stringify_list, strip_trailing_zeros
+from .validators import alphanumeric, numeric, validate_pct
+
+
+logger = logging.getLogger(__name__)
+User = get_user_model()
+
+
+class Organization(models.Model):
+    name = models.CharField(max_length=255, default=None)
+    subscription = models.CharField(max_length=1, choices=SUBSCRIPTION_TYPES)
+    subscription_quantity = models.IntegerField(default=0)
+    owner = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
+    number_scheme = models.CharField(max_length=1, choices=NUMBER_SCHEMES, default=NUMBER_SCHEME_SEMI_INTELLIGENT)
+    number_class_code_len = models.PositiveIntegerField(default=NUMBER_CLASS_CODE_LEN_DEFAULT,
+                                                        validators=[MinValueValidator(NUMBER_CLASS_CODE_LEN_MIN), MaxValueValidator(NUMBER_CLASS_CODE_LEN_MAX)])
+    number_item_len = models.PositiveIntegerField(default=NUMBER_ITEM_LEN_DEFAULT,
+                                                  validators=[MinValueValidator(NUMBER_ITEM_LEN_MIN), MaxValueValidator(NUMBER_ITEM_LEN_MAX)])
+    number_variation_len = models.PositiveIntegerField(default=NUMBER_VARIATION_LEN_DEFAULT,
+                                                       validators=[MinValueValidator(NUMBER_VARIATION_LEN_MIN), MaxValueValidator(NUMBER_VARIATION_LEN_MAX)])
+    google_drive_parent = models.CharField(max_length=128, blank=True, default=None, null=True)
+    currency = CurrencyField(max_length=3, choices=CURRENCY_CHOICES, default='USD')
+
+    def number_cs(self):
+        return "C" * self.number_class_code_len
+
+    def number_ns(self):
+        return "N" * self.number_item_len
+
+    def number_vs(self):
+        return "V" * self.number_variation_len
+
+    def __str__(self):
+        return u'%s' % self.name
+
+    def seller_parts(self):
+        return SellerPart.objects.filter(seller__organization=self)
+
+    def part_list_csv_headers(self):
+        if self.number_scheme == NUMBER_SCHEME_INTELLIGENT:
+            return PartsListCSVHeaders()
+        else:
+            return PartsListCSVHeadersSemiIntelligent()
+
+    @property
+    def email(self):
+        return self.owner.email
+
+    def save(self, *args, **kwargs):
+        super(Organization, self).save()
+        SellerPart.objects.filter(seller__organization=self).update(unit_cost_currency=self.currency, nre_cost_currency=self.currency)
+
+
+class UserMeta(models.Model):
+    user = models.OneToOneField(settings.AUTH_USER_MODEL, db_index=True, on_delete=models.CASCADE)
+    organization = models.ForeignKey(Organization, blank=True, null=True, on_delete=models.CASCADE)
+    role = models.CharField(max_length=1, choices=ROLE_TYPES)
+
+    def get_or_create_organization(self):
+        if self.organization is None:
+            if self.user.first_name == '' and self.user.last_name == '':
+                org_name = self.user.username
+            else:
+                org_name = self.user.first_name + ' ' + self.user.last_name
+
+            organization, created = Organization.objects.get_or_create(owner=self.user, defaults={'name': org_name, 'subscription': 'F'})
+
+            self.organization = organization
+            self.role = 'A'
+            self.save()
+        return self.organization
+
+    def google_authenticated(self) -> bool:
+        try:
+            self.user.social_auth.get(provider='google-oauth2')
+            return True
+        except UserSocialAuth.DoesNotExist:
+            return False
+
+    def is_organization_owner(self) -> bool:
+        return self.organization.owner == self.user if self.organization else False
+
+    def _user_meta(self, organization=None):
+        return UserMeta.objects.get_or_create(user=self, defaults={'organization': organization})[0]
+
+    User.add_to_class('bom_profile', _user_meta)
+
+
+class PartClass(models.Model):
+    organization = models.ForeignKey(Organization, on_delete=models.CASCADE, db_index=True)
+    code = models.CharField(max_length=NUMBER_CLASS_CODE_LEN_MAX, validators=[alphanumeric])
+    name = models.CharField(max_length=255, default=None)
+    comment = models.CharField(max_length=255, default='', blank=True)
+    mouser_enabled = models.BooleanField(default=False)
+
+    class Meta:
+        unique_together = [['code', 'organization', ], ]
+        ordering = ['code']
+        indexes = [
+            models.Index(fields=['organization', 'code']),
+        ]
+
+    def __str__(self):
+        return f'{self.code}: {self.name}'
+
+
+class Manufacturer(models.Model, AsDictModel):
+    name = models.CharField(max_length=128, default=None)
+    organization = models.ForeignKey(Organization, on_delete=models.CASCADE, db_index=True)
+
+    class Meta:
+        ordering = ['name']
+
+    def __str__(self):
+        return u'%s' % self.name
+
+
+# Part contains the root information for a component. Parts have attributes that can be changed over time
+# (see PartRevision). Part numbers can be changed over time, but these cannot be tracked, as it is not a practice
+# that should be done often.
+class Part(models.Model):
+    organization = models.ForeignKey(Organization, on_delete=models.CASCADE, db_index=True)
+    number_class = models.ForeignKey(PartClass, default=None, blank=True, null=True, related_name='number_class', on_delete=models.CASCADE, db_index=True)
+    number_item = models.CharField(max_length=NUMBER_ITEM_LEN_MAX, default=None, blank=True)
+    number_variation = models.CharField(max_length=NUMBER_VARIATION_LEN_MAX, default=None, blank=True, null=True, validators=[alphanumeric])
+    primary_manufacturer_part = models.ForeignKey('ManufacturerPart', default=None, null=True, blank=True,
+                                                  on_delete=models.SET_NULL, related_name='primary_manufacturer_part')
+    google_drive_parent = models.CharField(max_length=128, blank=True, default=None, null=True)
+
+    class Meta:
+        unique_together = ['number_class', 'number_item', 'number_variation', 'organization', ]
+        indexes = [
+            models.Index(fields=['organization', 'number_class']),
+        ]
+
+    def full_part_number(self):
+        if self.organization.number_scheme == NUMBER_SCHEME_SEMI_INTELLIGENT:
+            if self.organization.number_variation_len > 0:
+                return f"{self.number_class.code}-{self.number_item}-{self.number_variation}"
+            else:
+                return f"{self.number_class.code}-{self.number_item}"
+        else:
+            return self.number_item
+
+    @staticmethod
+    def verify_format_number_class(number_class, organization):
+        if len(number_class) != organization.number_class_code_len:
+            raise AttributeError(f"Expect {organization.number_class_code_len} digits for number class")
+        elif number_class is not None:
+            for c in number_class:
+                if not (c.isdigit() or c.isalpha()):
+                    raise AttributeError(f"{c} is not a proper character for a number class")
+        return number_class
+
+    @staticmethod
+    def verify_format_number_item(number_item, organization):
+        if len(number_item) != organization.number_item_len:
+            raise AttributeError(f"Expect {organization.number_item_len} digits for number item")
+        elif number_item is not None:
+            for c in number_item:
+                if not c.isdigit():
+                    raise AttributeError(f"{c} is not a proper character for a number item")
+        return number_item
+
+    @staticmethod
+    def verify_format_number_variation(number_variation, organization):
+        if len(number_variation) != organization.number_variation_len:
+            raise AttributeError(f"Expect {organization.number_variation_len} characters for number variation")
+        elif number_variation is not None:
+            for c in number_variation:
+                if not c.isalnum():
+                    raise AttributeError(f"{c} is not a proper character for a number variation. Must be alphanumeric.")
+        return number_variation
+
+    @staticmethod
+    def parse_part_number(part_number, organization):
+        if part_number is None:
+            raise AttributeError("Cannot parse empty part number")
+        if organization.number_scheme == NUMBER_SCHEME_SEMI_INTELLIGENT:
+            try:
+                (number_class, number_item, number_variation) = Part.parse_partial_part_number(part_number, organization)
+            except IndexError:
+                raise AttributeError("Invalid part number. Does not match organization preferences.")
+
+            if number_class is None:
+                raise AttributeError("Missing part number part class")
+            if number_item is None:
+                raise AttributeError("Missing part number item number")
+            if number_variation is None and organization.number_class_code_len != 0 and organization.number_variation_len > 0:
+                raise AttributeError("Missing part number part item variation")
+
+            return number_class, number_item, number_variation
+        else:
+            return None, part_number, None
+
+    @staticmethod
+    def parse_partial_part_number(part_number, organization, validate=True):
+        if organization.number_scheme == NUMBER_SCHEME_SEMI_INTELLIGENT:
+            elements = part_number.split('-')
+
+            number_class = elements[0] if len(elements) >= 1 else None
+            number_item = elements[1] if len(elements) >= 2 else None
+            number_variation = elements[2] if len(elements) >= 3 else None
+
+            if validate:
+                if len(elements) >= 2:
+                    number_class = Part.verify_format_number_class(elements[0], organization)
+                    number_item = Part.verify_format_number_item(elements[1], organization)
+                if len(elements) >= 3:
+                    number_variation = Part.verify_format_number_variation(elements[2], organization)
+
+            return number_class, number_item, number_variation
+        else:
+            return None, part_number, None
+
+    @classmethod
+    def from_part_number(cls, part_number, organization):
+        (number_class, number_item, number_variation) = Part.parse_part_number(part_number, organization)
+        if organization.number_scheme == NUMBER_SCHEME_SEMI_INTELLIGENT:
+            return Part.objects.get(
+                number_class__code=number_class,
+                number_class__organization=organization,
+                number_item=number_item,
+                number_variation=number_variation,
+                organization=organization
+            )
+        return Part.objects.get(
+            number_item=number_item,
+            organization=organization
+        )
+
+    @classmethod
+    def from_manufacturer_part_number(cls, manufacturer_part_number, organization):
+        part = Part.objects.filter(
+            primary_manufacturer_part__manufacturer_part_number=manufacturer_part_number,
+            organization=organization
+        )
+        if len(part) == 1:
+            return part[0]
+        elif len(part) == 0:
+            return None
+        else:
+            raise ValueError('Too many objects found')
+
+    def description(self):
+        return self.latest().description if self.latest() is not None else ''
+
+    def latest(self):
+        return self.revisions().order_by('-id').first()
+
+    def revisions(self):
+        return PartRevision.objects.filter(part=self)
+
+    def seller_parts(self, exclude_primary=False):
+        manufacturer_parts = ManufacturerPart.objects.filter(part=self)
+        q = SellerPart.objects.filter(manufacturer_part__in=manufacturer_parts).order_by('seller', 'minimum_order_quantity')\
+            .select_related('manufacturer_part').select_related('manufacturer_part__manufacturer').select_related('seller')
+        if exclude_primary and self.primary_manufacturer_part is not None and self.primary_manufacturer_part.optimal_seller():
+            return q.exclude(id=self.primary_manufacturer_part.optimal_seller().id)
+        return q
+
+    def manufacturer_parts(self, exclude_primary=False):
+        q = ManufacturerPart.objects.filter(part=self).select_related('manufacturer')
+        if exclude_primary and self.primary_manufacturer_part is not None and self.primary_manufacturer_part.optimal_seller():
+            return q.exclude(id=self.primary_manufacturer_part.id)
+        return q
+
+    def where_used(self):
+        revisions = PartRevision.objects.filter(part=self)
+        used_in_subparts = Subpart.objects.filter(part_revision__in=revisions)
+        used_in_assembly_ids = AssemblySubparts.objects.filter(subpart__in=used_in_subparts).values_list('assembly', flat=True)
+        used_in_prs = PartRevision.objects.filter(assembly__in=used_in_assembly_ids)
+        return used_in_prs
+
+    def where_used_full(self):
+        def where_used_given_part(used_in_parts, part):
+            where_used = part.where_used()
+            used_in_parts.update(where_used)
+            for p in where_used:
+                where_used_given_part(used_in_parts, p)
+            return used_in_parts
+
+        used_in_parts = set()
+        where_used_given_part(used_in_parts, self)
+        return list(used_in_parts)
+
+    def indented(self, part_revision=None):
+        if part_revision is None:
+            return self.latest().indented() if self.latest() is not None else None
+        else:
+            return part_revision.indented()
+
+    def optimal_seller(self, quantity=None):
+        if not quantity:
+            qty_cache_key = str(self.id) + '_qty'
+            quantity = int(cache.get(qty_cache_key, 100))
+
+        manufacturer_parts = ManufacturerPart.objects.filter(part=self)
+        sellerparts = SellerPart.objects.filter(manufacturer_part__in=manufacturer_parts)
+        # sellerparts = SellerPart.objects.filter(manufacturer_part__part=self)
+        return SellerPart.optimal(sellerparts, int(quantity))
+
+    def assign_part_number(self):
+        if self.number_item is None or self.number_item == '':
+            last_number_item = Part.objects.filter(
+                number_class=self.number_class,
+                organization=self.organization).order_by('number_item').last()
+            if not last_number_item:
+                self.number_item = '1'
+                for i in range(self.organization.number_item_len - 1):
+                    self.number_item = '0' + self.number_item
+            else:
+                FORMATS = {
+                    1: '{0:0=1d}', 2: '{0:0=2d}', 3: '{0:0=3d}', 4: '{0:0=4d}', 5: '{0:0=5d}',
+                    6: '{0:0=6d}', 7: '{0:0=7d}', 8: '{0:0=8d}', 9: '{0:0=9d}', 10: '{0:0=10d}'
+                }
+                self.number_item = FORMATS[self.organization.number_item_len].format(
+                    int(last_number_item.number_item) + 1)
+        if (self.number_variation is None or self.number_variation == '') and self.organization.number_variation_len > 0:
+            last_number_variation = Part.objects.all().filter(
+                number_class=self.number_class,
+                number_item=self.number_item).order_by('number_variation').last()
+
+            if not last_number_variation:
+                self.number_variation = '00'
+            else:
+                try:
+                    self.number_variation = "{0:0=2d}".format(int(last_number_variation.number_variation) + 1)
+                except ValueError as e:
+                    self.number_variation = "{}".format(increment_str(last_number_variation.number_variation))
+
+    def save(self, *args, **kwargs):
+        if self.organization.number_scheme == NUMBER_SCHEME_SEMI_INTELLIGENT:
+            self.assign_part_number()
+        super(Part, self).save()
+
+    def verbose_str(self):
+        return f'{self.full_part_number()} ┆ {self.description()}'
+
+    def __str__(self):
+        return u'%s' % (self.full_part_number())
+
+
+# Below are attributes of a part that can be changed, but it's important to trace the change over time
+class PartRevision(models.Model):
+    part = models.ForeignKey(Part, on_delete=models.CASCADE, db_index=True)
+    timestamp = models.DateTimeField(default=timezone.now)
+    configuration = models.CharField(max_length=1, choices=CONFIGURATION_TYPES, default='W')
+    revision = models.CharField(max_length=4, db_index=True, default='1')
+    assembly = models.ForeignKey('Assembly', default=None, null=True, on_delete=models.CASCADE, db_index=True)
+    displayable_synopsis = models.CharField(editable=False, default="", null=True, blank=True, max_length=255, db_index=True)
+    searchable_synopsis = models.CharField(editable=False, default="", null=True, blank=True, max_length=255, db_index=True)
+
+    class Meta:
+        unique_together = (('part', 'revision'),)
+        ordering = ['part']
+
+    # Part Revision Specification Properties:
+
+    description = models.CharField(max_length=255, default="", null=True, blank=True)
+
+    # By convention for IndaBOM, for part revision properties below, if a property value has
+    # an associated units of measure, and if the property value field name is 'vvv' then the
+    # associated units of measure field name must be 'vvv_units'.
+    value_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=VALUE_UNITS)
+    value = models.CharField(max_length=255, default=None, null=True, blank=True)
+    attribute = models.CharField(max_length=255, default=None, null=True, blank=True)
+    pin_count = models.DecimalField(max_digits=3, decimal_places=0, default=None, null=True, blank=True)
+    tolerance = models.CharField(max_length=6, validators=[validate_pct], default=None, null=True, blank=True)
+    package = models.CharField(max_length=16, default=None, null=True, blank=True, choices=PACKAGE_TYPES)
+    material = models.CharField(max_length=32, default=None, null=True, blank=True)
+    finish = models.CharField(max_length=32, default=None, null=True, blank=True)
+    color = models.CharField(max_length=32, default=None, null=True, blank=True)
+    length_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=DISTANCE_UNITS)
+    length = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    width_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=DISTANCE_UNITS)
+    width = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    height_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=DISTANCE_UNITS)
+    height = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    weight_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=WEIGHT_UNITS)
+    weight = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    temperature_rating_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=TEMPERATURE_UNITS)
+    temperature_rating = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    temperature_rating_range_max = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    temperature_rating_range_min = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    wavelength_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=WAVELENGTH_UNITS)
+    wavelength = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    frequency_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=FREQUENCY_UNITS)
+    frequency = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    memory_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=MEMORY_UNITS)
+    memory = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    interface = models.CharField(max_length=12, default=None, null=True, blank=True, choices=INTERFACE_TYPES)
+    power_rating_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=POWER_UNITS)
+    power_rating = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    supply_voltage_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=VOLTAGE_UNITS)
+    supply_voltage = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    voltage_rating_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=VOLTAGE_UNITS)
+    voltage_rating = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+    current_rating_units = models.CharField(max_length=5, default=None, null=True, blank=True, choices=CURRENT_UNITS)
+    current_rating = models.DecimalField(max_digits=7, decimal_places=3, default=None, null=True, blank=True)
+
+    def generate_synopsis(self, make_searchable=False):
+        def verbosify(val, units=None, pre=None, pre_whitespace=True, post=None, post_whitespace=True):
+            elaborated = ""
+            if val is not None and val != '':
+                try:
+                    elaborated = strip_trailing_zeros(str(val))
+                    if units is not None and units != '': elaborated += units
+                    if pre is not None and pre != '':
+                        elaborated = pre + (' ' if pre_whitespace else '') + elaborated
+                    if post is not None and post != '': elaborated += (' ' if post_whitespace else '') + post
+                    elaborated = elaborated + ' '
+                except ValueError:
+                    pass
+            return elaborated
+
+        s = ""
+        s += verbosify(self.value, units=self.value_units if make_searchable else self.get_value_units_display())
+        s += verbosify(self.description)
+        tolerance = self.tolerance.replace('%', '') if self.tolerance else ''
+        s += verbosify(tolerance, post='%', post_whitespace=False)
+        s += verbosify(self.attribute)
+        s += verbosify(self.package if make_searchable else self.get_package_display())
+        s += verbosify(self.pin_count, post='pins')
+        s += verbosify(self.frequency, units=self.frequency_units if make_searchable else self.get_frequency_units_display())
+        s += verbosify(self.wavelength, units=self.wavelength_units if make_searchable else self.get_wavelength_units_display())
+        s += verbosify(self.memory, units=self.memory_units if make_searchable else self.get_memory_units_display())
+        s += verbosify(self.interface if make_searchable else self.get_interface_display())
+        s += verbosify(self.supply_voltage, units=self.supply_voltage_units if make_searchable else self.get_supply_voltage_units_display(), post='supply')
+        s += verbosify(self.temperature_rating, units=self.temperature_rating_units if make_searchable else self.get_temperature_rating_units_display(), post='rating')
+        s += verbosify(self.power_rating, units=self.power_rating_units if make_searchable else self.get_power_rating_units_display(), post='rating')
+        s += verbosify(self.voltage_rating, units=self.voltage_rating_units if make_searchable else self.get_voltage_rating_units_display(), post='rating')
+        s += verbosify(self.current_rating, units=self.current_rating_units if make_searchable else self.get_current_rating_units_display(), post='rating')
+        s += verbosify(self.material)
+        s += verbosify(self.color)
+        s += verbosify(self.finish)
+        s += verbosify(self.length, units=self.length_units if make_searchable else self.get_length_units_display(), pre='L')
+        s += verbosify(self.width, units=self.width_units if make_searchable else self.get_width_units_display(), pre='W')
+        s += verbosify(self.height, units=self.height_units if make_searchable else self.get_height_units_display(), pre='H')
+        s += verbosify(self.weight, units=self.weight_units if make_searchable else self.get_weight_units_display())
+        return s[:255]
+
+    def synopsis(self, return_displayable=True):
+        return self.displayable_synopsis if return_displayable else self.searchable_synopsis
+
+    def save(self, *args, **kwargs):
+        if self.tolerance:
+            self.tolerance = self.tolerance.replace('%', '')
+        if self.assembly is None:
+            assy = Assembly.objects.create()
+            self.assembly = assy
+        # if self.id:
+        #     previous_configuration = PartRevision.objects.get(id=self.id).configuration
+        #     if self.configuration != previous_configuration:
+        #         self.timestamp = timezone.now()
+        self.searchable_synopsis = self.generate_synopsis(True)
+        self.displayable_synopsis = self.generate_synopsis(False)
+        super(PartRevision, self).save(*args, **kwargs)
+
+    def indented(self, top_level_quantity=100):
+        def indented_given_bom(bom, part_revision, parent_id=None, parent=None, qty=1, parent_qty=1, indent_level=0, subpart=None, reference='', do_not_load=False):
+            bom_item_id = (parent_id or '') + (str(part_revision.id) + '-dnl' if do_not_load else str(part_revision.id))
+            extended_quantity = parent_qty * qty
+            total_extended_quantity = top_level_quantity * extended_quantity
+
+            try:
+                seller_part = part_revision.part.optimal_seller(quantity=total_extended_quantity)
+            except AttributeError:
+                seller_part = None
+
+            bom.append_item_and_update(PartIndentedBomItem(
+                bom_id=bom_item_id,
+                part=part_revision.part,
+                part_revision=part_revision,
+                do_not_load=do_not_load,
+                references=reference,
+                quantity=qty,
+                extended_quantity=extended_quantity,
+                parent_quantity=parent_qty,  # Do we need this?
+                indent_level=indent_level,
+                parent_id=parent_id,
+                subpart=subpart,
+                seller_part=seller_part,
+            ))
+
+            indent_level = indent_level + 1
+            if part_revision is None or part_revision.assembly is None or part_revision.assembly.subparts.count() == 0:
+                return
+            else:
+                parent_qty *= qty
+                # TODO: Cache Me!
+                for sp in part_revision.assembly.subparts.all():
+                    qty = sp.count
+                    reference = sp.reference
+                    indented_given_bom(bom, sp.part_revision, parent_id=bom_item_id, parent=part_revision, qty=qty, parent_qty=parent_qty,
+                                       indent_level=indent_level, subpart=sp, reference=reference, do_not_load=sp.do_not_load)
+
+        bom = PartBom(part_revision=self, quantity=top_level_quantity)
+        indented_given_bom(bom, self)
+
+        return bom
+
+    def flat(self, top_level_quantity=100, sort=False):
+        def flat_given_bom(bom, part_revision, parent=None, qty=1, parent_qty=1, subpart=None, reference=''):
+            extended_quantity = parent_qty * qty
+            total_extended_quantity = top_level_quantity * extended_quantity
+
+            try:
+                seller_part = part_revision.part.optimal_seller(quantity=total_extended_quantity)
+            except AttributeError:
+                seller_part = None
+
+            try:
+                do_not_load = subpart.do_not_load
+            except AttributeError:
+                do_not_load = False
+
+            bom_item_id = str(part_revision.id) + '-dnl' if do_not_load else str(part_revision.id)
+            bom.append_item_and_update(PartBomItem(
+                bom_id=bom_item_id,
+                part=part_revision.part,
+                part_revision=part_revision,
+                do_not_load=do_not_load,
+                references=reference,
+                quantity=qty,
+                extended_quantity=extended_quantity,
+                seller_part=seller_part,
+            ))
+
+            if part_revision is None or part_revision.assembly is None or part_revision.assembly.subparts.count() == 0:
+                return
+            else:
+                parent_qty *= qty
+                for sp in part_revision.assembly.subparts.all():
+                    qty = sp.count
+                    reference = sp.reference
+                    flat_given_bom(bom, sp.part_revision, parent=part_revision, qty=qty, parent_qty=parent_qty, subpart=sp, reference=reference)
+
+        flat_bom = PartBom(part_revision=self, quantity=top_level_quantity)
+        flat_given_bom(flat_bom, self)
+
+        # Sort by references, if no references then use part number.
+        # Note that need to convert part number to a list so can be compared with the 
+        # list-ified string returned by prep_for_sorting_nicely.
+        def sort_by_references(p):
+            return prep_for_sorting_nicely(p.references) if p.references else p.__str__().split()
+        if sort:
+            flat_bom.parts = sorted(flat_bom.parts.values(), key=sort_by_references)
+        return flat_bom
+
+    def where_used(self):
+        # Where is a part_revision used???
+        # it gets used by being a subpart to an assembly of a part_revision
+        # so we can look up subparts, then their assemblys, then their partrevisions
+        used_in_subparts = Subpart.objects.filter(part_revision=self)
+        used_in_assembly_ids = AssemblySubparts.objects.filter(subpart__in=used_in_subparts).values_list('assembly', flat=True)
+        used_in_pr = PartRevision.objects.filter(assembly__in=used_in_assembly_ids).order_by('-revision')
+        return used_in_pr
+
+    def where_used_full(self):
+        def where_used_given_part(used_in_parts, part):
+            where_used = part.where_used()
+            used_in_parts.update(where_used)
+            for p in where_used:
+                where_used_given_part(used_in_parts, p)
+            return used_in_parts
+
+        used_in_parts = set()
+        where_used_given_part(used_in_parts, self)
+        return list(used_in_parts)
+
+    def next_revision(self):
+        try:
+            return int(self.revision) + 1
+        except ValueError:
+            return increment_str(self.revision)
+
+    def __str__(self):
+        return u'{}, Rev {}'.format(self.part.full_part_number(), self.revision)
+
+
+class AssemblySubparts(models.Model):
+    assembly = models.ForeignKey('Assembly', models.CASCADE)
+    subpart = models.ForeignKey('Subpart', models.CASCADE)
+
+    class Meta:
+        db_table = 'bom_assembly_subparts'
+        unique_together = (('assembly', 'subpart'),)
+
+
+class Subpart(models.Model):
+    part_revision = models.ForeignKey('PartRevision', related_name='assembly_subpart', null=True, on_delete=models.CASCADE)
+    count = models.FloatField(default=1, validators=[MinValueValidator(0)])
+    reference = models.TextField(default='', blank=True, null=True)
+    do_not_load = models.BooleanField(default=False, verbose_name='Do Not Load')
+
+    def save(self, *args, **kwargs):
+        # Make sure reference designators are formated as a string with comma-separated fields.
+        try:
+            reference = stringify_list(listify_string(self.reference))
+            self.reference = reference
+        except TypeError:
+            pass
+        super(Subpart, self).save(*args, **kwargs)
+
+    def __str__(self):
+        return u'{} {}'.format(self.part_revision, self.count)
+
+
+class Assembly(models.Model):
+    subparts = models.ManyToManyField(Subpart, related_name='assemblies', through='AssemblySubparts')
+
+
+class ManufacturerPart(models.Model, AsDictModel):
+    part = models.ForeignKey(Part, on_delete=models.CASCADE, db_index=True)
+    manufacturer_part_number = models.CharField(max_length=128, default='', blank=True)
+    manufacturer = models.ForeignKey(Manufacturer, default=None, blank=True, null=True, on_delete=models.CASCADE)
+    mouser_disable = models.BooleanField(default=False)
+    link = models.URLField(null=True, blank=True)
+
+    class Meta:
+        unique_together = [
+            'part',
+            'manufacturer_part_number',
+            'manufacturer']
+
+    def seller_parts(self):
+        return SellerPart.objects.filter(manufacturer_part=self).order_by('seller', 'minimum_order_quantity')
+
+    def optimal_seller(self, quantity=None):
+        if quantity is None:
+            qty_cache_key = str(self.part.id) + '_qty'
+            quantity = int(cache.get(qty_cache_key, 100))
+        sellerparts = SellerPart.objects.filter(manufacturer_part=self)
+        return SellerPart.optimal(sellerparts, quantity)
+
+    def as_dict_for_export(self):
+        return {
+            'manufacturer_name': self.manufacturer.name if self.manufacturer is not None else '',
+            'manufacturer_part_number': self.manufacturer_part_number
+        }
+
+    def __str__(self):
+        return u'%s' % (self.manufacturer_part_number)
+
+
+class Seller(models.Model, AsDictModel):
+    organization = models.ForeignKey(Organization, on_delete=models.CASCADE)
+    name = models.CharField(max_length=128, default=None)
+
+    def __str__(self):
+        return u'%s' % (self.name)
+
+
+class SellerPart(models.Model, AsDictModel):
+    seller = models.ForeignKey(Seller, on_delete=models.CASCADE)
+    seller_part_number = models.CharField(max_length=64, default='', blank=True, null=True)
+    manufacturer_part = models.ForeignKey(ManufacturerPart, on_delete=models.CASCADE)
+    minimum_order_quantity = models.PositiveIntegerField(default=1)
+    minimum_pack_quantity = models.PositiveIntegerField(default=1)
+    data_source = models.CharField(max_length=32, default=None, null=True, blank=True)
+    # "To comply with certain strict accounting or financial regulations, you may consider using max_digits=19 and decimal_places=4"
+    unit_cost = MoneyField(max_digits=19, decimal_places=4, default_currency='USD')
+    lead_time_days = models.PositiveIntegerField(null=True, blank=True)
+    nre_cost = MoneyField(max_digits=19, decimal_places=4, default_currency='USD')
+    link = models.URLField(null=True, blank=True)
+    ncnr = models.BooleanField(default=False)
+
+    def as_dict(self):
+        d = super().as_dict()
+        d['unit_cost'] = self.unit_cost.amount
+        d['nre_cost'] = self.nre_cost.amount
+        return d
+
+    def as_dict_for_export(self):
+        return {
+            'manufacturer_name': self.manufacturer_part.manufacturer.name if self.manufacturer_part.manufacturer is not None else '',
+            'manufacturer_part_number': self.manufacturer_part.manufacturer_part_number,
+            'seller': self.seller.name,
+            'seller_part_number': self.seller_part_number,
+            'unit_cost': self.unit_cost,
+            'minimum_order_quantity': self.minimum_order_quantity,
+            'nre_cost': self.nre_cost
+        }
+
+    @staticmethod
+    def optimal(sellerparts, quantity):
+        seller = None
+        for sellerpart in sellerparts:
+            if seller is None:
+                seller = sellerpart
+            else:
+                new_quantity = quantity if sellerpart.minimum_order_quantity < quantity else sellerpart.minimum_order_quantity
+                new_total_cost = new_quantity * sellerpart.unit_cost
+                old_quantity = quantity if seller.minimum_order_quantity < quantity else seller.minimum_order_quantity
+                old_total_cost = old_quantity * seller.unit_cost
+                if new_total_cost < old_total_cost:
+                    seller = sellerpart
+        return seller
+
+    def order_quantity(self, extended_quantity):
+        order_qty = extended_quantity
+        if self.minimum_order_quantity and extended_quantity > self.minimum_order_quantity:
+            order_qty = ceil(extended_quantity / float(self.minimum_order_quantity)) * self.minimum_order_quantity
+        return order_qty
+
+    def __str__(self):
+        return u'%s' % (self.manufacturer_part.part.full_part_number() + ' ' + self.seller.name)