# Intensiivsuse hinnastamine

# Intensiivsuse hinnastamine

Funktsioon võimaldab pakkuda õpilastele erinevaid hindu sõltuvalt tundide arvust nädalas. Selle asemel, et luua iga intensiivsuse jaoks eraldi kursus (1, 2, 3 korda nädalas), seadistate hinnad ühel kursusel.

---

## Kuidas see töötab

Administraator määrab iga intensiivsuse variandi jaoks **kuuhinna**. Süsteem automaatselt:

1. Arvutab hinnad kõigi tasumissageduste jaoks (kvartal, poolaasta, aasta)
2. Loob peidetud protsentuaalsed soodustused
3. Kuvab õpilasele registreerimisel intensiivsuse valiku
4. Rakendab soodustust automaatselt avalduse loomisel

**Näide:**

Kursus tundidega 5 korda nädalas. Baaskuuhind — 100 €.

| Intensiivsus | Hind/kuu | Kvartal | Poolaasta | Aasta |
|--------------|----------|---------|-------------|-------|
| 5× nädalas   | 100,00 € | 270,00 € | 500,00 € | 900,00 € |
| 3× nädalas   | 60,00 €  | 162,00 € | 300,00 € | 540,00 € |
| 1× nädalas   | 20,00 €  | 54,00 €  | 100,00 € | 180,00 € |

Täitke ainult veerg „Hind/kuu". Ülejäänud veerud arvutatakse automaatselt.

---

## Eeldused

Funktsiooni kasutamiseks on vajalik:

1. **Kursuse tunniplaan on määratud** — süsteem tuvastab tunniplaanist maksimaalse päevade arvu nädalas
2. **Kuuhind on määratud** — kursuse jaotises „Hinnad" peab olema märgitud hind tasumissagedusega „Kuu"

Kui üks tingimus pole täidetud, on intensiivsuse sektsioon vastava selgitusega kättesaamatu.

---

## Intensiivsuse seadistamine kursusel

### Samm 1. Avage vaheleht „Hinnad"

1. Minge **Kursused → Erialad → valige kursus**.
2. Avage vaheleht **Hinnad**.
3. Leidke sektsioon **Intensiivsus** (kuvatakse hindade all).

### Samm 2. Lülitage funktsioon sisse

1. Märkige märkeruut **„Luba intensiivsuse valik"**.
2. Ilmub seadistustabel.

### Samm 3. Seadistage parameetrid

**Minimaalne kordade arv nädalas** — valige rippmenüüst (1–6). See on minimaalne intensiivsus, mida õpilane saab valida.

**Maksimaalne kordade arv nädalas** — määratakse automaatselt kursuse tunniplaani järgi (unikaalsete tunnipäevade arv). Käsitsi muuta ei saa.

> **Märkus:** Kui kursusel on tunnid esmaspäeval, kolmapäeval ja reedel — maksimum on 3. Kusjuures 2 tundi ühel päeval loetakse üheks päevaks.

### Samm 4. Määrake kuuhinnad

Tabelis kuvatakse read miinimumist maksimumini intensiivsuseni:

| Intensiivsus | Hind/kuu | Kvartal | Pool aastat | Aasta |
|--------------|----------|---------|-------------|-------|
| 1× nädalas   | [sisesta] | auto | auto | auto |
| 2× nädalas   | [sisesta] | auto | auto | auto |
| 3× nädalas   | põhihind | auto | auto | auto |

- **Viimane rida** (maksimaalne intensiivsus) — on alati võrdne baaskuuhinnaga. Ei redigeerita.
- **Ülejäänud read** — sisestage soovitud kuuhind.
- **Veerud kvartal/poolaasta/aasta** — arvutatakse automaatselt ega ole redigeeritavad.

### Nupp „Arvuta automaatselt"

Täidab hinnad proportsionaalselt:

```
Hind N korda nädalas = Baashind × N / Maksimum
```

