Skip to content

Latest commit

 

History

History
194 lines (145 loc) · 8.32 KB

README.md

File metadata and controls

194 lines (145 loc) · 8.32 KB
Raw

FruitSMSDemo

a demo for fruit sales management system

部署

  1. 填写jdbc.properties中c3p0.password=，注意不要commit这个密码
  2. 注释或删除jdbc.properties中#local c3p0的相关配置
  3. 替换war包的jdbc.properties，或者直接mvn clean package -Dmaven.test.skip=true

Requirement

  • fruitMonth:水果上架的月份
  • maxOrderDay:可以触发下单（主单）操作的最晚日期，限制为当月的某号，如25号
  • maxProvNum:此批次水果最大可提供份数（水果都是按份数计算） - 暂时不对此做限制
  • maxOrderNum:一单（主单）最多可以下几份，如2份，
  • 注意：主单一个月对一个水果只可以下一份 - 需要确认需求

Coding Progress

Plan:

new feature

  1. 管理员设计 - 20170322
  2. 首页及菜单设计 - 20170324
  3. Jqrid加载数据及显示 - 20170324
  4. 菜单切换功能模块设计 - 20170324
  5. 管理员日志设计 - 20170323
  6. 登录接口设计 - 20170323
  7. 验证码及系统权限控制 - 20170323
  8. 订单状态设计 - 20170322
  9. 实现前端全部的增删改的设计和coding, 使用orderstatus为范例 - 20170327
  10. 统一全部前端jqgrid, jquery-ui 入口到index.js - 20170328
  11. 完成公共参数, 用户管理, 登录日志, 订单状态的全部前台后台工作 - 20170328
  12. add paging function from server part - 20170329
  13. add ASSIGN function from back-end and front-end - 20170329
  14. add ASSIGN_DETAIL function from back-end and front-end - 20170329
  15. add jquery-ui datepicker and jQuery-Timepicker-Addon for pick up date and time - 20170329
  16. add api of phone register - 20170405
  17. add api of order - 20170405
  18. add api of validate phone - 20170405
  19. add api for user cancle order - 20170406
  20. add auth validation for integration api - 20170406
  21. add Spring AOP for log
  22. slavePhone有条件性编辑来保持系统逻辑简单 - 20170406
  23. add api of validate wechatOpenId - 20170406
  24. add quick operation for changing order status - 20170406
  25. 增加查看功能，多列信息是方便查看 - 20170407
  26. 增加order页面的条件搜索功能 - 20170407(updated project screenshot)
  27. 增加assgin页面的条件搜索功能 - 20170407
  28. 增加assigndetail页面的条件搜索功能 - 20170407
  29. 增加fruit config页面的条件搜索功能 - 20170407
  30. 增加公共参数：默认收礼人建立时的默认有效期为3年 及相关逻辑 -20170408
  31. 增加前端新建和修改时的必填字段校验及提示信息 -20170408
  32. 备注改为非必填字段，后台判断是否为空，为空时置为默认备注 -20170408
  33. 修改jqgrid显示如激活、虚拟号、订单状态为真实字面意义，隐藏原来关联的id -20170408
  34. 增加AOP注解方式输出系统日志 -20170408
  35. 更新页面的显示信息，更为正式和商业 -20170409
  36. 增加逻辑：保存水果配置时，最大可定数量小于已存在的订单 -20170409
  37. 自动保存微信端下单时的地址信息，关联到openId - 20170410
  38. 收礼人下单时提供列表，并提供删除功能相关接口 - 20170410
  39. 订单管理页面支持收礼人姓名和收礼人手机号查询功能 - 20170410
  40. 使用c3p0数据库连接池代替DBCP，解决新浪SAE数据库默认设置max_wait=10s导致connection关闭却仍然存在pool里，引发的查询失效问题。 - 20170411
  41. 增加部署说明 - 20170411
  42. 暂时允许第三方跨域请求微信API controller: @CrossOrigin(origins = "*") or mvc:cors - 20170411
  43. 增加微信查询水果列表接口 - 20170412
  44. 增加微信查询当前月份水果列表接口 - 20170413
  45. 后台水果配置页面增加显示当前月份水果功能 - 20170414
  46. 微信接口增加一单多水果的功能 - 20170413
  47. 后台准备设计方法，显示一单多水果功能的展示 - 20170415
  48. 双击订单显示订单详细 - 20170415
  49. 格式化和标准化订单查询信息 - 20170420
  50. 增加短信调用接口，调用微信端的接口在用户获得分配水果时接收提醒短信 - 20170424
  51. 增加查询最大可订单日的微信端接口 - 20170426
  52. 简化页面格式选择，只显示yyyy-MM-dd(只保留登录日志精确到时分秒) - 20170427
  53. 新增defaultAddr字段，用于标识用户的默认地址，用于自动填充 - 20170427
  54. 新增控件用于数量的操作，防止不当操作。支持设置初始值，最小最大值 - 20170428
  55. 更新下单接口，支持参数是否将此单地址设为默认地址，兼容之前设计的下单接口 - 20170430
  56. 新增接口 统计当月用户已经下的订单数量（待派送的订单数量） - 20170430
  57. 根据讨论，删除水果设置上的最大订单日限制 - 20170502
  58. 删除slider控制数字，在前端页面使用js写死逻辑强制校验数字，010000、-1000010000 - 20170502
  59. 更新最大可在途订单量接口，返回当前用于当月的在途订单和公共参数配置的单数 - 20170503
  60. 更新计划送达时间（+7days of create day），送达时间，完成时间（状态扭转前不显示，扭转成功后显示当前时间）- 20170503
  61. move API related docs to wiki - 20170509
  62. 订单在后台点击派送中后，在前台查询的订单派送日期为1970-1-1，看起来是放的一个默认值，这个值应该是放成当时点击派送中时的系统日期 - 20170605
  63. 订单的默认备注如果不增加的话会自动增加一个default_remark, 默认设为空 - 20170605

