Todo List 备忘录

此项目使用Gin+Gorm ，基于RESTful API实现的一个备忘录。

此项目比较适合小白入门web开发这一方面

详细教程

注意，最新版本是v2

B站:

v1版本：https://www.bilibili.com/video/BV1GT4y1R7tX
重构v2版本：https://www.bilibili.com/video/BV13z4y1a7ZJ

博客:

v1版本：https://blog.csdn.net/weixin_45304503/article/details/120680957
重构v2版本：https://blog.csdn.net/weixin_45304503/article/details/130460797

前端仓库地址：https://github.com/CocaineCong/react-todolist

项目运行

手动执行

本项目使用Go Mod管理依赖。

将所有环境拉取启动

make env-up

下载依赖

go mod tidy

运行

go run ./cmd/main.go

将所有环境关闭并删除

make env-down

接口文档

Todo List 接口文档

密码：0000

也可以启动项目后，直接访问 http://localhost:3000/swagger/index.html

查看swagger文档

也可以选择postman文档导入

打开postman，点击导入

选择导入文件

效果

项目主要功能介绍

用户注册登录 ( jwt-go鉴权 )
新增/删除/修改/查询备忘录
存储每条备忘录的浏览次数
分页功能

项目主要依赖：

Golang V1.15

Gin
Gorm
mysql
redis
ini
jwt-go
logrus
go-swagger

项目结构

TodoList/
├── api
├── cmd
├── conf
├── consts
├── docs
├── middleware
├── pkg
│  ├── e
│  └── util
├── routes
├── repository
│  ├── cache
│  └── db
│     ├── dao
│     └── model
├── routes
├── service
└── types

api : 用于定义接口函数,也就是controller层
cmd : 程序启动
conf : 用于存储配置文件
middleware : 应用中间件
pkg/e : 封装错误码
pkg/logging : 日志打印
pkg/util : 工具函数
repository: 仓库放置所有存储
repository/cache: 放置redis缓存
repository/db: 持久层MySQL仓库
repository/db/dao: 对db进行操作的dao层
repository/db/model: 定义所有持久层数据库表结构的model层
routes : 路由逻辑处理
service : 接口函数的实现
types : 放置所有的定义的结构体

配置文件

配置文件在conf/config.ini.example中，把.example去掉，然后根据自己的情况配置就好了

conf/config.ini

# debug开发模式,release生产模式
[service]
AppMode = debug
HttpPort = :3000
# 运行端口号 3000端口

[redis]
RedisDb = redis
RedisAddr = 
# redis ip地址和端口号
RedisPw = 
# redis 密码
RedisDbName = 2
# redis 名字

[mysql]
Db = mysql
DbHost =
# mysql ip地址
DbPort = 
# mysql 端口号
DbUser = 
# mysql 用户名
DbPassWord = 
# mysql 密码
DbName = 
# mysql 名字

简要说明

mysql是存储主要数据
redis用来存储备忘录的浏览次数

CocaineCong/TodoList