九山 il y a 3 ans
Parent
commit
46e0f05647
2 fichiers modifiés avec 151 ajouts et 93 suppressions
  1. 72 12
      README.md
  2. 79 81
      package-lock.json

+ 72 - 12
README.md

@@ -1,19 +1,79 @@
-# sis_web
+#项目框架基础:
+vue 脚手架4.5.12搭建vue2项目
+#基础组件:
+vue 2.6.11+ElementUI2.15.1+axios0.21.1+router3.2.0
+#公共组件:
+	Echarts5.0.2
+	Excel:xlsx0.16.9
+	等
 
-## Project setup
-```
-npm install
-```
 
-### Compiles and hot-reloads for development
-```
-npm run serve
+#规范:
+1.	目录结构说明:
+Api:根据需求封装的请求,公共类型,不要随意修改。
+Assets:公共资源,包括图片,css文件,js文件,字体库等。
+Components:公共组件,根据项目需要,如果有重复可多次使用的相同或相似的功能,分装为组件,方便重复使用。
+Router:index.js主路由和子路由,所有前端会分配子路由。
+Store:vuex,按需使用。
+Tools:公共JS方法,如日期格式化等。通过全局变量this.BASE.使用公用的方法。如有新的需求,可以自行添加,注释一定要详细明了。
+Views:所有页面。
+2.	Vue文件分割开,html写在vue文件中,js写在assets/js/模块名称/*.js,Scss文件写在assets/css/模块名称/*.js
+Vue文件引入方式:
 ```
+<script>
+  import main from '../assets/js/main'
+  export default main
+</script>
 
-### Compiles and minifies for production
+<style lang="sass" scoped>
+  @import "../assets/css/main.less";
+</style>
+```
+3.	文件起名按照驼峰法命名,包括文件夹名称、文件名称、变量名称、函数名称等,尽量使用准确的英文单词命名,减少拼音使用次数。
+4.	引用使用尽量使用如下格式引用:
 ```
