crm-server/FRESH_START_README.md

# Fresh Start - Nový CRM systém so zdieľanými email účtami

## 🎯 Čo je nové?

Kompletne refaktorovaný CRM systém s **many-to-many** vzťahom medzi používateľmi a emailovými účtami.

### Hlavné vylepšenia:

✅ **Zdieľané emailové účty** - Viacero používateľov môže mať prístup k jednému email účtu
✅ **Jednoduchý dizajn** - Žiadne zbytočné role (owner/member)
✅ **Izolované kontakty** - Kontakty patria k email účtu, nie k používateľovi
✅ **Tracking odpovedí** - Vidíte kto poslal odpoveď (sentByUserId)

---

## 🚀 Rýchly štart (Fresh Database)

### 1. Drop a vytvor databázu od nula

```bash
cd /home/richardtekula/Documents/WORK/crm-server
node src/scripts/fresh-database.js
```

**Čo tento script robí:**
- Vymaže všetky existujúce tabuľky
- Vytvorí nové tabuľky s many-to-many vzťahmi
- Vytvorí potrebné indexy

### 2. Vytvor admin používateľa

```bash
node src/scripts/seed-admin.js
```

**Admin credentials:**
- Username: `admin`
- Password: `admin123`

⚠️ **DÔLEŽITÉ:** Zmeň heslo po prvom prihlásení!

### 3. Spusť server

```bash
npm run dev
```

### 4. Prihlás sa a začni používať

1. Otvor frontend aplikáciu
2. Prihlás sa ako admin (admin / admin123)
3. Vytvor používateľov
4. Pridaj emailové účty

---

## 📊 Databázová schéma

### users
Používatelia systému (admini a členovia).

### email_accounts
Emailové účty - môžu byť zdieľané medzi viacerými používateľmi.
- `email` - UNIQUE (jeden email = jeden záznam v systéme)

### user_email_accounts
Junction table - many-to-many medzi users a email_accounts.
- `user_id` + `email_account_id` - UNIQUE (každý user môže mať account len raz)
- `is_primary` - primárny účet pre daného usera

### contacts
Kontakty patriace k emailovému účtu (nie k používateľovi!).
- `email_account_id` + `email` - UNIQUE
- `added_by` - kto pridal kontakt (nullable)

### emails
Emaily patriace k emailovému účtu.
- `email_account_id` - k akému accountu patrí
- `contact_id` - od ktorého kontaktu
- `sent_by_user_id` - kto poslal odpoveď (null ak prijatý email)

---

## 🔄 Ako fungujú zdieľané účty?

### Scenár 1: Dva admini, jeden email account

```
Admin 1: richardtekula@example.com
Admin 2: peterkolar@example.com

Oba majú prístup k: firma@example.com
```

1. Admin 1 pridá `firma@example.com` → Vytvorí sa nový email account
2. Admin 2 pridá `firma@example.com` (s rovnakým heslom) → Automaticky sa pridá k existujúcemu accountu
3. Obaja vidia rovnaké kontakty a emaily pre `firma@example.com`
4. Keď Admin 1 odpovie na email, Admin 2 vidí že odpoveď poslal Admin 1 (`sentByUserId`)

### Scenár 2: Admin vytvorí používateľa s emailom

```
Admin vytvorí usera "jan" s emailom firma@example.com
```

- Ak `firma@example.com` už existuje → jan sa automaticky pripojí k existujúcemu accountu (zdieľanie)
- Ak neexistuje → vytvorí sa nový account a jan je prvý používateľ

---

## 🎨 API zmeny

### Email Accounts

```javascript
// Get user's email accounts
GET /api/email-accounts
// Returns: [{ id, email, jmapAccountId, isActive, isPrimary, addedAt }]

// Add email account
POST /api/email-accounts
Body: { email, emailPassword }
// Automaticky vytvorí many-to-many link
// Ak account už existuje, pripojí usera k existujúcemu

// Remove email account
DELETE /api/email-accounts/:accountId
// Odstráni link pre daného usera
// Ak je to posledný user, vymaže aj samotný email account

// Set primary account
POST /api/email-accounts/:accountId/set-primary
```

### Contacts

```javascript
// Get contacts for email account
GET /api/contacts?accountId=xxx (REQUIRED)

// Add contact
POST /api/contacts
Body: { email, name, notes, accountId }

// Remove contact
DELETE /api/contacts/:contactId?accountId=xxx (REQUIRED)

// Update contact
PATCH /api/contacts/:contactId?accountId=xxx (REQUIRED)
Body: { name, notes }
```

