nca-ai-cms-astro-plugin 1.0.7 → 1.0.8

package/README.md

@@ -88,6 +88,58 @@ ncaAiCms({
 
 All `/api/*` and `/editor` routes are protected by cookie-based authentication.
 
+## Settings Best Practice
+
+The editor has a **Settings** tab with two groups of fields (Homepage and Website) that control how AI generates content. It also has three prompt categories (Content-KI, Analyse-KI, Bild-KI) where you create reusable prompts. Filling these in with values tailored to your business dramatically improves output quality.
+
+### Settings fields
+
+| Tab | Field | Key | Description |
+|---|---|---|---|
+| Homepage | Hero Ueberschrift | `hero_headline` | Main headline shown on your homepage |
+| Homepage | Hero Text | `hero_text` | Supporting text below the hero headline |
+| Homepage | Zielgruppe | `target_audience` | Who your content is for (e.g. "CTOs at mid-size SaaS companies") |
+| Homepage | Tonalitaet | `tone` | Voice and tone for generated content (e.g. "professional but approachable") |
+| Homepage | Kernbotschaft | `core_message` | The one key message your site should communicate |
+| Website | CTA Link | `cta_url` | Default call-to-action URL (e.g. "/contact" or "/demo") |
+| Website | CTA Stil | `cta_style` | Style or label for the CTA button (e.g. "Jetzt starten") |
+| Website | CTA Prompt | `cta_prompt` | Prompt text used to generate CTA copy |
+| Website | Core Tags | `core_tags` | Comma-separated keywords for your site (e.g. "AI, CMS, Astro, Open Source") |
+| Website | Markenrichtlinien | `brand_guidelines` | Brand rules the AI should follow (colors, dos/don'ts, terminology) |
+
+### Get values for your business with one AI prompt
+
+Copy the prompt below into any AI chat (ChatGPT, Claude, Gemini) and replace the placeholder with a description of your business. You will get ready-to-paste values for every field.
+
+```text
+I run the following business/website:
+[Describe your business in 1-2 sentences, e.g. "An open-source community that organizes charity coding events for nonprofits in Germany."]
+
+Please generate values for each of the following content management settings.
+Return them as a simple list so I can copy-paste each value into the corresponding field.
+
+1. hero_headline — A compelling hero headline (max ~10 words)
+2. hero_text — Supporting hero text (2-3 sentences)
+3. target_audience — Target audience description (one sentence)
+4. tone — Tone of voice for all generated content (2-4 descriptive words)
+5. core_message — Core message / value proposition (1-2 sentences)
+6. cta_url — Suggested CTA link path (e.g. /contact)
+7. cta_style — CTA button label text (2-4 words)
+8. cta_prompt — Short prompt the AI uses to generate CTA copy (one sentence)
+9. core_tags — 5-8 comma-separated keywords/tags for the site
+10. brand_guidelines — Brand guidelines for AI-generated content (3-5 bullet points covering tone, terminology, and things to avoid)
+```
+
+### Prompt categories
+
+The three prompt tabs let you create reusable prompts that the AI uses when generating or analysing content.
+
+| Category | Purpose | Tips for good prompts |
+|---|---|---|
+| **Content-KI** | Controls how the AI writes blog articles and text | Define word count, structure (intro/sections/CTA), target keywords, and writing style. The more specific, the better. |
+| **Analyse-KI** | Controls how the AI analyses existing text | Specify what to check — SEO, readability, accessibility, keyword density — and ask for concrete improvement suggestions. |
+| **Bild-KI** | Controls how the AI generates images | Describe the visual style, color palette, composition, and aspect ratio. Mention what should *not* appear in the image. |
+
 ## Development
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nca-ai-cms-astro-plugin",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",

package/src/services/ContentGenerator.ts

@@ -32,21 +32,21 @@ interface SourceAnalysis {
 
 // Fallback values when database is not available
 const DEFAULT_CONTACT_URL =
-  'https://nevercodealone.de/de/landingpages/barrierefreies-webdesign';
+  'https://nevercodealone.de/de/kontakt';
 
-const DEFAULT_CORE_TAGS = ['Semantik', 'HTML', 'Barrierefrei'];
+const DEFAULT_CORE_TAGS = ['Web-Entwicklung', 'Best Practices'];
 
 const DEFAULT_SYSTEM_PROMPT = `Du bist ein erfahrener technischer Content-Writer für Web-Entwicklung.
 Deine Aufgabe ist es, hochwertige deutsche Fachartikel zu erstellen.
 
-Zielgruppe: Content-Marketing-Professionals und Frontend-Entwickler
+Zielgruppe: Content-Marketing-Professionals und Entwickler
 Tonalität: Professionell, aber zugänglich. Technisch korrekt, nicht übermäßig akademisch.
 
 KRITISCH - 100% Originalität:
 - Schreibe einen KOMPLETT EIGENSTÄNDIGEN Artikel
 - KEINE Sätze, Formulierungen oder Strukturen aus externen Quellen übernehmen
 - KEINE Hinweise auf Quellen, Referenzen oder Inspiration im Text
-- Nutze ausschließlich DEIN Expertenwissen zur Barrierefreiheit
+- Nutze ausschließlich DEIN Expertenwissen zum jeweiligen Thema
 - Jeder Satz muss NEU formuliert sein - wie von einem Experten geschrieben
 - Der Artikel muss wirken als käme er aus eigener Fachkenntnis
 
@@ -57,7 +57,6 @@ Regeln:
 - WICHTIG: Content MUSS mit einer H1-Überschrift (# Titel) beginnen
 - Danach H2 (##) und H3 (###) Hierarchie ohne Sprünge
 - WICHTIG: Nur Markdown, KEINE HTML-Tags wie <p>, <div>, <span> etc.
-- WICHTIG: Integriere die Keywords "Semantik", "HTML" und "Barrierefrei" natürlich in den Text
 
 Titel-Regeln:
 - Das Hauptthema/Keyword MUSS im Titel vorkommen
@@ -148,8 +147,10 @@ export class ContentGenerator {
   private async analyzeSource(
     fetched: FetchedContent
   ): Promise<SourceAnalysis> {
+    const systemPrompt = await this.buildSystemPrompt();
     const model = this.client.getGenerativeModel({
       model: this.model,
+      systemInstruction: systemPrompt,
       generationConfig: {
         responseMimeType: 'application/json',
         responseSchema: buildSourceAnalysisSchema(),
@@ -165,7 +166,7 @@ Inhalt:
 ${fetched.content.slice(0, 12000)}
 
 Identifiziere:
-1. Das Hauptthema (fokussiert auf Web-Entwicklung/Barrierefreiheit)
+1. Das Hauptthema
 2. Die wichtigsten Kernaussagen
 3. Besondere Erkenntnisse oder einzigartige Tipps
 4. Relevante Code-Beispiele oder Patterns`;
@@ -180,23 +181,23 @@ Identifiziere:
   }
 
   private async researchKeywords(keywords: string): Promise<SourceAnalysis> {
+    const systemPrompt = await this.buildSystemPrompt();
     const model = this.client.getGenerativeModel({
       model: this.model,
+      systemInstruction: systemPrompt,
       generationConfig: {
         responseMimeType: 'application/json',
         responseSchema: buildSourceAnalysisSchema(),
       },
     });
 
-    const prompt = `Du bist ein Experte für Web-Accessibility und barrierefreie Webentwicklung.
-
-Recherchiere zum Thema: "${keywords}"
+    const prompt = `Recherchiere zum Thema: "${keywords}"
 
 Nutze dein Fachwissen um:
-1. Das Hauptthema klar zu definieren (Bezug zu Barrierefreiheit/Web-Accessibility)
-2. Die wichtigsten Fakten, Best Practices und WCAG-Richtlinien zusammenzufassen
+1. Das Hauptthema klar zu definieren
+2. Die wichtigsten Fakten, Best Practices und Standards zusammenzufassen
 3. Weniger bekannte aber wichtige Tipps und Erkenntnisse zu identifizieren
-4. Praktische Code-Beispiele oder Patterns vorzuschlagen
+4. Praktische Beispiele oder Patterns vorzuschlagen
 
 Fokussiere auf aktuelle Standards und praktische Anwendbarkeit.`;
 
@@ -296,13 +297,13 @@ Fokussiere auf aktuelle Standards und praktische Anwendbarkeit.`;
   }
 
   private buildUserPrompt(analysis: SourceAnalysis): string {
-    return `Schreibe als Accessibility-Experte einen deutschen Fachartikel zum Thema: ${analysis.topic}
+    return `Schreibe einen deutschen Fachartikel zum Thema: ${analysis.topic}
 
 Behandle diese Aspekte aus deinem Fachwissen:
 ${analysis.keyPoints.map((p) => `- ${p}`).join('\n')}
 ${analysis.uniqueInsights.map((p) => `- ${p}`).join('\n')}
 
-${analysis.codeExamples.length > 0 ? `Zeige praktische Code-Beispiele für:\n${analysis.codeExamples.map((c) => `- ${c}`).join('\n')}` : ''}
+${analysis.codeExamples.length > 0 ? `Zeige praktische Beispiele für:\n${analysis.codeExamples.map((c) => `- ${c}`).join('\n')}` : ''}
 
 Wichtig: Schreibe komplett eigenständig aus deiner Expertise heraus.`;
   }

package/src/services/PromptService.ts

@@ -58,10 +58,24 @@ export class PromptService {
   }
 
   async updateSetting(key: string, value: string): Promise<void> {
-    await db
-      .update(SiteSettings)
-      .set({ value, updatedAt: new Date() })
-      .where(eq(SiteSettings.key, key));
+    const existing = await db
+      .select()
+      .from(SiteSettings)
+      .where(eq(SiteSettings.key, key))
+      .get();
+
+    if (existing) {
+      await db
+        .update(SiteSettings)
+        .set({ value, updatedAt: new Date() })
+        .where(eq(SiteSettings.key, key));
+    } else {
+      await db.insert(SiteSettings).values({
+        key,
+        value,
+        updatedAt: new Date(),
+      });
+    }
   }
 
   async getAllSettings(): Promise<Array<{ key: string; value: string }>> {
@@ -88,11 +102,11 @@ export class PromptService {
 
   async getCoreTags(): Promise<string[]> {
     const tags = await this.getSetting('core_tags');
-    if (!tags) return ['Semantik', 'HTML', 'Barrierefrei'];
+    if (!tags) return ['Web-Entwicklung', 'Best Practices'];
     try {
       return JSON.parse(tags);
     } catch {
-      return ['Semantik', 'HTML', 'Barrierefrei'];
+      return ['Web-Entwicklung', 'Best Practices'];
     }
   }
 }

package/update.md

@@ -1,3 +1,20 @@
+# v1.0.8
+
+## Generalize content generator for any topic
+- Removed hardcoded accessibility/Barrierefreiheit references from all prompts
+- `analyzeSource` now uses `systemInstruction` consistently with `researchKeywords` and `generateContent`
+- Default system prompt uses topic-agnostic language ("zum jeweiligen Thema" instead of "zur Barrierefreiheit")
+- Removed hardcoded keyword integration rule from default system prompt
+- Default core tags changed from accessibility-specific to general (`Web-Entwicklung`, `Best Practices`)
+- Default contact URL updated to generic contact page
+- Domain specialization now lives entirely in configurable database prompts
+
+## Fix: updateSetting upsert
+- `PromptService.updateSetting()` now inserts if key doesn't exist instead of silently doing nothing
+- Enables creating new settings through the settings UI without pre-seeding the database
+
+---
+
 # v1.0.6
 
 ## Separate settings from prompts in SettingsTab