辣评用户手册系统完善(二十一)
实现路径说明
本文保留了重构阶段的目录规划示例(如 manuals/ 结构)用于说明演进思路。
当前主线代码中,用户手册内容路径为 docs/manual/,后台接口为 /api/admin/manual*。
用户手册系统完善概述
在用户手册系统的初步实现后(参见第十一篇文档),我们根据实际使用反馈进行了全面的完善和优化。本次完善主要集中在内容重构、章节管理优化、在线编辑增强和导航体验改进等方面。
完善目标
重构手册内容结构
优化章节管理功能
增强在线编辑体验
改进导航和目录
提升前后端协作效率
手册内容重构
问题分析
原有问题:
所有内容存储在单一文件中,难以维护
章节结构不够清晰
内容更新困难
版本管理不便
重构目...
辣评前后端服务统一与优化(二十二)
服务统一背景
在项目初期,前端和后端分别运行在不同的端口上,这给开发和部署带来了一些不便。本次优化将前后端服务统一到同一端口,简化了部署流程,提升了用户体验。
优化前的架构
前端服务:http://localhost:5173 (Vite Dev Server)
后端服务:http://localhost:8888 (Go API Server)
部署时:
前端:Nginx 静态文件服务 (端口 80)
后端:Go API 服务 (端口 8888)
需要配置 Nginx 反向代理
存在的问题:
开发时需要启动两个服务
跨域问题需要额外配置
部署时需要配置反向代理
用户访问需要记住两个地址
优化后的架构
统一服务:http://localhost:88...
辣评版本管理与构建系统(十七)
历史说明
本文包含两类内容:
当时已落地的构建与发布实践;
同阶段的方案草稿与历史脚本示例(用于记录演进思路)。
为避免歧义,当前仓库可直接使用的工程化入口主要是:build.sh、build.ps1、local-build.sh、docker/Dockerfile、docker/docker-compose.yml、config.example.json。
文中提及的 VERSION、version.json、scripts/version.sh 等内容可视为历史方案示例。
版本管理系统概述
随着辣评项目的不断发展,我们需要一个规范的版本管理系统来追踪项目的演进历程。本文记录了版本号管理系统和构建系统的实现过程。
系统目标
实现自动化版本号管理
统...
辣评任务追踪系统完善(十八)
时间线说明
本文以 2026-02-27 的阶段优化为主,文中部分功能(如刷新按钮与后续样式细化)为 2026-03-06 的补充迭代,一并合并记录在本篇中。
任务追踪系统概述
任务追踪系统帮助用户了解自己的参赛资格状态、补评进度等信息。本次完善优化了页面设计、数据展示和交互体验。
优化目标
优化页面设计和布局
完善资格状态展示
改进补评进度追踪
添加数据刷新功能(2026-03-06 补充)
提升用户体验
任务追踪页面设计
页面布局
<template>
<div class="task-tracking-page">
<el-card class="header-card">
...
辣评 Docker 容器化与部署方案(二十六)
Docker 容器化概述
为了简化部署流程、提高环境一致性和便于扩展,我们为辣评项目实现了完整的 Docker 容器化方案。本文详细记录了 Docker 镜像构建、容器编排和部署的完整过程。
容器化目标
简化部署流程
保证环境一致性
便于横向扩展
提高资源利用率
简化运维管理
Docker 镜像构建
多阶段构建 Dockerfile
# Dockerfile
# 多阶段构建,减小最终镜像体积
# 阶段1:构建前端
FROM node:18-alpine AS frontend-builder
WORKDIR /app/admin-vue
# 复制前端依赖文件
COPY admin-vue/package*.json ./
# 安装依赖
RU...
辣评系统名称与品牌统一(二十三)
品牌统一背景
在项目发展过程中,系统名称在不同地方的显示不一致,缺乏统一的品牌形象。本次优化统一了系统名称为”辣评”,并设计了专属的 Logo,建立了完整的品牌识别系统。
优化前的问题
名称不统一
代码中使用 “SamgeBotWx”
页面显示 “投稿评论系统”
文档中使用 “LaPing”
用户困惑,缺乏品牌认知
缺少 Logo
使用通用图标
没有品牌识别度
界面缺乏特色
配置分散
系统名称硬编码在各处
修改困难
不便于定制
Logo 设计演进
设计理念
“...
辣评移动端界面全面优化(二十四)
移动端优化概述
随着移动设备使用率的不断提升,移动端体验成为用户体验的重要组成部分。本次优化全面改进了移动端界面,包括导航栏布局、菜单交互、页面显示等多个方面。
优化目标
优化导航栏布局
改进菜单交互体验
提升页面显示效果
增强响应式适配
提升整体用户体验
导航栏布局优化
优化前的问题
<!-- 优化前:用户菜单在左侧,不符合移动端习惯 -->
<div class="mobile-navbar">
<div class="user-menu">👤</div>
<div class="logo">辣评</div>
<div class="menu-toggle...
共计 129 篇文章,17 页。