Compare commits

..
Author SHA1 Message Date
Rudi 5d6d8f15f3 delete old files 2026-10-13 19:05:05 +02:00
Rudi 1d1976ed07 delete old files 2026-10-13 19:03:28 +02:00
Rudi 14b8a0c65f API route and script 2026-10-13 19:01:57 +02:00
Rudi df9143e95c added api route 2026-10-13 19:01:31 +02:00
Rudi c234c28d15 openapi.json generate script added 2026-10-13 19:01:22 +02:00
Rudi 87801c5b9b Added a script, to generate openapi.json 2026-10-13 18:59:05 +02:00
Rudi bdc864cf94 Working on Standartisation.... #TODO 2026-08-27 18:07:42 +02:00
Rudi da4d67ea47 Added stream API 2026-08-27 17:00:38 +02:00
23 changed files with 8985 additions and 1449 deletions

No files matched your search

-1
View File
@@ -46,4 +46,3 @@ songs.sqlite
.gitignore .gitignore
/lib/generated/prisma /lib/generated/prisma
pnpm-lock.yaml
+3 -2
View File
@@ -2,6 +2,7 @@
import { error } from "console"; import { error } from "console";
import Papa from "papaparse"; import Papa from "papaparse";
import { addSongToSongbook } from "@/lib/db/managing";
interface CSVRow { interface CSVRow {
nummer: string; nummer: string;
@@ -30,8 +31,8 @@ export async function uploadCSVAction(formData:FormData) {
console.log("Data:", rows); console.log("Data:", rows);
rows.forEach(row => { rows.forEach(row => {
console.log(`Nummer: ${row.nummer}, Titel: ${row.titel}`); //console.log(`Nummer: ${row.number}, Titel: ${row.titel}`);
//addSongToSongbook(String(row.titel), Number(songbookId), String(row.nummer)) addSongToSongbook(String(row.titel), Number(songbookId), String(row.nummer))
}); });
return { success: true, message: `${rows.length} Zeilen erfolgreich importiert.`}; return { success: true, message: `${rows.length} Zeilen erfolgreich importiert.`};
+31 -42
View File
@@ -9,7 +9,7 @@ import { Screens } from "@/components/DatabaseOverview";
interface Songbook { interface Songbook {
id: number; id: number;
title: string; name: string;
language: string; language: string;
} }
@@ -22,7 +22,7 @@ interface Song {
interface SongInfo { interface SongInfo {
songbook_id: number; songbook_id: number;
songbook_title: string; songbook_name: string;
song_number: string; song_number: string;
title: string; title: string;
} }
@@ -34,7 +34,7 @@ export default function AdminPage() {
const [number, setNumber] = useState(""); const [number, setNumber] = useState("");
const [title, setTitle] = useState(""); const [title, setTitle] = useState("");
const [newBookTitle, setNewBookTitle] = useState(""); const [newBookName, setNewBookName] = useState("");
const [newBookLanguage, setNewBookLanguage] = useState(""); const [newBookLanguage, setNewBookLanguage] = useState("");
const [uploadStatus, setUploadStatus] = useState<string | null>(null); const [uploadStatus, setUploadStatus] = useState<string | null>(null);
@@ -96,34 +96,21 @@ export default function AdminPage() {
} }
try { try {
// Create song const res = await fetch("/api/songs", {
const res1 = await fetch("/api/songs", {
method: "POST", method: "POST",
headers: { "Content-Type": "application/json" }, headers: { "Content-Type": "application/json" },
body: JSON.stringify({ body: JSON.stringify({
songbookId: Number(selectedSongbookId),
number: number,
title: title title: title
}) })
}) });
if (res1.ok) { if (res.ok) {
console.log("Lied erfolgreich erstellt!"); alert("Lied erfolgreich hinzugefügt!");
setNumber("");
setTitle("");
} else { } else {
console.log("Lied erstellen fehlgeschlagen!"); alert("Fehler beim Senden.");
}
// Attach song to songbook
const data = await res1.json()
const songId = data.song.id;
const res2 = await fetch(`/api/songbooks/${Number(selectedSongbookId)}/songs/${songId}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
number: number
})
})
if (res2.ok) {
console.log("Lied erfolgreich dem Liederbuch zugewiesen!");
} else {
console.log("Fehler");
} }
} catch (error) { } catch (error) {
console.error("Failed sending current songID:", error); console.error("Failed sending current songID:", error);
@@ -137,17 +124,19 @@ export default function AdminPage() {
} }
try { try {
const res2 = await fetch(`/api/songbooks/${Number(selectedSongbookId)}/songs/${selectedSong.song_id}`, { const res = await fetch("/api/songs/attach", {
method: "POST", method: "POST",
headers: { "Content-Type": "application/json" }, headers: { "Content-Type": "application/json" },
body: JSON.stringify({ body: JSON.stringify({
number: number songbookId: selectedSongbookId,
songId: selectedSong.song_id,
number: number,
}) })
}) });
if (res2.ok) { if (res.ok) {
console.log("Lied erfolgreich dem Liederbuch zugewiesen!"); alert("Lied erfolgreich zum Liederbuch hinzugefügt!");
} else { } else {
console.log("Fehler"); alert("Fehler beim Senden.");
} }
} catch (error) { } catch (error) {
console.error("Failed sending current songID:", error); console.error("Failed sending current songID:", error);
@@ -180,8 +169,8 @@ export default function AdminPage() {
} }
const addSongbook = async () => { const addSongbook = async () => {
if (!newBookTitle) { if (!newBookName) {
alert("Der Title des Liederbuches darf nicht leer sein!"); alert("Der Name des Liederbuches darf nicht leer sein!");
return; return;
} }
@@ -189,14 +178,14 @@ export default function AdminPage() {
const res = await fetch("/api/songbooks", { const res = await fetch("/api/songbooks", {
method: "POST", method: "POST",
headers: { "Content-Type": "application/json" }, headers: { "Content-Type": "application/json" },
body: JSON.stringify({ title: newBookTitle, language: newBookLanguage }) body: JSON.stringify({ name: newBookName, language: newBookLanguage })
}); });
if (res.ok) { if (res.ok) {
const createdBook = await res.json(); const createdBook = await res.json();
setSongbooks([...songbooks, createdBook]); setSongbooks([...songbooks, createdBook]);
alert("Liederbuch erfolgreich erstellt!"); alert("Liederbuch erfolgreich erstellt!");
setNewBookTitle(""); setNewBookName("");
setNewBookLanguage(""); setNewBookLanguage("");
} else { } else {
alert("Failed adding songbook!"); alert("Failed adding songbook!");
@@ -226,8 +215,8 @@ export default function AdminPage() {
<Input.Text <Input.Text
type="text" type="text"
placeholder="z.B. Gesangbuch" placeholder="z.B. Gesangbuch"
value={newBookTitle} value={newBookName}
onChange={(e) => setNewBookTitle(e.target.value)} onChange={(e) => setNewBookName(e.target.value)}
/> />
</div> </div>
<div> <div>
@@ -259,7 +248,7 @@ export default function AdminPage() {
<option value="">-- Bitte wählen --</option> <option value="">-- Bitte wählen --</option>
{songbooks.map((book) => ( {songbooks.map((book) => (
<option key={book.id} value={String(book.id)}> <option key={book.id} value={String(book.id)}>
{book.title}{book.language ? ` (${book.language})` : ""} {book.name}{book.language ? ` (${book.language})` : ""}
</option> </option>
))} ))}
</Input.Select> </Input.Select>
@@ -301,7 +290,7 @@ export default function AdminPage() {
<option value="">-- Bitte wählen --</option> <option value="">-- Bitte wählen --</option>
{songbooks.map((book) => ( {songbooks.map((book) => (
<option key={book.id} value={String(book.id)}> <option key={book.id} value={String(book.id)}>
{book.title}{book.language ? ` (${book.language})` : ""} {book.name}{book.language ? ` (${book.language})` : ""}
</option> </option>
))} ))}
</Input.Select> </Input.Select>
@@ -346,7 +335,7 @@ export default function AdminPage() {
<ul className="list-disc list-inside pl-2 text-xs text-neutral-400"> <ul className="list-disc list-inside pl-2 text-xs text-neutral-400">
{songInfos.map((info) => ( {songInfos.map((info) => (
<li key={info.songbook_id}> <li key={info.songbook_id}>
{info.songbook_title} (Nr. {info.song_number}) {info.songbook_name} (Nr. {info.song_number})
</li> </li>
))} ))}
</ul> </ul>
@@ -367,7 +356,7 @@ export default function AdminPage() {
<option value="">-- Bitte wählen --</option> <option value="">-- Bitte wählen --</option>
{songbooks.map((book) => ( {songbooks.map((book) => (
<option key={book.id} value={String(book.id)}> <option key={book.id} value={String(book.id)}>
{book.title}{book.language ? ` (${book.language})` : ""} {book.name}{book.language ? ` (${book.language})` : ""}
</option> </option>
))} ))}
</Input.Select> </Input.Select>
@@ -401,7 +390,7 @@ export default function AdminPage() {
{songInfos.length > 0 ? ( {songInfos.length > 0 ? (
songInfos.map((info) => ( songInfos.map((info) => (
<option key={info.songbook_id} value={String(info.songbook_id)}> <option key={info.songbook_id} value={String(info.songbook_id)}>
{info.songbook_title} (Nr. {info.song_number}) {info.songbook_name} (Nr. {info.song_number})
</option> </option>
)) ))
): ""} ): ""}
+8
View File
@@ -0,0 +1,8 @@
// @/app/api/docs/api/routes.ts
import { NextResponse } from 'next/server';
import spec from '@/src/generated/openapi.json';
export function GET() {
return NextResponse.json(spec);
}
+1
View File
@@ -0,0 +1 @@
// @/app/api/docs/routes.ts
+12 -7
View File
@@ -1,6 +1,11 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
import { getSongBookById, updateSongBook, deleteSongBook } from "@/lib/db/songbook"; import { getSongBookById, updateSongBook, deleteSongBook } from "@/lib/db/songbook";
// import { parseInt } from "@/lib/helper/checkvar";
interface RouteParams {
params: Promise<{
songBookId: string;
}>;
};
/** /**
* @openapi * @openapi
@@ -28,12 +33,12 @@ import { getSongBookById, updateSongBook, deleteSongBook } from "@/lib/db/songbo
*/ */
export async function GET(request: Request, { params }) { export async function GET(_request: Request, { params }: RouteParams) {
try { try {
const { songBookId } = await params; const { songBookId } = await params;
const res = await getSongBookById(songBookId); const res = await getSongBookById(parseInt(songBookId));
if (!res.success) { if (!res.success) {
@@ -81,11 +86,11 @@ export async function GET(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function PATCH(request: Request, { params }) { export async function PATCH(request: Request, { params }: RouteParams) {
try { try {
const { songBookId } = await params; const { songBookId } = await params;
const data = await request.json(); const data = await request.json();
const res = await updateSongBook(songBookId, data); const res = await updateSongBook(parseInt(songBookId), data);
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -126,10 +131,10 @@ export async function PATCH(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function DELETE(request: Request, { params }) { export async function DELETE(_request: Request, { params }: RouteParams) {
try { try {
const { songBookId } = await params; const { songBookId } = await params;
const res = await deleteSongBook(songBookId); const res = await deleteSongBook(parseInt(songBookId));
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -1,6 +1,12 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
import { addSongToBook, updateSongInBook, removeSongFromBook } from "@/lib/db/songbooksongs"; import { addSongToBook, updateSongInBook, removeSongFromBook } from "@/lib/db/songbooksongs";
// import { parseInt } from "@/lib/helper/checkvar";
interface RouteParams {
params: Promise<{
songBookId: string;
songId: string;
}>;
};
/** /**
* @openapi * @openapi
@@ -45,13 +51,13 @@ import { addSongToBook, updateSongInBook, removeSongFromBook } from "@/lib/db/so
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function POST(request: Request, { params }) { export async function POST(request: Request, { params }: RouteParams) {
try { try {
const { songBookId, songId } = await params; const { songBookId, songId } = await params;
const data = await request.json(); const data = await request.json();
const res = await addSongToBook(songId, songBookId, data.number); const res = await addSongToBook(parseInt(songId), parseInt(songBookId), String(data.number));
if (!res.success) { if (!res.success) {
@@ -114,11 +120,11 @@ export async function POST(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function PATCH(request: Request, { params }) { export async function PATCH(request: Request, { params }: RouteParams) {
try { try {
const { songBookId, songId } = await params; const { songBookId, songId } = await params;
const data = await request.json(); const data = await request.json();
const res = await updateSongInBook(songId, songBookId, data); const res = await updateSongInBook(parseInt(songId), parseInt(songBookId), data);
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -165,11 +171,11 @@ export async function PATCH(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function DELETE(request: Request, { params }) { export async function DELETE(_request: Request, { params }: RouteParams) {
try { try {
const { songBookId, songId } = await params; const { songBookId, songId } = await params;
const res = await removeSongFromBook(songId, songBookId); const res = await removeSongFromBook(parseInt(songId), parseInt(songBookId));
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -1,6 +1,11 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
import { getSongByNumber } from "@/lib/db/songbooksongs"; import { getSongByNumber } from "@/lib/db/songbooksongs";
interface RouteParams {
params: Promise<{
songBookId: string;
}>;
};
/** /**
* @openapi * @openapi
@@ -26,14 +31,14 @@ import { getSongByNumber } from "@/lib/db/songbooksongs";
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function GET(request: Request, { params }) { export async function GET(request: Request, { params }: RouteParams) {
try { try {
const { songBookId } = await params; const { songBookId } = await params;
const { searchParams } = new URL(request.url); const { searchParams } = new URL(request.url);
const number = searchParams.get("number") || searchParams.get("n"); const number = searchParams.get("number") || searchParams.get("n");
if(number){ if(number){
const res = await getSongByNumber(songBookId, number); const res = await getSongByNumber(parseInt(songBookId), number);
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
+11 -7
View File
@@ -1,7 +1,11 @@
import { NextResponse } from "next/server"; import { NextResponse } from "next/server";
import { getSongById, updateSong, deleteSong } from "@/lib/db/song"; import { getSongById, updateSong, deleteSong } from "@/lib/db/song";
// import { parseInt } from "@/lib/helper/checkvar";
interface RouteParams {
params: Promise<{
songId: string;
}>;
};
/** /**
* @openapi * @openapi
@@ -27,10 +31,10 @@ import { getSongById, updateSong, deleteSong } from "@/lib/db/song";
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function GET(request: Request, { params }) { export async function GET(_request: Request, { params }: RouteParams) {
try { try {
const { songId } = await params; const { songId } = await params;
const res = await getSongById(songId); const res = await getSongById(parseInt(songId));
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -77,11 +81,11 @@ export async function GET(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function PATCH(request: Request, { params }) { export async function PATCH(request: Request, { params }: RouteParams) {
try { try {
const { songId } = await params; const { songId } = await params;
const data = await request.json(); const data = await request.json();
const res = await updateSong(songId, data); const res = await updateSong(parseInt(songId), data);
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
@@ -122,10 +126,10 @@ export async function PATCH(request: Request, { params }) {
* 500: * 500:
* description: Serverfehler * description: Serverfehler
*/ */
export async function DELETE(request: Request, { params }) { export async function DELETE(_request: Request, { params }: RouteParams) {
try { try {
const { songId } = await params; const { songId } = await params;
const res = await deleteSong(songId); const res = await deleteSong(parseInt(songId));
if (!res.success) { if (!res.success) {
return NextResponse.json({ message: res.error }, { status: res.status }); return NextResponse.json({ message: res.error }, { status: res.status });
+1 -4
View File
@@ -110,10 +110,7 @@ export async function POST(request: Request) {
if (!res.success) { if (!res.success) {
return NextResponse.json( return NextResponse.json(
{ { message: res.error },
message: res.error,
song: res.song
},
{ status: res.status } { status: res.status }
); );
} }
-77
View File
@@ -1,77 +0,0 @@
// @wikiCategory: Stream
import { NextResponse } from "next/server";
import { getSongById } from "@/lib/db/song";
let currentSong = {
songID: "",
songbook: "",
number: "",
title: ""
};
// @wikiDescription: Akutell gestreamtes Lied abrufen
export async function GET() {
return NextResponse.json(currentSong)
}
// @wikiDescription: Lied zum Streamen festlegen
export async function POST(request: Request) {
try {
const data = await request.json();
const { songID, songbookID } = data;
if (!songID || !songbookID) {
return NextResponse.json(
{ success: false, error: "Fields incomplete!" },
{ status: 400 }
);
}
const result = await getSongById(songID);
if (result.success && result.song) {
const song = result.song;
// looking for the songbook with matching ID
const matchedBook = song.songBooks.find(
(entry) => String(entry.book.id) === String(songbookID)
);
if (matchedBook) {
currentSong = {
songID: String(song.id),
songbook: matchedBook.book.title,
number: String(matchedBook.songNumber),
title: song.title,
};
} else {
// song does exist but not in the given songbook
currentSong = {
songID: "",
songbook: "",
number: "",
title: "",
};
}
} else {
// song does not exist
currentSong = {
songID: "",
songbook: "",
number: "",
title: "",
};
}
console.log("Aktualisierter currentSong:", currentSong);
return NextResponse.json({ success: true, currentSong });
} catch (error) {
console.error("API POST Error:", error);
return NextResponse.json(
{ success: false, error: "Server-Fehler" },
{ status: 500 }
);
}
}
+67
View File
@@ -0,0 +1,67 @@
// @wikiCategory: Stream
import { NextResponse } from "next/server";
let currentSong = {
number: "",
song: "",
songbook: "",
};
const clients = new Set<ReadableStreamDefaultController>();
// @wikiDescription: Akutell gestreamtes Lied abrufen
export async function GET() {
let controllerRef: ReadableStreamDefaultController;
const stream = new ReadableStream({
start(controller) {
controllerRef = controller;
clients.add(controller);
if (currentSong.song) {
controller.enqueue(`data: ${JSON.stringify(currentSong)}\n\n`);
}
},
cancel() {
clients.delete(controllerRef);
},
});
return new NextResponse(stream, {
headers: {
'Content-Type': 'text/event-stream',
'Cache-Control': 'no-cache',
'Connection': 'keep-alive',
},
});
}
// @wikiDescription: Lied zum Streamen festlegen
export async function POST(request: Request) {
try {
const data = await request.json();
const song = data.song?.trim() ?? null;
const songbook = data.songBook?.trim() ?? null;
const number = data.number?.trim() ?? null;
if (song == null || songbook == null || number == null) {
return NextResponse.json({ success: false, error: "Fields incomplete!" }, { status: 400 });
}
currentSong = {
song,
songbook,
number
};
clients.forEach((controller) => {
controller.enqueue(`data: ${JSON.stringify(currentSong)}\n\n`);
});
return NextResponse.json({ success: true , currentSong }, { status: 200 });
} catch (error) {
return NextResponse.json({ success: false, error: "Server-Fehler" }, { status: 500 });
}
}
+8
View File
@@ -0,0 +1,8 @@
'use client';
import SwaggerUI from 'swagger-ui-react';
import 'swagger-ui-react/swagger-ui.css';
export default function DocsPage() {
return <SwaggerUI url="/api/docs/api" />;
}
-34
View File
@@ -1,34 +0,0 @@
import { getAllApis } from "@/lib/wiki";
import Article from '@/components/wiki/Article';
import { API } from '@/components/mdx-components';
export default async function Page() {
const allApis = await getAllApis();
// Gruppiert die APIs nach ihrer Kategorie
const groupedApis = Object.groupBy(allApis, (api) => api.category);
return (
<Article title="API-Endpunkte">
{Object.entries(groupedApis).map(([category, apis]) => (
<div key={category} className="mb-10">
{/* Kategorie-Überschrift wird nur EINMAL pro Kategorie gerendert */}
<h2 className="text-2xl font-bold text-white mt-10 mb-4 border-b border-zinc-800 pb-2">
{category}
</h2>
{/* Routen innerhalb dieser Kategorie durchgehen */}
{apis?.map((api, index) => (
<div key={index} className="my-4">
{api.methods.map((method, mIndex) => (
<API route={api.route} method={method.method} key={mIndex}>
{method.description}
</API>
))}
</div>
))}
</div>
))}
</Article>
);
}
+12 -14
View File
@@ -1,7 +1,7 @@
import { useState, useEffect, ComponentPropsWithoutRef } from "react"; import { useState, useEffect, ComponentPropsWithoutRef } from "react";
import Card from "./Card"; import Card from "./Card"
import { Input } from "./FormElements"; import { Input } from "./FormElements"
interface SongsProps extends Omit<ComponentPropsWithoutRef<typeof Card>, "title" | "children"> { interface SongsProps extends Omit<ComponentPropsWithoutRef<typeof Card>, "title" | "children"> {
onSelectSong?: (song: Song) => void; onSelectSong?: (song: Song) => void;
@@ -9,7 +9,7 @@ interface SongsProps extends Omit<ComponentPropsWithoutRef<typeof Card>, "title"
} }
interface Song { interface Song {
id: number; song_id: number;
songbook_id: number; songbook_id: number;
song_number: string; song_number: string;
title: string; title: string;
@@ -17,16 +17,17 @@ interface Song {
interface Songbook { interface Songbook {
id: number; id: number;
title: string; name: string;
language: string; language: string;
} }
function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...props }: SongsProps) { function Songs({ actionName, onSelectSong, className = "", ...props }: SongsProps) {
const [song_search_name, setSongSearchName] = useState(""); const [song_search_name, setSongSearchName] = useState("");
const [searchResults, setSearchResults] = useState<Song[]>([]); const [searchResults, setSearchResults] = useState<Song[]>([]);
const [allSongs, setAllSongs] = useState<Song[]>([]); const [allSongs, setAllSongs] = useState<Song[]>([]);
const [songbooks, setSongbooks] = useState<Songbook[]>([]); const [songbooks, setSongbooks] = useState<Songbook[]>([]);
const search = (query: string) => { const search = (query: string) => {
setSongSearchName(query); setSongSearchName(query);
if (query.trim() !== "") { if (query.trim() !== "") {
@@ -52,7 +53,7 @@ function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...pro
} }
} catch (error) { } catch (error) {
setAllSongs([]); setAllSongs([]);
console.error("Failed fetching songslist!", error); console.error("Failed fetching songslist!");
} }
}; };
@@ -67,7 +68,6 @@ function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...pro
console.error("Loading songbooks failed: ", error); console.error("Loading songbooks failed: ", error);
} }
} }
loadSongbooks(); loadSongbooks();
getSongslist(); getSongslist();
}, []); }, []);
@@ -86,7 +86,6 @@ function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...pro
onChange={(e) => search(e.target.value)} onChange={(e) => search(e.target.value)}
/> />
</div> </div>
{/* TABELLE */} {/* TABELLE */}
<div className="flex-1 min-h-0 overflow-auto border border-neutral-200 dark:border-neutral-800 rounded-lg bg-white dark:bg-black"> <div className="flex-1 min-h-0 overflow-auto border border-neutral-200 dark:border-neutral-800 rounded-lg bg-white dark:bg-black">
<table className="w-full text-left border-collapse text-sm"> <table className="w-full text-left border-collapse text-sm">
@@ -106,17 +105,16 @@ function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...pro
) : ( ) : (
searchResults.map((song) => { searchResults.map((song) => {
const songBook = songbooks.find((book) => book.id === song.songbook_id); const songBook = songbooks.find((book) => book.id === song.songbook_id);
return ( return (
<tr key={`${song.songbook_id}-${song.id}`} className="hover:bg-neutral-100/60 dark:hover:bg-neutral-900/40 transition"> <tr key={`${song.songbook_id}-${song.song_id}`} className="hover:bg-neutral-100/60 dark:hover:bg-neutral-900/40 transition">
<td className="p-3 font-medium text-neutral-900 dark:text-white max-w-[180px] sm:max-w-none truncate"> <td className="p-3 font-medium text-neutral-900 dark:text-white max-w-[180px] sm:max-w-none truncate">
{song.title} {song.title}
<span className="block text-xs text-neutral-500 dark:text-neutral-400 sm:hidden mt-0.5"> <span className="block text-xs text-neutral-500 dark:text-neutral-400 sm:hidden mt-0.5">
{songBook ? songBook.title : "Unbekannt"} {songBook ? songBook.name : "Unbekannt"}
</span> </span>
</td> </td>
<td className="p-3 text-neutral-700 dark:text-neutral-300 hidden sm:table-cell"> <td className="p-3 text-neutral-700 dark:text-neutral-300 hidden sm:table-cell">
{songBook ? songBook.title : "Unbekannt"} {songBook ? songBook.name : "Unbekannt"}
</td> </td>
<td className="p-3 text-center font-mono text-blue-600 dark:text-blue-400 font-bold"> <td className="p-3 text-center font-mono text-blue-600 dark:text-blue-400 font-bold">
{song.song_number} {song.song_number}
@@ -137,9 +135,9 @@ function Songs({ actionName = "Auswählen", onSelectSong, className = "", ...pro
</table> </table>
</div> </div>
</Card> </Card>
); )
} }
export const Screens = { export const Screens = {
Songs: Songs, Songs: Songs,
}; }
+42
View File
@@ -0,0 +1,42 @@
export interface Song {
id: number;
title: string;
}
export interface SongBook {
id: number;
title: string;
language?: string;
}
export interface SongDetailed {
song: {
id: number;
title: string;
songBooks?:{songNumber: number; book:SongBook}[]
};
}
export type APIResponse<T> =
| { success: true; status: number; data: T }
| { success: false; status: number; error: string };
export type GetSongsResponse = APIResponse<Song[]>;
export type GetSongDetailedResponse =
| {
success: true;
status: number;
song: SongDetailed
}
| { success: false; status: number; error: string };
export type GetSongsDelailedResponse =
| {
success: true;
status: number;
songs: SongDetailed[]
}
| { success: false; status: number; error: string };
export type CreateSongsResponse = APIResponse<Song>;
+15 -8
View File
@@ -1,7 +1,14 @@
import { prisma } from "@/lib/db/prisma"; import { prisma } from "@/lib/db/prisma";
import { parseInt } from "@/lib/helper/checkvar"; import { parseInt } from "@/lib/helper/checkvar";
import type * as API from "./response";
// For Error checking use this import: import { Prisma } from "@prisma/client"; // For Error checking use this import: import { Prisma } from "@prisma/client";
interface Response {
success: boolean;
status: number;
songs?: [];
error?: string;
}
/** /**
* GetSongs * GetSongs
@@ -9,7 +16,7 @@ import { parseInt } from "@/lib/helper/checkvar";
* *
* @returns {"success": boolean, "status": number, "songs": [{"id":number, "title": string},...]} * @returns {"success": boolean, "status": number, "songs": [{"id":number, "title": string},...]}
*/ */
export async function getSongs() { export async function getSongs(): Promise<API.GetSongsResponse> {
try{ try{
const songs = await prisma.song.findMany({ const songs = await prisma.song.findMany({
select: { select: {
@@ -35,7 +42,7 @@ export async function getSongs() {
* @param id - ID indicatin the song * @param id - ID indicatin the song
* @returns {"success": boolean, "status": number, "song": {"id":number, "title": string, "songBooks": [{"songNumber": number, "book": {"title": string, "language": string}},...]}} * @returns {"success": boolean, "status": number, "song": {"id":number, "title": string, "songBooks": [{"songNumber": number, "book": {"title": string, "language": string}},...]}}
*/ */
export async function getSongById(rawId: number) { export async function getSongById(rawId: number): Promise<API.GetSongDetailedResponse> {
try{ try{
const id = parseInt(rawId); const id = parseInt(rawId);
if (!id) { if (!id) {
@@ -78,13 +85,13 @@ export async function getSongById(rawId: number) {
* *
* @param query - The search term for the song title. * @param query - The search term for the song title.
* @param limit - Max number of songs returned for performance (default: 20). * @param limit - Max number of songs returned for performance (default: 20).
* @returns @returns {"success": boolean, "status": number, "song": {"id":number, "title": string, "songBooks": [{"songNumber": number, "book": {"title": string, "language": string}},...]}} * @returns {"success": boolean, "status": number, "song": {"id":number, "title": string, "songBooks": [{"songNumber": number, "book": {"title": string, "language": string}},...]}}
*/ */
export async function searchSongsByTitle(query: string, limit: number = 20) { export async function searchSongsByTitle(query: string, limit: number = 20): Promise<API.GetSongsDelailedResponse> {
try { try {
const cleanQuery = query.trim(); const cleanQuery = query.trim();
if (!cleanQuery) { if (!cleanQuery) {
return { success: true, songBooks: [] }; return { success: true, status: 200, songs: [] };
} }
const songs = await prisma.song.findMany({ const songs = await prisma.song.findMany({
@@ -124,7 +131,7 @@ export async function searchSongsByTitle(query: string, limit: number = 20) {
* @param data - object with title * @param data - object with title
* @returns {"success": boolean, "status": number, "song": {"id":number, "title": string}} * @returns {"success": boolean, "status": number, "song": {"id":number, "title": string}}
*/ */
export async function createSong(data: { title: string }) { export async function createSong(data: { title: string }): Promise<API.CreateSongsResponse> {
try{ try{
if(!data.title){ if(!data.title){
return { success: false, status: 400, error: "Field 'title' is required" }; return { success: false, status: 400, error: "Field 'title' is required" };
@@ -164,7 +171,7 @@ export async function createSong(data: { title: string }) {
export async function updateSong( export async function updateSong(
rawId: number, rawId: number,
data: { title?: string } data: { title?: string }
) { ): Promise<API.CreateSongsResponse> {
try { try {
const id = parseInt(rawId); const id = parseInt(rawId);
if (!id) { if (!id) {
@@ -213,7 +220,7 @@ export async function updateSong(
* @param id - ID indicatin the song * @param id - ID indicatin the song
* @returns {"success": boolean, "status": number, "song": {"id": number, "title": string}} * @returns {"success": boolean, "status": number, "song": {"id": number, "title": string}}
*/ */
export async function deleteSong(rawId: number) { export async function deleteSong(rawId: number): Promise<API.CreateSongsResponse> {
try { try {
const id = parseInt(rawId); const id = parseInt(rawId);
if (!id) { if (!id) {
+1 -1
View File
@@ -1,6 +1,6 @@
export function parseInt(rawInteger){ export function parseInt(rawInteger: number){
const integer = Number.parseInt(rawInteger); const integer = Number.parseInt(rawInteger);
if (Number.isNaN(integer) || !Number.isInteger(integer)) { if (Number.isNaN(integer) || !Number.isInteger(integer)) {
-228
View File
@@ -1,228 +0,0 @@
import fs from 'fs';
import path from 'path';
import matter from 'gray-matter';
import ts from 'typescript';
import { ApiRoute, ApiMethod } from '@/types/api';
export type WikiArticle = {
slug: string;
title: string;
rawContent: string;
updatedAt?: string;
};
export type WikiPage = {
title: string;
path: string;
}
const wikiDirectory = path.join(process.cwd(), "data/wiki/pages");
export async function getWikiPageBySlug(slug: string): Promise<WikiArticle | null> {
try {
const fullPath = path.join(wikiDirectory, `${slug}.mdx`);
const fileContents = fs.readFileSync(fullPath, "utf-8");
const { data, content } = matter(fileContents);
return {
slug,
rawContent: content,
title: data.title || 'Unbenannt',
updatedAt: data.updatedAt || null,
...data,
} as WikiArticle;
} catch (error) {
return null;
}
}
/**
* Liest rekursiv alle Dateien aus einem Verzeichnis aus.
* @param dirPath - Der Startordner
* @param extension - Optionale Dateiendung zur Filterung (z. B. ".ts" oder "ts")
* @returns Array mit den Dateipfaden
*/
export function getAllFiles(dirPath: string, extension?: string): string[] {
if (!fs.existsSync(dirPath)) return [];
let results: string[] = [];
// optionales führendes Dot sicherstellen (z. B. aus "ts" wird ".ts")
const targetExt = extension && !extension.startsWith('.')
? `.${extension}`
: extension;
// withFileTypes: true spart zusätzliche fs.statSync Aufrufe
const entries = fs.readdirSync(dirPath, { withFileTypes: true });
for (const entry of entries) {
const fullPath = path.join(dirPath, entry.name);
if (entry.isDirectory()) {
results = results.concat(getAllFiles(fullPath, targetExt));
} else if (!targetExt || entry.name.endsWith(targetExt)) {
results.push(fullPath);
}
}
return results;
}
/**
* Liest die Kategorie aus der Datei aus (@wikiCategory) oder ermittelt sie aus dem Ordnernamen.
*/
export function filterCategory(
content: string,
filePath: string,
prefix: string = '@wikiCategory'
): string {
// 1. In Kommentaren nach @wikiCategory suchen
const lines = content.split('\n');
for (const line of lines) {
const cleaned = line.replace(/^\/\/\s*/, '').replace(/^\/\*\*?\s*/, '').replace(/\*\/$/, '').trim();
if (cleaned.startsWith(prefix)) {
let category = cleaned.slice(prefix.length).trim().replace(/^:\s*/, '');
if (category) return category;
}
}
// 2. Fallback: Ersten Ordnernamen unter app/api/ als Kategorie nutzen
const normalizedPath = filePath.replace(/\\/g, '/');
const apiMatch = normalizedPath.match(/app\/api\/([^/]+)/);
if (apiMatch && apiMatch[1]) {
const folderName = apiMatch[1];
// Ersten Buchstaben großschreiben (z. B. "stream" -> "Stream")
return folderName.charAt(0).toUpperCase() + folderName.slice(1);
}
return 'Allgemein';
}
/**
* Parst TypeScript-Code via AST und extrahiert HTTP-Methoden sowie deren Kommentare.
*/
export function filterMethods(
content: string,
prefix: string = '@wikiDescription'
): ApiMethod[] {
const sourceFile = ts.createSourceFile(
'temp.ts',
content,
ts.ScriptTarget.Latest,
/* setParentNodes */ true
);
const methods: ApiMethod[] = [];
const validMethods = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
ts.forEachChild(sourceFile, (node) => {
if (ts.isFunctionDeclaration(node) && node.name) {
const functionName = node.name.text;
if (validMethods.has(functionName)) {
let description = '';
const commentRanges = ts.getLeadingCommentRanges(content, node.pos);
if (commentRanges && commentRanges.length > 0) {
const lastCommentRange = commentRanges[commentRanges.length - 1];
const rawComment = content.substring(
lastCommentRange.pos,
lastCommentRange.end
);
const cleanedComment = rawComment
.replace(/^\/\/\s*/, '')
.replace(/^\/\*\*?\s*/, '')
.replace(/\*\/$/, '')
.split('\n')
.map((line) => line.replace(/^\s*\*\s?/, '').trim())
.join(' ')
.trim();
if (cleanedComment.startsWith(prefix)) {
let textAfterPrefix = cleanedComment.slice(prefix.length).trim();
textAfterPrefix = textAfterPrefix.replace(/^:\s*/, '');
description = textAfterPrefix;
}
}
methods.push({
method: functionName,
description: description || 'Keine Beschreibung vorhanden.',
});
}
}
});
return methods;
}
/**
* Liest alle API-Dateien dynamisch aus und wandelt sie in ApiRoute-Objekte um.
*/
export async function getAllApis(): Promise<ApiRoute[]> {
try {
const apiBasePath = path.join(process.cwd(), "app/api");
const allTsFiles = getAllFiles(apiBasePath, ".ts");
const routes: ApiRoute[] = [];
allTsFiles.forEach((filePath) => {
const fileContents = fs.readFileSync(filePath, "utf-8");
// 1. Methoden extrahieren
const methods = filterMethods(fileContents, "@wikiDescription");
// Nur Routen hinzufügen, die auch API-Methoden exportieren
if (methods.length > 0) {
// 2. Kategorie ermitteln
const category = filterCategory(fileContents, filePath, "@wikiCategory");
// 3. Route-Pfad automatisch aus dem Dateipfad generieren (app/api/stream/currentID/route.ts -> stream/currentID)
const relativePath = path.relative(apiBasePath, filePath).replace(/\\/g, '/');
const routePath = relativePath
.replace(/\/route\.ts$/, '')
.replace(/\.ts$/, '');
routes.push({
route: routePath,
category,
methods,
});
}
});
return routes;
} catch (error) {
console.error("Fehler beim Auslesen der API-Dateien:", error);
return [];
}
}
export async function getAllWikiPages(): Promise<WikiPage[]> {
try {
const pagesBasePath = path.join(process.cwd(), "data/wiki/pages");
const allPaths = getAllFiles(pagesBasePath, ".mdx");
const allPages: WikiPage[] = [];
for (const filePath of allPaths) {
// extract filename of the path (e. g. "test" at "data/wiki/pages/test.mdx")
const slug = path.parse(filePath).name;
const wikiPage = await getWikiPageBySlug(slug);
if (wikiPage) {
allPages.push({
path: slug,
title: wikiPage.title,
});
}
}
console.log(allPages);
return allPages;
} catch (error) {
console.error("Fehler beim Auslesen der Wiki-Seiten:", error);
return [];
}
}
+8150 -1008
View File
File diff suppressed because it is too large. Load diff
+8 -7
View File
@@ -7,14 +7,11 @@
"build": "next build", "build": "next build",
"start": "next start", "start": "next start",
"lint": "eslint", "lint": "eslint",
"postinstall": "prisma generate", "openapi:generate": "node scripts/generate-openapi.mjs"
"predev": "prisma migrate deploy",
"prestart": "prisma migrate deploy",
"db:setup": "node -e \"require('fs').existsSync('.env')||require('fs').copyFileSync('example.env','.env')\" && prisma migrate deploy && prisma generate"
}, },
"dependencies": { "dependencies": {
"@prisma/adapter-better-sqlite3": "^7.9.1", "@prisma/adapter-better-sqlite3": "^7.9.1",
"@prisma/client": "^7.9.1", "@prisma/client": "^7.10.0",
"@types/papaparse": "^5.5.2", "@types/papaparse": "^5.5.2",
"argon2": "^0.45.1", "argon2": "^0.45.1",
"better-sqlite3": "^13.0.2", "better-sqlite3": "^13.0.2",
@@ -23,7 +20,6 @@
"next": "16.2.9", "next": "16.2.9",
"next-mdx-remote": "^6.0.0", "next-mdx-remote": "^6.0.0",
"papaparse": "^5.5.4", "papaparse": "^5.5.4",
"prisma": "^7.9.1",
"react": "19.2.4", "react": "19.2.4",
"react-dom": "19.2.4", "react-dom": "19.2.4",
"rehype-autolink-headings": "^7.1.0", "rehype-autolink-headings": "^7.1.0",
@@ -35,7 +31,8 @@
"remark-html": "^16.0.1", "remark-html": "^16.0.1",
"remark-parse": "^11.0.0", "remark-parse": "^11.0.0",
"remark-rehype": "^11.1.2", "remark-rehype": "^11.1.2",
"shiki": "^4.4.1" "shiki": "^4.4.1",
"swagger-ui-react": "^5.33.2"
}, },
"devDependencies": { "devDependencies": {
"@tailwindcss/postcss": "^4", "@tailwindcss/postcss": "^4",
@@ -44,8 +41,12 @@
"@types/node": "^20", "@types/node": "^20",
"@types/react": "^19", "@types/react": "^19",
"@types/react-dom": "^19", "@types/react-dom": "^19",
"@types/swagger-jsdoc": "^6.0.4",
"@types/swagger-ui-react": "^5.18.0",
"eslint": "^9", "eslint": "^9",
"eslint-config-next": "16.2.9", "eslint-config-next": "16.2.9",
"prisma": "^8.0.0-rc.22",
"swagger-jsdoc": "^6.3.0",
"tailwindcss": "^4", "tailwindcss": "^4",
"typescript": "^5.9.3" "typescript": "^5.9.3"
}, },
+18
View File
@@ -0,0 +1,18 @@
import swaggerJsdoc from 'swagger-jsdoc';
import { mkdirSync, writeFileSync } from 'node:fs';
import { dirname } from 'node:path';
const spec = swaggerJsdoc({
definition: {
openapi: '3.0.0',
info: { title: 'PsalmTafel API', version: '1.0.0' },
},
apis: ['./app/api/**/*.ts'],
failOnErrors: true,
});
const out = 'src/generated/openapi.json';
mkdirSync(dirname(out), { recursive: true });
writeFileSync(out, JSON.stringify(spec, null, 2));
console.log(`OpenAPI: ${Object.keys(spec.paths ?? {}).length} Pfade -> ${out}`);
+577
View File
@@ -0,0 +1,577 @@
{
"openapi": "3.0.0",
"info": {
"title": "PsalmTafel API",
"version": "1.0.0"
},
"paths": {
"/api/songs": {
"get": {
"summary": "Get all songs",
"responses": {
"200": {
"description": "List of songs"
},
"500": {
"description": "Internal Server Error"
}
}
},
"post": {
"summary": "Creates a new song",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"example": "Großer Gott"
}
}
}
}
}
},
"responses": {
"201": {
"description": "Songbook successfully created",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"songBook": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 1
},
"title": {
"type": "string",
"example": "Großer Gott"
}
}
}
}
}
}
}
},
"400": {
"description": "Bad Request (missing name)"
},
"409": {
"description": "Conflict (title already exists)"
},
"500": {
"description": "Internal Server Error"
}
}
}
},
"/api/songs/{id}": {
"get": {
"summary": "Einzelnen Song abrufen",
"tags": [
"Songs"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"responses": {
"200": {
"description": "Song erfolgreich gefunden"
},
"400": {
"description": "Ungültige Song-ID"
},
"404": {
"description": "Song nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
},
"patch": {
"summary": "Song aktualisieren",
"tags": [
"Songs"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Song erfolgreich aktualisiert"
},
"400": {
"description": "Ungültige Parameter oder Daten"
},
"404": {
"description": "Song nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
},
"delete": {
"summary": "Song löschen",
"tags": [
"Songs"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"responses": {
"200": {
"description": "Song erfolgreich gelöscht"
},
"400": {
"description": "Ungültige Song-ID"
},
"404": {
"description": "Song nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
}
},
"/api/songbooks": {
"get": {
"summary": "Get all songbooks",
"responses": {
"200": {
"description": "List of songbooks"
},
"500": {
"description": "Internal Server Error"
}
}
},
"post": {
"summary": "Creates a new songbook",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"example": "Feiert Jesus 1"
},
"language": {
"type": "string",
"example": "DE"
}
}
}
}
}
},
"responses": {
"201": {
"description": "Songbook successfully created",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true
},
"songBook": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 1
},
"title": {
"type": "string",
"example": "Feiert Jesus 1"
},
"language": {
"type": "string",
"example": "DE"
}
}
}
}
}
}
}
},
"400": {
"description": "Bad Request (missing title)"
},
"409": {
"description": "Conflict (title already exists)"
},
"500": {
"description": "Internal Server Error"
}
}
}
},
"/api/songbooks/{id}": {
"get": {
"summary": "Einzelnen Songbook abrufen",
"tags": [
"Songbooks"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songbooks"
}
],
"responses": {
"200": {
"description": "Songbook erfolgreich gefunden"
},
"400": {
"description": "Ungültige Songbook-ID"
},
"404": {
"description": "Songbook nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
},
"patch": {
"summary": "Songbook aktualisieren",
"tags": [
"Songbooks"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songbooks"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
"responses": {
"200": {
"description": "Songbook erfolgreich aktualisiert"
},
"400": {
"description": "Ungültige Parameter oder Daten"
},
"404": {
"description": "Songbook nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
},
"delete": {
"summary": "Songbook löschen",
"tags": [
"Songbooks"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songbooks"
}
],
"responses": {
"200": {
"description": "Songbook erfolgreich gelöscht"
},
"400": {
"description": "Ungültige Songbook-ID"
},
"404": {
"description": "Songbook nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
}
},
"/api/songbooks/{id}/songs": {
"get": {
"summary": "Einen Song nach Nummer in einem Songbook suchen",
"tags": [
"Songbook"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songbooks"
}
],
"responses": {
"200": {
"description": "Songbook erfolgreich gefunden"
},
"400": {
"description": "Ungültige Songbook-ID"
},
"404": {
"description": "Songbook nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
}
},
"/api/songbooks/{songBookId}/songs/{songId}": {
"post": {
"summary": "Song zu Liederbuch hinzufügen",
"tags": [
"Songbook"
],
"parameters": [
{
"in": "path",
"name": "songBookId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Liederbuchs"
},
{
"in": "path",
"name": "songId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"example": "104a",
"description": "Die Songnummer im Liederbuch"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Song erfolgreich zugewiesen"
},
"400": {
"description": "Ungültige Parameter oder fehlende Songnummer"
},
"409": {
"description": "Songnummer bereits vergeben oder Song existiert bereits im Buch"
},
"500": {
"description": "Serverfehler"
}
}
},
"patch": {
"summary": "Songnummer eines Songs im Liederbuch aktualisieren",
"tags": [
"Songbook"
],
"parameters": [
{
"in": "path",
"name": "songBookId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Liederbuchs"
},
{
"in": "path",
"name": "songId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"number"
],
"properties": {
"number": {
"type": "string",
"example": "105",
"description": "Die neue Songnummer im Liederbuch"
}
}
}
}
}
},
"responses": {
"200": {
"description": "Songnummer erfolgreich aktualisiert"
},
"400": {
"description": "Ungültige Parameter oder fehlende Daten"
},
"404": {
"description": "Zuweisung nicht gefunden"
},
"409": {
"description": "Neue Songnummer bereits vergeben"
},
"500": {
"description": "Serverfehler"
}
}
},
"delete": {
"summary": "Song aus Liederbuch entfernen",
"tags": [
"Songbook"
],
"parameters": [
{
"in": "path",
"name": "songBookId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Liederbuchs"
},
{
"in": "path",
"name": "songId",
"required": true,
"schema": {
"type": "integer"
},
"description": "Die ID des Songs"
}
],
"responses": {
"200": {
"description": "Song erfolgreich aus dem Liederbuch entfernt"
},
"400": {
"description": "Ungültige Parameter"
},
"404": {
"description": "Zuweisung nicht gefunden"
},
"500": {
"description": "Serverfehler"
}
}
}
}
},
"components": {},
"tags": []
}