index.adoc 3.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. = 软件优雅设计与开发最佳实践 =
  2. =====
  3. :Shoulder: Specifications
  4. :Author: lym
  5. :Email: <cn_lym@foxmail.com>
  6. :Date: 2020
  7. :Revision: 1.0
  8. :doctype: book
  9. :revdate: {docdate}
  10. :sectanchors:
  11. :xrefstyle: full
  12. :anchor:
  13. :toc: left
  14. :toclevels: 3
  15. :sectnumlevels: 5
  16. == 简介
  17. 分享软件系统设计、开发中一些利于项目维护、安全和快速落地的 *最佳实践准则* 。
  18. [TIP]
  19. ====
  20. 这些规范中给出了良好的实践方案,但不要为了规范而规范,盲目地做太多苛刻格式限制而偏离了规范意义的本质。
  21. 规范本是为了更好的解决问题而定义的,在不同场景下的最佳实践方案可能会有变化,要根据实际情况指定规范。
  22. ====
  23. 规范部分不针对特定语言,但为了帮助规范更容易地落地,推荐开发脚手架,便于快速开发, <<shoulder-framework, 这里实现了Java 的框架 shoulder-framework>> 。
  24. [TIP]
  25. ====
  26. - **Shoulder** 并未与该规范完全绑定,而是实现功能性的接口,以扩展形式作为默认实现。
  27. - **Shoulder** 允许使用者二次开发,制定自己团队的规范,通过简单地对 **Shoulder** 扩展即可实现自己的规范与丰富的功能。
  28. ====
  29. === 开发
  30. ==== link:specs/base/basic.html[基本]
  31. ==== link:specs/base/log.html[日志]
  32. ==== link:specs/base/errorCode.html[错误码]
  33. ==== link:specs/base/api.html[接口开发]
  34. ==== link:specs/base/cache.html[缓存]
  35. ==== link:specs/base/communication.html[服务通信]
  36. ==== link:specs/base/notify.html[消息通知]
  37. ==== link:specs/base/i18n.html[国际化]
  38. === 安全
  39. ==== link:specs/security/security.html[数据保护与安全原则]
  40. ==== link:specs/security/crypto.html[加密方案与应用]
  41. ==== link:specs/security/auth.html[认证授权]
  42. ==== link:specs/security/negotiate.html[密钥协商]
  43. === 发布、部署、升级
  44. ==== link:specs/devOps/cicd.html[持续集成]
  45. ==== link:specs/devOps/cloud-artifact.html[系统架构]
  46. ==== link:specs/devOps/monitor.html[状态监控与告警]
  47. ==== link:specs/devOps/deployAndUpgrade.html[部署与升级]
  48. === 管理
  49. ==== link:specs/manager/directory.html[发布软件目录结构]
  50. ==== link:specs/manager/package.html[Java 工程目录结构推荐]
  51. === 常用技术
  52. ==== link:specs/technology/java.html[Java 编码规范]
  53. ==== link:specs/technology/javaScript.html[JavaScript 编码规范]
  54. ==== link:specs/technology/python.html[Python 编码规范]
  55. ==== link:specs/technology/go.html[Go 编码规范]
  56. ==== link:specs/technology/db.html[数据库 实践手册]
  57. ==== link:specs/technology/es.html[ElasticSearch 实践手册]
  58. == 网站运营
  59. ==== link:seo/seo.html[SEO]
  60. == IDEA
  61. ==== link:blog/idea/plugins.html[IDEA-Plugins]
  62. == 实践与落地(开源框架)
  63. 规范定义了一些要求,应用实践起来必然存在大量重复代码,为了将这些规范优雅快速落地,提升开发效率,特编写可复用的软件开发框架来实现,*同样开源!*。
  64. === shoulder-framework
  65. ==== *link:https://gitee.com/ChinaLym/shoulder-framework[gitee]*
  66. ==== *link:https://gitee.com/ChinaLym/shoulder-framework[github]*
  67. 欢迎补充完善。
  68. == 附录
  69. ==== link:ref/technologies.html[技术名词解析]
  70. ==== link:ref/port.html[IANA 持有端口列表]
  71. ==== link:ref/aes.html[AES介绍]