Informační systém pro SVJ 🏡

SVJIS je CMS pro Společenství Vlastníku Jednotek. Systém poskytuje redakční systém 📝, diskuze pod článkem, aknkety 📊, hlášení a sledování závad, inzeráty, databázi vlastníků 👨‍👩‍👦 včetně evidence jednotek a podílů. Více na stránkách projektu.

Předpokládá se, že máte na počítači nainstalovaný python verze 3.10 a nebo vyšší.

python --version

Naklonujte si projekt

git clone https://github.com/svjis/svjis2.git
cd svjis2

Vytvořte si virtuální prostředí a přepněte se do něj

python -m venv venv
# v Linuxu
source venv/bin/activate
# ve Windows
source venv/Scripts/activate

Nainstalujte závislosti a vytvoře konfiguraci

pip install -r requirements.txt
cd svjis
python manage.py migrate
python manage.py svjis_setup --password <heslo pro uživatele admin>

python manage.py compilemessages

python manage.py runserver

Aplikace běží na adrese https://127.0.0.1:8000/ uživatel je admin heslo je vámi dříve zadané heslo.

Uvedený způsob spuštění je vhodný pro rychlé vyzkoušení aplikace na vašem počítači, nebo pro vývojáře. Pokud chcete SVJIS nasadit na server do produkce tak si prostudujte Django dokumentaci.

Nastavení údajů o SVJ je v aplikaci v sekci Administrace

Systém SVJIS při různých událostech používá odesílání emailů, proto je správné nastavení e-mailového rozhraní pro funkci aplikace podstatné.

Vytvořte nový soubor svjis/svjis/local_settings.py a v něm vytvořte následující konfiguraci

SECRET_KEY = 'produkcni django secret'
TIME_ZONE = 'Europe/Prague'

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'vas smtp server'
EMAIL_USE_TLS = False
EMAIL_USE_SSL = True
EMAIL_PORT = 465
EMAIL_HOST_USER = 'username k vasemu smtp serveru'
EMAIL_HOST_PASSWORD = 'heslo k vasemu smtp serveru'

Odesílání e-mailů se děje na pozadí - systém ukládá e-maily do fronty k odeslání, viz Administrace - čekající zprávy. Pro odeslání zprávy je třeba spustit následující příkaz:

python manage.py svjis_send_messages

Při testování aplikace ho můžete spouštět ručně. Při produkčním nastavení je potřeba nastavit plánovač systému (například cron) aby ho spoštěl v určitých itervalech (například každých 5 minut).

Jakákoliv forma spolupráce je vítána.
Více informací naleznete v CONTRIBUTING.md.