Elektronické hlasovanie
a správa bytovky
pre ľudí, nie pre právnikov

Požiadavky

Na spustenie OpenResiApp potrebuješ:

• Docker 24+ a Docker Compose plugin
• Server alebo VPS s min. 1 GB RAM a 10 GB disku
• Doménu alebo subdoménu (pre HTTPS)
• SMTP prístup (pre emaily)

Inštalácia

Automatický setup (odporúčané)

Skript sa opýta na doménu a názov budovy, vygeneruje bezpečné heslá a vytvorí všetky súbory:

mkdir open-resiapp && cd open-resiapp
curl -O https://raw.githubusercontent.com/open-resiapp/open-resiapp/main/setup.sh
chmod +x setup.sh
./setup.sh
docker compose up -d

Manuálny setup

Ak uprednostňuješ manuálnu inštaláciu:

1. Vytvor docker-compose.yml

mkdir open-resiapp && cd open-resiapp

Ulož nasledovný obsah ako docker-compose.yml:

services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: resiapp
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

  app:
    image: ipk0/open-resiapp:latest
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      DATABASE_URL: postgresql://postgres:${POSTGRES_PASSWORD}@db:5432/resiapp
      NEXTAUTH_SECRET: ${NEXTAUTH_SECRET}
      NEXTAUTH_URL: ${APP_URL}
      AUTH_TRUST_HOST: "true"
      APP_NAME: ${APP_NAME:-Bytove spolocenstvo}
      LANGUAGE: ${LANGUAGE:-sk}
    volumes:
      - uploads:/app/uploads

  caddy:
    image: caddy:2-alpine
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - caddy_data:/data
    depends_on:
      - app
    command: caddy reverse-proxy --from ${APP_DOMAIN} --to app:3000

volumes:
  postgres_data:
  uploads:
  caddy_data:

2. Nastav .env

Vytvor súbor .env s týmito hodnotami:

APP_NAME="Bytove spolocenstvo Hlavna 12"
APP_URL=https://yourdomain.sk
APP_DOMAIN=yourdomain.sk
POSTGRES_PASSWORD=changeMe_veryLongPassword123
NEXTAUTH_SECRET=changeMe_anotherRandomString456
# Generate secrets: openssl rand -base64 32

3. Spusti

docker compose up -d

Docker automaticky stiahne obrazy z Docker Hub, vytvorí databázu a spustí app. Migrácie sa spustia automaticky.

Konfigurácia .env

Otvor súbor .env a uprav nasledovné hodnoty:

APP_NAME="Bytove spolocenstvo Hlavna 12"
APP_URL=https://yourdomain.sk
APP_DOMAIN=yourdomain.sk
POSTGRES_PASSWORD=changeMe_veryLongPassword123
NEXTAUTH_SECRET=changeMe_anotherRandomString456
# Generate secrets: openssl rand -base64 32

Prvé spustenie

Po spustení overte, že všetko beží:

docker compose ps

Všetky tri služby (app, db, caddy) musia mať status Up.

Otvor prehliadač na http://localhost:3000 – uvidíš prihlasovací formulár.

Seed dáta pre testovanie

Pre rýchle otestovanie môžeš načítať ukážkové dáta:

docker compose exec app npm run db:seed

Toto vytvorí testovacích vlastníkov, byty a jedno aktívne hlasovanie. Prihlasovacie údaje admina:

Email:  admin@test.sk
Heslo:  Admin123!

Vlastná doména

Uprav .env:

APP_URL=https://bytovka.mojadomena.sk
APP_DOMAIN=bytovka.mojadomena.sk

Nastav DNS A záznam tvojej domény na IP adresu servera:

bytovka.mojadomena.sk.  A  1.2.3.4

DNS zmeny sa môžu šíriť 5–60 minút.

HTTPS (automaticky)

OpenResiApp používa Caddy ako reverse proxy, ktorý automaticky zaobstará a obnovuje SSL certifikát cez Let's Encrypt. Nemusíš nič ručne nastavovať.

Po nastavení domény reštartuj stack:

docker compose down
docker compose up -d

Zálohovanie

Všetky dáta sú v PostgreSQL databáze a v priečinku uploads/. Odporúčame zálohovať denne.

Automatická záloha

docker compose exec db pg_dump -U postgres resiapp | gzip > backup_$(date +%Y%m%d).sql.gz

Pridaj do cronu pre denné zálohy:

(crontab -l 2>/dev/null; echo "0 3 * * * cd /path/to/project && docker compose exec -T db pg_dump -U postgres resiapp | gzip > /backups/resiapp_\$(date +\%Y\%m\%d).sql.gz") | crontab -

Obnova zo zálohy

gunzip < backup_20260309.sql.gz | docker compose exec -T db psql -U postgres resiapp

Aktualizácia na novú verziu

Aktualizácia je jednoduchá – nové migrácie sa spustia automaticky pri štarte.

docker compose pull
docker compose up -d

Toto stiahne najnovší Docker image a reštartuje app. Migrácie databázy sa spustia automaticky – žiadne manuálne kroky.

Admin účet

Pri prvom spustení v produkcii vytvor admin účet cez príkazový riadok:

docker compose exec app \
  npx tsx src/scripts/create-admin.ts \
  --email predseda@bytovka.sk \
  --name "Ján Novák"

Príkaz vytlačí dočasné heslo. Po prvom prihlásení si ho zmeň v nastaveníach.

Pridanie vlastníkov

Po prihlásení ako admin:

• Choď do Nastavenia → Byty a vchody – vytvor vchody a byty s podielmi
• Choď do Vlastníci → Pozvať vlastníka – zadaj email a priraď byt
• Vlastník dostane email s odkazom na nastavenie hesla

Prvé hlasovanie

Ako admin choď do Hlasovanie → Nové hlasovanie:

• Zadaj názov a popis
• Nastav dátum začiatku a konca
• Voliteľne priraď sčítača hlasov pre papierové lístky
• Klikni Spustiť hlasovanie

Všetkým vlastníkom príde email s odkazom. Výsledky sú viditeľné v reálnom čase. Po skončení môžeš vygenerovať PDF zápisnicu.