django-lux 1.0.0__tar.gz

django_lux-1.0.0/LICENSE

@@ -0,0 +1,105 @@
+# MIT License
+
+Software: django-lux
+Repository: https://github.com/debeski/django-lux
+Author: DeBeski (micro)
+Website: https://github.com/debeski
+Copyright (c) 2026
+
+---
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+# THIRD-PARTY NOTICES
+
+This Software utilizes the following open-source packages. By using this Software,
+you agree to the terms of their respective licenses:
+
+## Python Runtime Dependencies
+The following Python dependencies are declared by the main `django-lux`
+package and should retain their upstream license notices.
+
+- Python (3.9+) - Python Software Foundation License (PSFL)
+  https://docs.python.org/3/license.html
+- Django (5.1+) - BSD-3-Clause License
+  https://github.com/django/django/blob/main/LICENSE
+- django-crispy-forms - MIT License
+  https://github.com/django-crispy-forms/django-crispy-forms/blob/main/LICENSE.txt
+- crispy-bootstrap5 - MIT License
+  https://github.com/django-crispy-forms/crispy-bootstrap5/blob/main/LICENSE
+- django-tables2 - BSD-2-Clause License
+  https://github.com/jieter/django-tables2/blob/master/LICENSE
+- django-filter - BSD-3-Clause License
+  https://github.com/carltongibson/django-filter/blob/main/LICENSE
+- psutil - BSD-3-Clause License
+  https://github.com/giampaolo/psutil/blob/master/LICENSE
+- pyotp - MIT License
+  https://github.com/pyauth/pyotp/blob/main/LICENSE
+- qrcode - BSD-3-Clause License
+  https://github.com/lincolnloop/python-qrcode/blob/main/LICENSE
+- Pillow - HPND (Pillow License)
+  https://github.com/python-pillow/Pillow/blob/main/LICENSE
+- Babel - BSD-3-Clause License
+  https://github.com/python-babel/babel/blob/master/LICENSE
+- cryptography - Apache-2.0 OR BSD-3-Clause
+  https://github.com/pyca/cryptography/blob/main/LICENSE
+- openpyxl - MIT License
+  https://foss.heptapod.net/openpyxl/openpyxl/-/blob/branch/default/LICENCE.rst
+
+## Bundled Frontend Assets
+The following third-party frontend assets are bundled under `dlux/static/`
+and should also retain their upstream license notices.
+
+- Bootstrap - MIT License
+  https://github.com/twbs/bootstrap/blob/main/LICENSE
+- Bootstrap Icons - MIT License
+  https://github.com/twbs/icons/blob/main/LICENSE
+- vanillajs-datepicker - MIT License
+  https://github.com/mymth/vanillajs-datepicker/blob/master/LICENSE
+- Driver.js - MIT License
+  https://github.com/nilbuild/driver.js/blob/master/license
+
+## Bundled Font Assets
+The following bundled font assets should also retain their upstream license
+notices and attribution where applicable.
+
+- Cairo - SIL Open Font License 1.1
+  https://github.com/Gue3bara/Cairo/blob/main/OFL.txt
+- Alexandria - SIL Open Font License 1.1
+  https://github.com/Gue3bara/Alexandria/blob/master/OFL.txt
+- Changa - SIL Open Font License 1.1
+  https://github.com/google/fonts/blob/main/ofl/changa/OFL.txt
+- Markazi Text - SIL Open Font License 1.1
+  https://github.com/google/fonts/blob/main/ofl/markazitext/OFL.txt
+- Readex Pro - SIL Open Font License 1.1
+  https://github.com/google/fonts/blob/main/ofl/readexpro/OFL.txt
+- Twemoji Country Flags / Twemoji Mozilla derived asset
+  Upstream references:
+  https://github.com/PasteBar/country-flags-emoji-polyfill-builder
+  https://github.com/mozilla/twemoji-colr/blob/master/LICENSE.md
+  https://github.com/twitter/twemoji/blob/master/LICENSE-GRAPHICS
+
+## Optional Package Note
+This repository also includes optional packages under `optional_packages/`
+with their own dependency trees, such as `django-lux-sso` and
+`django-lux-sso-client`. If you distribute those optional packages, keep
+their dependency notices aligned with their own `pyproject.toml` metadata as
+well.

