Merge branch 'main' of https://gitea.yinghuasoft.com/yhsoft/dev-aid

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "cSpell.words": ["Navicat", "Yinghua"]
+}

README.md

@@ -5,11 +5,20 @@
 
 ### 内容
 
+- 工作规范
+  - [编码规范.md](./工作规范/编码规范.md)
+  - [工作职责.md](./工作规范/工作职责.md)
+  - [publish-flow](./工作规范/publish-flow.md) 项目发布流程
 - Docker
   - [install.md](./docker/install.md) Docker 安装
+  - [cli](./docker/cli.md) Docker 常用命令
+  - [issue](./docker/issue.md) Docker 问题讨论
+  - [Dockerfile](./docker/Dockerfile/) 存放 Dockerfile
 - git
   - [cli.md](./git/cli.md) git 命令
   - [ssh-key.md](./git/ssh-key.md) 生成 ssh key
+- linux
+  - [cli.md](./linux/cli.md) linux 常用命令
 - nginx
   - conf.d
     - default.conf 默认配置文件
@@ -19,7 +28,7 @@
   - [cli.md](./vue/cli.md) Vue CLI 命令
   - [issue.md](./vue/issue.md) 问题解决方法
 - [CodeConventions.md](./CodeConventions.md) 编码规范
-- [Docs.md](./Docs.md) 开发常用网站大全
+- [dev-urls.md](./dev-urls.md) 开发常用网站大全
 - README.md
 
 ---

dev-urls.md

@@ -69,4 +69,4 @@
 
 ## 6️⃣ 颖华软件 ✨
 
