feat(cms): enhance content editors with dynamic UI configs and validation

Implement a more flexible, configuration-driven approach for CMS editors across accreditation, admissions, and partnerships modules.
- Move UI labels, help texts, and field limits from hardcoded views to `editorUi` configurations in config files.
- Add server-side and client-side validation to prevent duplicate category tabs in accreditation and partnerships editors.
- Refactor partnership and admission views to dynamically render tabs and fields based on the provided configuration.
- Update field length constraints and default values across multiple content editors to better align with frontend requirements.
- Improve the admissions calculator editor with dynamic field configurations and default value fallbacks.
This commit is contained in:
Tống Thành Đạt
2026-04-22 18:06:03 +07:00
parent a44d005c13
commit a39c336dd4
19 changed files with 790 additions and 228 deletions
+113 -6
View File
@@ -2,9 +2,71 @@ const PartnershipsPage = require("../models/partnerships");
const AUDIT_ACTIONS = require("../constants/auditAction");
const partnershipsConfig = require("../utils/contentEditors/partnershipsConfig");
const createPageContentController = require("./_createPageContentController");
const createRenderSingletonPageView = require("./_renderSingletonPageView");
const { ensureUniqueIds } = require("../utils/contentEditorIds");
function getTabConfig(tabKey) {
return (partnershipsConfig.tabs || []).find((tab) => tab.key === tabKey) || {};
}
function getObjectField(tabKey, fieldKey) {
const fields = getTabConfig(tabKey)?.schema?.fields || [];
return fields.find((field) => field.key === fieldKey) || {};
}
function getArrayItemField(tabKey, arrayKey, fieldKey) {
const arrayField = getObjectField(tabKey, arrayKey);
const itemFields = arrayField?.itemSchema?.fields || [];
return itemFields.find((field) => field.key === fieldKey) || {};
}
function getPartnershipsEditorUi() {
return {
hero: {
badge: getObjectField("hero", "badge"),
title: getObjectField("hero", "title"),
description: getObjectField("hero", "description"),
linkLabel: getObjectField("hero", "linkLabel"),
image: getObjectField("hero", "image"),
imageAlt: getObjectField("hero", "imageAlt"),
},
directory: {
heading: getObjectField("directory", "heading"),
description: getObjectField("directory", "description"),
tabs: getObjectField("directory", "tabs"),
partnerFields: {
name: getArrayItemField("directory", "partners", "name"),
category: getArrayItemField("directory", "partners", "category"),
summary: getArrayItemField("directory", "partners", "summary"),
logo: getArrayItemField("directory", "partners", "logo"),
logoAlt: getArrayItemField("directory", "partners", "logoAlt"),
about: getArrayItemField("directory", "partners", "about"),
collabType: getArrayItemField("directory", "partners", "collabType"),
benefits: getArrayItemField("directory", "partners", "benefits"),
},
tabsFrontendHint: partnershipsConfig.editorUi?.directory?.tabsFrontendHint || "",
partnersHelpText: partnershipsConfig.editorUi?.directory?.partnersHelpText || "",
},
cta: {
heading: getObjectField("cta", "heading"),
description: getObjectField("cta", "description"),
buttonLabel: getObjectField("cta", "buttonLabel"),
},
inquiryForm: {
title: getObjectField("inquiryForm", "title"),
fields: getObjectField("inquiryForm", "fields"),
fieldFields: {
label: getArrayItemField("inquiryForm", "fields", "label"),
placeholder: getArrayItemField("inquiryForm", "fields", "placeholder"),
type: getArrayItemField("inquiryForm", "fields", "type"),
width: getArrayItemField("inquiryForm", "fields", "width"),
options: getArrayItemField("inquiryForm", "fields", "options"),
required: getArrayItemField("inquiryForm", "fields", "required"),
},
fieldsHelpText: partnershipsConfig.editorUi?.inquiryForm?.fieldsHelpText || "",
},
};
}
function toInquiryField(id, field, type, width) {
return {
id,
@@ -53,9 +115,34 @@ function prepareInquiryPayload(payload) {
const fields = Array.isArray(normalized?.inquiryForm?.fields)
? normalized.inquiryForm.fields
: [];
const tabs = Array.isArray(normalized?.directory?.tabs)
? normalized.directory.tabs
: [];
const partners = Array.isArray(normalized?.directory?.partners)
? normalized.directory.partners
: [];
const seenTabs = new Set();
const duplicateTabs = [];
tabs.forEach((tab) => {
const normalizedTab = String(tab || "").trim().toLowerCase();
if (!normalizedTab) {
return;
}
if (seenTabs.has(normalizedTab)) {
duplicateTabs.push(String(tab || "").trim());
return;
}
seenTabs.add(normalizedTab);
});
if (duplicateTabs.length > 0) {
throw new Error(
`Category tab already exists: ${duplicateTabs[0]}. Please use unique tab names.`,
);
}
return {
...normalized,
@@ -100,12 +187,32 @@ const controller = createPageContentController({
controller.index = async function index(req, res) {
try {
return await createRenderSingletonPageView({
model: PartnershipsPage,
const doc = await PartnershipsPage.getSingle();
const rawData = doc.toObject();
const data = normalizeInquiryForm(rawData);
const frontendUrl = process.env.FRONTEND_URL || "http://localhost:3000";
const backendUrl =
process.env.BACKEND_URL ?? `${req.protocol}://${req.get("host")}`;
const defaultTab = partnershipsConfig.tabs[0]?.key;
const requestedTab = req.query.tab;
const activeTab = partnershipsConfig.tabs.some((tab) => tab.key === requestedTab)
? requestedTab
: defaultTab;
return res.render("admin/partnerships/index", {
layout: "layouts/main",
title: partnershipsConfig.title,
subtitle: partnershipsConfig.subtitle,
data,
editorConfig: partnershipsConfig,
view: "admin/partnerships/index",
normalizeForEditor: normalizeInquiryForm,
})(req, res);
editorUi: getPartnershipsEditorUi(),
activeTab,
frontendUrl,
backendUrl,
previewUrl: `${frontendUrl}${partnershipsConfig.previewPath}`,
currentPath: req.path,
user: req.session.user,
});
} catch (error) {
console.error("partnerships index error:", error);
req.flash("error_msg", "Error loading Partnerships Management");