数据库作业:
语言
JavaScript,HTML,C++
数据库:
MySQL
===================
数据库表设计
===================
表前缀: bs_
用户表(bs_user)
登录账号 varchar 主键
登录密码 varchar (hashed)
昵称 varchar
用户级别 integer (0 超级管理员 1 管理员 2 图书馆借阅处 3 读者)
3级用户必须有对应的用户信息!
账户状态 integer (0 隐藏 1 禁止登陆 2 需要验证才能激活 3 允许登陆)
隐藏状态: 以该登陆账号登陆时会提示账户不存在,但注册时会提示不能不注册
禁止登陆: 以该登陆账号登陆时会提示账户已被禁用
待验证: 刚注册完的用户需要经过验证,登陆时会提示待验证. 验证后状态变为3
允许登陆: 一切正常
级别表(bs_level)
等级 integer 主键
默认最低借阅限额 integer
默认最高借阅限额 integer
默认最低借阅时间 integer
默认最高借阅时间 integer
可接受的最小余额额度 money
读者表(bs_reader)
登录账号 外键到bs_user
姓名 varchar
身份证号 varchar
联系电话 varchar
等级 integer (触发器->升级->改变限额等信息) 外键到bs_level
成长值(经验值) integer (签到送经验值等等)
借阅限额 integer (可以与级别表中的默认值不一致,但升级时会受到影响进而重新评估)
已使用借阅额度 integer 冗余
借阅时间限额 integer (天)
积分 integer (签到,奖励,活动)
余额 money
图书类别表(bs_booktype)
类别名称 varchar 主键
图书表(bs_book)
图书定义序号 varchar 主键 (考虑到有些书没有ISBN号)
ISBN号 varchar 主键
名称 varchar
类别 外键到bs_booktype
作者 varchar
出版社 varchar
出版日期 date
状态 integer (0 隐藏 1 禁用 2 正常)
隐藏: 不在图书搜索中显示这本书的信息
禁用: 禁止借阅这本书
图书状态表(bs_bookstatus)
图书实体序号 varchar 主键 (一本书可能在图书馆里有多本藏书)
图书类别序号 外键到bs_book
位置 varchar (用来提示图书所在位置)
状态 integer (0 借出 1 丢失 2 在馆)
借出: 书籍已借出,可以在bs_borrow中查找到
丢失: 书籍已丢失,且无法从其他表中查找到有关信息.(用于报告丢失)
在馆: 书籍在馆,可以借出
借阅关系表(bs_borrow)
借阅者账号 外键到bs_user
图书实体序号 外键到bs_bookstatus
借阅日期 date
最迟还书日期 date (即使用户在借阅图书后升级,这个日期也不会改动. 此日期是在借阅书籍的时候计算的)
还书日期 date 可以为空 (如果没还书就是null,否则表示书已归还,此条数据留存为历史数据)
===================
特性设计
===================
5分钟安装(在线安装,类似Wordpress Install)
超级管理员账号 可以修改所有账户的密码,此账户只能有一个,可以添加管理员账号,其他功能同管理员账号
管理员账号 可以修改自己和所有普通用户的密码,添加/修改图书类别表,其他功能同图书馆借阅处账号
图书馆借阅处账号 可以修改自己的密码,添加/修改借阅关系表
===================
具体设计
===================
5分钟安装需要的信息:
数据库服务器地址 dbaddr
数据库端口 dbport
数据库账户 dbuser
数据库口令 dbpass
数据库名称 dbname
超级管理员口令 supass (超级管理员账户锁定为root)
新建账号:
session
增删改查 : 图书类别,图书,账户
http://booksys.com/api/v1/install POST
POST:
dbaddr,dbport,dbuser,dbpass,dbname,supass
http://booksys.com/api/v1/search?type=...&name=... GET
GET:
type= 0 用户 1 书籍
name= 用户名,书籍名称
typename= 书籍种类名称,仅当type为1时有效
http://booksys.com/api/v1/explore GET
GET:
没有参数
http://booksys.com/api/v1/addbook POST
POST:
(图书定义序号自动生成)
isbn
bookname
booktype
author
publisher
pubdate
status
http://booksys.com/api/v1/editbook POST
POST:
book_key (唯一图书定义序号)
isbn
bookname
booktype
author
publisher
pubdate
status
http://booksys.com/api/v1/removebook POST
POST:
book_key (唯一图书定义序号)
错误:
当图书的任一实体处于借出状态时将不能删除图书定义.
http://booksys.com/api/v1/addbooktype POST
POST:
booktype
错误:
当新的类型名称发生冲突
http://booksys.com/api/v1/editbooktype POST
POST:
booktype_old
booktype_new
错误:
当新的类型名称发生冲突
副作用:
改变图书种类会引起所有与原种类相关图书的信息变更
http://booksys.com/api/v1/removebooktype POST
POST:
booktype
错误:
当任一图书定义使用此定义时将不能删除图书种类
http://booksys.com/api/v1/register POST
POST:
account
pass
nickname
提示:通过此API注册的用户等级锁定为3. 且注册后账户处于状态2
错误:
账户名称重复时
http://booksys.com/api/v1/enableuser POST
POST:
account
realname
realid
realphone
提示:通过此API激活的用户等级必须为3.(更高等级的用户不需要经此激活) 激活后账户状态将自动变更为3.
错误:
内容填充错误或禁止激活.
http://booksys.com/api/v1/login POST
POST:
account
pass
提示:通过此API可登陆的用户等级为0,1,2,3,账户状态为3才能登陆成功,账户状态为2时返回提示信息前往激活,账户状态为1时返回禁止登陆,账户状态为0时返回需要联系管理员激活信息.
错误:
账户或密码错误(包括账户错误)
返回:
当登陆成功时返回一个apikey用于调用以上的API. 此key在一段时间内有效.
http://booksys.com/api/v1/logout POST
POST:
apikey
提示:退出登陆. 会立刻注销此apikey