-[官网一](https://www.yinghuasoft.com) | [官网二](https://www.yinghuainfo.com) | [Ⓜ️ 企业邮箱](http://mail.yinghuasoft.com)
+[官网一](https://www.yinghuasoft.com) | [官网二](https://www.yinghuainfo.com) | [Ⓜ️ 企业邮箱](http://mail.yinghuasoft.com) | [PMS](https://zt.yinghuasoft.com)

docker/aspnet-cn/error.md

@@ -0,0 +1,26 @@
+## release模式下报错
+```c#
+//错误：
+//System.IO.FileNotFoundException: 'Could not load file or assembly 'Anonymously Hosted DynamicMethods Assembly, Culture=neutral, PublicKeyToken=null'. 系统找不到指定的文件。'
+
+//解决方法：
+//在数据库项目的文件里加入
+AssemblyString = "RapidApp.DataPersistence";
+```
+![Alt text](image.png)
+
+## 启动项目找不到 *(项目名.xml)*
+
+1. 下图文件找不到
+
+    ![Alt text](image-1.png)
+
+2. 右击->properties
+
+    ![Alt text](image-2.png)
+
+3. 修改
+
+    ![Alt text](image-3.png)
+
+

docker/cli.md

@@ -10,7 +10,7 @@ docker ps
 
 ### 启动、停止、重启容器
 
-```
+```bash
 docker start {容器名称或者Id}
 
 docker stop {容器名称或者Id}
@@ -18,6 +18,7 @@ docker stop {容器名称或者Id}
 docker restart {容器名称或者Id}
 ```
 
+<<<<<<< HEAD
 ### 查看镜像
 ```
 docker images
@@ -46,4 +47,19 @@ df -h
 ### 查看目录下每个文件夹的大小
 ```
 du -h -d1 {路径}
-```
+```
+=======
+### 进入容器
+
+```bash
+docker exec -it [containerName] bash
+```
+
+### 镜像构建命令
+
+```bash
+docker build -t [imagesName] -f Dockerfile .
+```
+
+ps:命令要在 Dockerfile 在的目录下执行
+>>>>>>> 7f7fc1406d4278f4b5c10b95bbe521e61f3b63db

docker/issue.md

@@ -0,0 +1,14 @@
+<h1>Docker 相关的问题讨论</h1>
+
+## 解决 Docker 容器不支持中文的问题，中文乱码问题
+
+#### 编写 Dockerfile
+
+```Dockerfile
+FROM mcr.microsoft.com/dotnet/aspnet:7.0
+WORKDIR /app   #容器内的工作目录
+EXPOSE 80      #容器监听的端口
+ADD /Fonts/* /usr/share/fonts/ #中文字体
+ENV LANG=C.UTF-8  #容器默认编码
+ENTRYPOINT ["dotnet","RapidApp.Api.dll"]
+```

docker/setFonts.md

@@ -1,49 +0,0 @@
-<h1>解决docker中文乱码</h1>
-
-## 构建镜像
-
-1. 编写Dockerfile
-    ```Dockerfile
-    FROM mcr.microsoft.com/dotnet/aspnet:7.0 
-    WORKDIR /app   #容器内的工作目录
-    EXPOSE 80      #容器监听的端口
-    ADD /Fonts/* /usr/share/fonts/ #中文字体
-    ENV LANG=C.UTF-8  #容器默认编码
-    ENTRYPOINT ["dotnet","RapidApp.Api.dll"]
-    ```
-
-2. 构建命令
-    ```cmd
-    docker build -t [imagesName] -f Dockerfile .
-    ```
-    ps:命令要在Dockerfile在的目录下执行
-
-## 添加容器
-![Alt text](image.png)
-
-## 查看容器字体
-1. 进入容器
-    ```cmd
-    docker exec -it [containerName] bash
-    ```
-    ![Alt text](image-1.png)
-
-2. 查看字体
-* fc-list :查看所有字体
-* fc -list:lang-zh:查看中文字体
-
-![Alt text](image-2.png)
-
-3. 命令不起作用
-
-    如果出现以下信息
-    ```cmd
-    bash: fc-list: command not found
-    ```
-
-    解决：
-    ```cmd
-    apt-get update
-    apt-get upgrade
-    apt-get install fontconfig
-    ```

git/cli.md

@@ -81,7 +81,7 @@ git remote add origin git@github.com:mick-xu/xxx.git
 git push -u origin master
 ```
 
-### 清除 git 缓存
+### 清除 git 缓存，解决添加 .gitignore 不生效的问题
 
 ```bash
 git rm -r --cached .

linux/cli.md

@@ -0,0 +1,22 @@
+### 查看字体
+
+```bash
+- fc-list # 查看所有字体
+- fc -list:lang-zh #查看中文字体
+```
+
+![查看字体](./assets/view-font.png)
+
+#### 如果出现以下信息
+
+```bash
+bash: fc-list: command not found
+```
+
+解决：
+
+```bash
+apt-get update
+apt-get upgrade
+apt-get install fontconfig
+```

nginx/cli.md

@@ -29,10 +29,15 @@ systemctl disable nginx
 ### Docker 容器中重新加载配置
 
 ```docker
+# 方法1
 docker exec -it nginx /etc/init.d/nginx reload
 
+# 方法2
 # alpine
 docker exec -it nginx /bin/sh
 cd /etc/init.d
 nginx -s reload
+
+# 方法3
+docker exec [容器id] nginx -s reload
 ```

工作规范/publish-flow.md

@@ -0,0 +1,15 @@
+### 济南颖华系统发布流程
+
+1. #### 开发新功能
+2. #### 发布至 Dev 环境 （华为云服务器）
+3. #### 测试新开发的功能，修复 BUG
+4. #### 发布 Staging 环境（华为云服务器），公司内部演示用
+5. #### 所有问题修复完毕
+6. #### 发布至生成环境
+   1. 近期开发的功能完成，测试没有任何问题，发布一次 Production 生产环境
+   2. 或者每周五或者每月底发布至生产环境。
+7. #### 修改版本号，编写更新日志（CHANGELOG.md）
+8. #### 生产环境数据库数据、程序以及相关文件备份
+9. #### 发布前后端程序，修改数据结构
+10. #### 测试，直至没有任何问题
+11. #### 群内发布系统升级通知，发布版本号以及更新日志

工作规范/工作职责.md

@@ -0,0 +1,32 @@
+### 组长工作职责、权利和义务
+
+- 制定开发计划，分配开发任务
+- 与客户沟通业务逻辑、开发细节
+- 保证编码规范和项目质量
+- 审批成员请假、调休，以及休假前的工作交接
+- 必要时申请加班，安排加班
+
+* 拥有项目组成员的申请、组内工作分配、调离等权利
+* 项目奖金知悉权以及组内的建议分配权
+* 参与项目组成员其他任命和涨薪幅度的制定，给出公平的建议或意见
+* 根据员工薪资能力合理安排任务
+* 可获取协助和客户沟通以及辅助与客户协调的权利
+* 获取技术指导以及建议
+
+### 团队成员工作职责
+
+- 积极配合项目组长按时完成指定的任务
+- 请假提前申请，以及配合组长做好工作交接
+- 保证自己的工作质量，避免出现明显 BUG
+- 按时提交代码，注意代码规范
+- 贡献代码或者问题解决方案
+
+* 加班调休的权利
+* 可获取技术支持或者技术指导
+* 获得技术成长培训以及良好的学习环境
+
+### 工作要求，涨薪必备
+
+黑色部分是基本要求，橙色部分是涨薪和奖金比例参考关键点
+
+![涨薪必备](./assets/work-rule.jpg)

工作规范/新员工快速上手.md

@@ -0,0 +1,30 @@
+## 新入职员工快速上手指南
+
+### 准备工作
+
+- 钉钉扫码办理入职，实名认证钉钉账号，完善入职资料
+- 注册公司内部 Git 服务账号，[点击注册](https://gitea.yinghuasoft.com/user/sign_up)，注册完成后将账号告诉 Git 管理人员。
+- 使用新注册的 Git 账号登录 https://gitea.yinghuasoft.com，进入代码仓库 yhsoft/dev-aid 工作规范目录，仔细阅读 [编码规范](./编码规范.md) 和 [工作职责](./工作职责.md)
+- 分配 PMS 系统账号，PMS 登录地址：https://zt.yinghuasoft.com
+- 安装软件列表： [钉钉桌面版](https://page.dingtalk.com/wow/z/dingtalk/simple/ddhomedownload#/)，[Git](https://git-scm.com/book/zh/v2/%E8%B5%B7%E6%AD%A5-%E5%AE%89%E8%A3%85-Git)，Office 2021
+
+### 前端
+
+- 安装软件：[Node JS](https://nodejs.org/en) (下载 LTS 版本)，[VS Code](https://code.visualstudio.com/)，[pnpm](https://www.pnpm.cn/installation)，[微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)
+- 公司 NPM 地址：https://npm.yinghuasoft.com
+- Rapid Design 文档: https://rd-docs.yinghuasoft.com
+- VS Code 必装插件列表：`Auto Close Tag`, `Auto Rename Tag`, `Code Spell Checker`, `ESLint, Path Intellisense`
+  , `Prettier - Code formatter`, `Less IntelliSense`, `Sass (.sass only)`, `Vue VSCode Snippets`, `vue3-snippets-for-vscode`, `Ant Design Vue helper`, `Tailwind CSS IntelliSense`, `TypeScript Vue Plugin (Volar)`, `Live Server`
+
+### 后端
+
+- 安装软件：[Visual Studio 2022](https://visualstudio.microsoft.com/zh-hans/vs/) (下载企业版)，[Navicat Premium 16](https://www.navicat.com.cn/products)
+- 公司 NuGet 地址：https://nuget.yinghuasoft.com，Visual Studio 2022 NuGet 包管理器配置程序包源：名称：Yinghua Soft，源：https://nuget.yinghuasoft.com/v3/index.json
+- 公司华为云服务器地址：114.215.110.136，数据库：PostgreSQL 账号 postgres，MySQL 账号 root
+
+### 工作时间、考勤、请假、加班、调休
+
+- 上班时间 8:30 - 17:30 (周一至周五)，周六、周日、法定节假日休息
+- 上下班各打卡一次，忘记打卡需要补卡，每个月有 5 次补卡机会
+- 请假：打开钉钉 -> 颖华软件(工作台) -> OA 审批 -> 请假 -> 提交
+- 加班需提前提交加班申请，加班时长按实际钉钉打卡计算，晚上加班从 18:00 开始计算，17:30 - 18:00 是晚饭时间，先吃饭再加班，流程：打开钉钉 -> 颖华软件(工作台) -> OA 审批 -> 加班

工作规范/编码规范.md

@@ -18,11 +18,16 @@
 - 标签名必须使用小写字母，标签使用要遵循其语义
 - 标签属性名必须使用小写字母，属性必须用双引号（""）包围，自定义属性以 data- 作为前缀
 - bool 类型的属性不需要添加属性值
-- class 必须单词全字母小写，单词之间以 '-' 分隔
+- class 使用短横线式（kebab-case）命名，单词之间以 '-' 分隔，不允许使用大写字母
 - id 必须保证同一个页面内唯一，使用小驼峰式命名（camelCase）
--
+- 如果使用第三方组件库，尽可能二次封装组件库，减少自定义组件的使用。
+- 引用的文件名称使用短横线式（kebab-case）命名，静态资源文件一般放在类似 assets/images 的目录中
 
-### CSS
+### CSS / LESS / SCSS
+
+- 类名使用 kebab-case（短横线）式命名，禁止出现大写字母
+- 禁止使用 style 行内样式
+- 样式推荐使用 TailwindCSS 或 UnoCSS，尽可能避免编写和维护大量特定样式
 
 ### JavaScript
 
@@ -35,15 +40,25 @@
 
 ### TypeScript
 
+- 使用 PascalCase 为类型、枚举命名
+- 使用 camelCase 为属性、变量、函数命名。
+- 尽可能使用完整的单词拼写命名
+- 共享的类型应该在 types.ts 里定义
+- 在一个文件里，类型定义应该出现在顶部
+- 使用 undefined，不要使用 null
+
 ## 服务端
 
-### C#
+### C# / ASP.NET
 
 - record 名称、结构体名称、类名、公有属性、方法名称、文件名使用 Pascal 式命名
 - 接口 第一个字母应为大写 I
 - private 和 internal 属性使用小驼峰式命名（camelCase）或者开头添加 \_
 - 方法参数使用小驼峰式命名（camelCase）命名
 - 所有 ApiController 必须返回 ResultDto 类型，并且被 Ok() 函数包裹
+- 尽可能使用公司内部 NuGet 包中的方法，减少自定义方法的实现
+- 编写 Controller 中的方法，需要尽可能遵守 RESTful 风格，要有默认的 Get Post Put Delete 等方法，
+- Program.cs 文件避免出现业务逻辑代码
 
 ## 工作目录