IT Haldus

Organisatsiooni IT halduskeskkond.

• Võrgukaart - Võrguseadmete automaatne avastamine SSH/SNMP kaudu
• Arvutite andmebaas - Arvutite register
• Seadmete andmebaas - Muude IT seadmete haldamine
• Helpdesk - Kasutajate pöördumiste haldamine
• Turvasündmused - Intsidentide registreerimine ja jälgimine
• Mitmekeelsus - Eesti ja inglise keel

• Docker (üks järgmistest):
  • Mac: OrbStack (soovitatav) või Docker Desktop
  • Windows: Docker Desktop
  • Linux: Docker või Podman

# 1. Kopeeri seadistusfail
cp .env.example .env

# 2. Käivita arendusserver
./dev.sh          # Linux/Mac
dev.cmd           # Windows

# 3. Käivita migratsioonid ja andmebaasi seedimine (ainult esimesel korral)
docker compose exec dev bun run db:migrate
docker compose exec dev bun run db:seed

# 4. Ava http://localhost:3000 (AUTH_BYPASS=true võimaldab sisselogimist)

./ithaldus status          # Vaata olekut
./ithaldus --dev start     # Käivita arendusserver (OrbStack VM-iga)
./ithaldus --dev stop      # Peata arendusserver
./ithaldus --dev logs      # Vaata logisid

./ithaldus build           # Ehita tootmisversioon
./ithaldus start           # Käivita tootmisversioon
./ithaldus stop            # Peata tootmisversioon

• Käitusaeg: Bun
• Kasutajaliides: React + Vite + TailwindCSS
• Taustarakendus: Hono
• Andmebaas: SQLite + Drizzle ORM
• Autentimine: Microsoft 365 OAuth

src/
├── client/              # React kasutajaliides
│   ├── components/      # UI komponendid
│   ├── routes/          # Leheküljed
│   ├── i18n/            # Tõlked (en.json, et.json)
│   └── lib/             # Abifunktsioonid
└── server/              # Hono taustarakendus
    ├── db/              # Andmebaasi skeem ja migratsioonid
    ├── routes/          # API marsruudid
    ├── services/        # Skannerid ja draiverid
    └── middleware/      # Autentimise vahevara

Võrgukaardi vaade toetab URL parameetreid:

Kasuta täisnimesid või lühendeid: firmware/f, interfaces/i, vendor/v, enddevices/e, assettag/a, mac/m, ports/p, serialnumber/s

router, switch, access-point, server, computer, phone, desktop-phone, tv, tablet, printer, camera, iot, end-device

Arenduskeskkond käivitab Dockeris kaks protsessi:

• Vite (port 5173) - Kasutajaliides koos kuumlaadimisega
• Bun API (port 3001) - Taustarakendus

Kõik päringud lähevad läbi pordi 3000.

Staging käitab tootmisversiooni koos VPN-ühendusega.

Linux:

docker compose up staging

Mac (OrbStack):

./ithaldus --dev start     # Käivita VM + VPN + konteiner
./ithaldus --dev status    # Vaata olekut
./ithaldus --dev logs      # Vaata logisid
./ithaldus --dev stop      # Peata

Tootmiskonteiner toetab kolme VPN protokolli: OpenVPN, SSTP ja WireGuard.

# Seadista .env failis
VPN_PROTOCOL=openvpn  # või: sstp, wireguard, none
VPN_USERNAME=kasutaja
VPN_PASSWORD=parool

# VPN käsud
./ithaldus vpn-status      # Vaata VPN olekut
./ithaldus vpn-logs        # Vaata VPN logisid
./ithaldus vpn-test 10.0.0.1  # Testi ühendust

Täpsem juhend: docs/VPN.md

1. Mine Azure portaali
2. Ava Microsoft Entra ID → App registrations → New registration
3. Seadista:
   • Nimi: IT Haldus
   • Redirect URI: http://localhost:3000/api/auth/callback

1. Ava Certificates & secrets → New client secret
2. Kopeeri saladuse väärtus kohe

MICROSOFT_CLIENT_ID=sinu-rakenduse-id
MICROSOFT_CLIENT_SECRET=sinu-saladus
MICROSOFT_TENANT_ID=sinu-rentniku-id
APP_URL=http://localhost:3000

Arendamiseks ilma Azure AD-ta lisa .env faili:

AUTH_BYPASS=true

MIT