diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9c2da7b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,136 @@
+# bookstore
+[![Build Status](https://travis-ci.com/DaSE-DBMS/bookstore.svg?branch=master)](https://travis-ci.com/DaSE-DBMS/bookstore)
+[![codecov](https://codecov.io/gh/DaSE-DBMS/bookstore/branch/master/graph/badge.svg)](https://codecov.io/gh/DaSE-DBMS/bookstore)
+
+## 功能
+实现一个提供网上购书功能的网站后端。
+网站支持书商在上面开商店,购买者可能通过网站购买。
+买家和卖家都可以注册自己的账号。
+一个卖家可以开一个或多个网上商店,
+买家可以为自已的账户充值,在任意商店购买图书。
+支持下单->付款->发货->收货,流程。
+
+1.实现对应接口的功能,见doc下面的.md文件描述 (60%分数)
+
+其中包括:
+
+1)用户权限接口,如注册、登录、登出、注销
+
+2)买家用户接口,如充值、下单、付款
+
+3)卖家用户接口,如创建店铺、填加书籍信息及描述、增加库存
+通过对应的功能测试,所有test case都pass
+测试下单及付款两个接口的性能(最好分离负载生成和后端),测出支持的每分钟交易数,延迟等
+
+2.为项目添加其它功能 :(40%分数)
+
+1)实现后续的流程
+发货 -> 收货
+
+2)搜索图书
+用户可以通过关键字搜索,参数化的搜索方式;
+如搜索范围包括,题目,标签,目录,内容;全站搜索或是当前店铺搜索。
+如果显示结果较大,需要分页
+(使用全文索引优化查找)
+
+3)订单状态,订单查询和取消定单
+用户可以查自已的历史订单,用户也可以取消订单。
+取消定单(可选项,加分 +5~10),买家主动地取消定单,如果买家下单经过一段时间超时后,如果买家未付款,定单也会自动取消。
+
+## 要求
+1.可以扩展.md中的接口,但不要修改(字段可以多,不可以减少或修改参数名,减分项 -2\~5分),也不要修改test case(减分项 -2\~5分)。
+测试程序如果有问题可以提bug (加分项,每提1个bug +2, 提1个pull request +5)。
+
+2.核心数据使用关系型数据库(PostgreSQL或MySQL数据库)。
+blob数据(如图片和大段的文字描述)可以分离出来存其它NoSQL数据库或文件系统。
+
+3.对所有的接口都要写test case,通过测试并计算代码覆盖率(有较高的覆盖率是加分项 +2~5)。
+
+4.尽量使用正确的软件工程方法及工具,如,版本控制,测试驱动开发 (利用版本控制是加分项 +2~5)
+
+5.后端使用技术,实现语言不限;不要复制这个项目上的后端代码(不是正确的实践, 减分项 -2~5)
+
+6.不需要实现页面
+
+7.最后评估分数时考虑以下要素:
+1)实现完整度,全部测试通过,效率合理
+2)正确地使用数据库和设计分析工具,ER图,从ER图导出关系模式,规范化,事务处理,索引等
+3)其它...
+
+8.3个人一组,做好分工,量化每个人的贡献度
+
+
+
+## 项目目录结构
+```
+bookstore
+ |-- be mock的后端
+ |-- model
+ |-- view
+ |-- ....
+ |-- doc JSON API规范说明
+ |-- fe 前端代码
+ |-- access
+ |-- bench 效率测试
+ |-- data
+ |-- book.db sqlite 数据库(book.db,较少量的测试数据)
+ |-- book_lx.db sqlite 数据库(book_lx.db, 较大量的测试数据,要从网盘下载)
+ |-- scraper.py 从豆瓣爬取的图书信息数据
+ |-- test 功能性测试(不要修改这里的文件,可以提pull request或bug)
+ |-- conf.py 测试参数,修改这个文件以适应自己的需要
+ |-- conftest.py pytest初始化配置,修改这个文件以适应自己的需要
+ |-- ....
+ |-- ....
+```
+
+### 安装配置
+安装python (需要python3.6以上)
+
+安装依赖
+
+ pip install -r requirements.txt
+
+
+执行测试
+
+ bash script/test.sh
+
+
+ bookstore/fe/data/book.db中包含测试的数据,从豆瓣网抓取的图书信息,
+ 其DDL为:
+
+ create table book
+ (
+ id TEXT primary key,
+ title TEXT,
+ author TEXT,
+ publisher TEXT,
+ original_title TEXT,
+ translator TEXT,
+ pub_year TEXT,
+ pages INTEGER,
+ price INTEGER,
+ currency_unit TEXT,
+ binding TEXT,
+ isbn TEXT,
+ author_intro TEXT,
+ book_intro text,
+ content TEXT,
+ tags TEXT,
+ picture BLOB
+ );
+
+
+更多的数据可以从网盘下载,下载地址为,链接:
+
+ https://pan.baidu.com/s/1bjCOW8Z5N_ClcqU54Pdt8g
+
+提取码:
+
+ hj6q
+
+这份数据同bookstore/fe/data/book.db的schema相同,但是有更多的数据(约3.5GB, 40000+行)
+
+
+
+