Flask 博客系统技术详细设计

1. 项目概述

1.1 系统架构设计

架构类型：MVC（模型-视图-控制器）架构。
技术栈：
- 后端：Flask（Python）
- 数据库：SQLite（开发环境） / MySQL/PostgreSQL（生产环境）
- 前端：HTML、CSS、JavaScript、Bootstrap 5
- ORM：SQLAlchemy
- 富文本编辑器：CKEditor

2. 模块功能设计

2.1 用户管理

功能：用户注册、登录、登出、密码找回、权限管理。
接口设计：
- GET /login：登录页面
- POST /login：处理登录
- GET /logout：登出
- POST /register：处理用户注册
- POST /reset-password：密码重置

数据库表：

用户表：

CREATE TABLE users (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  username VARCHAR(50) NOT NULL UNIQUE,
  email VARCHAR(100) NOT NULL UNIQUE,
  password_hash VARCHAR(128) NOT NULL,
  is_admin BOOLEAN DEFAULT 0,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

2.2 博客文章管理

功能：文章的创建、编辑、删除、分类和标签管理。
接口设计：
- GET /post/new：新建文章页面
- POST /post/new：保存新文章
- GET /post/<int:post_id>/edit：编辑文章页面
- POST /post/<int:post_id>/edit：保存编辑
- POST /post/<int:post_id>/delete：删除文章

数据库表：

文章表：

CREATE TABLE posts (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  title VARCHAR(200) NOT NULL,
  body TEXT NOT NULL,
  category_id INTEGER,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (category_id) REFERENCES categories (id)
);

2.3 评论系统

功能：文章评论、评论审核、评论管理。
接口设计：
- POST /post/<int:post_id>/comment：添加评论
- POST /comment/<int:comment_id>/approve：审核评论
- POST /comment/<int:comment_id>/delete：删除评论

数据库表：

评论表：

CREATE TABLE comments (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  post_id INTEGER NOT NULL,
  author VARCHAR(100),
  email VARCHAR(100),
  body TEXT NOT NULL,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  reviewed BOOLEAN DEFAULT 0,
  FOREIGN KEY (post_id) REFERENCES posts (id)
);

2.4 分类管理

功能：文章分类的增删改查。
接口设计：
- GET /category/new：新增分类页面
- POST /category/new：保存分类
- GET /category/<int:category_id>/edit：编辑分类页面
- POST /category/<int:category_id>/edit：保存修改
- POST /category/<int:category_id>/delete：删除分类

数据库表：

分类表：

CREATE TABLE categories (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name VARCHAR(50) NOT NULL UNIQUE,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

2.5 标签管理

功能：标签的增删改查，以及文章与标签的关联。
接口设计：
- POST /tag/<int:tag_id>/delete：删除标签
- GET /tag/<int:tag_id>：查看某标签的文章

数据库表：

标签表：

CREATE TABLE tags (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name VARCHAR(50) NOT NULL UNIQUE
);

文章与标签的多对多关系表：

CREATE TABLE post_tags (
  post_id INTEGER,
  tag_id INTEGER,
  PRIMARY KEY (post_id, tag_id),
  FOREIGN KEY (post_id) REFERENCES posts (id),
  FOREIGN KEY (tag_id) REFERENCES tags (id)
);