ircu2/README_SCRIPTS.md

# 📦 Scripturile de Instalare Automată - Rezumat Complet

## 🎯 Ce am Creat

Am adăugat **4 scripturi shell bash** și **2 ghiduri documentare** complete în limba română pentru instalare și administrare automată a Nefarious IRCd.

---

## 📜 Scripturile Incluse

### 1️⃣ **install.sh** - Instalare Automată Principală

**Funcție:** Automatizează complet instalarea de la clonare la pornire

**Ce face:**
- ✅ Verifică dependențele (gcc, make, SSL, autoconf)
- ✅ Rulează `./configure` cu parametri optimali
- ✅ Compilează codul sursă
- ✅ Instalează binare și biblioteci
- ✅ Cere date despre server (interactive)
- ✅ Generează fișierul `ircd.conf`
- ✅ Creează structura de directoare
- ✅ Generează fișierele MOTD

**Utilizare:**
```bash
# Instalare standard
./install.sh

# Instalare customizată
./install.sh --prefix /opt/ircd --maxcon 8192 --debug

# Opțiuni disponibile:
  -h, --help              Ajutor
  -p, --prefix PATH       Calea de instalare
  -m, --maxcon NUM        Maxim conexiuni
  -d, --debug             Modul debug
  -s, --no-ssl            Fără SSL/TLS
```

---

### 2️⃣ **configure-interactive.sh** - Configurare Interactivă Avansată

**Funcție:** Ghidare step-by-step prin toate setările serverului

**Ce face:**
- ✅ Etapa 1: Setări generale (nume, descriere, numeric)
- ✅ Etapa 2: Informații administrator (locație, email)
- ✅ Etapa 3: Configurare porturi (standard, SSL, server-to-server)
- ✅ Etapa 4: Clase de conexiuni (maxlinks, sendq, pingfreq)
- ✅ Etapa 5: Operatori (nick, host, parola)
- ✅ Etapa 6: Setări avansate (AUTH, persist channels, SWHOIS)

**Utilizare:**
```bash
# După instalare, pentru configurare detaliată
./configure-interactive.sh

# Sau din nou din 0
./install.sh
./configure-interactive.sh
```

---

### 3️⃣ **admin.sh** - Meniu Interactiv de Administrare

**Funcție:** Tool grafic (TUI) pentru administrare server zilnică

**Opțiuni Meniu:**
```
1. Pornire server
2. Oprire server
3. Restart server
4. Verifica status (PID, CPU, RAM, porturi)
5. Editare configurare (cu backup automat)
6. Vizionare log-uri (tail, live, search)
7. Generare parola operator
8. Test sintaxă configurare
9. Iesire
```

**Utilizare:**
```bash
./admin.sh

# Deschide meniu interactiv cu toate opțiunile
```

---

## 📚 Documentare

### 📖 **QUICKSTART.md** - Start Rapid (Recomandabil pentru Începători)

**Conținut:**
- Instalare în 3 comenzi
- Ce face script-ul automat
- Opțiuni instalare
- Setare parola operator
- Conectare la server
- Comenzi utile
- Troubleshooting rapid

**Perfect pentru:** Primii 5 minute

---

### 📖 **INSTALL_AUTO.md** - Documentație Completă

**Conținut:**
- Cerințe sistem pe fiecare platforma
- Instalare rapidă vs customizată
- Toate opțiunile disponibile
- Structura directoarelor post-instalare
- Pornire și oprire server
- Setare parola cu umkpasswd
- Editare avansată configurare
- Conectare la server
- Verificare status și log-uri
- Rezolvare probleme comune
- Networking (link la alte servere)
- Comenzi administrator
- Sfaturi de securitate

**Perfect pentru:** Referință completă

---

## 🎓 Exemplu de Utilizare Tipic

### Scenariu: Instalare Completă

```bash
# 1. Clone repository
git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2

# 2. Instalare automată (cere doar date de bază)
./install.sh
# Răspunzi la: Nume server, Descriere, Admin email, etc.

# 3. Configurare avansată (opțional, pentru setări detaliate)
./configure-interactive.sh

# 4. Generare parola operator
./admin.sh
# Alege: 7) Generare parola operator

# 5. Editare configurare dacă trebuie
nano ~/ircd/etc/ircd.conf

# 6. Pornire server
./admin.sh
# Alege: 1) Pornire server

# 7. Verificare status
./admin.sh
# Alege: 4) Verifica status

# 8. Urmărire log-uri
./admin.sh
# Alege: 6) Vizionare log-uri

# 9. Conectare client
# irc://localhost:6667
```

---

## 🔄 Flux de Lucru Zilnică

```bash
# Meniu central pentru administrare
./admin.sh

# De aici:
# - Pornești/oprești serverul
# - Editezi configurare cu backup automat
# - Urmărești log-urile live
# - Generezi parole operator
# - Testezi sintaxă
```