Näide baashinnaga 150 € ja maksimumiga 5:
- 1×: 150 × 1/5 = **30,00 €**
- 2×: 150 × 2/5 = **60,00 €**
- 3×: 150 × 3/5 = **90,00 €**
- 4×: 150 × 4/5 = **120,00 €**
- 5×: **150,00 €** (baas)

Enne salvestamist saate automaatselt arvutatud hindu käsitsi muuta.

### Samm 5. Salvestage

Vajutage **Salvesta**. Süsteem loob iga intensiivsuse taseme jaoks automaatselt peidetud soodustused.

---

## Kuidas arvutatakse hinnad erinevate tasumissageduste jaoks

Kuuhind määratakse käsitsi. Hinnad kvartalile, pooleks aastaks ja aastaks arvutatakse proportsiooni kaudu:

```
Koefitsient = Intensiivsuse kuuhind / Baaskuuhind
Kvartali hind = Baaskvartalihind × Koefitsient
```

### Üksikasjalik näide

**Algandmed:**
- Kursuse baashinnad (maksimaalne intensiivsus 3×/näd):
  - Kuu: 65,00 €
  - Kvartal: 180,00 €
  - Pool aastat: 350,00 €
  - Aasta: 650,00 €

**Seadistatud kuuhinnad:**
- 1×/näd: 25,00 €
- 2×/näd: 45,00 €
- 3×/näd: 65,00 € (baas)

**Arvutus 1× nädalas:**
- Koefitsient: 25 / 65 = 0,3846
- Kvartal: 180 × 0,3846 = **69,23 €**
- Pool aastat: 350 × 0,3846 = **134,62 €**
- Aasta: 650 × 0,3846 = **250,00 €**

**Arvutus 2× nädalas:**
- Koefitsient: 45 / 65 = 0,6923
- Kvartal: 180 × 0,6923 = **124,62 €**
- Pool aastat: 350 × 0,6923 = **242,31 €**
- Aasta: 650 × 0,6923 = **450,00 €**

**Lõpptabel:**

| Intensiivsus | Kuu | Kvartal | Poolaasta | Aasta |
|--------------|-----|---------|-------------|-------|
| 1× nädalas   | 25,00 € | 69,23 € | 134,62 € | 250,00 € |
| 2× nädalas   | 45,00 € | 124,62 € | 242,31 € | 450,00 € |
| 3× nädalas   | 65,00 € | 180,00 € | 350,00 € | 650,00 € |

> **Tähtis:** Soodustus „mida kauem maksad — seda soodsam" säilib iga intensiivsuse jaoks. Kui kvartal on odavam kui 3 kuud kuuhinnaga, säilib see suhe ka väiksema intensiivsuse juures.

---

## Intensiivsuse väljalülitamine

1. Avage kursuse vaheleht **Hinnad**.
2. Eemaldage märkeruut **„Luba intensiivsuse valik"**.
3. Vajutage **Salvesta**.

Välja lülitamisel kustutatakse kõik intensiivsuse seaded ja seotud soodustused. Olemasolevaid avaldusi juba rakendatud soodustustega **ei mõjutata** — soodustused jäävad alles kuni käsitsi kustutamiseni.

---

## Õpilase registreerimine

### Avalik registreerimisvorm

Kui kursusel on intensiivsus sisse lülitatud, ilmub registreerimisvormil enne tasumissageduse valikut küsimus:

**„Mitu korda nädalas?"**

Õpilane valib intensiivsuse (näiteks 2× nädalas) ja hinnad sageduste loendis uuenevad automaatselt.

Pärast vormi saatmist:
- Avaldus luuakse väärtusega `sessions_per_week = 2`
- Intensiivsuse soodustus seotakse automaatselt
- Arved genereeritakse soodustusega

### Avalduse loomine administraatori poolt

Avalduse loomisel administreerimisliidese kaudu:

