refactor(plugins): 将导航/友链/关于/统计 4 模块迁出 framework 至 plugins

- 在 applications/config.py 中通过 PLUGIN_ENABLE_FOLDERS 启用 4 个业务插件 - 删除 framework 内 applications/view/system/nav.py 与 templates/system/nav/* 模板 - applications/extensions/init_plugs 移除重复的 broadcast_execute('event_init'/'event_finish') （由 init_bps / init_script 触发，避免 Blueprint 注册冲突） - applications/view/system/index.py：未登录访问 / 直接渲染前台公开聚合页 - templates/system/index.html：移动端首屏即折叠侧边栏 - 新增 5 个 model（Nav 字段 status→enable 兼容、NavCategory、About、Friend、VisitLog/PageStat、NavClick） - 新增 2 个 schema（NavCategorySchema、FriendOutSchema/ManageSchema） - admin_about/admin_friend/admin_nav_category 在 init.json 中以「网站管理」分组挂载 - .gitignore 补充一次性备份、调试截图、探针截图不入库
2026-09-06 18:17:52 +08:00
parent 1214bfdf4a
commit 1ea69c2c34
22 changed files with 512 additions and 646 deletions
@@ -9,3 +9,8 @@ from .admin_user import User
 from .admin_user_role import user_role
 from .admin_mail import Mail
 from .admin_nav import Nav
+from .admin_nav_category import NavCategory
+from .admin_about import About
+from .admin_friend import Friend
+from .admin_stat import VisitLog, PageStat
+from .admin_nav_click import NavClick
@@ -0,0 +1,62 @@
+"""
+「关于本站」内容管理。
+
+单条记录表 (id=1)：
+- 用于站点"关于"页面：自我介绍、备案号、联系方式、捐赠等。
+- 不限制多份：单条表单就能维护全部内容，幂等 upsert。
+
+设计原则：
+- 内容字段全可空（除 id），发布前可以临时空着。
+- Markdown 字段长度无限制，存原始文本，渲染时由前端解析。
+"""
+import datetime
+from applications.extensions import db
+
+
+class About(db.Model):
+    __tablename__ = 'site_about'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment='主键')
+
+    # 站点名称（公开页头部）
+    site_name = db.Column(db.String(120), default='', comment='站点名')
+
+    # 自我介绍 / 关于（Markdown 格式，前台渲染）
+    content_md = db.Column(db.Text, default='', comment='关于本站正文 (Markdown)')
+
+    # 备案信息
+    icp = db.Column(db.String(120), default='', comment='ICP 备案号')
+
+    # 联系信息（任选）
+    contact_email = db.Column(db.String(120), default='', comment='联系邮箱')
+    contact_qq = db.Column(db.String(32), default='', comment='联系 QQ')
+    contact_wechat = db.Column(db.String(120), default='', comment='微信号')
+    contact_telegram = db.Column(db.String(120), default='', comment='Telegram')
+    contact_github = db.Column(db.String(255), default='', comment='GitHub 链接')
+
+    # 捐赠 / 打赏 URL（一般挂二维码图片）
+    donate_url = db.Column(db.String(255), default='', comment='捐赠/打赏 URL 或二维码图片地址')
+
+    create_at = db.Column(db.DateTime, default=datetime.datetime.now, comment='创建时间')
+    update_at = db.Column(
+        db.DateTime,
+        default=datetime.datetime.now,
+        onupdate=datetime.datetime.now,
+        comment='更新时间',
+    )
+
+    def to_dict(self) -> dict:
+        return {
+            'id': self.id,
+            'site_name': self.site_name or '',
+            'content_md': self.content_md or '',
+            'icp': self.icp or '',
+            'contact_email': self.contact_email or '',
+            'contact_qq': self.contact_qq or '',
+            'contact_wechat': self.contact_wechat or '',
+            'contact_telegram': self.contact_telegram or '',
+            'contact_github': self.contact_github or '',
+            'donate_url': self.donate_url or '',
+            'create_at': self.create_at.strftime('%Y-%m-%d %H:%M:%S') if self.create_at else '',
+            'update_at': self.update_at.strftime('%Y-%m-%d %H:%M:%S') if self.update_at else '',
+        }
@@ -0,0 +1,56 @@
+"""
+「友情链接」管理。
+
+- 后台：列表 + 新增 / 编辑 / 删除 / 启用 / 禁用（与 Nav 一致接口风格）
+- 前台：公开只读
+
+字段：
+- title  : 友链名称
+- url    : 友链 URL
+- logo   : 站点头像 / favicon（可空，自动用 url 的 favicon）
+- description : 简介
+- category   : 友链分组（默认「推荐友链」）
+- sort       : 同分类下排序
+- enable     : 1 启用，0 禁用
+- is_external: 1 新窗口打开 / 0 当前窗口
+"""
+import datetime
+from applications.extensions import db
+
+
+class Friend(db.Model):
+    __tablename__ = 'site_friend'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment='友情链接ID')
+    title = db.Column(db.String(100), nullable=False, comment='名称')
+    url = db.Column(db.String(255), nullable=False, comment='链接')
+    logo = db.Column(db.String(255), default='', comment='Logo / favicon')
+    description = db.Column(db.String(255), default='', comment='简介')
+    category = db.Column(db.String(50), default='推荐友链', comment='分组', index=True)
+    sort = db.Column(db.Integer, default=0, comment='排序')
+    enable = db.Column(db.Integer, default=1, comment='状态(1启用,0关闭)')
+    is_external = db.Column(db.Integer, default=1, comment='是否外链')
+    create_by = db.Column(db.String(50), default='admin', comment='创建者')
+    create_at = db.Column(db.DateTime, default=datetime.datetime.now, comment='创建时间')
+    update_at = db.Column(
+        db.DateTime,
+        default=datetime.datetime.now,
+        onupdate=datetime.datetime.now,
+        comment='更新时间',
+    )
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'title': self.title,
+            'url': self.url,
+            'logo': self.logo or '',
+            'description': self.description or '',
+            'category': self.category or '推荐友链',
+            'sort': self.sort or 0,
+            'enable': self.enable,
+            'is_external': self.is_external,
+            'create_by': self.create_by,
+            'create_at': self.create_at.strftime('%Y-%m-%d %H:%M:%S') if self.create_at else '',
+            'update_at': self.update_at.strftime('%Y-%m-%d %H:%M:%S') if self.update_at else '',
+        }
@@ -36,7 +36,7 @@ class Nav(db.Model):
    sort = db.Column(db.Integer, default=0, comment='排序')

    # 1=启用，0=禁用（禁用后前台不再展示，后台列表仍可见）
-    status = db.Column(db.Integer, default=1, comment='状态(1启用,0关闭)')
+    enable = db.Column(db.Integer, default=1, comment='状态(1启用,0关闭)')

    # 1=外链（新窗口打开），0=站内（当前窗口）
    is_external = db.Column(db.Integer, default=1, comment='是否外链')
@@ -62,7 +62,7 @@ class Nav(db.Model):
            'description': self.description or '',
            'icon': self.icon or 'layui-icon-link',
            'sort': self.sort or 0,
-            'status': self.status,
+            'enable': self.enable,
            'is_external': self.is_external,
            'create_by': self.create_by,
            'create_at': self.create_at.strftime('%Y-%m-%d %H:%M:%S') if self.create_at else '',
@@ -0,0 +1,54 @@
+"""
+导航分类表
+
+Nav.category 是字符串字段，难以管理顺序/启用/图标。
+NavCategory 把"分类"提到一张独立表，允许后台做完整的 CRUD。
+
+数据关系：
+- NavCategory 1 — N Nav
+- 保留 Nav.category 字符串字段为冗余存储，避免前端热路径上做 LEFT JOIN
+"""
+import datetime
+
+from applications.extensions import db
+
+
+class NavCategory(db.Model):
+    __tablename__ = 'nav_category'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment='分类ID')
+
+    # 同名分类不能重复，方便前台 URL /site/category/<name> 用作 slug
+    name = db.Column(db.String(50), nullable=False, unique=True, index=True, comment='分类名（前端分类详情 URL）')
+
+    # 分类图标（前端首页标题旁小图标）
+    icon = db.Column(db.String(50), default='layui-icon-list', comment='layui-icon class')
+
+    # 分类简介（前端首页卡片标题下方描述）
+    description = db.Column(db.String(255), default='', comment='分类简介')
+
+    # 同级别的展示顺序（前端首页自上而下）
+    sort = db.Column(db.Integer, default=0, comment='排序')
+
+    # 1=启用，0=禁用（禁用后前台不再展示该分类，但 Nav 记录仍保留）
+    enable = db.Column(db.Integer, default=1, comment='状态(1启用,0关闭)')
+
+    create_at = db.Column(db.DateTime, default=datetime.datetime.now, comment='创建时间')
+    update_at = db.Column(
+        db.DateTime,
+        default=datetime.datetime.now,
+        onupdate=datetime.datetime.now,
+        comment='更新时间',
+    )
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'name': self.name,
+            'icon': self.icon or 'layui-icon-list',
+            'description': self.description or '',
+            'sort': self.sort or 0,
+            'enable': self.enable,
+            'create_at': self.create_at.strftime('%Y-%m-%d %H:%M:%S') if self.create_at else '',
+            'update_at': self.update_at.strftime('%Y-%m-%d %H:%M:%S') if self.update_at else '',
+        }
@@ -0,0 +1,21 @@
+"""
+导航卡片点击埋点模型。
+
+每条记录是用户点了一次某张 Nav 卡片跳出去的事件。
+- nav_id     关联 public_nav.id
+- day        YYYY-MM-DD 日期
+- ip         访客 IP（用于去重 / 隐私留存期控制）
+- clicked_at 点击时间
+"""
+import datetime
+from applications.extensions import db
+
+
+class NavClick(db.Model):
+    __tablename__ = 'site_nav_click'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment='记录ID')
+    nav_id = db.Column(db.Integer, nullable=False, index=True, comment='被点击的导航ID')
+    day = db.Column(db.String(10), default='', index=True, comment='日期 YYYY-MM-DD')
+    ip = db.Column(db.String(64), default='', comment='访客IP')
+    clicked_at = db.Column(db.DateTime, default=datetime.datetime.now, index=True, comment='点击时间')
@@ -0,0 +1,57 @@
+"""
+「访问统计」数据模型。
+
+每条记录是一次访问事件：
+- path    访问路径
+- referer 来源页（可空）
+- ua      User-Agent 摘要（可空）
+- ip      访客 IP（如果能拿到）
+- day     YYYY-MM-DD 日期（用于按天聚合）
+- visit_at 访问时间
+"""
+import datetime
+from applications.extensions import db
+
+
+class VisitLog(db.Model):
+    __tablename__ = 'site_visit_log'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True, comment='记录ID')
+    path = db.Column(db.String(255), default='', index=True, comment='访问路径')
+    referer = db.Column(db.String(255), default='', comment='来源页')
+    ua = db.Column(db.String(255), default='', comment='UA')
+    ip = db.Column(db.String(64), default='', comment='访问IP')
+    day = db.Column(db.String(10), default='', index=True, comment='日期 YYYY-MM-DD')
+    visit_at = db.Column(db.DateTime, default=datetime.datetime.now, index=True, comment='访问时间')
+
+
+class PageStat(db.Model):
+    """
+    路径级累计统计：每次访问做 upsert（按 path+day）。
+
+    字段：
+    - path
+    - day
+    - pv        当日 / 累计 Page View
+    - uv        IP 去重计数（用 set 维护在内存里，但用户规模小可以按 (path, day, ip) 简单去重）
+    - last_hit  最后一次访问时间
+    """
+    __tablename__ = 'site_page_stat'
+
+    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
+    path = db.Column(db.String(255), default='', index=True)
+    day = db.Column(db.String(10), default='', index=True)
+    pv = db.Column(db.Integer, default=0, comment='Page View')
+    uv = db.Column(db.Integer, default=0, comment='独立访客数（IP 去重后）')
+    uv_ip_set = db.Column(db.Text, default='', comment='独立 IP 列表 CSV')
+    last_hit = db.Column(db.DateTime, default=datetime.datetime.now, comment='最近访问时间')
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'path': self.path,
+            'day': self.day,
+            'pv': self.pv or 0,
+            'uv': self.uv or 0,
+            'last_hit': self.last_hit.strftime('%Y-%m-%d %H:%M:%S') if self.last_hit else '',
+        }