From 6299d4e8157e7f1ffeabf05c45e3fc8c9d73eb93 Mon Sep 17 00:00:00 2001
From: Joachim Hummel <jh@unixweb.de>
Date: Fri, 16 Jan 2026 21:51:52 +0000
Subject: [PATCH] Add project metadata files

- CHANGELOG.md: Version history (v1.0.0)
- .nvmrc: Node.js version (20)
- .editorconfig: Code style configuration
- CONTRIBUTING.md: Contribution guidelines

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .editorconfig   | 20 +++++++++++++
 .nvmrc          |  1 +
 CHANGELOG.md    | 22 ++++++++++++++
 CONTRIBUTING.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 121 insertions(+)
 create mode 100644 .editorconfig
 create mode 100644 .nvmrc
 create mode 100644 CHANGELOG.md
 create mode 100644 CONTRIBUTING.md

diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..539d679
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,20 @@
+# EditorConfig - https://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.json]
+indent_size = 2
+
+[Makefile]
+indent_style = tab
diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 0000000..209e3ef
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+20
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..fa0b708
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,22 @@
+# Changelog
+
+Alle wichtigen Änderungen an diesem Projekt werden hier dokumentiert.
+
+Das Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.0.0/),
+und dieses Projekt folgt [Semantic Versioning](https://semver.org/lang/de/).
+
+## [1.0.0] - 2026-01-16
+
+### Hinzugefügt
+- Express-Server mit REST-API für E-Mail-Versand
+- Weboberfläche zum Versenden von E-Mails (Empfänger, CC, Betreff, Text/HTML)
+- SQLite-Datenbank für persistente Versand-Historie
+- Nodemailer-Integration für Brevo SMTP
+- E-Mail-Footer mit eingebettetem Bild via CID-Attachment
+- Umfangreiche Dokumentation inkl. CID-Embedding Tutorial
+
+### Technische Details
+- Node.js 20.x
+- Express 4.18
+- Nodemailer 6.9
+- better-sqlite3 11.0
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..46edac9
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,78 @@
+# Contributing / Mitwirken
+
+Danke für dein Interesse an diesem Projekt!
+
+## Wie du beitragen kannst
+
+### Bugs melden
+
+1. Prüfe, ob der Bug bereits gemeldet wurde
+2. Erstelle ein Issue mit:
+   - Beschreibung des Problems
+   - Schritte zur Reproduktion
+   - Erwartetes vs. tatsächliches Verhalten
+   - Node.js Version und Betriebssystem
+
+### Feature-Anfragen
+
+1. Erstelle ein Issue mit dem Tag "enhancement"
+2. Beschreibe das gewünschte Feature und den Anwendungsfall
+
+### Code beitragen
+
+1. Fork das Repository
+2. Erstelle einen Feature-Branch: `git checkout -b feature/mein-feature`
+3. Committe deine Änderungen: `git commit -m 'Add: Mein neues Feature'`
+4. Push zum Branch: `git push origin feature/mein-feature`
+5. Erstelle einen Pull Request
+
+## Entwicklung
+
+### Setup
+
+```bash
+# Repository klonen
+git clone https://git.unixweb.net/joachim/mail-service-embedded.git
+cd mail-service-embedded
+
+# Dependencies installieren
+npm install
+
+# Konfiguration erstellen
+cp .env.example .env
+# .env bearbeiten
+
+# Server starten
+npm run dev
+```
+
+### Code-Style
+
+- 2 Spaces für Einrückung
+- Semikolons am Zeilenende
+- Einfache Anführungszeichen für Strings
+- Keine trailing whitespace
+
+Der `.editorconfig` sorgt automatisch für konsistente Formatierung.
+
+### Commit-Messages
+
+Format: `<type>: <description>`
+
+| Type | Beschreibung |
+|------|--------------|
+| Add | Neue Funktion |
+| Fix | Bugfix |
+| Update | Verbesserung bestehender Funktion |
+| Remove | Entfernung von Code/Features |
+| Docs | Dokumentation |
+| Refactor | Code-Umstrukturierung |
+
+Beispiele:
+- `Add: E-Mail-Anhänge unterstützen`
+- `Fix: SMTP-Timeout bei langsamer Verbindung`
+- `Docs: CID-Embedding Beispiele ergänzen`
+
+## Lizenz
+
+Mit deinem Beitrag stimmst du zu, dass dein Code unter der MIT-Lizenz veröffentlicht wird.