django-nova 0.2.0__tar.gz

django_nova-0.2.0/.github/workflows/python-publish.yml

@@ -0,0 +1,70 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      # url: https://pypi.org/p/YOURPROJECT
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+       url: https://test.pypi.org/project/django-nova/0.1.0/${{ Artem Alimpiev }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

django_nova-0.2.0/.idea/.gitignore

@@ -0,0 +1,5 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/

django_nova-0.2.0/.idea/django-nova.iml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="Python 3.12 (django-nova) (2)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

django_nova-0.2.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,24 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="PyCompatibilityInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ourVersions">
+        <value>
+          <list size="2">
+            <item index="0" class="java.lang.String" itemvalue="2.7" />
+            <item index="1" class="java.lang.String" itemvalue="3.14" />
+          </list>
+        </value>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="PyPackageRequirementsInspection" enabled="true" level="WARNING" enabled_by_default="true">
+      <option name="ignoredPackages">
+        <list>
+          <option value="pytest-asyn" />
+          <option value="cio" />
+          <option value="langchain-openai" />
+        </list>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

django_nova-0.2.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

django_nova-0.2.0/.idea/markdown.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MarkdownSettings">
+    <option name="previewPanelProviderInfo">
+      <ProviderInfo name="Mermaid Studio (Chromium browser)" className="MermaidStudio_z.MermaidStudio_R.MermaidStudio_n.MermaidStudio_Q.MermaidStudio_U.MermaidStudio__.JCEFHtmlPanelProvider" />
+    </option>
+  </component>
+</project>

django_nova-0.2.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.12 (django-nova) (2)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.12 (django-nova) (2)" project-jdk-type="Python SDK" />
+</project>

django_nova-0.2.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/django-nova.iml" filepath="$PROJECT_DIR$/.idea/django-nova.iml" />
+    </modules>
+  </component>
+</project>

django_nova-0.2.0/.idea/shelf/Uncommitted_changes_before_Update_at_12_06_2026,_08_36_[Changes]/shelved.patch

@@ -0,0 +1,31 @@
+Index: run_fastapi.py
+IDEA additional info:
+Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
+<+>UTF-8
+===================================================================
+diff --git a/run_fastapi.py b/run_fastapi.py
+new file mode 100644
+--- /dev/null	(date 1781207527557)
++++ b/run_fastapi.py	(date 1781207527557)
+@@ -0,0 +1,20 @@
++import django
++from django.conf import settings
++
++if not settings.configured:
++    settings.configure(
++        DEBUG=True,
++        DATABASES={'default': {'ENGINE': 'django.db.backends.sqlite3', 'NAME': ':memory:'}},
++        INSTALLED_APPS=['django.contrib.contenttypes', 'django.contrib.auth', 'nova', 'tests.apps.TestsConfig'],
++        SECRET_KEY='test', USE_TZ=True,
++    )
++django.setup()
++
++from fastapi import FastAPI
++from nova.ecosystem.fastapi import to_fastapi_router
++from tests.models import Lab
++
++app = FastAPI(title="Django Nova OpenAPI Demo", version="0.1.0")
++app.include_router(to_fastapi_router(Lab, prefix="/api/labs"))
++
++# Запуск: uvicorn run_fastapi:app --reload
+

django_nova-0.2.0/.idea/shelf/Uncommitted_changes_before_Update_at_12_06_2026__08_36__Changes_.xml

@@ -0,0 +1,4 @@
+<changelist name="Uncommitted_changes_before_Update_at_12_06_2026,_08_36_[Changes]" date="1781242616719" recycled="false" toDelete="true">
+  <option name="PATH" value="$PROJECT_DIR$/.idea/shelf/Uncommitted_changes_before_Update_at_12_06_2026,_08_36_[Changes]/shelved.patch" />
+  <option name="DESCRIPTION" value="Uncommitted changes before Update at 12.06.2026, 08:36 [Changes]" />
+</changelist>

django_nova-0.2.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

django_nova-0.2.0/.idea/workspace.xml

