diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 00000000..5b1288af --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,46 @@ +## 更新日志 + +### V 0.4.0 + +*2018-04-21*,项目结构调整,增加了两个模块 + + * `小商场`的后台服务代码添加注释,校验输入参数 + * `小商场`商品无货时显示“商品已售空” + * `管理后台`支持管理员同一账户多终端登录,方便演示 + * `管理后台`专题内容支持富文本编辑 + * `基础系统`litemall-os-api的链接从`storage/index/index`调整至`os/index/index` + * `基础系统`litemall-os-api支持浏览器显示。 + * `基础系统`新增litemall-core模块,综合了litemall-os-api、litemall-wx-api + 和litemall-admin-api的共性代码 + * `基础系统`新增litemall-all模块作为包裹模块,支持三个后台服务和静态文件 + 打包成一个war项目包 + +### V 0.3.0 + +*2018-04-07*,业务模块从物理删除调整成逻辑删除 + +* `小商场`的后台服务加密用户账号密码 +* `小商场`如果用户选择货品,则显示货品对应的价格;否则显示商品价格 +* `小商场`只有规格都选择,则商品页面才显示所对应货品的规格文本 +* `管理后台`商品详细信息支持tinymce富文本编辑 +* `管理后台`的后台服务加密管理员密码 +* `管理后台`完善登录退出逻辑 +* `基础系统`数据库中除regions几个表,其他所有表都添加`add_time`和`deleted`字段 +* `基础系统`litemall-db模块不支持数据物理删除,删除则设置`deleted`,而查询则过滤`deleted` + +### V 0.2.0 + +*2018-04-02*,修复一些小商场出现的问题。 + +* `小商场`微信登录 +* `小商场`账号登录、注册、找回密码 + (注意手机验证码不支持,因此目前只是完成基本功能,但是存在安全风险) +* `小商场`订单编号采用日期+6位随机数 +* `小商场`简单运费计算 +* `小商场`专题评价 +* `管理后台`禁止管理员修改超级管理员信息 +* `基础系统`自动脚本util/lazy.sh和util/upload.sh + +### V 0.1.0 + +*2018-03-24*, 项目架构基本完成。 \ No newline at end of file diff --git a/CONTRIBUTE.md b/CONTRIBUTE.md new file mode 100644 index 00000000..fe0ce3bc --- /dev/null +++ b/CONTRIBUTE.md @@ -0,0 +1,95 @@ +## 贡献 + +任何形式的贡献都欢迎,包括: + +* Issue里面报告的BUG +* Issue里面对业务或技术的讨论 +* Pull Request +* 对文档的意见或补充 +* 其他任何有意义本项目的行为 + +个人能力有限,欢迎一起开发。 + +目前项目基本框架已经建立,但是还不完整,因此非常欢迎人一起讨论技术和业务。 +但是交流合作之前,请查看以下碎碎念。 + +### 项目理念 + +litemall的设计受众是小微型企业,而不是互联网企业,因此litemall的开发理念是一个小而美: + +* 小,指的是技术简单、架构简单、性能指标低、业务仅覆盖基本功能 +* 美,指的是技术新、架构清晰易扩展、安全系数不低、业务可直接部署使用 + +正是因为以上考虑,目前litemall的架构是简单的,三种技术栈都是最基本的。 + +虽然这么说,但是实际上开发的入门门槛不低: +* 项目采用了三种技术栈,相互之间是相对独立的; +* 采用的spring boot框架和vue-element-admin框架已经依赖相当多的库; +* 除了开发技术,开发过程中也会涉及其他技术,包括环境配置、版本控制、 + 测试技术、日志、部署等等。 + +因此贡献新的代码或讨论业务前,建议考虑以下问题: + +* 是否引入过多的复杂性,而没有带来相应的收益? + + 因为本项目希望能够为更多的人所学习使用,项目的复杂性是需要考虑的问题。 + 如果是复杂性和收益是相同的,那么接收贡献的可能性其实值得讨论。 + +* 是否依赖过多的库?是否必须依赖该库?如果仅仅是该库的微小部分,是否可以自己实现一个简单的util类? + + 例如,一些技术框架采用了fastjson,而实际上spring boot已经默认采用jackson,因此如果没有特殊原因, + 贡献者应该尽可能采用jackson。 + +* 是否盲目地采用过多过先进的技术?是否可以暂缓采用? + + 这里是谨慎的。例如,如果要引入缓存技术,则需要去学习缓存相关的类库,以及可能会遇到一些使用中存在的问题。 + 而v2.0.0之前其实没有必要提前考虑性能问题。同样地,单点登录技术是分布式架构中必须存在的基本功能,但是 + 目前两个后台服务分别采用各自登录方案即可。 + + 注意: + > 这里并不是拒绝新技术,而是希望采取一个渐进式的谨慎的态度。 + > 此外,对于新技术运用,其实规划是基于本项目稳定版本再开发一个独立的分布式版本。 + +* 已经有了一个技术,是否有必要贡献相同目的的另外一种技术? + + 这里是欢迎的。例如,已经有了vue框架的管理后台,但是采用其他前端框架的管理后台也是欢迎的。 + 这样可以给不同技术背景的用户所选择。当然,应该尽量保持不同版本之间的同步。又或者,小程序 + 已经有了一些开发框架,而目前小商场的小程序端仍然是原始的小程序技术,因此基于这些新的开发框架 + 来重构小程序端是欢迎的。 + + 也就是说本项目希望避免技术深度,而倾向于技术宽度,帮助自己以及更多的人学习了解不同的技术。 + +* 贡献代码量不大,或者改善文档。 + + 这里是欢迎的。很多开源项目都建议贡献代码时应该少量并且逻辑分明。这样审阅代码时才能明确。 + 当然,如果是单词拼写不对之类,那么应该尽可能在一次commit中修复同样的问题。 + +虽然这里可能表现出对新技术的谨慎态度,但是如果用户发现有更好的技术或者有必要,欢迎讨论。 +当然,如果开发者不认同这里的一些理念,也可以基于自己的技术选型来开发自己的版本。 +如果认为自己开发的好,可以在本项目提交链接地址,让其他开发者了解。 + +### 项目业务 + +本项目所设想的基本业务功能已经在文档中列举完成。 + +如果希望引入高级功能,例如分销功能等,建议用户在本项目基础上自行开发。 + +如果认为有基本业务没有实现,可以Issue或者QQ群讨论,加入后续开发计划。 + +当然更希望开发者直接提供代码,丰富完善目前的基础业务功能。 + +### 代码贡献 + +* 代码规范目前没有严格要求,后续会补充。 + +### Issue规范 + +* 在提交issue之前,请搜索是否存在相关问题。 +* 提交的Issue请尽可能给出详细信息 +* 建议Issue基于最新的代码 + +### QQ群提问 + +不建议开发者在QQ群讨论遇到的Bug或者问题,而是应该在Issue中提交。 + +当然,如果仍然坚持,那么请先看看[提问的智慧](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/master/README-zh_CN.md) \ No newline at end of file diff --git a/README.md b/README.md index 8dad64ba..c49211aa 100644 --- a/README.md +++ b/README.md @@ -107,6 +107,8 @@ litemall 5. [商场子系统](doc/5.md) 6. [下一步计划](doc/6.md) +文档内容采用 [署名-禁止演绎 4.0 国际协议许可](https://creativecommons.org/licenses/by-nd/4.0/deed.zh) + 开发计划 ==== @@ -126,7 +128,7 @@ V 3.0.0 完成以下目标: 1. 管理后台一些辅助功能 2. 后台服务加强安全功能、配置功能 3. 项目代码重构和清理 -4. 其他配套服务,如代码文档、war部署支持 +4. 其他配套服务,如代码文档 项目结束,已经是一个真正可工作的项目,此时进入维护阶段。 @@ -139,39 +141,12 @@ V 3.0.0 完成以下目标: > ** 以上仅仅是个人规划的开发计划,实际可能出现任何情况,例如能力有限而放弃开发。** 开发进度更新 -== +====== + +查看[更新日志](CHANGELOG.md) + +目前V0.4.0 -* V 0.1.0,项目架构基本完成。 -* V 0.2.0,修复一些小商场出现的问题。 - * `小商场`微信登录 - * `小商场`账号登录、注册、找回密码 - (注意手机验证码不支持,因此目前只是完成基本功能,但是存在安全风险) - * `小商场`订单编号采用日期+6位随机数 - * `小商场`简单运费计算 - * `小商场`专题评价 - * `管理后台`禁止管理员修改超级管理员信息 - * `基础系统`自动脚本util/lazy.sh和util/upload.sh -* V 0.3.0, - * `小商场`的后台服务加密用户账号密码 - * `小商场`如果用户选择货品,则显示货品对应的价格;否则显示商品价格 - * `小商场`只有规格都选择,则商品页面才显示所对应货品的规格文本 - * `管理后台`商品详细信息支持tinymce富文本编辑 - * `管理后台`的后台服务加密管理员密码 - * `管理后台`完善登录退出逻辑 - * `基础系统`数据库中除regions几个表,其他所有表都添加`add_time`和`deleted`字段 - * `基础系统`litemall-db模块不支持数据物理删除,删除则设置`deleted`,而查询则过滤`deleted` -* V 0.4.0, 项目结构调整,增加了两个模块 - * `小商场`的后台服务代码添加注释,校验输入参数 - * `小商场`商品无货时显示“商品已售空” - * `管理后台`支持管理员同一账户多终端登录,方便演示 - * `管理后台`专题内容支持富文本编辑 - * `基础系统`litemall-os-api的链接从`storage/index/index`调整至`os/index/index` - * `基础系统`litemall-os-api支持浏览器显示。 - * `基础系统`新增litemall-core模块,综合了litemall-os-api、litemall-wx-api - 和litemall-admin-api的共性代码 - * `基础系统`新增litemall-all模块作为包裹模块,支持三个后台服务和静态文件 - 打包成一个war项目包 - 警告 == @@ -180,7 +155,6 @@ V 3.0.0 完成以下目标: > 3. 项目代码目前还不完善,仍处在开发中 > 4. 项目开源(MIT),但不承担任何使用后果 - 致谢 == @@ -201,26 +175,16 @@ V 3.0.0 完成以下目标: 开发者有问题或者好的建议可以用Issues反馈交流,请给出详细信息,本人会尽可能解决。 * 如果问题是共性问题(如代码bug或文档不全),本人会及时解决。 * 如果问题是个人问题(如开发者了解不深入或者没有相关技术),请见谅(本人也是百度和谷歌)。 + * 请教问题, 贡献 == -任何形式的贡献都欢迎,包括: - -* Issue里面报告的BUG -* Issue里面对业务或技术的讨论 -* Pull Request -* 对文档的意见或补充 -* 其他任何有意义本项目的行为 - -个人能力有限,欢迎一起开发。 - -目前litemall开发交流群: +任何形式的贡献都欢迎,查看[贡献指南](CONTRIBUTE.md) ![](doc/pic/qq.png) 注意: -> * 这是开发交流群。 > * 如果开发者开发使用中有问题,建议采用Issue来报告问题和解决问题。 > * 在开发交流群中应讨论开发、业务和合作问题。 > * 交流结果如果是共识性的则在文档中记录,如果是开放性的则会在Issue中记录。 \ No newline at end of file