马克思主义文化传播平台 (Vue3 + FastAPI + Docker)

一个基于前后端分离架构实现的本科毕业设计项目，主题为“马克思主义文化传播”。项目围绕马克思人物介绍、文章展示、用户登录注册、评论互动与关键词搜索等功能展开，适合课程展示、毕业设计答辩与基础 Web 系统实践。

项目简介

本项目旨在构建一个具有宣传、展示与互动功能的马克思主义文化网站。系统以前端页面展示理论内容，以后端接口提供数据支持，并通过 SQLite 实现轻量化数据存储。

网站主要包含以下模块：

• 首页展示
• 文章列表与分类筛选
• 文章详情阅读
• 用户注册与登录
• 评论系统
• 关键词搜索

技术栈

前端

• Vue 3
• Vite
• Vue Router
• Pinia
• Axios

后端

• Python
• FastAPI
• SQLAlchemy ORM
• SQLite
• JWT 认证

部署

• Docker
• Docker Compose

项目结构

马文化网站/
├── backend/
│   ├── app/
│   │   ├── main.py
│   │   ├── database.py
│   │   ├── models.py
│   │   ├── schemas.py
│   │   ├── init_db.py
│   │   ├── routers/
│   │   └── services/
│   ├── data/
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── api/
│   │   ├── assets/
│   │   ├── components/
│   │   ├── router/
│   │   ├── stores/
│   │   ├── utils/
│   │   └── views/
│   ├── Dockerfile
│   ├── nginx.conf
│   ├── package.json
│   └── vite.config.js
├── docker-compose.yml
└── README.md

功能说明

1. 首页

• 展示马克思人物介绍
• 展示名言 Banner
• 展示推荐文章

2. 文章系统

• 文章列表分页展示
• 分类筛选
• 标题关键词搜索
• 文章详情查看

3. 用户系统

• 用户注册
• 用户登录
• JWT 登录认证

4. 评论系统

• 查看文章评论
• 登录后发表评论

本地运行方式

1. 启动后端

cd /Users/lichunfeng/项目和代码/马文化网站/backend
/opt/miniconda3/envs/WebForMarxis/bin/python -m uvicorn app.main:app --reload

后端接口地址：

http://localhost:8000

接口文档地址：

http://localhost:8000/docs

2. 启动前端

cd /Users/lichunfeng/项目和代码/马文化网站/frontend
npm install --cache .npm-cache
npm run dev

前端访问地址：

http://localhost:5173

Docker 一键部署

本项目已经完成 Docker 化，可以通过一条命令同时启动前端和后端，无需再分别手动启动。

1. 启动项目

cd /Users/lichunfeng/项目和代码/马文化网站
docker compose up --build

如果希望后台运行：

docker compose up --build -d

2. 查看运行状态

docker compose ps

3. 查看日志

docker compose logs -f

4. 停止项目

docker compose down

5. Docker 部署后的访问地址

• 前端：http://localhost:5173
• 后端：http://localhost:8000
• 接口文档：http://localhost:8000/docs

默认测试账号

项目初始化时会自动生成默认测试账号：

• 用户名：admin
• 密码：admin123

项目特点

• 采用前后端分离架构，结构清晰
• 使用 FastAPI 构建 RESTful API，便于扩展
• 使用 Pinia 管理登录状态，便于前端统一维护用户信息
• 使用 SQLite，部署简单，适合本科毕业设计
• 使用 Docker Compose 实现一键部署，适合答辩展示

关于本项目的开发方式

这个项目并不是传统意义上“从零手敲每一行代码”的开发方式，而是一次非常典型、非常彻底的 vibe coding 实践。

更准确地说：

• 此项目主要依靠 CodeX 协助完成
• 开发过程中几乎没有大量手写业务代码
• 我主要负责搭建运行环境、明确需求、不断组织提示词
• 然后通过调用模型、使用工具、持续联调与修正，逐步完成整个项目

也就是说，这个项目的核心开发过程，更接近一种“人负责提出目标、约束和反馈，模型负责生成、调整和实现”的协作式开发流程。

这既是一次课程项目实践，也是一场对 AI 辅助编程、提示词组织能力和工程整合能力的真实尝试。

毕设说明可用表述

如果需要在毕业设计说明中对开发方式进行简洁描述，可以写成：

本项目在开发过程中引入了 AI 辅助编程方式，借助 CodeX 完成系统结构设计、前后端代码生成、接口联调与 Docker 部署等工作。开发者主要负责需求拆解、提示词组织、环境搭建、过程验证与结果调整。这是一种以“提示驱动 + 工具协作”为核心的 vibe coding 实践。

后续可扩展方向

• 增加后台管理系统
• 支持文章发布与编辑
• 支持用户头像与个人资料
• 支持文章收藏与点赞
• 将 SQLite 升级为 MySQL
• 部署到云服务器，实现公网访问

许可证说明

本项目主要用于本科毕业设计、课程展示与学习交流。