@@ -0,0 +1,147 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="2040f54d-711a-4dfd-88d1-7c5051d4a070" name="Changes" comment="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem">
+      <change beforePath="$PROJECT_DIR$/dist/django_nova-0.2.0-py3-none-any.whl" beforeDir="false" />
+      <change beforePath="$PROJECT_DIR$/dist/django_nova-0.2.0.tar.gz" beforeDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;Artem7898&quot;
+  }
+}</component>
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/Artem7898/django-nova.git&quot;,
+    &quot;accountId&quot;: &quot;c08155fe-f126-45fc-acbd-91240ab8f3c1&quot;
+  }
+}</component>
+  <component name="McpProjectServerCommands">
+    <commands />
+    <urls />
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;customColor&quot;: &quot;&quot;,
+  &quot;associatedIndex&quot;: 2
+}</component>
+  <component name="ProjectId" id="3CCEcBOjDYLt0mtxULic5GNBsHq" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.MCP Project settings loaded&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.typescript.service.memoryLimit.init&quot;: &quot;true&quot;,
+    &quot;codeWithMe.voiceChat.enabledByDefault&quot;: &quot;false&quot;,
+    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
+    &quot;last_opened_file_path&quot;: &quot;/home/atrem/PycharmProjects/django-nova&quot;,
+    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
+    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
+    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
+    &quot;settings.editor.selected.configurable&quot;: &quot;com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable&quot;
+  }
+}</component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-024ed6589d45-c2ffad84badb-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-261.23567.174" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="2040f54d-711a-4dfd-88d1-7c5051d4a070" name="Changes" comment="" />
+      <created>1775881230494</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1775881230494</updated>
+    </task>
+    <task id="LOCAL-00001" summary="Migration Safety Hardening">
+      <option name="closed" value="true" />
+      <created>1781242256699</created>
+      <option name="number" value="00001" />
+      <option name="presentableId" value="LOCAL-00001" />
+      <option name="project" value="LOCAL" />
+      <updated>1781242256699</updated>
+    </task>
+    <task id="LOCAL-00002" summary="Migration Safety Hardening">
+      <option name="closed" value="true" />
+      <created>1781243330688</created>
+      <option name="number" value="00002" />
+      <option name="presentableId" value="LOCAL-00002" />
+      <option name="project" value="LOCAL" />
+      <updated>1781243330688</updated>
+    </task>
+    <task id="LOCAL-00003" summary="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem">
+      <option name="closed" value="true" />
+      <created>1781246810674</created>
+      <option name="number" value="00003" />
+      <option name="presentableId" value="LOCAL-00003" />
+      <option name="project" value="LOCAL" />
+      <updated>1781246810674</updated>
+    </task>
+    <task id="LOCAL-00004" summary="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem">
+      <option name="closed" value="true" />
+      <created>1781255936367</created>
+      <option name="number" value="00004" />
+      <option name="presentableId" value="LOCAL-00004" />
+      <option name="project" value="LOCAL" />
+      <updated>1781255936367</updated>
+    </task>
+    <task id="LOCAL-00005" summary="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem">
+      <option name="closed" value="true" />
+      <created>1781256186897</created>
+      <option name="number" value="00005" />
+      <option name="presentableId" value="LOCAL-00005" />
+      <option name="project" value="LOCAL" />
+      <updated>1781256186897</updated>
+    </task>
+    <option name="localTasksCounter" value="6" />
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="Vcs.Log.Tabs.Properties">
+    <option name="TAB_STATES">
+      <map>
+        <entry key="MAIN">
+          <value>
+            <State />
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+  <component name="VcsManagerConfiguration">
+    <MESSAGE value="Migration Safety Hardening" />
+    <MESSAGE value="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem" />
+    <option name="LAST_COMMIT_MESSAGE" value="Release v0.2.0: Enterprise Observability, DRF &amp; FastAPI Ecosystem" />
+  </component>
+</project>