---

## 🌍 Suport Multiplatforma

### Linux (Debian/Ubuntu)
```bash
sudo apt-get install build-essential autoconf libssl-dev
./install.sh
```

### Linux (RHEL/CentOS)
```bash
sudo yum install gcc make autoconf openssl-devel
./install.sh
```

### macOS
```bash
xcode-select --install
brew install autoconf libtool openssl
./install.sh
```

### BSD/Unix
```bash
# Verifică INSTALL_AUTO.md pentru detalii
./install.sh
```

---

## 📋 Checklist Instalare

```
□ Sistem cu gcc, make, autoconf instalate
□ Spațiu pe disk suficient (~100MB)
□ Permisiuni de scriere în $HOME
□ Port 6667 disponibil (sau schimbă în config)

□ git clone https://gitlab.back.ro/underchat/ircu2.git
□ cd ircu2
□ ./install.sh
  □ Răspunde la întrebări
  □ Astepta completarea

□ ./admin.sh
  □ Alege: 7) Generare parola
  □ Alege: 1) Pornire server

□ Conectare cu IRC client
□ Verificare log-uri

GATA! ✓
```

---

## 🔐 Puncte Importante de Securitate

### Imediat După Instalare:
1. ✅ **Schimbă parola operator**
   ```bash
   ./admin.sh → 7) Generare parola operator
   ```

2. ✅ **Securizează fișierul de config**
   ```bash
   chmod 600 ~/ircd/etc/ircd.conf
   ```

3. ✅ **Backup configurare**
   ```bash
   cp ~/ircd/etc/ircd.conf ~/ircd/etc/ircd.conf.backup
   ```

4. ✅ **Configurează firewall**
   ```bash
   sudo ufw allow 6667/tcp
   sudo ufw allow 6697/tcp
   ```

5. ✅ **Monitorizează log-urile**
   ```bash
   tail -f ~/ircd/log/ircd.log
   ```

---

## 🆘 Troubleshooting Rapid

### Nu merge ./install.sh
```bash
# Verifică permisiuni
chmod +x install.sh configure-interactive.sh admin.sh

# Rulează din nou
./install.sh
```

### Server nu pornește
```bash
./admin.sh
# 8) Test sintaxă configurare
# 4) Verifica status
# 6) Vizionare log-uri
```

### Port deja în uz
```bash
./admin.sh
# 5) Editare configurare
# Schimbă portul în Port { port = 6668; }
# 3) Restart server
```

### Probleme compilare
```bash
cd ircu2
make clean
./configure --enable-debug
make
make install
```

---

## 📊 Fișiere Noi Adăugate

```
ircu2/
├── install.sh                    (Instalare automată)
├── configure-interactive.sh      (Configurare avansată)
├── admin.sh                      (Meniu administrare)
├── QUICKSTART.md                (Start rapid - 5 min)
├── INSTALL_AUTO.md              (Documentație completă)
└── README_SCRIPTS.md            (Acest fișier)
```

---

## 🎯 Roadmap Viitor

### Versiune 2.0 (Planificat)
- [ ] Suport pentru Docker deploy
- [ ] Monitoring dashboard (web UI)
- [ ] Backup/restore automat
- [ ] Multi-server management
- [ ] Plugin system
- [ ] Statistics & analytics

---

## 📞 Suport & Feedback

**Documentație:**
- QUICKSTART.md - Start rapid
- INSTALL_AUTO.md - Referință completă
- CLAUDE.md - Detalii tehnisce
- doc/example.conf - Config detaliat

**Probleme comune:**
- Citește INSTALL_AUTO.md secțiunea "Rezolvare probleme"

**Updates:**
- `git pull origin main` pentru latest versiune

---

## ✨ Caracteristici Script-uri

| Feature | install.sh | configure-interactive.sh | admin.sh |
|---------|-----------|----------------------|----------|
| Instalare automată | ✅ | - | - |
| Configurare interactivă | ✅ | ✅ | - |
| Pornire server | - | - | ✅ |
| Oprire/Restart | - | - | ✅ |
| Status monitoring | - | - | ✅ |
| Editare config | - | ✅ | ✅ |
| Log viewing | - | - | ✅ |
| Parola generator | ✅ | ✅ | ✅ |
| Config testing | - | ✅ | ✅ |

---

## 🎓 Versiunea & Info

- **Data creării**: 13 februarie 2026
- **Versiune**: 1.0
- **Limbă**: Română 🇷🇴
- **Platform**: Linux, macOS, BSD, Unix
- **Licență**: GNU General Public License (din ircu2)

---

## 🚀 Start Acum!

```bash
git clone https://gitlab.back.ro/underchat/ircu2.git
cd ircu2
./install.sh
```

**În 5-10 minute, serverul tău IRC e gata!** ✨

---

**Succes cu instalarea!** 🎉