-npm run build
+.set('@', resolve('src'))
+.set('@assets', resolve('src/assets'))
+.set('@components', resolve('src/components'))
+.set('@views', resolve('src/views'))
+.set('@store', resolve('src/store'));
 ```
+例如:@import "../assets/css/main.less";改成@import "@assets/css/main.less";
+5.	Sass语法按照官方语法写,树级结构,使用class样式,不要使用id样式。
+6.	代码缩进,统一为2。设置方式:文件-首选项-设置,搜索tabsize。严格按照2的缩进编写代码,提高代码美观程度。
+7.	代码注释,方法用途(方法的输入、输出注释),关键代码注释。
+8.	代码自我优化,js,css代码自行优化,用最短得代码,高效完成功能和效果。
+9.	资源优化,图片资源,优化后再放入项目中,选择正确的资源放置位置。
+10.	防止死循环。
+11.	自己的功能做完后需要自测。
+
+12.	接口访问,统一封装,统一通过this.API.get(url, 参数)
+13.	针对请求超过1s的接口,必须进行loading加载中提示。
+14.	防抖动。
+15.	控制台零报错,见到错误第一时间解决。
+
+16.	引入新的组件,前端成员共同商讨,选择合适、轻量、简单易上手的组件。
+17.	组件引入后,如果无用请卸载。
+18.	遇到技术难点,攻克时不要一把抓,什么都粘进来,弄明白每一行的用途,并注释。
+19.	后台提供可阅读的接口文档,包括接口地址、请求类型、请求参数、返回数据注释用途等。
+20.	与后台约定所有请求的基本头类型,推荐application/json,或约定一个其他类型的。
+21.	与后台约定数据格式,请求格式、返回数据的格式,code统一使用200int型。
+22.	与后台约定,message提示内容由后台编写,所有code !==200的自动显示message内容。
+23.	Git代码统一管理,没有账号就先借用一下使用。有账号的按照自己的账号编写代码。
+每天提交一次代码,如单个功能未开发完成可以在完成后提交。每周提交一次代码。
+代码编写规范:先拉取最新代码-创建本地分支-开发-提交-合并分支-本地验证无误、无冲突可以push。
+Git使用教程:https://www.liaoxuefeng.com/wiki/896043488029600/900003767775424
+
+
+#本次改动目标:
+1.	全面完成前后端分离,完成解耦。
+2.	统一项目全局的常用文字的字体、字号、字色。
+3.	基于ElementUI开发,需统一使用其按钮、表格、表单等,形成风格统一。
+4.	提升报表Echarts,按照最新的API实现所有报表。
+5.	地图建议设计更好看的地图图片,或更换百度高德等,后期讨论、调研决定。
+6.	设计方面,如UI时间比较紧,建议只设计登录页、框架页面、公共页出设计稿,定稿后修改。其他所有的表格表单,按照ElementUI实现。
 
-### Customize configuration
-See [Configuration Reference](https://cli.vuejs.org/config/).
+#开发工具:
+Visual Studio Code V1.55.2,小版本区别没关系。
+#任务:
+2周移植项目。

+ 79 - 81
package-lock.json

@@ -1693,6 +1693,16 @@
           "integrity": "sha1-/q7SVZc9LndVW4PbwIhRpsY1IPo=",
           "dev": true
         },
+        "ansi-styles": {
+          "version": "4.3.0",
+          "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+          "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "color-convert": "^2.0.1"
+          }
+        },
         "cacache": {
           "version": "13.0.1",
           "resolved": "https://registry.npm.taobao.org/cacache/download/cacache-13.0.1.tgz?cache=0&sync_timestamp=1616431251047&other_urls=https%3A%2F%2Fregistry.npm.taobao.org%2Fcacache%2Fdownload%2Fcacache-13.0.1.tgz",
@@ -1719,6 +1729,53 @@
             "unique-filename": "^1.1.1"
           }
         },
+        "chalk": {
+          "version": "4.1.0",
+          "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.0.tgz",
+          "integrity": "sha512-qwx12AxXe2Q5xQ43Ac//I6v5aXTipYrSESdOgzrN+9XjgEpyjpKuvSGaN4qE93f7TQTlerQQ8S+EQ0EyDoVL1A==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "ansi-styles": "^4.1.0",
+            "supports-color": "^7.1.0"
+          }
+        },
+        "color-convert": {
+          "version": "2.0.1",
+          "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+          "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "color-name": "~1.1.4"
+          }
+        },
+        "color-name": {
+          "version": "1.1.4",
+          "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+          "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+          "dev": true,
+          "optional": true
+        },
+        "has-flag": {
+          "version": "4.0.0",
+          "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+          "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+          "dev": true,
+          "optional": true
+        },
+        "loader-utils": {
+          "version": "2.0.0",
+          "resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.0.tgz",
+          "integrity": "sha512-rP4F0h2RaWSvPEkD7BLDFQnvSf+nK+wr3ESUjNTyAGobqrijmW92zc+SO6d4p4B1wh7+B/Jg1mkQe5NYUEHtHQ==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "big.js": "^5.2.2",
+            "emojis-list": "^3.0.0",
+            "json5": "^2.1.2"
+          }
+        },
         "source-map": {
           "version": "0.6.1",
           "resolved": "https://registry.npm.taobao.org/source-map/download/source-map-0.6.1.tgz",
@@ -1735,6 +1792,16 @@
             "minipass": "^3.1.1"
           }
         },
+        "supports-color": {
+          "version": "7.2.0",
+          "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+          "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "has-flag": "^4.0.0"
+          }
+        },
         "terser-webpack-plugin": {
           "version": "2.3.8",
           "resolved": "https://registry.npm.taobao.org/terser-webpack-plugin/download/terser-webpack-plugin-2.3.8.tgz",
@@ -1751,6 +1818,18 @@
             "terser": "^4.6.12",
             "webpack-sources": "^1.4.3"
           }
+        },
+        "vue-loader-v16": {
+          "version": "npm:vue-loader@16.2.0",
+          "resolved": "https://registry.npmjs.org/vue-loader/-/vue-loader-16.2.0.tgz",
+          "integrity": "sha512-TitGhqSQ61RJljMmhIGvfWzJ2zk9m1Qug049Ugml6QP3t0e95o0XJjk29roNEiPKJQBEi8Ord5hFuSuELzSp8Q==",
+          "dev": true,
+          "optional": true,
+          "requires": {
+            "chalk": "^4.1.0",
+            "hash-sum": "^2.0.0",
+            "loader-utils": "^2.0.0"
+          }
         }
       }
     },
@@ -13162,87 +13241,6 @@
         }
       }
     },
-    "vue-loader-v16": {
-      "version": "npm:vue-loader@16.2.0",
-      "resolved": "https://registry.npm.taobao.org/vue-loader/download/vue-loader-16.2.0.tgz?cache=0&other_urls=https%3A%2F%2Fregistry.npm.taobao.org%2Fvue-loader%2Fdownload%2Fvue-loader-16.2.0.tgz",
-      "integrity": "sha1-BGpTMI3Ufljv4g3ewe3sAnzjtG4=",
-      "dev": true,
-      "optional": true,
-      "requires": {
-        "chalk": "^4.1.0",
-        "hash-sum": "^2.0.0",
-        "loader-utils": "^2.0.0"
-      },
-      "dependencies": {
-        "ansi-styles": {
-          "version": "4.3.0",
-          "resolved": "https://registry.npm.taobao.org/ansi-styles/download/ansi-styles-4.3.0.tgz",
-          "integrity": "sha1-7dgDYornHATIWuegkG7a00tkiTc=",
-          "dev": true,
-          "optional": true,
-          "requires": {
-            "color-convert": "^2.0.1"
-          }
-        },
-        "chalk": {
-          "version": "4.1.0",
-          "resolved": "https://registry.npm.taobao.org/chalk/download/chalk-4.1.0.tgz?cache=0&other_urls=https%3A%2F%2Fregistry.npm.taobao.org%2Fchalk%2Fdownload%2Fchalk-4.1.0.tgz",
-          "integrity": "sha1-ThSHCmGNni7dl92DRf2dncMVZGo=",
-          "dev": true,
-          "optional": true,
-          "requires": {
-            "ansi-styles": "^4.1.0",
-            "supports-color": "^7.1.0"
-          }
-        },
-        "color-convert": {
-          "version": "2.0.1",
-          "resolved": "https://registry.npm.taobao.org/color-convert/download/color-convert-2.0.1.tgz",
-          "integrity": "sha1-ctOmjVmMm9s68q0ehPIdiWq9TeM=",
-          "dev": true,
-          "optional": true,
-          "requires": {
-            "color-name": "~1.1.4"
-          }
-        },
-        "color-name": {
-          "version": "1.1.4",
-          "resolved": "https://registry.npm.taobao.org/color-name/download/color-name-1.1.4.tgz",
-          "integrity": "sha1-wqCah6y95pVD3m9j+jmVyCbFNqI=",
-          "dev": true,
-          "optional": true
-        },
-        "has-flag": {
-          "version": "4.0.0",
-          "resolved": "https://registry.npm.taobao.org/has-flag/download/has-flag-4.0.0.tgz",
-          "integrity": "sha1-lEdx/ZyByBJlxNaUGGDaBrtZR5s=",
-          "dev": true,
-          "optional": true
-        },
-        "loader-utils": {
-          "version": "2.0.0",
-          "resolved": "https://registry.npm.taobao.org/loader-utils/download/loader-utils-2.0.0.tgz",
-          "integrity": "sha1-5MrOW4FtQloWa18JfhDNErNgZLA=",
-          "dev": true,
-          "optional": true,
-          "requires": {
-            "big.js": "^5.2.2",
-            "emojis-list": "^3.0.0",
-            "json5": "^2.1.2"
-          }
-        },
-        "supports-color": {
-          "version": "7.2.0",
-          "resolved": "https://registry.npm.taobao.org/supports-color/download/supports-color-7.2.0.tgz?cache=0&sync_timestamp=1611394043517&other_urls=https%3A%2F%2Fregistry.npm.taobao.org%2Fsupports-color%2Fdownload%2Fsupports-color-7.2.0.tgz",
-          "integrity": "sha1-G33NyzK4E4gBs+R4umpRyqiWSNo=",
-          "dev": true,
-          "optional": true,
-          "requires": {
-            "has-flag": "^4.0.0"
-          }
-        }
-      }
-    },
     "vue-router": {
       "version": "3.5.1",
       "resolved": "https://registry.npm.taobao.org/vue-router/download/vue-router-3.5.1.tgz?cache=0&sync_timestamp=1617697726574&other_urls=https%3A%2F%2Fregistry.npm.taobao.org%2Fvue-router%2Fdownload%2Fvue-router-3.5.1.tgz",