Refresh HiveGrid Cloud reference snapshot

This commit is contained in:
david committed 2026-08-03 15:31:14 +02:00
1 parent 5e99e14772
commit 7f88026f79
5955 files changed
+1177325 -188362

No files matched your search

@@ -136,7 +136,9 @@ export const action = async ({ request }: ActionFunctionArgs) => {
userId: userInfo.userId,
position: "last",
});
return redirect(adminPath(`knowledge-base/bases/${kb.slug}/articles/${KnowledgeBaseUtils.defaultLanguage}/${created.id}/edit`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${kb.slug}/articles/${KnowledgeBaseUtils.defaultLanguage}/${created.id}/edit`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.created")}`
);
} else if (action === "set-orders") {
const items: { id: string; order: number }[] = form.getAll("orders[]").map((f: FormDataEntryValue) => {
return JSON.parse(f.toString());
@@ -1,5 +1,5 @@
import { ActionFunctionArgs, LoaderFunctionArgs, MetaFunction, redirect, useActionData, useLoaderData } from "react-router";
import { t as i18nT } from "i18next";
import { requestScopedT as i18nT } from "~/locale/request-scoped-t";
import { Form, useNavigate, useOutlet, useParams } from "react-router";
import { MetaTagsDto } from "~/application/dtos/seo/MetaTagsDto";
import ButtonSecondary from "~/components/ui/buttons/ButtonSecondary";
@@ -83,7 +83,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t("knowledgeBase.admin.errors.articleNotFound") }, { status: 404 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/articles/${params.lang}/${params.id}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/articles/${params.lang}/${params.id}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.draftSaved")}`
);
}
return Response.json({ error: t("knowledgeBase.admin.errors.invalidAction") }, { status: 400 });
};
@@ -13,11 +13,10 @@ import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsServ
import KnowledgeBaseUtils from "~/modules/knowledgeBase/utils/KnowledgeBaseUtils";
import { MetaTagsDto } from "~/application/dtos/seo/MetaTagsDto";
import { getTranslations } from "~/locale/i18next.server";
import { useEffect } from "react";
import { useTranslation } from "react-i18next";
import { toast } from "sonner";
import { adminPath } from "~/utils/app/CanonicalUrlUtils";
import { validateCSRFToken } from "~/utils/session.server";
import { useSaveToast } from "~/hooks/use-save-toast";
export const meta: MetaFunction<typeof loader> = ({ data }) => data?.metatags || [];
type LoaderData = {
@@ -53,12 +52,14 @@ export const loader = async ({ request, params }: LoaderFunctionArgs) => {
};
type ActionData = {
error?: string;
intent?: "publish" | "unpublish";
ok?: true;
messageKey?: string;
errorKey?: string;
};
export const action = async ({ request, params }: ActionFunctionArgs) => {
await verifyUserHasPermission(request, "admin.kb.update");
await validateCSRFToken(request);
const { t } = await getTranslations(request);
const form = await request.formData();
const action = form.get("action")?.toString() ?? "";
@@ -68,13 +69,14 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
});
const item = await getKbArticleByIdInKnowledgeBase({ id: params.id!, knowledgeBaseId: knowledgeBase.id, language: params.lang! });
if (!item) {
return Response.json({ error: t("knowledgeBase.admin.errors.articleNotFound") }, { status: 400 });
return Response.json({ errorKey: "knowledgeBase.admin.errors.articleNotFound" } satisfies ActionData, { status: 400 });
}
if (action === "togglePublish") {
if (!item.categoryId) {
return Response.json({ error: t("knowledgeBase.admin.errors.articleCategoryRequired") }, { status: 400 });
return Response.json({ errorKey: "knowledgeBase.admin.errors.articleCategoryRequired" } satisfies ActionData, { status: 400 });
}
const intent = item.publishedAt ? "unpublish" : "publish";
let publishedAt = item.publishedAt;
let contentPublished = item.contentPublished;
if (item.publishedAt) {
@@ -94,12 +96,16 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
}
);
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.admin.errors.articleNotFound") }, { status: 404 });
return Response.json({ intent, errorKey: "knowledgeBase.admin.errors.articleNotFound" } satisfies ActionData, { status: 404 });
}
return Response.json({ success: true });
return Response.json({
intent,
ok: true,
messageKey: intent === "publish" ? "knowledgeBase.adminArticles.toast.published" : "knowledgeBase.adminArticles.toast.unpublished",
} satisfies ActionData);
}
return Response.json({ error: t("knowledgeBase.admin.errors.invalidAction") }, { status: 400 });
return Response.json({ errorKey: "knowledgeBase.admin.errors.invalidAction" } satisfies ActionData, { status: 400 });
};
export default function () {
@@ -110,11 +116,7 @@ export default function () {
const navigate = useNavigate();
const { t } = useTranslation();
useEffect(() => {
if (actionData?.error) {
toast.error(actionData.error);
}
}, [actionData]);
useSaveToast(actionData);
return (
<Form method="post" className="space-y-6">
@@ -172,14 +172,18 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t("knowledgeBase.articleSettings.errors.articleNotFound") }, { status: 404 });
}
return redirect(adminPath(`knowledge-base/bases/${knowledgeBase.slug}/articles/${language}/${item.id}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${knowledgeBase.slug}/articles/${language}/${item.id}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.settingsSaved")}`
);
} else if (action === "delete") {
await verifyUserHasPermission(request, "admin.kb.delete");
const result = await deleteKnowledgeBaseArticleInKnowledgeBase({ id: item.id, knowledgeBaseId: routeKnowledgeBase.id, language: params.lang! });
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.articleSettings.errors.articleNotFound") }, { status: 404 });
}
return redirect(adminPath(`knowledge-base/bases/${routeKnowledgeBase.slug}/articles/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${routeKnowledgeBase.slug}/articles/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.deleted")}`
);
}
return Response.json({ error: t("knowledgeBase.articleSettings.errors.invalidAction") }, { status: 400 });
};
@@ -136,7 +136,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
userId: userInfo.userId,
position: "last",
});
return redirect(adminPath(`knowledge-base/bases/${kb.slug}/articles/${params.lang}/${created.id}/edit`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${kb.slug}/articles/${params.lang}/${created.id}/edit`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.created")}`
);
} else if (action === "set-orders") {
const items: { id: string; order: number }[] = form.getAll("orders[]").map((f: FormDataEntryValue) => {
return JSON.parse(f.toString());
@@ -164,7 +166,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
try {
const id = form.get("id")?.toString() ?? "";
const item = await KnowledgeBaseService.duplicateArticle({ kb, language: params.lang!, articleId: id });
return redirect(adminPath(`knowledge-base/bases/${kb.slug}/articles/${params.lang}/${item.id}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${kb.slug}/articles/${params.lang}/${item.id}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminArticles.toast.duplicated")}`
);
} catch (e: unknown) {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
@@ -45,6 +45,7 @@ import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsServ
import { getUserInfo, validateCSRFToken } from "~/utils/session.server";
import { appendCSRFToken } from "~/utils/csrf";
import { useLocaleFormatters } from "~/locale/format";
import { useSaveToast } from "~/hooks/use-save-toast";
type LoaderData = {
knowledgeBase: KnowledgeBaseDto;
@@ -71,6 +72,9 @@ export const loader = async ({ request, params }: LoaderFunctionArgs) => {
};
type ActionData = {
intent?: string;
ok?: true;
messageKey?: string;
error?: string;
};
export const action = async ({ request, params }: ActionFunctionArgs) => {
@@ -127,7 +131,7 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.adminCategories.errors.categoryNotFound") }, { status: 404 });
}
return Response.json({ deleted: true });
return Response.json({ intent: "delete-category", ok: true, messageKey: "knowledgeBase.adminCategories.toast.deleted" } satisfies ActionData);
} else if (action === "delete-section") {
await verifyUserHasPermission(request, "admin.kb.delete");
const id = form.get("id")?.toString() ?? "";
@@ -144,7 +148,7 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.adminCategories.errors.sectionNotFound") }, { status: 404 });
}
return Response.json({ deleted: true });
return Response.json({ intent: "delete-section", ok: true, messageKey: "knowledgeBase.adminCategories.toast.sectionDeleted" } satisfies ActionData);
} else if (action === "delete-article") {
await verifyUserHasPermission(request, "admin.kb.delete");
const id = form.get("id")?.toString() ?? "";
@@ -156,13 +160,13 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.adminCategories.errors.articleNotFound") }, { status: 404 });
}
return Response.json({ deleted: true });
return Response.json({ intent: "delete-article", ok: true, messageKey: "knowledgeBase.adminArticles.toast.deleted" } satisfies ActionData);
} else if (action === "duplicate") {
await verifyUserHasPermission(request, "admin.kb.create");
try {
const categoryId = form.get("id")?.toString() ?? "";
await KnowledgeBaseService.duplicateCategory({ kb, language: params.lang!, categoryId });
return Response.json({ duplicated: true });
return Response.json({ intent: "duplicate-category", ok: true, messageKey: "knowledgeBase.adminCategories.toast.duplicated" } satisfies ActionData);
} catch (e: unknown) {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
@@ -192,7 +196,7 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
initialSlug: slug.length > 0 ? slug : undefined,
position: position as any,
});
return Response.json({ created: true });
return Response.json({ intent: "create-article", ok: true, messageKey: "knowledgeBase.adminArticles.toast.created" } satisfies ActionData);
} catch (e: unknown) {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
@@ -242,6 +246,8 @@ export default function () {
const submit = useSubmit();
const location = useLocation();
useSaveToast(actionData?.ok ? actionData : undefined);
const [toggledCategories, setToggledCategories] = useState<string[]>([]);
const confirmDeleteCategory = useRef<RefConfirmModal>(null);
@@ -90,14 +90,18 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.sectionSaved")}`
);
} else if (action === "delete") {
await verifyUserHasPermission(request, "admin.kb.delete");
const result = await deleteKnowledgeBaseCategorySectionInCategory({ id: item.id, categoryId: category.id });
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.admin.errors.sectionNotFound") }, { status: 404 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.sectionDeleted")}`
);
} else if (action === "set-orders") {
await verifyUserHasPermission(request, "admin.kb.update");
const items: { id: string; order: number }[] = form.getAll("orders[]").map((f: FormDataEntryValue) => {
@@ -69,7 +69,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.sectionCreated")}`
);
} else {
return Response.json({ error: t("knowledgeBase.admin.errors.invalidForm") }, { status: 400 });
}
@@ -93,14 +93,18 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.saved")}`
);
} else if (action === "delete") {
await verifyUserHasPermission(request, "admin.kb.delete");
const result = await deleteKnowledgeBaseCategoryInKnowledgeBase({ id: item.id, knowledgeBaseId: knowledgeBase.id, language: params.lang! });
if (result.count !== 1) {
return Response.json({ error: t("knowledgeBase.admin.errors.categoryNotFound") }, { status: 404 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.deleted")}`
);
} else if (action === "set-orders") {
const items: { id: string; order: number }[] = form.getAll("orders[]").map((f: FormDataEntryValue) => {
return JSON.parse(f.toString());
@@ -77,7 +77,9 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" }));
return redirect(
`${adminPath(`knowledge-base/bases/${params.slug}/categories/${params.lang}`, { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminCategories.toast.created")}`
);
} else {
return Response.json({ error: t("knowledgeBase.admin.errors.invalidForm") }, { status: 400 });
}
@@ -1,4 +1,4 @@
import { ActionFunctionArgs, LoaderFunctionArgs, MetaFunction, useLoaderData } from "react-router";
import { ActionFunctionArgs, LoaderFunctionArgs, MetaFunction, useActionData, useLoaderData } from "react-router";
import SimpleBadge from "~/components/ui/badges/SimpleBadge";
import { Link, useNavigate, useOutlet, useParams, useSearchParams, useSubmit } from "react-router";
import TabsWithIcons from "~/components/ui/tabs/TabsWithIcons";
@@ -25,12 +25,14 @@ import { appendCSRFToken } from "~/utils/csrf";
import { useRootData } from "~/utils/data/useRootData";
import { absoluteAppRootPath, isAbsoluteHttpUrl, type PublicDomainRoutingConfig } from "~/utils/app/CrossHostUrls";
import { useLocaleFormatters } from "~/locale/format";
import { useSaveToast, type SaveActionResult } from "~/hooks/use-save-toast";
type LoaderData = {
metatags: MetaTagsDto;
items: KnowledgeBaseDto[];
template: KnowledgeBasesTemplateDto;
};
type ActionData = { intent: "toggle"; errorKey?: string };
export const loader = async ({ request }: LoaderFunctionArgs) => {
await verifyUserHasPermission(request, "admin.kb.view");
const { t } = await getTranslations(request);
@@ -44,10 +46,9 @@ export const loader = async ({ request }: LoaderFunctionArgs) => {
export const meta: MetaFunction<typeof loader> = ({ data }) => data?.metatags || [];
export const action = async ({ request, params }: ActionFunctionArgs) => {
export const action = async ({ request, params: _params }: ActionFunctionArgs) => {
await verifyUserHasPermission(request, "admin.kb.view");
await validateCSRFToken(request);
const { t } = await getTranslations(request);
const form = await request.formData();
const action = form.get("action")?.toString();
if (action === "toggle") {
@@ -57,16 +58,16 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
const item = await KnowledgeBaseService.getById({ id, request });
if (!item) {
return Response.json({ error: t("knowledgeBase.admin.errors.notFound") }, { status: 404 });
return Response.json({ intent: "toggle", errorKey: "knowledgeBase.admin.errors.notFound" } satisfies ActionData, { status: 404 });
}
await updateKnowledgeBase(id, {
enabled,
});
return Response.json({ success: t("knowledgeBase.admin.success.updated") });
return Response.json({ intent: "toggle" } satisfies ActionData);
} else {
return Response.json({ error: t("knowledgeBase.admin.errors.invalidForm") }, { status: 400 });
return Response.json({ intent: "toggle", errorKey: "knowledgeBase.admin.errors.invalidForm" } satisfies ActionData, { status: 400 });
}
};
@@ -74,6 +75,7 @@ export default function () {
const { t } = useTranslation();
const formatters = useLocaleFormatters();
const data = useLoaderData<LoaderData>();
const actionData = useActionData<ActionData>();
const submit = useSubmit();
const outlet = useOutlet();
const navigate = useNavigate();
@@ -81,6 +83,10 @@ export default function () {
const rootData = useRootData();
const [selected, setSelected] = useState<KnowledgeBaseDto[]>([]);
const [exportResult, setExportResult] = useState<SaveActionResult>();
useSaveToast(actionData);
useSaveToast(exportResult);
const [searchParams] = useSearchParams();
@@ -114,18 +120,23 @@ export default function () {
}
function onExport() {
if (selected.length > 0) {
data.template.knowledgeBases = data.template.knowledgeBases.filter((item) => selected.find((i) => i.slug === item.slug));
data.template.categories = data.template.categories.filter((item) => selected.find((i) => i.slug === item.knowledgeBaseSlug));
data.template.articles = data.template.articles.filter((item) => selected.find((i) => i.slug === item.knowledgeBaseSlug));
try {
if (selected.length > 0) {
data.template.knowledgeBases = data.template.knowledgeBases.filter((item) => selected.find((i) => i.slug === item.slug));
data.template.categories = data.template.categories.filter((item) => selected.find((i) => i.slug === item.knowledgeBaseSlug));
data.template.articles = data.template.articles.filter((item) => selected.find((i) => i.slug === item.knowledgeBaseSlug));
}
const dataStr = "data:text/json;charset=utf-8," + encodeURIComponent(JSON.stringify(data.template, null, "\t"));
const downloadAnchorNode = document.createElement("a");
downloadAnchorNode.setAttribute("href", dataStr);
downloadAnchorNode.setAttribute("download", "kbs.json");
document.body.appendChild(downloadAnchorNode);
downloadAnchorNode.click();
downloadAnchorNode.remove();
setExportResult({ ok: true, messageKey: "knowledgeBase.adminBases.toast.exported" });
} catch {
setExportResult({ errorKey: "knowledgeBase.adminBases.errors.exportFailed" });
}
const dataStr = "data:text/json;charset=utf-8," + encodeURIComponent(JSON.stringify(data.template, null, "\t"));
const downloadAnchorNode = document.createElement("a");
downloadAnchorNode.setAttribute("href", dataStr);
downloadAnchorNode.setAttribute("download", "kbs.json");
document.body.appendChild(downloadAnchorNode); // required for firefox
downloadAnchorNode.click();
downloadAnchorNode.remove();
}
function publicKbUrl(item: KnowledgeBaseDto) {
return absolutePublicAppPath(rootData.routing, KnowledgeBaseUtils.getKbUrl({ kb: item, params }));
@@ -96,12 +96,16 @@ export const action = async ({ request, params }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath("knowledge-base/bases", { mode: "host-aware" }));
return redirect(
`${adminPath("knowledge-base/bases", { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminBases.toast.saved")}`
);
} else if (action === "delete") {
await verifyUserHasPermission(request, "admin.kb.delete");
try {
await KnowledgeBaseService.del(item);
return redirect(adminPath("knowledge-base/bases", { mode: "host-aware" }));
return redirect(
`${adminPath("knowledge-base/bases", { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminBases.toast.deleted")}`
);
} catch (e: unknown) {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
@@ -70,7 +70,9 @@ export const action = async ({ request }: ActionFunctionArgs) => {
return Response.json({ error: t(getKnowledgeBaseActionErrorKey(e)) }, { status: 400 });
}
return redirect(adminPath("knowledge-base/bases", { mode: "host-aware" }));
return redirect(
`${adminPath("knowledge-base/bases", { mode: "host-aware" })}?toast=${encodeURIComponent("knowledgeBase.adminBases.toast.created")}`
);
} else {
return Response.json({ error: t("knowledgeBase.admin.errors.invalidForm") }, { status: 400 });
}
@@ -3,13 +3,13 @@ import { Form, useActionData, useSubmit } from "react-router";
import { FormEvent, useRef } from "react";
import { useTranslation } from "react-i18next";
import ButtonPrimary from "~/components/ui/buttons/ButtonPrimary";
import ActionResultModal from "~/components/ui/modals/ActionResultModal";
import ConfirmModal, { RefConfirmModal } from "~/components/ui/modals/ConfirmModal";
import { getTranslations } from "~/locale/i18next.server";
import { db } from "~/utils/db.server";
import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService";
import { validateCSRFToken } from "~/utils/session.server";
import { appendCSRFToken } from "~/utils/csrf";
import { useSaveToast } from "~/hooks/use-save-toast";
type LoaderData = {
title: string;
@@ -24,23 +24,28 @@ export const loader = async ({ request }: LoaderFunctionArgs): Promise<LoaderDat
export const meta: MetaFunction<typeof loader> = ({ data }) => [{ title: data?.title }];
type ActionData = {
error?: string;
success?: string;
intent: "reset-all-data";
ok?: true;
messageKey?: string;
errorKey?: string;
};
export const action = async ({ request }: ActionFunctionArgs) => {
await verifyUserHasPermission(request, "admin.kb.view");
await validateCSRFToken(request);
const { t } = await getTranslations(request);
const form = await request.formData();
const action = form.get("action")?.toString();
if (action === "reset-all-data") {
await verifyUserHasPermission(request, "admin.kb.delete");
await db.knowledgeBaseCategory.deleteMany({});
await db.knowledgeBaseArticle.deleteMany({});
await db.knowledgeBase.deleteMany({});
return Response.json({ success: t("knowledgeBase.admin.success.resetSuccessful") });
try {
await db.knowledgeBaseCategory.deleteMany({});
await db.knowledgeBaseArticle.deleteMany({});
await db.knowledgeBase.deleteMany({});
return Response.json({ intent: "reset-all-data", ok: true, messageKey: "knowledgeBase.adminDanger.toast.reset" } satisfies ActionData);
} catch {
return Response.json({ intent: "reset-all-data", errorKey: "knowledgeBase.admin.errors.actionFailed" } satisfies ActionData, { status: 400 });
}
} else {
return Response.json({ error: t("knowledgeBase.admin.errors.invalidForm") }, { status: 400 });
return Response.json({ intent: "reset-all-data", errorKey: "knowledgeBase.admin.errors.invalidForm" } satisfies ActionData, { status: 400 });
}
};
@@ -48,6 +53,8 @@ export default function () {
const { t } = useTranslation();
const actionData = useActionData<ActionData>();
useSaveToast(actionData);
const submit = useSubmit();
const confirmDelete = useRef<RefConfirmModal>(null);
@@ -89,7 +96,6 @@ export default function () {
</div>
</Form>
</div>
<ActionResultModal actionData={actionData} showSuccess={false} />
<ConfirmModal ref={confirmDelete} onYes={onConfirmedDelete} destructive />
</div>
);
@@ -1,6 +1,9 @@
import type { LoaderFunctionArgs, MetaFunction } from "react-router";
import { useLoaderData } from "react-router";
import { Link, useLoaderData } from "react-router";
import { useTranslation } from "react-i18next";
import type { MetaTagsDto } from "~/application/dtos/seo/MetaTagsDto";
import { Badge } from "~/components/ui/badge";
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "~/components/ui/card";
import {
countAllKbsArticleDownvotes,
countAllKbsArticleUpvotes,
@@ -11,58 +14,159 @@ import { countKnowledgeBaseArticles } from "~/modules/knowledgeBase/db/kbArticle
import { countKnowledgeBaseCategories } from "~/modules/knowledgeBase/db/kbCategories.db.server";
import { countKnowledgeBases } from "~/modules/knowledgeBase/db/knowledgeBase.db.server";
import { verifyUserHasPermission } from "~/utils/helpers/.server/PermissionsService";
import { useTranslation } from "react-i18next";
import { useLocaleFormatters } from "~/locale/format";
import { getTranslations } from "~/locale/i18next.server";
import { adminPath } from "~/utils/app/CanonicalUrlUtils";
import { db } from "~/utils/db.server";
type LoaderData = {
metatags: MetaTagsDto;
summary: {
kbsTotal: number;
enabledBases: number;
articlesTotal: number;
publishedArticles: number;
draftArticles: number;
categoriesTotal: number;
kbsViews: number;
articlesViews: number;
articlesUpvotes: number;
articlesDownvotes: number;
};
recentArticles: {
id: string;
title: string;
language: string;
publishedAt: string | null;
updatedAt: string | null;
knowledgeBaseSlug: string;
knowledgeBaseTitle: string;
}[];
};
export const loader = async ({ request }: LoaderFunctionArgs) => {
await verifyUserHasPermission(request, "admin.kb.view");
const { t } = await getTranslations(request);
const [enabledBases, publishedArticles, draftArticles, recentArticles] = await Promise.all([
db.knowledgeBase.count({ where: { enabled: true } }),
db.knowledgeBaseArticle.count({ where: { publishedAt: { not: null } } }),
db.knowledgeBaseArticle.count({ where: { publishedAt: null } }),
db.knowledgeBaseArticle.findMany({
orderBy: { updatedAt: "desc" },
take: 8,
select: {
id: true,
title: true,
language: true,
publishedAt: true,
updatedAt: true,
knowledgeBase: { select: { slug: true, title: true } },
},
}),
]);
const data: LoaderData = {
metatags: [{ title: t("knowledgeBase.authoring.metaTitle") }],
summary: {
kbsTotal: await countKnowledgeBases(),
enabledBases,
articlesTotal: await countKnowledgeBaseArticles(),
publishedArticles,
draftArticles,
categoriesTotal: await countKnowledgeBaseCategories(),
kbsViews: await countAllKbsViews(),
articlesViews: await countAllKbsArticleViews(),
articlesUpvotes: await countAllKbsArticleUpvotes(),
articlesDownvotes: await countAllKbsArticleDownvotes(),
},
recentArticles: recentArticles.map((article) => ({
id: article.id,
title: article.title,
language: article.language,
publishedAt: article.publishedAt?.toISOString() ?? null,
updatedAt: article.updatedAt?.toISOString() ?? null,
knowledgeBaseSlug: article.knowledgeBase.slug,
knowledgeBaseTitle: article.knowledgeBase.title,
})),
};
return data;
};
export const meta: MetaFunction<typeof loader> = ({ data }) => data?.metatags || [];
export default function () {
export default function KnowledgeBaseOverviewRoute() {
const { t } = useTranslation();
const data = useLoaderData<LoaderData>();
const formatters = useLocaleFormatters();
const voteBalance = data.summary.articlesUpvotes - data.summary.articlesDownvotes;
return (
<div className="mx-auto mb-12 max-w-5xl space-y-5 px-4 py-4 sm:px-6 lg:px-8 xl:max-w-7xl">
<div className="border-border border-b pb-5">
<h3 className="text-foreground text-lg leading-6 font-medium">{t("knowledgeBase.adminOverview.title")}</h3>
<div className="mx-auto mb-12 max-w-7xl space-y-5 px-4 py-4 sm:px-6 lg:px-8">
<div className="border-border flex flex-col gap-3 border-b pb-5 lg:flex-row lg:items-start lg:justify-between">
<div>
<h3 className="text-foreground text-lg leading-6 font-medium">{t("knowledgeBase.adminOverview.title")}</h3>
<p className="text-muted-foreground mt-1 text-sm">{t("admin.knowledgeOps.description")}</p>
</div>
<Badge color={data.summary.enabledBases > 0 ? "green" : "yellow"} withColorDot>
{data.summary.enabledBases > 0 ? t("admin.knowledgeOps.enabled") : t("admin.knowledgeOps.notEnabled")}
</Badge>
</div>
<dl className="grid gap-2 sm:grid-cols-3">
<dl className="grid gap-3 sm:grid-cols-2 xl:grid-cols-5">
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.knowledgeBases")} value={data.summary.kbsTotal} />
<SummaryCard title={t("admin.knowledgeOps.metrics.enabledBases")} value={data.summary.enabledBases} />
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.articles")} value={data.summary.articlesTotal} />
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.categories")} value={data.summary.categoriesTotal} />
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.articleViews")} value={data.summary.articlesViews} />
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.articleUpvotes")} value={data.summary.articlesUpvotes} />
<SummaryCard title={t("knowledgeBase.adminOverview.metrics.articleDownvotes")} value={data.summary.articlesDownvotes} />
<SummaryCard title={t("admin.knowledgeOps.metrics.publishedArticles")} value={data.summary.publishedArticles} />
<SummaryCard title={t("admin.knowledgeOps.metrics.draftArticles")} value={data.summary.draftArticles} />
</dl>
<div className="grid gap-4 xl:grid-cols-[minmax(0,1fr)_minmax(320px,0.45fr)]">
<Card className="gap-4 rounded-lg py-5">
<CardHeader>
<div className="flex items-start justify-between gap-3">
<div>
<CardTitle>{t("admin.knowledgeOps.recent.title")}</CardTitle>
<CardDescription>{t("admin.knowledgeOps.recent.description")}</CardDescription>
</div>
<Link className="text-primary text-sm font-medium hover:underline" to={adminPath("knowledge-base/articles", { mode: "host-aware" })}>
{t("shared.viewAll")}
</Link>
</div>
</CardHeader>
<CardContent className="space-y-2">
{data.recentArticles.length === 0 ? <div className="text-muted-foreground text-sm">{t("admin.knowledgeOps.recent.empty")}</div> : null}
{data.recentArticles.map((article) => (
<div key={article.id} className="rounded-md border p-3 text-sm">
<div className="flex items-start justify-between gap-3">
<div className="min-w-0">
<div className="truncate font-medium">{article.title}</div>
<div className="text-muted-foreground mt-1 truncate">{article.knowledgeBaseTitle} · {article.language}</div>
<div className="text-muted-foreground mt-1 text-xs">
{article.updatedAt ? formatters.dateTime(article.updatedAt) : t("shared.notSet")}
</div>
</div>
<Badge color={article.publishedAt ? "green" : "yellow"} withColorDot>
{article.publishedAt ? t("admin.knowledgeOps.published") : t("admin.knowledgeOps.draft")}
</Badge>
</div>
</div>
))}
</CardContent>
</Card>
<Card className="gap-4 rounded-lg py-5">
<CardHeader>
<CardTitle>{t("admin.knowledgeOps.quality.title")}</CardTitle>
<CardDescription>{t("admin.knowledgeOps.quality.description")}</CardDescription>
</CardHeader>
<CardContent className="grid gap-3 text-sm">
<QualityRow label={t("knowledgeBase.adminOverview.metrics.articleViews")} value={formatters.number(data.summary.articlesViews)} />
<QualityRow label={t("admin.knowledgeOps.metrics.baseViews")} value={formatters.number(data.summary.kbsViews)} />
<QualityRow label={t("knowledgeBase.adminOverview.metrics.articleUpvotes")} value={formatters.number(data.summary.articlesUpvotes)} />
<QualityRow label={t("knowledgeBase.adminOverview.metrics.articleDownvotes")} value={formatters.number(data.summary.articlesDownvotes)} />
<QualityRow label={t("admin.knowledgeOps.metrics.voteBalance")} value={formatters.number(voteBalance)} tone={voteBalance < 0 ? "danger" : "success"} />
</CardContent>
</Card>
</div>
</div>
);
}
@@ -78,3 +182,12 @@ function SummaryCard({ title, value }: { title: string; value: number }) {
</div>
);
}
function QualityRow({ label, value, tone = "neutral" }: { label: string; value: string; tone?: "success" | "danger" | "neutral" }) {
return (
<div className="flex items-center justify-between gap-3 rounded-md border px-3 py-2">
<span className="text-muted-foreground">{label}</span>
<span className={tone === "danger" ? "font-medium text-red-700" : tone === "success" ? "font-medium text-green-700" : "font-medium"}>{value}</span>
</div>
);
}
@@ -66,4 +66,18 @@ describe("admin knowledge-base articles i18n", () => {
expect(en.knowledgeBase.adminCategories.actions.toggleCategory).toContain("{{title}}");
expect(de.knowledgeBase.adminCategories.actions.toggleCategory).toContain("{{title}}");
});
it("keeps CRUD toast copy action-specific and complete in both locales", () => {
const en = JSON.parse(fs.readFileSync(enTranslationsPath, "utf8"));
const de = JSON.parse(fs.readFileSync(deTranslationsPath, "utf8"));
for (const namespace of ["adminBases", "adminCategories", "adminArticles"]) {
expect(Object.keys(de.knowledgeBase[namespace].toast)).toEqual(Object.keys(en.knowledgeBase[namespace].toast));
}
expect(de.knowledgeBase.adminBases.toast.created).toBe("Wissensdatenbank erstellt");
expect(de.knowledgeBase.adminCategories.toast.sectionDeleted).toBe("Abschnitt gelöscht");
expect(de.knowledgeBase.adminArticles.toast.draftSaved).toBe("Artikelentwurf gespeichert");
expect(de.knowledgeBase.adminArticles.toast.published).not.toBe(de.knowledgeBase.adminArticles.toast.unpublished);
});
});