Files
django-nepkit/example/demo/models.py
T
sankalp 1338f9e5fe refactor: global project refinement, DRY consolidation, and documentation overhaul
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)
2026-01-30 17:00:33 +05:45

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