# 公司官网项目总结（WebAdmin）

## 1. 项目概述

本项目围绕“公司对外官网 + 后台内容管理”完成了从模板迁移、内容结构重建、后台编辑能力建设到发布试运行的完整闭环。

目标是让业务人员可在后台独立维护网站栏目、单页图文、图片画廊、首页模块及在线留言数据，减少开发介入频率，并保持前端展示风格与旧站视觉体验的一致性。

## 2. 建设目标与达成情况

• **统一前后端管理能力**：已完成后台菜单、内容、画廊、留言管理。

• **首页可配置化**：已实现首页栏目按菜单/配置动态加载，支持动画效果。

• **富文本可用性提升**：已解决初始化时序问题、图片越界问题、字体字号应用问题。

• **数据初始化可控**：已支持启动时按配置清空并重建核心业务数据表。

• **部署可落地**：已完成 IIS 场景试运行验证，并梳理上线流程与风险点。

## 3. 核心功能交付清单

### 3.1 前台展示能力

• 首页模块化展示（公司简介、产品展示、工程案例等）。

• 首页轮播图全局化（通过 `MainLayout` 统一承载）。

• 栏目页支持多展示模式：

  • 列表图文

  • 单页图文

  • 图片画廊

  • 在线留言表单

• 内容页、栏目页图片自适应，解决超出容器问题。

### 3.2 后台管理能力

• 菜单管理：支持菜单层级与展示类型配置。

• 内容管理：

  • 二级菜单维度维护内容

  • 编辑/保存状态控制（避免误操作）

  • 单页模式隐藏“新建内容”等不适配操作

• 图片画廊：

  • 支持排序、发布状态、批量上传

  • 调整为“上传原图后自动生成 `_s` 缩略图”的流程

• 在线留言：

  • 前台表单提交

  • 后台独立管理页面查看与处理

### 3.3 富文本编辑器增强

• 修复 `rte.attach` 未定义导致的初始化异常。

• 增加脚本就绪检测与重试机制。

• 图片在编辑器内按容器约束显示，不再溢出。

• 字体/字号改为优先包裹 `span` 样式方式，提高稳定性。

### 3.4 数据与初始化

• 增加 `SeedOptions`、`HomeSectionsOptions` 配置对象。

• 支持按配置清空并重建核心数据（菜单/内容/画廊）并重置 ID。

• 处理外键约束与 EF 跟踪冲突：

  • `PRAGMA foreign_keys` 控制

  • `ChangeTracker.Clear()`

• 保留轮播图相关数据并解除引用，避免清空后首页轮播丢失。

## 4. 关键技术实现

• **技术栈**：ASP.NET Core / Blazor（Interactive Server）/ EF Core / SQLite / JS Interop。

• **前端交互**：基于 `IntersectionObserver` 实现轻量滚动动画。

• **图片处理**：画廊上传引入服务端缩略图生成逻辑（原图 + `_s` 缩略图）。

• **布局结构**：全局 Banner、Footer 宽度与首页内容区统一。

• **配置化能力**：通过 `appsettings` 控制种子行为与首页模块映射。

## 5. 问题攻坚与解决结果

• **构建文件锁定（MSB3027/MSB3021）**：明确进程占用原因并形成标准处理流程。

• **富文本脚本时序异常**：脚本前置加载 + 就绪探测 + 延迟重试后稳定。

• **数据库重置失败（外键/跟踪冲突）**：通过重置顺序与上下文清理彻底修复。

• **前端图片越界**：在编辑端和展示端同时加约束，问题闭环。

• **Git 资源目录误纳管风险**：形成 `.gitignore + rm --cached` 标准操作。

## 6. 部署与运行结论

### 6.1 当前部署现状

• 已完成 IIS 环境下的基础部署与访问验证。

• 已可通过 HTTP（80）进行功能联调与业务验收。

### 6.2 风险与建议

• 现网服务器为 **Windows Server 2008 R2**，对 .NET 8 支持存在系统级风险。

• 建议正式上线迁移到受支持系统（Windows Server 2016/2019/2022）并启用 HTTPS。

• SQLite 继续放站点目录可行，但需严格控制文件权限与备份机制。

## 7. 验收建议（推荐执行）

• 前台：首页、栏目页、详情页、轮播、动画、图片弹出。

• 后台：菜单配置、内容编辑、画廊上传/排序、留言管理。

• 数据：重启后配置项生效、清空重建逻辑正确、主键重置符合预期。

• 部署：发布包替换、数据保留、回滚演练、日志检查。

## 8. 运维与交接建议

• 固化发布流程：发布前备份、`app_offline.htm`、差异覆盖、上线后冒烟测试。

• 建立定期备份：SQLite 数据库 + `wwwroot/uploads`。

• 建立变更记录：每次菜单结构、展示模式和配置修改需记录。

• 后续可扩展方向：

  • 后台操作审计日志

  • 留言防刷/验证码

  • 媒体文件生命周期管理（归档/清理策略）

  • 迁移至更高可用部署架构

## 9. 项目结论

截至当前，官网核心业务能力已基本完成并进入“可测试、可运营、可迭代”阶段。

建议以“先稳定试运行、再迁移升级正式上线”为主线推进，优先完成服务器环境升级与 HTTPS 正式切换。