django_lux-1.0.0/MANIFEST.in

@@ -0,0 +1,19 @@
+# Include the README so PyPI shows your long description
+include README.md
+
+# Include the license
+include LICENSE
+
+# Include all files inside the users package
+recursive-include dlux *
+
+# If you have templates inside the users app
+recursive-include dlux/templates *
+
+# If you have static files
+recursive-include dlux/static *
+
+# Keep test code and cache artifacts out of source distributions
+prune dlux/tests
+global-exclude __pycache__
+global-exclude *.py[cod]

django_lux-1.0.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: django_lux
+Version: 1.0.0
+Summary: DjangoLux (System Integration Service) - Multilingual Django Starter Pack, Packed with Features.
+Author-email: DeBeski <debeski1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/debeski/django-lux
+Keywords: django,dlux,permissions,authentication
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5
+Classifier: Framework :: Django :: 6
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1
+Requires-Dist: django-crispy-forms>=2.4
+Requires-Dist: django-tables2>=2.7
+Requires-Dist: django-filter>=24.3
+Requires-Dist: crispy-bootstrap5>=2025.6
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: pyotp>=2.9
+Requires-Dist: qrcode>=8.2
+Requires-Dist: pillow>=11.0
+Requires-Dist: babel>=2.1
+Requires-Dist: cryptography>=42.0
+Requires-Dist: openpyxl>=3.1
+Provides-Extra: sso
+Requires-Dist: django-lux-sso>=0.1.0; extra == "sso"
+
+# DjangoLux - System Integration Service
+
+[![PyPI version](https://badge.fury.io/py/django-lux.svg)](https://pypi.org/project/django-lux/)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/debeski/django-lux/main/dlux/static/img/login_logo.webp" alt="DjangoLux Logo" width="450"/>
+</p>
+
+<p align="center">
+  <a href="https://chatgpt.com/g/g-6a14ac8cbb0c8191aad3b3619e5bef21-dlux-agent"><strong>Open DjangoLux Agent on ChatGPT</strong></a><br/>
+  <sub>Specialized custom GPT for django-lux integration, configuration, extension, and troubleshooting.</sub>
+</p>
+
+DjangoLux is a multilingual Django app that gives a project-level system layer for user management, branding, translations, scopes, navigation, activity logging, guided onboarding, data export, and dynamic CRUD tooling. It is not just a themed admin shell: it is a fairly large internal-systems toolkit that bundles runtime configuration, user operations, auditability, UI infrastructure, and zero-boilerplate management patterns into one package. The package keeps the landing README short, You can view the long-form operating and integration guidance at [`docs/`](docs/README.md).
+
+## What DjangoLux gives you
+
+- A first-launch setup wizard at `/sys/setup/` for identity, explicit language catalog management, translation-matrix overrides, access/security toggles, UI-first Dlux email delivery, themes, default table density, global home URL, and sidebar structure, including full sidebar disable, runtime sidebar-toolbar, and user-reordering controls.
+- A runtime system UI for users and superusers, including Options, user management, profiles, 2FA, activity logs, scopes, and system settings.
+- A disabled-by-default public registration playground for email-first local signup with mandatory email verification, Dlux email readiness checks, public-account provenance badges, throttles, and optional approval.
+- A database-backed `SystemSettings` singleton layered over `DLUX_CONFIG`, so projects can seed defaults in code and refine them in the UI later.
+- A framework-owned `django_tables2` platform that auto-adopts stock tables, ships built-in pagination and per-page controls, exposes a public `DluxTable` base class, and supports per-table `dlux_table`, `dlux_density`, `dlux_per_page`, and `dlux_actions` overrides.
+- A `ScopedModel` base with audit fields, soft-delete behavior, actor tracking, filtered managers, and automatic scope handling.
+- Zero-boilerplate sections and dynamic modal CRUD flows for auxiliary models, plus a reusable context-menu/event model for richer interactions.
+- A built-in audit trail with signal-based logging, merged User/Profile updates, diff capture, masked sensitive fields, and download/export log entries.
+- Universal data helpers such as `fetch_file`, `fetch_excel`, sticky-form autofill, tutorial overlays, and persistent UI preferences.
+
+## Requirements
+`note: all the requirements will be installed automatically when you install django-lux.`
+
+- Python 3.11+
+- Django 5.1+
+- `django-crispy-forms`
+- `crispy-bootstrap5`
+- `django-tables2`
+- `django-filter`
+- `pillow` "for image handling"
+- `babel` "for translations"
+- `psutil` "for system monitoring"
+- `pyotp` "for TOTP 2FA"
+- `qrcode` "for TOTP 2FA QR codes"
+- `cryptography` "for encrypted TOTP and SMTP secret storage"
+
+## Installation
+
+```bash
+pip install django-lux
+# OR
+pip install git+https://github.com/debeski/django-lux.git
+```
+
+## Scaffold a New Project or App
+
+```bash
+python -m dlux startproject myproject
+cd myproject
+python -m dlux startapp billing --register
+```
+
+`python -m dlux startproject` creates a new Django project already wired for DjangoLux. `python -m dlux startapp` creates a DjangoLux-native app skeleton with models, forms, filters, tables, translations, templates, tests, and optional project registration.
+
+Generated projects also include a baseline Docker stack with `compose.yml`, `compose.dev.yml`, a `config/celery.py` worker entrypoint, and a `/health/` endpoint via `django-health-check`.
+They also generate `.secrets/.env` with the bootstrap secrets used by the standard decrypter/startup flow.
+The scaffolded settings baseline now also includes `django-cors-headers` and `django-csp` with their apps, middleware, and starter CORS/CSP policy settings.
+
+## Minimal Quick Start
+
+1. Add the DjangoLux helper at the end of your project `settings.py`.
+
+```python
+from dlux.utils import dlux_settings
+
+dlux_settings(globals())
+```
+
+That helper prepends the required apps, inserts `django.middleware.locale.LocaleMiddleware` and `dlux.middleware.DluxMiddleware` in the supported order, adds the Dlux context processor, sets the Crispy Bootstrap 5 defaults, adds a Bootstrap-friendly `MESSAGE_TAGS` error mapping, and seeds the standard DjangoLux runtime defaults for language, timezone, i18n/tz flags, `FORMAT_MODULE_PATH`, and charset unless your project already defines them.
+
+__Proceed to [Getting Started](docs/getting-started.md) if you prefer to wire everything manually.__
+
+Public registration is documented separately at [Public Registration Playground](docs/registration.md). It is disabled by default and is not part of the optional SSO packages.
+
+
+2. Mount `dlux.urls` at project root so the bundled auth and system routes stay at `/accounts/...` and `/sys/...`.
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    path("", include("dlux.urls")),
+]
+```
+
+With that root include in place, dlux provides `/accounts/...` and `/sys/...`. If your project does not define its own `/` view, dlux falls back from an unresolved `/` request into its login/setup flow instead of leaving a 404. On a fresh and unconfigured install, Dlux also guards ordinary anonymous requests so a public root page cannot bypass first-time setup; once setup is complete, your existing root view continues to behave normally.
+
+3. Run the setup command.
+
+```bash
+python manage.py dlux_setup
+```
+
+4. Sign in as a superuser and complete the first-launch wizard at `/sys/setup/`. On a fresh install, an anonymous request may be sent through `/sys/setup/` and then to login before the wizard can be completed. After setup, the main runtime UI lives under `user_hub`.
+
+For a fuller setup path, prefix-mount guidance, and first-launch expectations, use the [Getting Started guide](docs/getting-started.md).
+
+
+## Key Capabilities
+
+- Onboarding and runtime configuration:
+  first-launch setup wizard, Options view, runtime System Settings modal, source-tabbed translation overrides, setup import/export, language/theme defaults, and a global Home destination.
+- User and security operations:
+  interactive user wizard, grouped translated permissions, four-tier staff authorization (superuser, Global Staff, Central Staff, Scoped Staff), permission-based sidebar visibility, profile management, multiple 2FA flows (App, Email, Backup), trusted device tracking for 30 days, and runtime preference persistence.
+- Generic CRUD infrastructure:
+  dynamic sections, AJAX-driven modal CRUD, automatic form/table/filter discovery, context-menu actions, and reusable event dispatch.
+- Navigation and UI infrastructure:
+  resolver-driven sidebar builder with permission-based visibility, runtime tree rendering, optional user-level reordering, configurable sidebar toolbar visibility, a shared theme registry, tutorial overlays, theme-aware system surfaces, and template injection hooks.
+- Data movement and productivity helpers:
+  universal file download, Excel export, smart autofill, sticky-form cloning, and generic list/filter helpers.
+- Audit and governance:
+  signal-based activity logging with configurable IP resolution (direct/proxy/header), diff capture, masked sensitive fields, deduplicated entries, download/export logging, and scoped visibility.
+- Optional SSO:
+  `django-lux-sso` and `django-lux-sso-client` live as separate optional packages for OIDC provider/client deployments without changing core Dlux runtime behavior.
+- Standalone backup viewer:
+  `tools/dlb-viewer/` is a dependency-free, cross-platform binary for inspecting encrypted `.dlb` system backups offline — browse models, rows, and stored files without a running instance. Prebuilt binaries ship with each release.
+- Framework-level automation:
+  translation patches, scoped-model auto-injection, actor tracking, soft-delete, and config layering across defaults, project settings, and runtime UI.
+
+## Documentation
+
+- [Documentation Hub](docs/README.md)
+- [Security Policy](SECURITY.md)
+- [Contributing Guide](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Getting Started](docs/getting-started.md)
+- [Admin Guide](docs/admin-guide.md)
+- [Developer Guide](docs/developer-guide.md)
+- [Customization Guide](docs/customization-guide.md)
+- [Reference](docs/reference.md)
+- [MSRP-1 Security Standard](docs/security-msrp-1.md)
+- [Optional SSO Packages](docs/sso.md)
+- [Standalone .dlb Backup Viewer](tools/dlb-viewer/README.md)
+- [Releasing](docs/RELEASING.md) — tag-driven PyPI + GitHub release flow
+- [Migrating from django-microsys](docs/migrating-from-microsys.md) — in-place upgrade for existing deployments
+- [Features](docs/FEATURES.md) — complete feature inventory
+- [Changelog](CHANGELOG.md)

django_lux-1.0.0/README.md

@@ -0,0 +1,144 @@
+# DjangoLux - System Integration Service
+
+[![PyPI version](https://badge.fury.io/py/django-lux.svg)](https://pypi.org/project/django-lux/)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/debeski/django-lux/main/dlux/static/img/login_logo.webp" alt="DjangoLux Logo" width="450"/>
+</p>
+
+<p align="center">
+  <a href="https://chatgpt.com/g/g-6a14ac8cbb0c8191aad3b3619e5bef21-dlux-agent"><strong>Open DjangoLux Agent on ChatGPT</strong></a><br/>
+  <sub>Specialized custom GPT for django-lux integration, configuration, extension, and troubleshooting.</sub>
+</p>
+
+DjangoLux is a multilingual Django app that gives a project-level system layer for user management, branding, translations, scopes, navigation, activity logging, guided onboarding, data export, and dynamic CRUD tooling. It is not just a themed admin shell: it is a fairly large internal-systems toolkit that bundles runtime configuration, user operations, auditability, UI infrastructure, and zero-boilerplate management patterns into one package. The package keeps the landing README short, You can view the long-form operating and integration guidance at [`docs/`](docs/README.md).
+
+## What DjangoLux gives you
+
+- A first-launch setup wizard at `/sys/setup/` for identity, explicit language catalog management, translation-matrix overrides, access/security toggles, UI-first Dlux email delivery, themes, default table density, global home URL, and sidebar structure, including full sidebar disable, runtime sidebar-toolbar, and user-reordering controls.
+- A runtime system UI for users and superusers, including Options, user management, profiles, 2FA, activity logs, scopes, and system settings.
+- A disabled-by-default public registration playground for email-first local signup with mandatory email verification, Dlux email readiness checks, public-account provenance badges, throttles, and optional approval.
+- A database-backed `SystemSettings` singleton layered over `DLUX_CONFIG`, so projects can seed defaults in code and refine them in the UI later.
+- A framework-owned `django_tables2` platform that auto-adopts stock tables, ships built-in pagination and per-page controls, exposes a public `DluxTable` base class, and supports per-table `dlux_table`, `dlux_density`, `dlux_per_page`, and `dlux_actions` overrides.
+- A `ScopedModel` base with audit fields, soft-delete behavior, actor tracking, filtered managers, and automatic scope handling.
+- Zero-boilerplate sections and dynamic modal CRUD flows for auxiliary models, plus a reusable context-menu/event model for richer interactions.
+- A built-in audit trail with signal-based logging, merged User/Profile updates, diff capture, masked sensitive fields, and download/export log entries.
+- Universal data helpers such as `fetch_file`, `fetch_excel`, sticky-form autofill, tutorial overlays, and persistent UI preferences.
+
+## Requirements
+`note: all the requirements will be installed automatically when you install django-lux.`
+
+- Python 3.11+
+- Django 5.1+
+- `django-crispy-forms`
+- `crispy-bootstrap5`
+- `django-tables2`
+- `django-filter`
+- `pillow` "for image handling"
+- `babel` "for translations"
+- `psutil` "for system monitoring"
+- `pyotp` "for TOTP 2FA"
+- `qrcode` "for TOTP 2FA QR codes"
+- `cryptography` "for encrypted TOTP and SMTP secret storage"
+
+## Installation
+
+```bash
+pip install django-lux
+# OR
+pip install git+https://github.com/debeski/django-lux.git
+```
+
+## Scaffold a New Project or App
+
+```bash
+python -m dlux startproject myproject
+cd myproject
+python -m dlux startapp billing --register
+```
+
+`python -m dlux startproject` creates a new Django project already wired for DjangoLux. `python -m dlux startapp` creates a DjangoLux-native app skeleton with models, forms, filters, tables, translations, templates, tests, and optional project registration.
+
+Generated projects also include a baseline Docker stack with `compose.yml`, `compose.dev.yml`, a `config/celery.py` worker entrypoint, and a `/health/` endpoint via `django-health-check`.
+They also generate `.secrets/.env` with the bootstrap secrets used by the standard decrypter/startup flow.
+The scaffolded settings baseline now also includes `django-cors-headers` and `django-csp` with their apps, middleware, and starter CORS/CSP policy settings.
+
+## Minimal Quick Start
+
+1. Add the DjangoLux helper at the end of your project `settings.py`.
+
+```python
+from dlux.utils import dlux_settings
+
+dlux_settings(globals())
+```
+
+That helper prepends the required apps, inserts `django.middleware.locale.LocaleMiddleware` and `dlux.middleware.DluxMiddleware` in the supported order, adds the Dlux context processor, sets the Crispy Bootstrap 5 defaults, adds a Bootstrap-friendly `MESSAGE_TAGS` error mapping, and seeds the standard DjangoLux runtime defaults for language, timezone, i18n/tz flags, `FORMAT_MODULE_PATH`, and charset unless your project already defines them.
+
+__Proceed to [Getting Started](docs/getting-started.md) if you prefer to wire everything manually.__
+
+Public registration is documented separately at [Public Registration Playground](docs/registration.md). It is disabled by default and is not part of the optional SSO packages.
+
+
+2. Mount `dlux.urls` at project root so the bundled auth and system routes stay at `/accounts/...` and `/sys/...`.
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    path("", include("dlux.urls")),
+]
+```
+
+With that root include in place, dlux provides `/accounts/...` and `/sys/...`. If your project does not define its own `/` view, dlux falls back from an unresolved `/` request into its login/setup flow instead of leaving a 404. On a fresh and unconfigured install, Dlux also guards ordinary anonymous requests so a public root page cannot bypass first-time setup; once setup is complete, your existing root view continues to behave normally.
+
+3. Run the setup command.
+
+```bash
+python manage.py dlux_setup
+```
+
+4. Sign in as a superuser and complete the first-launch wizard at `/sys/setup/`. On a fresh install, an anonymous request may be sent through `/sys/setup/` and then to login before the wizard can be completed. After setup, the main runtime UI lives under `user_hub`.
+
+For a fuller setup path, prefix-mount guidance, and first-launch expectations, use the [Getting Started guide](docs/getting-started.md).
+
+
+## Key Capabilities
+
+- Onboarding and runtime configuration:
+  first-launch setup wizard, Options view, runtime System Settings modal, source-tabbed translation overrides, setup import/export, language/theme defaults, and a global Home destination.
+- User and security operations:
+  interactive user wizard, grouped translated permissions, four-tier staff authorization (superuser, Global Staff, Central Staff, Scoped Staff), permission-based sidebar visibility, profile management, multiple 2FA flows (App, Email, Backup), trusted device tracking for 30 days, and runtime preference persistence.
+- Generic CRUD infrastructure:
+  dynamic sections, AJAX-driven modal CRUD, automatic form/table/filter discovery, context-menu actions, and reusable event dispatch.
+- Navigation and UI infrastructure:
+  resolver-driven sidebar builder with permission-based visibility, runtime tree rendering, optional user-level reordering, configurable sidebar toolbar visibility, a shared theme registry, tutorial overlays, theme-aware system surfaces, and template injection hooks.
+- Data movement and productivity helpers:
+  universal file download, Excel export, smart autofill, sticky-form cloning, and generic list/filter helpers.
+- Audit and governance:
+  signal-based activity logging with configurable IP resolution (direct/proxy/header), diff capture, masked sensitive fields, deduplicated entries, download/export logging, and scoped visibility.
+- Optional SSO:
+  `django-lux-sso` and `django-lux-sso-client` live as separate optional packages for OIDC provider/client deployments without changing core Dlux runtime behavior.
+- Standalone backup viewer:
+  `tools/dlb-viewer/` is a dependency-free, cross-platform binary for inspecting encrypted `.dlb` system backups offline — browse models, rows, and stored files without a running instance. Prebuilt binaries ship with each release.
+- Framework-level automation:
+  translation patches, scoped-model auto-injection, actor tracking, soft-delete, and config layering across defaults, project settings, and runtime UI.
+
+## Documentation
+
+- [Documentation Hub](docs/README.md)
+- [Security Policy](SECURITY.md)
+- [Contributing Guide](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Getting Started](docs/getting-started.md)
+- [Admin Guide](docs/admin-guide.md)
+- [Developer Guide](docs/developer-guide.md)
+- [Customization Guide](docs/customization-guide.md)
+- [Reference](docs/reference.md)
+- [MSRP-1 Security Standard](docs/security-msrp-1.md)
+- [Optional SSO Packages](docs/sso.md)
+- [Standalone .dlb Backup Viewer](tools/dlb-viewer/README.md)
+- [Releasing](docs/RELEASING.md) — tag-driven PyPI + GitHub release flow
+- [Migrating from django-microsys](docs/migrating-from-microsys.md) — in-place upgrade for existing deployments
+- [Features](docs/FEATURES.md) — complete feature inventory
+- [Changelog](CHANGELOG.md)

django_lux-1.0.0/django_lux.egg-info/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.1
+Name: django-lux
+Version: 1.0.0
+Summary: DjangoLux (System Integration Service) - Multilingual Django Starter Pack, Packed with Features.
+Author-email: DeBeski <debeski1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/debeski/django-lux
+Keywords: django,dlux,permissions,authentication
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5
+Classifier: Framework :: Django :: 6
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=5.1
+Requires-Dist: django-crispy-forms>=2.4
+Requires-Dist: django-tables2>=2.7
+Requires-Dist: django-filter>=24.3
+Requires-Dist: crispy-bootstrap5>=2025.6
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: pyotp>=2.9
+Requires-Dist: qrcode>=8.2
+Requires-Dist: pillow>=11.0
+Requires-Dist: babel>=2.1
+Requires-Dist: cryptography>=42.0
+Requires-Dist: openpyxl>=3.1
+Provides-Extra: sso
+Requires-Dist: django-lux-sso>=0.1.0; extra == "sso"
+
+# DjangoLux - System Integration Service
+
+[![PyPI version](https://badge.fury.io/py/django-lux.svg)](https://pypi.org/project/django-lux/)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/debeski/django-lux/main/dlux/static/img/login_logo.webp" alt="DjangoLux Logo" width="450"/>
+</p>
+
+<p align="center">
+  <a href="https://chatgpt.com/g/g-6a14ac8cbb0c8191aad3b3619e5bef21-dlux-agent"><strong>Open DjangoLux Agent on ChatGPT</strong></a><br/>
+  <sub>Specialized custom GPT for django-lux integration, configuration, extension, and troubleshooting.</sub>
+</p>
+
+DjangoLux is a multilingual Django app that gives a project-level system layer for user management, branding, translations, scopes, navigation, activity logging, guided onboarding, data export, and dynamic CRUD tooling. It is not just a themed admin shell: it is a fairly large internal-systems toolkit that bundles runtime configuration, user operations, auditability, UI infrastructure, and zero-boilerplate management patterns into one package. The package keeps the landing README short, You can view the long-form operating and integration guidance at [`docs/`](docs/README.md).
+
+## What DjangoLux gives you
+
+- A first-launch setup wizard at `/sys/setup/` for identity, explicit language catalog management, translation-matrix overrides, access/security toggles, UI-first Dlux email delivery, themes, default table density, global home URL, and sidebar structure, including full sidebar disable, runtime sidebar-toolbar, and user-reordering controls.
+- A runtime system UI for users and superusers, including Options, user management, profiles, 2FA, activity logs, scopes, and system settings.
+- A disabled-by-default public registration playground for email-first local signup with mandatory email verification, Dlux email readiness checks, public-account provenance badges, throttles, and optional approval.
+- A database-backed `SystemSettings` singleton layered over `DLUX_CONFIG`, so projects can seed defaults in code and refine them in the UI later.
+- A framework-owned `django_tables2` platform that auto-adopts stock tables, ships built-in pagination and per-page controls, exposes a public `DluxTable` base class, and supports per-table `dlux_table`, `dlux_density`, `dlux_per_page`, and `dlux_actions` overrides.
+- A `ScopedModel` base with audit fields, soft-delete behavior, actor tracking, filtered managers, and automatic scope handling.
+- Zero-boilerplate sections and dynamic modal CRUD flows for auxiliary models, plus a reusable context-menu/event model for richer interactions.
+- A built-in audit trail with signal-based logging, merged User/Profile updates, diff capture, masked sensitive fields, and download/export log entries.
+- Universal data helpers such as `fetch_file`, `fetch_excel`, sticky-form autofill, tutorial overlays, and persistent UI preferences.
+
+## Requirements
+`note: all the requirements will be installed automatically when you install django-lux.`
+
+- Python 3.11+
+- Django 5.1+
+- `django-crispy-forms`
+- `crispy-bootstrap5`
+- `django-tables2`
+- `django-filter`
+- `pillow` "for image handling"
+- `babel` "for translations"
+- `psutil` "for system monitoring"
+- `pyotp` "for TOTP 2FA"
+- `qrcode` "for TOTP 2FA QR codes"
+- `cryptography` "for encrypted TOTP and SMTP secret storage"
+
+## Installation
+
+```bash
+pip install django-lux
+# OR
+pip install git+https://github.com/debeski/django-lux.git
+```
+
+## Scaffold a New Project or App
+
+```bash
+python -m dlux startproject myproject
+cd myproject
+python -m dlux startapp billing --register
+```
+
+`python -m dlux startproject` creates a new Django project already wired for DjangoLux. `python -m dlux startapp` creates a DjangoLux-native app skeleton with models, forms, filters, tables, translations, templates, tests, and optional project registration.
+
+Generated projects also include a baseline Docker stack with `compose.yml`, `compose.dev.yml`, a `config/celery.py` worker entrypoint, and a `/health/` endpoint via `django-health-check`.
+They also generate `.secrets/.env` with the bootstrap secrets used by the standard decrypter/startup flow.
+The scaffolded settings baseline now also includes `django-cors-headers` and `django-csp` with their apps, middleware, and starter CORS/CSP policy settings.
+
+## Minimal Quick Start
+
+1. Add the DjangoLux helper at the end of your project `settings.py`.
+
+```python
+from dlux.utils import dlux_settings
+
+dlux_settings(globals())
+```
+
+That helper prepends the required apps, inserts `django.middleware.locale.LocaleMiddleware` and `dlux.middleware.DluxMiddleware` in the supported order, adds the Dlux context processor, sets the Crispy Bootstrap 5 defaults, adds a Bootstrap-friendly `MESSAGE_TAGS` error mapping, and seeds the standard DjangoLux runtime defaults for language, timezone, i18n/tz flags, `FORMAT_MODULE_PATH`, and charset unless your project already defines them.
+
+__Proceed to [Getting Started](docs/getting-started.md) if you prefer to wire everything manually.__
+
+Public registration is documented separately at [Public Registration Playground](docs/registration.md). It is disabled by default and is not part of the optional SSO packages.
+
+
+2. Mount `dlux.urls` at project root so the bundled auth and system routes stay at `/accounts/...` and `/sys/...`.
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    path("", include("dlux.urls")),
+]
+```
+
+With that root include in place, dlux provides `/accounts/...` and `/sys/...`. If your project does not define its own `/` view, dlux falls back from an unresolved `/` request into its login/setup flow instead of leaving a 404. On a fresh and unconfigured install, Dlux also guards ordinary anonymous requests so a public root page cannot bypass first-time setup; once setup is complete, your existing root view continues to behave normally.
+
+3. Run the setup command.
+
+```bash
+python manage.py dlux_setup
+```
+
+4. Sign in as a superuser and complete the first-launch wizard at `/sys/setup/`. On a fresh install, an anonymous request may be sent through `/sys/setup/` and then to login before the wizard can be completed. After setup, the main runtime UI lives under `user_hub`.
+
+For a fuller setup path, prefix-mount guidance, and first-launch expectations, use the [Getting Started guide](docs/getting-started.md).
+
+
+## Key Capabilities
+
+- Onboarding and runtime configuration:
+  first-launch setup wizard, Options view, runtime System Settings modal, source-tabbed translation overrides, setup import/export, language/theme defaults, and a global Home destination.
+- User and security operations:
+  interactive user wizard, grouped translated permissions, four-tier staff authorization (superuser, Global Staff, Central Staff, Scoped Staff), permission-based sidebar visibility, profile management, multiple 2FA flows (App, Email, Backup), trusted device tracking for 30 days, and runtime preference persistence.
+- Generic CRUD infrastructure:
+  dynamic sections, AJAX-driven modal CRUD, automatic form/table/filter discovery, context-menu actions, and reusable event dispatch.
+- Navigation and UI infrastructure:
+  resolver-driven sidebar builder with permission-based visibility, runtime tree rendering, optional user-level reordering, configurable sidebar toolbar visibility, a shared theme registry, tutorial overlays, theme-aware system surfaces, and template injection hooks.
+- Data movement and productivity helpers:
+  universal file download, Excel export, smart autofill, sticky-form cloning, and generic list/filter helpers.
+- Audit and governance:
+  signal-based activity logging with configurable IP resolution (direct/proxy/header), diff capture, masked sensitive fields, deduplicated entries, download/export logging, and scoped visibility.
+- Optional SSO:
+  `django-lux-sso` and `django-lux-sso-client` live as separate optional packages for OIDC provider/client deployments without changing core Dlux runtime behavior.
+- Standalone backup viewer:
+  `tools/dlb-viewer/` is a dependency-free, cross-platform binary for inspecting encrypted `.dlb` system backups offline — browse models, rows, and stored files without a running instance. Prebuilt binaries ship with each release.
+- Framework-level automation:
+  translation patches, scoped-model auto-injection, actor tracking, soft-delete, and config layering across defaults, project settings, and runtime UI.
+
+## Documentation
+
+- [Documentation Hub](docs/README.md)
+- [Security Policy](SECURITY.md)
+- [Contributing Guide](CONTRIBUTING.md)
+- [Code of Conduct](CODE_OF_CONDUCT.md)
+- [Getting Started](docs/getting-started.md)
+- [Admin Guide](docs/admin-guide.md)
+- [Developer Guide](docs/developer-guide.md)
+- [Customization Guide](docs/customization-guide.md)
+- [Reference](docs/reference.md)
+- [MSRP-1 Security Standard](docs/security-msrp-1.md)
+- [Optional SSO Packages](docs/sso.md)
+- [Standalone .dlb Backup Viewer](tools/dlb-viewer/README.md)
+- [Releasing](docs/RELEASING.md) — tag-driven PyPI + GitHub release flow
+- [Migrating from django-microsys](docs/migrating-from-microsys.md) — in-place upgrade for existing deployments
+- [Features](docs/FEATURES.md) — complete feature inventory
+- [Changelog](CHANGELOG.md)