1. Valige avalduse loomise vormis kursus.
2. Kui kursusel on intensiivsus sisse lülitatud — ilmuvad valikuks raadionupud.
3. Valige intensiivsus.
4. Hinnad uuenevad automaatselt.
5. Salvestage avaldus.

Soodustus rakendatakse automaatselt.

---

## Intensiivsuse vaatamine avaldusel

Avalduse lehel hinnaplokis kuvatakse valitud intensiivsuse märgis:

```
📅 2× nädalas
```

Intensiivsuse soodustus on nähtav avalduse jaotises **Soodustused** — see kuvatakse protsentuaalse soodustusena nimega „2× nädalas (Kursuse nimi)".

---

## Õpilase intensiivsuse muutmine

Olemasoleva avalduse intensiivsuse muutmiseks:

1. Avage õpilase avaldus.
2. Jaotises **Soodustused** kustutage praegune intensiivsuse soodustus.
3. Lisage uus intensiivsuse soodustus (läbi „Tunni põhine soodustus" või käsitsi).

Intensiivsuse soodustuse kustutamisel lähtestatakse avalduse `sessions_per_week` väärtus automaatselt.

> **Märkus:** Tulevased arved (staatused „Planeeritud" ja „Valmis") arvutatakse soodustuste muutmisel automaatselt ümber. Esitatud ja tasutud arveid ei mõjutata.

---

## Koostoime teiste soodustustega

Intensiivsuse soodustus on tavaline protsentuaalne soodustus. Seda saab kombineerida teiste soodustustega:

| Soodustus | Tüüp | Näide |
|-----------|------|-------|
| Intensiivsus | Protsentuaalne | -40% (3× asemel 5×) |
| Lasterikas pere | Protsentuaalne | -10% |
| Ühekordne soodustus | Fikseeritud | -50 € |

Kõik protsentuaalsed soodustused liidetakse, seejärel rakendatakse fikseeritud:

```
Kokku = Baashind × (1 - 40% - 10%) - 50 € proportsionaalselt
```

---

## Seos proportsionaalse arvestusega (proration)

Kui õpilane registreerub perioodi keskel, rakendatakse **kõigepealt** intensiivsuse soodustus ja **seejärel** tundide proportsioon.

**Näide:**
- Kvartalihind (5×): 270,00 €
- Intensiivsus 3×: soodustus -40% → 162,00 €
- Õpilane tuli, kui jäänud 14 tundi 77-st: proportsioon 18,18%
- Kokku: 162,00 × 0,1818 = **29,45 €**

Rohkem proportsionaalsest arvestusest — vt jaotist [„Proportsionaalne arvestus"](https://docs.huvis.ee/link/117).

---

## Korduma kippuvad küsimused

### Miks intensiivsuse sektsioon ei kuvata?

Kontrollige:
1. Kursusel on määratud **tunniplaan** (vähemalt üks päev)
2. On määratud **kuuhind** (tasumissagedus „Kuu")

### Kas maksimaalset intensiivsust saab muuta?

Ei, maksimum määratakse automaatselt kursuse tunniplaani järgi. Maksimumi muutmiseks — muutke tunniplaani.

### Mis juhtub, kui ma muudan tunniplaani pärast intensiivsuse seadistamist?

Maksimaalne intensiivsus uueneb vahelehe „Hinnad" järgmisel avamisel. Kui maksimum vähenes, võib olla vaja intensiivsuse seaded uuesti salvestada.

### Õpilane on juba registreeritud. Kuidas muuta intensiivsust?

Kustutage avalduse lehel praegune intensiivsuse soodustus ja lisage uus. Arved arvutatakse automaatselt ümber.

### Kas õpilane näeb intensiivsuse soodustust?

Maksja portaalis kuvatakse soodustus protsentuaalse soodustusena. Soodustuse nimi ei kuvata arvel, kui soodustuse seadetes pole sisse lülitatud „Kuva nimi arvel" (`display_name_on_invoice = false` vaikimisi).