diff --git a/apps/core/setup_views.py b/apps/core/setup_views.py new file mode 100644 index 0000000..cada0aa --- /dev/null +++ b/apps/core/setup_views.py @@ -0,0 +1,54 @@ +from django import forms +from django.contrib.auth.decorators import login_required +from django.core.exceptions import ValidationError +from django.http import HttpResponseForbidden +from django.shortcuts import redirect, render +from django.views.decorators.http import require_http_methods +from wagtail.admin import messages + +from .models import SiteSettings +from .site_setup import COMPANY_FIELDS, default_site, setup_company_site + + +class CompanySetupForm(forms.ModelForm): + company_name = forms.CharField(label="企业名称", max_length=100) + create_demo = forms.BooleanField( + label="创建软件/技术服务企业示例站", required=False, + help_text="仅补齐缺失页面和菜单,新页面将公开发布;不会覆盖已有页面或菜单。", + ) + + class Meta: + model = SiteSettings + fields = COMPANY_FIELDS + help_texts = { + "contact_email": "新建咨询表单将使用此邮箱发送通知;需先配置服务器邮件服务。", + "icp_number": "请填写本企业真实备案号;未取得备案号时留空,不使用示例号码。", + } + + +@login_required(login_url="wagtailadmin_login") +@require_http_methods(["GET", "POST"]) +def company_setup(request): + if not request.user.is_active or not request.user.is_superuser: + return HttpResponseForbidden("仅超级管理员可以初始化企业站点。") + try: + site = default_site() + except ValidationError as error: + return render(request, "core/site_setup.html", {"setup_error": ";".join(error.messages)}) + + settings = SiteSettings.for_site(site) + form = CompanySetupForm(request.POST if request.method == "POST" else None, instance=settings) + if request.method == "POST" and form.is_valid(): + try: + created = setup_company_site(form.cleaned_data, form.cleaned_data["create_demo"]) + except ValidationError as error: + form.add_error(None, ";".join(error.messages)) + else: + result = f"企业资料已保存,新增 {len(created)} 个页面。" if form.cleaned_data["create_demo"] else "企业资料已保存,未创建示例内容。" + messages.success(request, result) + return redirect("company_site_setup") + return render(request, "core/site_setup.html", { + "form": form, + "site": site, + "pages": site.root_page.get_children().specific(), + }) diff --git a/apps/core/site_setup.py b/apps/core/site_setup.py new file mode 100644 index 0000000..02df682 --- /dev/null +++ b/apps/core/site_setup.py @@ -0,0 +1,159 @@ +"""企业开站模板。仅创建缺失内容,不修改或重新发布已有页面。""" +from django.core.exceptions import ValidationError +from django.db import transaction +from django.utils import timezone +from django.utils.html import format_html +from wagtail.models import Page, Site + +from apps.blog.models import BlogIndexPage, BlogPage +from apps.cases.models import CaseStudyIndexPage, CaseStudyPage +from apps.core.management.commands.seed_contact_page import CONTACT_FORM_FIELDS +from apps.core.models import ( + ContactPage, NavigationMenu, NavigationMenuItem, SimpleContentPage, SiteSettings, +) +from apps.forms.models import FormDefinition +from apps.home.models import HomePage +from apps.products.models import ProductIndexPage, ProductPage +from apps.solutions.models import SolutionIndexPage, SolutionPage + +COMPANY_FIELDS = ("company_name", "contact_phone", "contact_email", "address", "icp_number") + + +def default_site(): + site = Site.objects.filter(is_default_site=True).first() + if site is None: + raise ValidationError("未配置默认站点,请先在“设置 → 站点”中配置默认站点。") + return site + + +def _ensure_page(parent, model, slug, title, created, **fields): + existing = parent.get_children().filter(slug=slug).first() + if existing is not None: + if not isinstance(existing.specific, model): + raise ValidationError(f"路径 {slug} 已被其他类型的页面占用,请先调整页面路径。") + return existing.specific + page = model(title=title, slug=slug, **fields) + parent.add_child(instance=page) + page.save_revision().publish() + created.append(title) + return page + + +def _cta(): + return ("cta", { + "heading": "一起讨论您的项目需求", + "description": "告诉我们业务目标、当前挑战与期望交付时间。", + "button": {"text": "预约项目咨询", "link": "/contact/"}, + }) + + +def _detail_body(heading, description): + return [ + ("richtext", str(format_html("
{}
", heading, description))), + ("feature_grid", {"heading": "服务流程", "items": [ + {"icon": "1", "title": "需求梳理", "description": "明确业务场景、范围与验收标准。"}, + {"icon": "2", "title": "迭代交付", "description": "分阶段演示并收集使用反馈。"}, + {"icon": "3", "title": "持续维护", "description": "按约定提供培训、维护与优化支持。"}, + ]}), + _cta(), + ] + + +def _create_template(site, company_name): + created = [] + home = site.root_page.specific + if not isinstance(home, HomePage): + # 只允许接管全新 Wagtail 安装的空白通用欢迎页,不重绑定已有业务站点。 + if type(home) is not Page or home.depth != 2 or home.get_children().exists() or home.slug != "home": + raise ValidationError("默认站点根页面不是企业首页。请先配置 HomePage,现有站点不会被替换。") + home = _ensure_page(home.get_parent(), HomePage, "company-home", "首页", created, body=[ + ("hero", { + "title": f"{company_name} · 软件与技术服务", + "subtitle": "从需求分析到软件交付,帮助企业构建适合自身业务的数字化系统。", + "background_image": None, + "buttons": [{"text": "了解服务", "link": "/products/"}, {"text": "项目咨询", "link": "/contact/"}], + }), + ("feature_grid", {"heading": "我们可以帮助您", "items": [ + {"icon": "", "title": "软件定制", "description": "围绕业务流程设计与开发应用。"}, + {"icon": "", "title": "系统集成", "description": "连接现有系统,减少重复录入。"}, + {"icon": "", "title": "运维支持", "description": "提供上线培训与持续维护服务。"}, + ]}), + ("product_card", {"heading": "产品与服务", "items": [ + {"title": "企业内容平台", "description": "统一管理官网内容与咨询入口。", "image": None, "link": "/products/content-platform/"}, + {"title": "定制开发服务", "description": "从原型到交付,适配实际业务场景。", "image": None, "link": "/products/custom-development/"}, + ]}), + ("faq", {"items": [ + {"question": "如何开始合作?", "answer": "通过咨询表单描述需求,我们会进一步确认范围与交付安排。
"}, + {"question": "能否对接现有系统?", "answer": "需要先评估现有接口、数据要求与安全边界,再确定实施方案。
"}, + ]}), + _cta(), + ]) + site.root_page = home + site.save(update_fields=["root_page"]) + + def ensure(parent, model, slug, title, **fields): + return _ensure_page(parent, model, slug, title, created, **fields) + + products = ensure(home, ProductIndexPage, "products", "产品与服务", intro="探索企业内容平台与软件定制服务。") + for slug, title, summary in [ + ("content-platform", "企业内容平台", "集中管理品牌官网、产品内容、客户案例与咨询表单。"), + ("custom-development", "定制开发服务", "根据业务流程提供 Web 应用、接口集成与运维支持。"), + ]: + ensure(products, ProductPage, slug, title, summary=summary, body=_detail_body(title, summary)) + solutions = ensure(home, SolutionIndexPage, "solutions", "解决方案", intro="以业务场景为起点,规划可落地的数字化方案。") + ensure(solutions, SolutionPage, "digital-workplace", "企业数字化协同", industry="企业服务", + summary="连接内容、流程与数据,减少团队之间的信息断层。", + body=_detail_body("从业务流程出发", "先梳理现有工具与协作瓶颈,再规划分阶段实施方案。")) + cases = ensure(home, CaseStudyIndexPage, "cases", "客户案例", intro="以下案例为模板演示,请上线前替换为获得授权的真实案例。") + ensure(cases, CaseStudyPage, "demo-content-project", "示例案例:企业内容管理项目(虚构)", + client_name="虚构示例企业", industry="企业服务", published_at=timezone.now(), + summary="仅用于展示案例结构,不代表真实客户、交付成果或业绩。", + body=_detail_body("示例内容,请勿作为真实业绩发布", "展示需求背景、实施过程与验收方式;请替换为客户授权的真实材料。")) + blog = ensure(home, BlogIndexPage, "blog", "技术与洞察", intro="分享技术实践、产品思考与项目经验。") + ensure(blog, BlogPage, "website-content-checklist", "示例文章:企业官网上线内容清单", + published_at=timezone.now(), intro="上线前核对品牌资料、产品信息、联系渠道与隐私说明。", + body=[("richtext", "我们提供软件开发、系统集成与技术服务。
" + "明确需求、迭代交付、持续支持。
" + "模板提示:请补充真实的公司介绍、团队与资质,不要发布未经核实的业绩。
", company_name))) + privacy = ensure(home, SimpleContentPage, "privacy-policy", "隐私政策(待完善)", + body="这是隐私说明占位内容。上线前请根据实际收集的数据、处理目的、保存期限、联系与删除方式完善,并完成必要审核。
") + contact = home.get_children().filter(slug="contact").first() + if contact is not None and not isinstance(contact.specific, ContactPage): + raise ValidationError("路径 contact 已被其他类型的页面占用,请先调整页面路径。") + if contact is None: + form = FormDefinition.objects.create(name="官网项目咨询", notification_email=SiteSettings.for_site(site).contact_email) + for order, field in enumerate(CONTACT_FORM_FIELDS): + form.fields.create(sort_order=order, **field) + contact = ensure(home, ContactPage, "contact", "联系我们", body=[ + ("richtext", "请描述您的业务需求与预期,我们将与您进一步沟通。
"), + ("form", {"form": form}), + ]) + else: + contact = contact.specific + for name, entries in [ + ("main", [("首页", home), ("产品与服务", products), ("解决方案", solutions), ("案例", cases), ("技术博客", blog), ("关于我们", about), ("联系咨询", contact)]), + ("footer", [("关于我们", about), ("联系我们", contact), ("隐私政策", privacy)]), + ]: + menu, is_new = NavigationMenu.objects.get_or_create(name=name) + if is_new: + for order, (label, page) in enumerate(entries): + if page.live: + NavigationMenuItem.objects.create(menu=menu, sort_order=order, label=label, link_page=page) + return created + + +@transaction.atomic +def setup_company_site(company_data, create_demo=False): + site = default_site() + # 序列化同一站点的初始化请求,避免重复页面/表单。 + site = Site.objects.select_for_update().get(pk=site.pk) + settings = SiteSettings.for_site(site) + for field in COMPANY_FIELDS: + setattr(settings, field, company_data[field]) + settings.full_clean() + settings.save() + site.site_name = settings.company_name + site.save(update_fields=["site_name"]) + return _create_template(site, settings.company_name) if create_demo else [] diff --git a/apps/core/templates/core/site_setup.html b/apps/core/templates/core/site_setup.html new file mode 100644 index 0000000..555e28f --- /dev/null +++ b/apps/core/templates/core/site_setup.html @@ -0,0 +1,45 @@ +{% extends "wagtailadmin/base.html" %} +{% load wagtailadmin_tags %} +{% block titletag %}企业开站向导{% endblock %} +{% block content %} + {% include "wagtailadmin/shared/header.html" with title="企业开站向导" icon="site" %} +{{ setup_error }}
+ {% else %} +当前默认站点:{{ site.hostname }}。保存将更新该站点的企业名称、联系方式和备案信息。
+软件/技术服务模板包含首页、产品、解决方案、案例、博客、关于我们、联系我们和隐私说明,以及对应导航。
+新建页面会立即公开发布。已有页面、内容和菜单不会被替换,已有草稿也不会自动发布。若已有首页,则保留其原样。
+示例案例为虚构内容,不代表真实业绩;隐私说明仅为占位。请在正式上线前替换、审核,不要作为真实客户材料使用。
+ +客户自己的内容
" + page.save_revision().publish() + count = Page.objects.count() + forms = FormDefinition.objects.count() + assert setup_company_site(company_data, True) == [] + page.refresh_from_db() + assert page.title == "客户自己的介绍" + assert str(page.body) == "客户自己的内容
" + assert Page.objects.count() == count + assert FormDefinition.objects.count() == forms + + +def test_existing_home_contact_menu_and_draft_are_preserved(home_page, company_data): + site = Site.objects.get(is_default_site=True) + site.root_page = home_page + site.save() + original_body = home_page.body.get_prep_value() + contact = home_page.add_child(instance=ContactPage(title="原有联系页", slug="contact", body=[("richtext", "自定义
")])) + contact.save_revision().publish() + products = home_page.add_child(instance=ProductIndexPage(title="草稿栏目", slug="products", live=False)) + products.save_revision() + menu = NavigationMenu.objects.create(name="main") + NavigationMenuItem.objects.create(menu=menu, label="原有菜单", link_url="/custom/") + setup_company_site(company_data, True) + home_page.refresh_from_db() + contact.refresh_from_db() + products.refresh_from_db() + assert home_page.body.get_prep_value() == original_body + assert contact.title == "原有联系页" + assert "自定义" in str(contact.body) + assert not products.live + assert menu.items.count() == 1 + assert menu.items.first().label == "原有菜单" + assert FormDefinition.objects.count() == 0 + + +def test_company_only_does_not_create_pages_or_forms(company_data): + before = Page.objects.count() + setup_company_site(company_data) + assert Page.objects.count() == before + assert FormDefinition.objects.count() == 0 + assert NavigationMenu.objects.count() == 0 + + +def test_conflict_rolls_back_all_changes(home_page, company_data): + site = Site.objects.get(is_default_site=True) + site.root_page = home_page + site.save() + home_page.add_child(instance=SimpleContentPage(title="路径冲突", slug="solutions")) + before = Page.objects.count() + with pytest.raises(ValidationError, match="solutions"): + setup_company_site(company_data, True) + assert Page.objects.count() == before + assert not SiteSettings.objects.filter(company_name=company_data["company_name"]).exists() + site.refresh_from_db() + assert site.site_name != company_data["company_name"] + + +def test_incompatible_root_is_not_replaced(company_data): + site = Site.objects.get(is_default_site=True) + site.root_page.slug = "existing-business" + site.root_page.save() + with pytest.raises(ValidationError, match="根页面"): + setup_company_site(company_data, True) + site.refresh_from_db() + assert site.root_page.slug == "existing-business" + + +def test_company_html_is_escaped(company_data): + company_data["company_name"] = '' + setup_company_site(company_data, True) + assert "