This commit represents a comprehensive improvement of the library's architecture, developer experience, and documentation accuracy. Core Refactoring: - apply DRY principle to models.py by introducing BaseNepaliBSField and BaseLocationField - standardize widget logic in widgets.py using NepaliWidgetMixin - centralize admin filtering logic into BaseNepaliDateFilter New Features & API: - add NepaliMonthFilter for Django Admin and NepaliDateMonthFilter for DRF - implementation of HTMX-driven location chaining for dynamic address selects - extend demo project with comprehensive DRF search, ordering, and filter examples Configuration & Sync: - implement global NEPKIT settings in conf.py (DEFAULT_LANGUAGE, ADMIN_DATEPICKER, etc.) - universalize BS_DATE_FORMAT/BS_DATETIME_FORMAT across the entire stack - synchronize frontend datepicker initialization with backend date formats Documentation & DX: - complete rewrite of README.md into high-energy, factual, English-only guides - project-wide audit and simplification of comments/docstrings for beginner accessibility - expanded 'Technical Design' and 'FAQ' sections covering data integrity and storage - added docs/migration_guide.py for bulk AD-to-BS data transitions Quality & Maintenance: - fixed all E402 module-level import errors across the library - verified codebase with project-wide ruff checks (all checks passed)
55 lines
1.6 KiB
Python
55 lines
1.6 KiB
Python
from django.db import models
|
|
from django_nepkit import (
|
|
NepaliDateField,
|
|
NepaliTimeField,
|
|
NepaliPhoneNumberField,
|
|
NepaliDateTimeField,
|
|
ProvinceField,
|
|
DistrictField,
|
|
MunicipalityField,
|
|
)
|
|
|
|
|
|
class Person(models.Model):
|
|
name = models.CharField(max_length=100)
|
|
# Dates and times
|
|
birth_date = NepaliDateField() # English by default
|
|
birth_date_ne = NepaliDateField(ne=True, blank=True, null=True) # Using Devanagari
|
|
registration_time = NepaliTimeField(auto_now_add=True) # English digits by default
|
|
phone_number = NepaliPhoneNumberField()
|
|
|
|
# Location fields
|
|
province = ProvinceField() # English names by default
|
|
province_ne = ProvinceField(ne=True, blank=True, null=True) # In Devanagari
|
|
district = DistrictField()
|
|
district_ne = DistrictField(ne=True, blank=True, null=True)
|
|
municipality = MunicipalityField()
|
|
municipality_ne = MunicipalityField(ne=True, blank=True, null=True)
|
|
|
|
created_at = NepaliDateTimeField(auto_now_add=True)
|
|
updated_at = NepaliDateTimeField(auto_now=True)
|
|
|
|
def __str__(self):
|
|
return self.name
|
|
|
|
|
|
class Citizen(models.Model):
|
|
name = models.CharField(max_length=100)
|
|
|
|
# Chaining works automatically
|
|
province = ProvinceField()
|
|
district = DistrictField()
|
|
municipality = MunicipalityField()
|
|
|
|
def __str__(self):
|
|
return self.name
|
|
|
|
|
|
class AuditedPerson(models.Model):
|
|
name = models.CharField(max_length=100)
|
|
birth_date = NepaliDateField()
|
|
created_at = NepaliDateTimeField(auto_now_add=True)
|
|
|
|
def __str__(self):
|
|
return self.name
|