CS_AN_AZ_employee_manager

员工经理

使用 Angular 版本 8 作为前端 UI 和 Asp.Net Core 作为后端 Web Api 的管理系统。

范围

这是一个展示将概念扩展到更大项目的项目。它是一个使用 Angular 和 ASP.Net Core 进行表单验证的员工管理系统。这些概念是熟悉流行的 JavaScript 框架并将其与 C#/ASP.Net Core 相结合，同时提供 Api 版本控制、控制器端点测试以及为未来功能实现设置集成测试。

使用自动映射器使用数据传输对象 (Dtos) 可以保护 Api 的DataEntities目录中找到的原始实体类并将其映射到用于特定任务（即获取、创建和编辑）的类。

开发堆栈

该应用程序是使用以下工具和框架构建的：

• C#/ASP.Net 核心 2.2

• 角度版本 8.3

• 引导程序4

• SQL Server 或 PostgreSQL 数据库（在 DbContext 类中轻松配置）

内置端点测试

该项目包含使用 Swagger 构建的 Api 端点测试。这是在启动时使用的配置服务和 IConfiguration 中的Startup.cs类中进行设置的。在本地环境中启动项目后，导航到https://localhost:5001/swagger以查看测试索引页面。

设置

为了测试/使用此应用程序，您将需要以下内容：

• Asp.Net Core 2.0 SDK，最好是2.2.1

• Node.js 版本 8 或更高版本

• Angular CLI

• Microsoft SQL Server 或 PostgreSQL 的 pgAdmin

安装

通过下载 zip 文件或克隆项目来获取存储库。

克隆或解压缩文件后，导航到包含解决方案文件的目录：

 ~$ cd src/EmployeeManager/

无论哪种顺序，导航到客户端或 api/服务器端文件并安装它们的依赖项。再次，您将需要安装 Node.js 和npm以及 .Net Core 2.2 SDK。

对于客户端依赖项：

 ~$ cd src/EmployeeManager/client~$ npm install

确保@angularcli也已安装：

 # 对于 Angular~$ npm install -g @angular/cli @angular/core

对于服务器端代码，构建和恢复依赖项和 NuGet 包：

 ~$ cd src/EmployeeManager/server/~$ dotnet 恢复

运行环境

要在客户端运行本地环境：在../client目录中的终端/命令框中使用npm script 命令：

 # 对于 Angular 客户端~$ ng build -options

这将通过angular.json脚本在 API 的wwwroot目录中输出缩小的 JavaScript 文件。

要在服务器端运行本地环境：使用dotnet 工具在终端中运行它或使用 Visual Studio 通过CTL + F5运行它

在浏览器中导航到localhost:5001 （或 ）以查看当前正在运行的构建。

待办事项

• 添加授权和登录。

• 启用按员工姓名搜索。

已知问题和错误

• ApiVersion 2（即 api/v2/endpoint）下的控制器端点类中的 Update 操作在向服务器发送成功请求时存在问题，因为 AutoMapper 无法将EmployeeDto绑定到EmployeeUpdateDto ，因此它改用 context 类在/v1/...路线下的版本 1 上。 （问题已修复）