bwadmin/pear-admin-flask
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(nav): 新增前台公开导航页与后台导航管理

Browse Source 
新增模块
- Nav 模型（applications/models/admin_nav.py）：公开导航表，与 admin_power 解耦
- NavOutSchema / NavManageSchema（applications/schemas/admin_nav.py）
- 前台公开视图 applications/view/public/nav.py：/site/、/site/category/<name>、/site/api/navs，无需登录
- 后台管理视图 applications/view/system/nav.py：CRUD + 启用/禁用，挂入 system_bp
- 前台模板 templates/public/{base,index,category}.html（独立配色，无需登录即可访问）
- 后台模板 templates/system/nav/{main,add,edit}.html（Layui table + form）

调整
- applications/view/__init__.py：注册前台蓝图到根
- applications/view/system/__init__.py：注册后台 nav 子蓝图
- applications/common/script/admin.py：admin init/export 支持 navs 数组
- applications/common/script/app_data/init.json：新增 10 条导航种子 + 4 条 system:nav 权限

数据库
- 新增 public_nav 表（含 category 索引）
- migration: 38751d88d42c_add_public_nav_table.py
This commit is contained in:
bwstudio
2026-09-05 14:58:08 +08:00
parent 3debece5d3
commit b208087f74
17 changed files with 1147 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
templates/public/base.html
+153
View File
@@ -0,0 +1,153 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
<title>{% block title %}{{ site_name|default('BWStudio · 导航') }}{% endblock %}</title>
<meta name="description" content="BWStudio 公开导航聚合页：精选开发工具、AI、设计资源、效率工具等优质站点。">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/layui@2.9.7/dist/css/layui.css">
<style>
:root {
--brand: #16baaa;
--bg: #f5f7fa;
--card-bg: #ffffff;
--text: #2c3e50;
--text-muted: #6c7a89;
--border: #e8eef0;
--shadow: 0 2px 12px rgba(0,0,0,0.06);
--shadow-hover: 0 8px 24px rgba(22, 186, 170, 0.18);
}
body {
margin: 0;
background: var(--bg);
color: var(--text);
font-family: -apple-system, BlinkMacSystemFont, "PingFang SC", "Microsoft YaHei", sans-serif;
}
.topbar {
background: linear-gradient(135deg, #16baaa 0%, #2e8de8 100%);
color: #fff;
padding: 56px 0 48px;
}
.topbar .container { max-width: 1200px; margin: 0 auto; padding: 0 24px; }
.topbar h1 { font-size: 36px; margin: 0 0 8px; font-weight: 600; }
.topbar .sub { font-size: 15px; opacity: 0.92; }
.topbar .actions { margin-top: 18px; }
.topbar .actions a {
display: inline-block;
padding: 6px 14px;
margin-right: 8px;
background: rgba(255,255,255,0.18);
border: 1px solid rgba(255,255,255,0.35);
color: #fff;
border-radius: 999px;
font-size: 13px;
text-decoration: none;
transition: all 0.2s;
}
.topbar .actions a:hover { background: rgba(255,255,255,0.32); }
.container { max-width: 1200px; margin: 0 auto; padding: 0 24px; }
.section { margin: 32px 0; }
.section-header {
display: flex;
align-items: baseline;
justify-content: space-between;
margin-bottom: 16px;
border-left: 4px solid var(--brand);
padding-left: 12px;
}
.section-header h2 {
font-size: 20px;
margin: 0;
font-weight: 600;
}
.section-header .meta { font-size: 13px; color: var(--text-muted); }
.grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
gap: 16px;
}
.card {
background: var(--card-bg);
border: 1px solid var(--border);
border-radius: 10px;
padding: 18px;
text-decoration: none;
color: inherit;
box-shadow: var(--shadow);
transition: all 0.25s ease;
display: flex;
flex-direction: column;
gap: 6px;
}
.card:hover {
transform: translateY(-3px);
box-shadow: var(--shadow-hover);
border-color: var(--brand);
}
.card .title-row {
display: flex; align-items: center; gap: 10px;
}
.card .icon-wrap {
width: 36px; height: 36px;
background: rgba(22, 186, 170, 0.1);
color: var(--brand);
border-radius: 8px;
display: flex; align-items: center; justify-content: center;
font-size: 18px;
flex-shrink: 0;
}
.card .title {
font-size: 15px; font-weight: 600; color: var(--text);
flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
}
.card .desc {
font-size: 13px; color: var(--text-muted);
line-height: 1.5;
overflow: hidden;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
min-height: 38px;
}
.card .url {
font-size: 12px; color: #b0bac3;
overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
}
.empty {
text-align: center; padding: 48px 0; color: var(--text-muted);
}
footer.site-footer {
margin-top: 48px; padding: 24px 0;
text-align: center; color: var(--text-muted); font-size: 13px;
border-top: 1px solid var(--border);
}
</style>
{% block extra_head %}{% endblock %}
</head>
<body>
<header class="topbar">
<div class="container">
<h1>{{ site_name|default('BWStudio · 导航') }}</h1>
<div class="sub">{% block subtitle %}精选优质站点，按分类聚合展示 · 共 {{ total|default(0) }} 个链接{% endblock %}</div>
<div class="actions">
<a href="{{ url_for('public_nav.index') }}">🏠 首页</a>
<a href="/admin/login">🔐 登录后台</a>
</div>
</div>
</header>
<main class="container">
{% block content %}{% endblock %}
</main>
<footer class="site-footer">
© 2026 BWStudio · 基于 <a href="https://gitea.bwhome.top/bwadmin/pear-admin-flask" style="color:var(--brand);">Pear Admin Flask</a> 构建
</footer>
{% block extra_js %}{% endblock %}
</body>
</html>
templates/public/category.html
+36
View File
@@ -0,0 +1,36 @@
{% extends 'public/base.html' %}
{% block title %}{{ category }} - {{ site_name }}{% endblock %}
{% block content %}
<section class="section">
<div class="section-header">
<h2>{{ category }}</h2>
<div class="meta">
共 {{ items|length }} 个 ·
<a href="{{ url_for('public_nav.index') }}">← 返回首页</a>
</div>
</div>
{% if not items %}
<div class="empty">该分类下暂无导航。</div>
{% else %}
<div class="grid">
{% for item in items %}
<a class="card"
href="{{ item.url }}"
{% if item.is_external %}target="_blank" rel="noopener noreferrer"{% endif %}>
<div class="title-row">
<div class="icon-wrap">
<i class="layui-icon {{ item.icon }}"></i>
</div>
<div class="title">{{ item.title }}</div>
</div>
<div class="desc">{{ item.description or '暂无描述' }}</div>
<div class="url">{{ item.url }}</div>
</a>
{% endfor %}
</div>
{% endif %}
</section>
{% endblock %}
templates/public/index.html
+38
View File
@@ -0,0 +1,38 @@
{% extends 'public/base.html' %}
{% block content %}
{% if not groups %}
<div class="empty">
<i class="layui-icon layui-icon-face-surprised" style="font-size:48px;color:#ccc;"></i>
<p>暂无导航数据，请先在后台【系统管理 → 导航管理】添加。</p>
</div>
{% else %}
{% for category, items in groups.items() %}
<section class="section">
<div class="section-header">
<h2>{{ category }}</h2>
<div class="meta">
共 {{ items|length }} 个 ·
<a href="{{ url_for('public_nav.category_detail', name=category) }}">查看全部 →</a>
</div>
</div>
<div class="grid">
{% for item in items %}
<a class="card"
href="{{ item.url }}"
{% if item.is_external %}target="_blank" rel="noopener noreferrer"{% endif %}>
<div class="title-row">
<div class="icon-wrap">
<i class="layui-icon {{ item.icon }}"></i>
</div>
<div class="title">{{ item.title }}</div>
</div>
<div class="desc">{{ item.description or '暂无描述' }}</div>
<div class="url">{{ item.url }}</div>
</a>
{% endfor %}
</div>
</section>
{% endfor %}
{% endif %}
{% endblock %}
templates/system/nav/add.html
+101
View File
@@ -0,0 +1,101 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>新增导航</title>
{% include 'system/common/header.html' %}
</head>
<body>
<div class="layui-form" lay-filter="nav-form" style="padding: 20px 30px 0 0;">
<div class="layui-form-item">
<label class="layui-form-label">分类</label>
<div class="layui-input-block">
<input type="text" name="category" required lay-verify="required" placeholder="如：开发工具 / AI / 设计资源"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">标题</label>
<div class="layui-input-block">
<input type="text" name="title" required lay-verify="required" placeholder="显示在卡片上的名称"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">链接 URL</label>
<div class="layui-input-block">
<input type="text" name="url" required lay-verify="required|url"
placeholder="https://example.com" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<textarea name="description" placeholder="选填，鼠标悬停时显示" class="layui-textarea"></textarea>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标</label>
<div class="layui-input-block">
<input type="text" name="icon" placeholder="layui-icon-website / layui-icon-ai / 等"
autocomplete="off" class="layui-input" value="layui-icon-link">
<div class="layui-form-mid layui-word-aux">参考：<a href="https://layui.dev/web/doc/element/icon.html" target="_blank">layui 图标库</a></div>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-inline">
<input type="number" name="sort" value="0" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">类型</label>
<div class="layui-input-block">
<input type="radio" name="isExternal" value="1" title="外链（新窗口）" checked>
<input type="radio" name="isExternal" value="0" title="站内（当前窗口）">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
<input type="radio" name="status" value="1" title="启用" checked>
<input type="radio" name="status" value="0" title="禁用">
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button class="layui-btn" lay-submit lay-filter="nav-submit">保存</button>
<button type="reset" class="layui-btn layui-btn-primary">重置</button>
</div>
</div>
</div>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.on('submit(nav-submit)', function(data){
$.ajax({
url: '/system/nav/save',
type: 'POST',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.success) {
layer.msg(res.msg, {icon: 1});
parent.layui.table.reload('nav-table');
setTimeout(function(){ parent.layer.closeAll(); }, 800);
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
});
</script>
</body>
</html>
templates/system/nav/edit.html
+100
View File
@@ -0,0 +1,100 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>编辑导航</title>
{% include 'system/common/header.html' %}
</head>
<body>
<div class="layui-form" lay-filter="nav-form" style="padding: 20px 30px 0 0;">
<input type="hidden" name="id" value="{{ nav.id }}">
<div class="layui-form-item">
<label class="layui-form-label">分类</label>
<div class="layui-input-block">
<input type="text" name="category" required lay-verify="required" value="{{ nav.category }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">标题</label>
<div class="layui-input-block">
<input type="text" name="title" required lay-verify="required" value="{{ nav.title }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">链接 URL</label>
<div class="layui-input-block">
<input type="text" name="url" required lay-verify="required|url" value="{{ nav.url }}"
autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">简介</label>
<div class="layui-input-block">
<textarea name="description" class="layui-textarea">{{ nav.description or '' }}</textarea>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">图标</label>
<div class="layui-input-block">
<input type="text" name="icon" value="{{ nav.icon }}" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">排序</label>
<div class="layui-input-inline">
<input type="number" name="sort" value="{{ nav.sort }}" autocomplete="off" class="layui-input">
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">类型</label>
<div class="layui-input-block">
<input type="radio" name="isExternal" value="1" title="外链（新窗口）" {% if nav.is_external == 1 %}checked{% endif %}>
<input type="radio" name="isExternal" value="0" title="站内（当前窗口）" {% if nav.is_external != 1 %}checked{% endif %}>
</div>
</div>
<div class="layui-form-item">
<label class="layui-form-label">状态</label>
<div class="layui-input-block">
<input type="radio" name="status" value="1" title="启用" {% if nav.status == 1 %}checked{% endif %}>
<input type="radio" name="status" value="0" title="禁用" {% if nav.status != 1 %}checked{% endif %}>
</div>
</div>
<div class="layui-form-item">
<div class="layui-input-block">
<button class="layui-btn" lay-submit lay-filter="nav-submit">保存</button>
<button type="button" class="layui-btn layui-btn-primary" onclick="parent.layer.closeAll();">取消</button>
</div>
</div>
</div>
{% include 'system/common/footer.html' %}
<script>
layui.use(['form', 'layer'], function(){
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
form.on('submit(nav-submit)', function(data){
$.ajax({
url: '/system/nav/update',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify(data.field),
success: function(res){
if (res.success) {
layer.msg(res.msg, {icon: 1});
parent.layui.table.reload('nav-table');
setTimeout(function(){ parent.layer.closeAll(); }, 800);
} else {
layer.msg(res.msg, {icon: 2});
}
}
});
return false;
});
});
</script>
</body>
</html>
templates/system/nav/main.html
+177
View File
@@ -0,0 +1,177 @@
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>导航管理</title>
{% include 'system/common/header.html' %}
</head>
<body class="layui-layout-body pear-admin">
<div class="layui-layout layui-layout-admin">
{% include 'system/common/head.html' %}
{% include 'system/common/side.html' %}
<div class="layui-body">
<div class="layui-card">
<div class="layui-card-header">
<span class="layui-icon layui-icon-link"></span> 导航管理
<button class="layui-btn layui-btn-sm layui-btn-normal" style="float:right;margin-top:-6px;"
lay-event="add" id="btn-add">
<i class="layui-icon layui-icon-add-1"></i> 新增导航
</button>
</div>
<div class="layui-card-body">
<form class="layui-form" lay-filter="search-form">
<div class="layui-form-item">
<div class="layui-inline">
<label class="layui-form-label">关键词</label>
<div class="layui-input-inline">
<input type="text" name="keyword" placeholder="标题/链接/简介" class="layui-input">
</div>
</div>
<div class="layui-inline">
<label class="layui-form-label">分类</label>
<div class="layui-input-inline">
<input type="text" name="category" placeholder="按分类过滤" class="layui-input">
</div>
</div>
<div class="layui-inline">
<button type="button" class="layui-btn" lay-submit lay-filter="search">搜索</button>
<button type="reset" class="layui-btn layui-btn-primary">重置</button>
</div>
</div>
</form>
<table id="nav-table" lay-filter="nav-table"></table>
</div>
</div>
</div>
{% include 'system/common/footer.html' %}
</div>
{% raw %}
<script type="text/html" id="col-status">
{{# if(d.status === 1){ }}
<span class="layui-badge layui-bg-green">启用</span>
{{# } else { }}
<span class="layui-badge layui-bg-gray">禁用</span>
{{# } }}
</script>
<script type="text/html" id="col-external">
{{# if(d.is_external === 1){ }}
<span class="layui-badge layui-bg-blue">外链</span>
{{# } else { }}
<span class="layui-badge">站内</span>
{{# } }}
</script>
<script type="text/html" id="col-op">
<a class="layui-btn layui-btn-xs" lay-event="edit">编辑</a>
{{# if(d.status === 1){ }}
<a class="layui-btn layui-btn-xs layui-btn-warm" lay-event="disable">禁用</a>
{{# } else { }}
<a class="layui-btn layui-btn-xs layui-btn-normal" lay-event="enable">启用</a>
{{# } }}
<a class="layui-btn layui-btn-xs layui-btn-danger" lay-event="remove">删除</a>
</script>
{% endraw %}
<script>
layui.use(['table', 'form', 'layer'], function(){
var table = layui.table;
var form = layui.form;
var layer = layui.layer;
var $ = layui.$;
var renderTable = function(){
var keyword = $('input[name="keyword"]').val();
var category = $('input[name="category"]').val();
table.render({
elem: '#nav-table',
url: '/system/nav/data',
where: { keyword: keyword, category: category },
page: true,
limit: 20,
cols: [[
{field: 'id', title: 'ID', width: 60},
{field: 'category', title: '分类', width: 120},
{field: 'title', title: '标题', width: 180},
{field: 'url', title: '链接', minWidth: 200},
{field: 'icon', title: '图标', width: 100},
{field: 'sort', title: '排序', width: 70},
{field: 'is_external', title: '类型', width: 80, templet: '#col-external'},
{field: 'status', title: '状态', width: 80, templet: '#col-status'},
{field: 'create_at', title: '创建时间', width: 170},
{fixed: 'right', title: '操作', toolbar: '#col-op', width: 220}
]],
response: {
statusCode: 200
},
parseData: function(res){
return {
code: res.success ? 0 : 1,
msg: res.msg,
count: res.count || 0,
data: res.data || []
};
}
});
};
renderTable();
form.on('submit(search)', function(data){
renderTable();
return false;
});
$('#btn-add').on('click', function(){
layer.open({
type: 2,
title: '新增导航',
area: ['640px', '600px'],
content: '/system/nav/add'
});
});
table.on('tool(nav-table)', function(obj){
var data = obj.data;
if (obj.event === 'edit'){
layer.open({
type: 2,
title: '编辑导航',
area: ['640px', '600px'],
content: '/system/nav/edit?navId=' + data.id
});
} else if (obj.event === 'remove'){
layer.confirm('确定删除该导航吗？', function(idx){
$.ajax({
url: '/system/nav/remove/' + data.id,
type: 'DELETE',
success: function(res){
if (res.success) { layer.msg(res.msg); obj.del(); }
else layer.msg(res.msg);
}
});
layer.close(idx);
});
} else if (obj.event === 'enable'){
$.ajax({
url: '/system/nav/enable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({navId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
} else if (obj.event === 'disable'){
$.ajax({
url: '/system/nav/disable',
type: 'PUT',
contentType: 'application/json',
data: JSON.stringify({navId: data.id}),
success: function(res){ layer.msg(res.msg); renderTable(); }
});
}
});
});
</script>
</body>
</html>