Metadata-Version: 2.4
Name: sysnet-gov-django
Version: 0.1.2
Summary: Standardized framework for Czech e-government projects based on Django and GDS 4 (Gov.cz Design System)
Author-email: Radim Jäger <rjaeger@sysnet.cz>
Requires-Python: >=3.12
Requires-Dist: django-components>=0.100
Requires-Dist: django-htmx>=1.17.0
Requires-Dist: django>=5.0
Description-Content-Type: text/markdown

# sysnet-gov-django

**Standardizovaný framework pro státní správu ČR založený na Django a GDS 4 (Gov.cz Design System).**

[![PyPI version](https://img.shields.io/pypi/v/sysnet-gov-django.svg)](https://pypi.org/project/sysnet-gov-django/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## 🏛️ O projektu

`sysnet-gov-django` je komplexní knihovna komponent a nástrojů, která umožňuje extrémně rychlou stavbu webových aplikací pro státní správu v souladu s vizuální identitou a legislativními požadavky ČR.

Knihovna implementuje **Gov.cz Design System (GDS) verze 4** pomocí moderní architektury `django-components`, což přináší "slotovou" logiku známou z Vue/Reactu přímo do SSR (Server-Side Rendering) prostředí Django template.

### Hlavní přínosy:
- **100% soulad s GDS 4:** Automatické dodržování barev, typografie a přístupnosti.
- **Vysoká rychlost vývoje:** Hotové komponenty pro layout, formuláře, tabulky a karty.
- **Legislativní připravenost:** Architektura navržená pro auditovatelnost a soulad s kybernetickým zákonem.
- **Dostupnost:** Integrovaný HTMX pro moderní UX bez nutnosti psát JavaScript.

---

## 📚 Dokumentace

Projekt je rozdělen do několika úrovní pro různé role v organizaci:

- [📈 Manažerské shrnutí](docs/MANAGEMENT.md) — Proč zvolit tento stack a jaké přináší úspory.
- [🛠️ Technická specifikace](docs/TECHNICAL.md) — Architektura, závislosti a vnitřní fungování.
- [💻 Vývojářská příručka](docs/USER_GUIDE.md) — Jak používat komponenty v praxi.
- [⚙️ Administrace a provoz](docs/ADMINISTRATION.md) — Instalace, konfigurace a nasazení.
- [🧩 Katalog komponent](docs/COMPONENTS.md) — Detailní popis parametrů jednotlivých prvků.

---

## ⚡ Rychlý start

### 1. Instalace
```bash
pip install sysnet-gov-django
```

### 2. Konfigurace `settings.py`
```python
INSTALLED_APPS = [
    # ...
    "django_components",
    "django_htmx",
    "sysnet_gov_django",
]

MIDDLEWARE = [
    # ...
    "django_htmx.middleware.HtmxMiddleware",
    "django_components.middleware.ComponentDependencyMiddleware",
]

# Registrace globálních komponent
COMPONENTS = {
    "libraries": [
        "sysnet_gov_django.components",
    ],
}
```

### 3. Použití v šabloně
```html
{% component "gov_master_layout" title="IS MojeÚřad" %}
    {% component "gov_heading" tag="h1" variant="xl" %}Vítejte v systému{% endcomponent %}
    
    {% component "gov_button" variant="primary" %}
        Podat žádost
    {% endcomponent %}
{% endcomponent %}
```

---

## 🤝 Vývoj a podpora

Projekt je vyvíjen společností **SYSNET s.r.o.** jako součást ekosystému pro moderní e-government.

- **GitHub:** [SYSNET-CZ/sysnet-gov-django](https://github.com/SYSNET-CZ/sysnet-gov-django)
- **E-mail:** support@sysnet.cz
- **Redmine:** [Projekt ID 184](https://redmine.sysnet.cz/projects/184)

© 2026 SYSNET s.r.o. | Veškerá práva vyhrazena.