bug fix

  1. assign page cannot use view function - 20170407
  2. user order missing verify of public config of max_order_day_to - 20170407
  3. fix user order and save common address, should getNextId for entity to save - 20170410
  4. user login record save date time(db) but query/list without HH:mm:ss - 20170411
  5. fix jquery ajax with CORS issue - 20170412
  6. fix bug of cannot query order from wechat - 20170420
  7. fix bug that user can cancel canceled orders - 20170427
  8. fix bug of getCurrentMonthWaitForOrderNums - 20170504
  9. fix bug of save same address with order set default address - 20170509

function design

  • Jqgrid调用同一增删改接口 js和前端控制研究和设计 - done #10
  • 管理退出登录控制及session设置 - done #11
  • ASSIGN设计 - done #14
  • ASSIGN DETAIL设计 - done #14
  • ORDER设计 - done #13
  • 系统参数设计 - done #11
  • 暂时未设计翻页操作，全部使用loadonce=ture设计，后期改进 - done #12
  • setup new ORDER, how to desgin UI and get data from ASSIGN - done

微信第三方接口的安全性设计

安全设计

微信API

接口在wiki

Assign

后台

  • 不允许add/update/delete

前台

  • 提供接口提供手机号码状态查询 - done
  • 激活号码时更新status - done
  • 下订单时减少unit - done
  • 取消订单时增加unit - done

AssignDetail - 后台管理人员控制源数据

后台

  • 允许add - done
  • 不允许delete，写错数量时允许unit填负值进行对冲 -done
  • 允许有条件的编辑：
    • 不允许编辑unit，只允许新建正值增加或者新建负值对冲 -done
    • slavePhone允许编辑，新建是为真实，编辑时仍为真实，不允许修改为虚拟 - done
    • 新建时虚拟，编辑时强制虚拟号码改为真实号码 - done
    • isVirtual不允许编辑，新建时时真号码，一直是真实；新建时是虚拟，第一次编辑置强制置为真实并且不允许改动
  • 所有的改动只允许按规定流程顺序执行，不能错乱或者回退信息流

前台

Order - 前台消费数据控制

后台

  • 不允许add/edit/delete
  • 不允许更新订单 - 后台管理不负责更新订单的信息，全部由前台来操作
  • 提供两个按钮，支持批量选择，支持status更改'待派送' -> '派送中' -> '派送成功' - done
  • 订单状态参数的新建和修改不开放 - done

前台

  • 提供必要的接口参数，给前台下订单使用(add接口) - done
  • 支持前台订单的取消（地址等信息错误重新下单） - done

Demo Show

page with quick operation & criteria search

Alt text

common page

Alt text

Design API

Wait...

Design DB

初始化脚本见项目目录

Design Overall

Business requirements