**DÔLEŽITÉ:** `accountId` je teraz **povinný parameter** pre všetky contact operácie!

### Users (Admin)

```javascript
// Create user with email
POST /api/admin/users
Body: {
  username,
  firstName,
  lastName,
  email, // Optional
  emailPassword // Optional
}
// Ak email existuje, user sa automaticky pripojí k existujúcemu accountu
```

---

## 🐛 Opravené bugy

✅ **Bug č.1:** Keď admin vytvoril používateľa s emailom, credentials išli do `users` tabuľky namiesto `email_accounts`
   - **Opravené:** Používa `emailAccountService.createEmailAccount` s many-to-many

✅ **Bug č.2:** Duplikátne kontakty keď viacero používateľov pridalo rovnaký email
   - **Opravené:** Kontakty patria k `email_account`, nie k jednotlivým používateľom
   - UNIQUE constraint: `(email_account_id, email)`

✅ **Bug č.3:** Chýbajúci "mark as read" button
   - **Funguje:** Frontend dostáva správne `accountId` parameter

✅ **Bug č.4:** Nepoužívané stĺpce v `users` tabuľke
   - **Opravené:** `email`, `emailPassword`, `jmapAccountId` odstránené z users tabuľky

---

## 🧪 Testovanie

### Test 1: Vytvorenie používateľa s emailom

```bash
# Ako admin:
1. Vytvor usera "jan" s emailom jan@firma.sk
2. Overiť že email account bol vytvorený
3. Prihlás sa ako jan
4. Overiť že vidíš jan@firma.sk v sidebari
```

### Test 2: Zdieľanie email accountu

```bash
# Ako admin:
1. Vytvor usera "peter" s emailom jan@firma.sk (rovnaký ako vyššie!)
2. Overiť že peter sa pripojil k existujúcemu accountu
3. Prihlás sa ako peter
4. Overiť že peter vidí rovnaké kontakty ako jan
5. Peter pridá nový kontakt
6. Prihlás sa ako jan → overiť že jan vidí nový kontakt
```

### Test 3: Odpoveď na email

```bash
1. Jan odpovie na email od kontaktu
2. Prihlás sa ako peter
3. Overiť že peter vidí odpoveď
4. Overiť že vidíš indikáciu "Sent by Jan" (sentByUserId)
```

---

## 📝 Poznámky pre vývojárov

### Many-to-many vzťah

```
users ←→ user_email_accounts ←→ email_accounts
```

- Jeden user môže mať viacero email accounts
- Jeden email account môže patriť viacerým userom

### Kontakty a emaily patria k email accountu

```
email_accounts → contacts → emails
```

- Kontakty sú **zdieľané** medzi všetkými usermi s prístupom k danému email accountu
- Emaily sú **zdieľané** rovnako

### Tracking odpovedí

- `emails.sent_by_user_id` - kto poslal odpoveď
- NULL = prijatý email (nie odpoveď)
- UUID = user, ktorý poslal odpoveď

---

## 🔒 Bezpečnosť

- Email heslá sú **encrypted** (nie hashed), lebo potrebujeme decryption pre JMAP
- Používateľské heslá sú **bcrypt hashed**
- Access control: User môže pristupovať len k email accountom, kde má link v `user_email_accounts`

---

## 🚨 Troubleshooting

### Problem: "Email účet nenájdený"

**Možné príčiny:**
1. User nemá link v `user_email_accounts` tabuľke
2. Email account neexistuje v `email_accounts` tabuľke

**Riešenie:**
```sql
-- Check links
SELECT * FROM user_email_accounts WHERE user_id = 'your-user-id';

-- Check accounts
SELECT * FROM email_accounts;
```

### Problem: "Kontakt už existuje"

**Príčina:** Kontakt s týmto emailom už existuje pre daný email account.

**Riešenie:** Kontakty sú zdieľané medzi všetkými usermi. Jeden email môže byť len raz per email account.

---

## 📞 Podpora

Ak narazíte na problémy:
1. Skontrolujte logs: `tail -f logs/server.log`
2. Skontrolujte databázu: `psql -U username -d database`
3. Re-run fresh database script

---

Vytvoril: Claude Code
Dátum: 2025-11-20
Verzia: 2.0 (Many-to-many)