openforce/custom_objects/models.py
2026-09-26 07:31:43 +00:00

131 lines
5 KiB
Python

import re
from django.db import models
from django.contrib.auth import get_user_model
from django.contrib.postgres.indexes import GinIndex
from django.core.exceptions import ValidationError
User = get_user_model()
RESERVED_NAMES = {
'id', 'pk', 'user', 'created_at', 'updated_at', 'account', 'contact',
'lead', 'opportunity', 'activity', 'select', 'where', 'from', 'table',
'drop', 'delete', 'insert', 'update'
}
def validate_api_name(value):
if not re.match(r'^[a-z][a-z0-9_]*$', value):
raise ValidationError(
f"'{value}' is not a valid API name. Must start with lowercase letter and contain only alphanumeric and underscores."
)
clean_val = value[:-3] if value.endswith('__c') else value
if clean_val.lower() in RESERVED_NAMES:
raise ValidationError(f"'{value}' is a reserved system keyword.")
class CustomObjectDefinition(models.Model):
name = models.CharField(max_length=100, unique=True, validators=[validate_api_name])
api_name = models.CharField(max_length=100, unique=True, blank=True, validators=[validate_api_name])
label = models.CharField(max_length=100)
plural_label = models.CharField(max_length=100, blank=True, default='')
description = models.TextField(blank=True, default='')
created_by = models.ForeignKey(User, null=True, blank=True, on_delete=models.SET_NULL)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
def clean(self):
super().clean()
if self.name and not self.name.endswith('__c'):
self.name = f"{self.name}__c"
if self.api_name and not self.api_name.endswith('__c'):
self.api_name = f"{self.api_name}__c"
if not self.api_name and self.name:
self.api_name = self.name
if not self.name and self.api_name:
self.name = self.api_name
def save(self, *args, **kwargs):
if not self.api_name and self.name:
self.api_name = self.name
if not self.name and self.api_name:
self.name = self.api_name
super().save(*args, **kwargs)
def __str__(self):
return f"{self.label} ({self.name})"
class CustomFieldDefinition(models.Model):
FIELD_TYPE_CHOICES = [
('text', 'Text'),
('number', 'Number'),
('boolean', 'Boolean'),
('date', 'Date'),
('datetime', 'DateTime'),
('email', 'Email'),
('url', 'URL'),
('select', 'Picklist (Select)'),
('picklist', 'Picklist'),
('lookup', 'Lookup (Relationship)'),
]
custom_object = models.ForeignKey(
CustomObjectDefinition, on_delete=models.CASCADE, related_name='fields'
)
name = models.CharField(max_length=100, validators=[validate_api_name])
label = models.CharField(max_length=100)
field_type = models.CharField(max_length=20, choices=FIELD_TYPE_CHOICES)
is_required = models.BooleanField(default=False)
is_unique = models.BooleanField(default=False)
default_value = models.JSONField(null=True, blank=True)
choices = models.JSONField(null=True, blank=True, help_text="List of choices for 'select' type")
options = models.JSONField(null=True, blank=True, help_text="List of choices for picklist")
target_object = models.ForeignKey(
CustomObjectDefinition, null=True, blank=True, on_delete=models.SET_NULL,
related_name='referencing_fields', help_text="Target for 'lookup' type"
)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
unique_together = [['custom_object', 'name']]
def clean(self):
super().clean()
if self.name and not self.name.endswith('__c'):
self.name = f"{self.name}__c"
if self.field_type == 'select' and not self.choices:
raise ValidationError({'choices': 'Select fields require a list of choices.'})
if self.field_type == 'lookup' and not self.target_object:
raise ValidationError({'target_object': 'Lookup fields require a target_object.'})
def __str__(self):
return f"{self.custom_object.name}.{self.name} ({self.field_type})"
class CustomRecord(models.Model):
custom_object = models.ForeignKey(
CustomObjectDefinition, on_delete=models.CASCADE, related_name='records'
)
data = models.JSONField(default=dict)
owner = models.ForeignKey(User, null=True, blank=True, on_delete=models.SET_NULL)
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
db_table = 'custom_record'
indexes = [
GinIndex(fields=['data'], name='idx_custom_record_data_gin'),
]
ordering = ['-created_at']
def clean(self):
super().clean()
from .schema_engine import validate_record_data
validate_record_data(self.custom_object, self.data)
def __str__(self):
return f"{self.custom_object.name} #{self.id}"