django_nova-0.2.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+## [0.2.0] - 2025-05-06 - "Enterprise & Ecosystem"
+
+### Added
+- **Structured Observability:** Integrated `structlog` for machine-readable JSON logging. Cache miss/hit events now include ISO-timestamps and execution timings.
+- **Distributed Tracing:** Added OpenTelemetry integration (`nova.core.tracing`). Automatic spans for `Model.save()` and `QuerySetCache` operations. Uses "Safe Import" pattern (0 overhead if OTEL is not installed).
+- **Migration Safety:** Implemented `AddFieldConcurrently` and `CreateIndexConcurrently` for true zero-downtime schema changes on PostgreSQL.
+- **DRF Auto-Serializer:** Added `to_drf_serializer()`. Dynamically generates Django Rest Framework `ModelSerializer` that delegates business logic validation strictly to Pydantic schemas.
+- **FastAPI Auto-Router:** Added `to_fastapi_router()`. Dynamically generates FastAPI endpoints (`GET/POST`) bound to Django ORM.
+- **Native OpenAPI:** FastAPI routers automatically generate perfect Swagger/OpenAPI schemas using runtime signature injection (`inspect.Signature`), bypassing PEP 563 limitations.
+
+### Changed
+- `QuerySetCache` now uses SQL Compiler for deterministic cache key hashing (safe across all Django 5.x versions).
+- `QuerySetCache` invalidation moved from hash-search to O(1) reverse index mapping.
+

