# read_sys

**Repository Path**: liufeixiang6/read_sys

## Basic Information

- **Project Name**: read_sys
- **Description**: 基于nicegui和sqlite3的阅读记录管理系统
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://1life2live.cn
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2025-01-11
- **Last Updated**: 2025-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# read_sys

#### 介绍
基于nicegui和sqlite3的阅读记录管理系统(整个程序完全基于移动端设备设计，PC端打开显示会不太正常)
对书籍，作者信息进行完整收录后，可以通过首页推荐，或书名搜索进入书籍详情页，将书籍加入书架。
书架页面可以看到当前用户的阅读记录，并显示每本书的阅读状态，点击可进入书籍详情页。
书籍详情页可看到书籍较为丰富的信息，点击作者名，可进入作者详情页（暂时只维护了一位作者 叶真中显 进行测试，其他作者进去会报错）
书籍页可以设置阅读状态 想读 在读 已读。
书籍页可以增加评论，并显示其他人历史评论。 
评论区点用户头像可进入用户页面 ，查看该用户的阅读信息。

#### 软件架构
整体基于nicegui提供前后端支持，数据库暂用sqlite3，通过五张数据表管理整个系统的所有信息。
使用PIL和numpy提供图像算法相关支持，用于计算书籍详情页/用户页/作者页动态背景色。
使用nicegui自带echarts模块生成简单阅读统计图表。
#### 安装教程
1.  新鲜空白文件夹
2.  将本仓库所有文件一起拷贝进该文件夹
3.  运行该文件即可
4.  初始登录账号为：ad1 密码：123
5.  如自用需自己维护好书籍信息和作者信息
6.  建议针对自用设备重新做尺寸适配

#### 使用说明

1.  登录账号后进入首页，可以在上方搜索框输入书名（可不完整），点击搜索，会出现相关书籍，点击即进入详情页。

![首页](https://s21.ax1x.com/2025/01/11/pEPKUW6.jpg "在这里输入图片标题")

2.  首页推荐书籍，每次刷新都会变，点击加入书架，会直接加入到阅读记录中，可以在书架中找到。
3.  书架页显示当前用户有阅读记录的所有书籍，点击可进入书籍详情页，书籍图片采用二次加载，页面刷新，第一次只加载各组件，不加载图片，第二次才按需加载图片，以此保证服务流畅。

![书架页](https://s21.ax1x.com/2025/01/11/pEPKwQO.jpg "在这里输入图片标题")

4.  书籍详情页显示信息较多，包含，书名，作者，译者（如有维护），出版社，出版时间，豆瓣评分，阅读状态，书籍简介，评论模块。

![书籍详情页](https://s21.ax1x.com/2025/01/11/pEPKBOe.jpg "在这里输入图片标题")

5.  点击作者或译者，可进入对应页面，会显示该作者的所有书籍。

![作者页](https://s21.ax1x.com/2025/01/11/pEPK0yD.jpg "在这里输入图片标题")

6.  点击评论区用户头像，可进入用户页，可查看用户的阅读统计信息，以及最近阅读的三本书。

![用户页](https://s21.ax1x.com/2025/01/11/pEPKdSK.jpg "在这里输入图片标题")


#### 数据表字段说明

1.  用户表字段分别为 登录账号id，用户名，用户密码，头像图片的路径，以及权限说明，管理员可进行后台管理操作
2.  作者列表字段分别为 作者名，头像图片的路径，作者简介，国籍信息，如维护信息缺失，进入作者详情页会报错。
3.  书籍列表字段分别为 书籍名，作者在作者表的id，译者在作者表的id（如无译者则为0），出版社，出版时间，封面路径，评分，简介。
4.  书籍记录字段分别为 用户id，书籍id，阅读状态，阅读开始日期和结束日期。
5.  评论表字段分别为 书籍id，评论内容，评论时间，评论用户id

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)