django_nova-0.2.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: django-nova
+Version: 0.2.0
+Summary: Next-generation Django toolkit: typed ORM, unified validation, async-first, smart caching
+Author-email: Artem Alimpiev <alimpievne@gmail.com>
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Requires-Dist: asyncpg>=0.30; extra == 'async'
+Requires-Dist: cachetools>=5.4
+Requires-Dist: django<6.0,>=5.0
+Requires-Dist: pydantic-settings<3.0,>=2.5
+Requires-Dist: pydantic<3.0,>=2.8
+Requires-Dist: redis>=5.0; extra == 'cache'
+Requires-Dist: typing-extensions>=4.12
+Provides-Extra: async
+Requires-Dist: asyncpg>=0.30; extra == 'async'
+Requires-Dist: databases[asyncpg]>=0.9; extra == 'async'
+Provides-Extra: cache
+Requires-Dist: hiredis>=3.0; extra == 'cache'
+Requires-Dist: redis>=5.0; extra == 'cache'
+Provides-Extra: dev
+Requires-Dist: coverage>=7.6; extra == 'dev'
+Requires-Dist: djangorestframework>=3.15; extra == 'dev'
+Requires-Dist: fastapi>=0.115; extra == 'dev'
+Requires-Dist: hatch>=1.12; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: opentelemetry-api>=1.20; extra == 'dev'
+Requires-Dist: pyright>=1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-django>=4.9; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: structlog>=24.0; extra == 'dev'
+Provides-Extra: drf
+Requires-Dist: djangorestframework>=3.15; extra == 'drf'
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.115; extra == 'fastapi'
+Requires-Dist: uvicorn>=0.30; extra == 'fastapi'
+Provides-Extra: observability
+Requires-Dist: structlog>=24.0; extra == 'observability'
+Provides-Extra: tasks
+Requires-Dist: asyncio-throttle>=1.0; extra == 'tasks'
+Provides-Extra: tracing
+Requires-Dist: opentelemetry-api>=1.20; extra == 'tracing'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# 🚀 Django Nova
+
+**Typed, unified, and async-first toolkit for Django 5+**
+
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
+[![Django 5.0+](https://img.shields.io/badge/django-5.0%2B-green.svg)](https://www.djangoproject.com/)
+[![PyPI version](https://img.shields.io/pypi/v/django-nova.svg)](https://pypi.org/project/django-nova/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+*Django Nova eliminates fundamental architectural flaws in Django that lead to data corruption, runtime errors, and maintainability issues in scientific and enterprise software.*
+
+</div>
+
+---
+
+## 🔑 Key Innovations
+
+- ✅ **Single Source of Truth:** Define validation once in Pydantic. Django Models, Forms, and APIs automatically read from it. No more duplication.
+- 🔒 **Strict Type Safety:** Full `pyright --strict` compatibility for ORM, QuerySets, and Models using modern PEP 695 syntax.
+- ⚡ **Smart QuerySet Cache:** Automatic O(1) cache invalidation on write via Django signals. Zero percent stale data in research pipelines.
+- 🔄 **Zero-Downtime Migrations:** Native PostgreSQL `CONCURRENTLY` operations for locked tables containing millions of rows.
+- 📊 **Structured Observability:** Built-in `structlog` integration emitting machine-readable JSON logs with ISO-timestamps for Datadog/ELK.
+- 🔍 **Distributed Tracing:** OpenTelemetry spans for `Model.save()` and Cache operations. Zero overhead if OTEL is not installed.
+- 🔌 **DRF Auto-Serializer:** Generate Django Rest Framework Serializers dynamically from Pydantic schemas. Pydantic validation overrides DRF.
+- 🚀 **FastAPI Auto-Router:** Generate fully documented FastAPI routers with native OpenAPI/Swagger from Django models.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Core library
+pip install django-nova
+
+# With DRF support
+pip install django-nova[drf]
+
+# With FastAPI support
+pip install django-nova[fastapi]
+
+# With full enterprise stack (tracing, logging)
+pip install django-nova[tracing,observability]
+```
+
+---
+
+## 💡 Usage Example
+
+### Define your rules once, use them everywhere:
+
+```python
+# models.py
+from pydantic import BaseModel, field_validator
+from django.db import models
+from nova import NovaModel, NovaConfig
+
+# 1. Define validation rules (ONCE)
+class ResearcherSchema(BaseModel):
+    name: str
+    h_index: int = 0
+
+    @field_validator("h_index")
+    @classmethod
+    def validate_h_index(cls, v: int) -> int:
+        if v < 0:
+            raise ValueError("h-index cannot be negative")
+        return v
+
+# 2. Link to Django
+class Researcher(NovaModel):
+    name = models.CharField(max_length=300)
+    h_index = models.IntegerField(default=0)
+
+    _nova_config = NovaConfig(
+        pydantic_schema=ResearcherSchema,
+        cache_enabled=True,
+        strict_validation=True
+    )
+```
+
+**Now, any attempt to save invalid data is blocked at the ORM level, and the schema is automatically reused in DRF and FastAPI!**
+
+---
+
+## 🔗 Ecosystem Integration
+
+Django Nova acts as a universal hub between Python frameworks.
+
+### Django Rest Framework
+
+```python
+from nova.ecosystem.drf import to_drf_serializer
+
+# Dynamically generates a ModelSerializer that delegates business logic to Pydantic
+ResearcherSerializer = to_drf_serializer(Researcher)
+```
+
+### FastAPI
+
+```python
+from fastapi import FastAPI
+from nova.ecosystem.fastapi import to_fastapi_router
+
+app = FastAPI()
+# Generates GET/POST endpoints with native OpenAPI/Swagger documentation
+app.include_router(to_fastapi_router(Researcher, prefix="/api/researchers"))
+```
+
+---
+
+## 🏗️ Architecture
+
+Django Nova intercepts standard processes at the core level:
+
+```text
+Request -> View -> Model.save() -> [Pydantic Validation -> Django Fields -> Business Logic] -> DB
+                |
+                +-> Cache Invalidation Signal -> Evict stale QuerySets
+                |
+                +-> OpenTelemetry Span -> Metrics & Traces
+                |
+                +-> Structlog -> JSON Logs to Datadog/ELK
+```
+
+### Core Tech Stack:
+
+- **PEP 562:** Lazy imports bypassing AppRegistryNotReady.
+- **PEP 695:** Modern generic syntax (`class Cache[T]:`).
+- **SQL Compiler:** Deterministic cache hash key generation (safe across any Django version).
+
+---
+
+## 🧪 Testing
+
+The project is tested on the bleeding-edge stack (Python 3.14 + Django 5.2).
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v  # 39 passed
+```
+
+---
+
+## 👤 Author
+
+**Artem Alimpiev**
+
+- ORCID: [0009-0007-6740-7242](https://orcid.org/0009-0007-6740-7242)
+- DOI: [10.5281/zenodo.20057443](https://doi.org/10.5281/zenodo.20057443)
+- DOI: [10.5281/zenodo.20659647](https://doi.org/10.5281/zenodo.20659647)
+
+---
+
+## 📄 License
+
+This project is licensed under the terms of the MIT License. See the [LICENSE](LICENSE) file for details.