employee manager

Менеджер по работе с сотрудниками

Система управления, использующая Angular версии 8 для внешнего пользовательского интерфейса и Asp.Net Core для внутреннего веб-API.

Объем

Это проект, призванный продемонстрировать распространение концепций в более крупные проекты. Это система управления сотрудниками с проверкой форм с использованием Angular и ASP.Net Core. Концепция заключается в ознакомлении и объединении популярной платформы JavaScript с C#/ASP.Net Core, обеспечивая при этом управление версиями API, тестирование конечных точек контроллера и настройку интеграционных тестов для будущих реализаций функций.

Использование объектов передачи данных (Dtos) с помощью Auto Mapper защищает и сопоставляет исходные классы сущностей, находящиеся в каталоге DataEntities API, с классами для конкретных задач, т. е. выборки, создания и редактирования.

Стек разработки

Приложение было создано с использованием следующих инструментов и фреймворков:

• С#/ASP.Net Core 2.2
• Угловая версия 8.3
• Бутстрап 4
• SQL Server или база данных PostgreSQL (легко настраивается в классе DbContext)

Встроенное тестирование конечных точек

Проект содержит встроенное тестирование конечных точек API с использованием Swagger. Это было настроено в классе Startup.cs как в службах настройки, так и в IConfiguration, которые будут использоваться при запуске. После запуска проекта в локальной среде перейдите по адресу https://localhost:5001/swagger чтобы просмотреть тестовую индексную страницу.

Настраивать

Чтобы протестировать/использовать это приложение, вам понадобится следующее:

• Asp.Net Core 2.0 SDK, желательно 2.2.1
• Node.js версии 8 или выше
• Угловой интерфейс командной строки
• Microsoft SQL Server или pgAdmin для PostgreSQL.

Установка

Получите репозиторий, загрузив zip-файл или клонировав проект.

После клонирования или распаковки файлов перейдите в каталог, содержащий файл решения:

 ~ $ cd src/EmployeeManager/

В любом порядке перейдите к файлам на стороне клиента или API/сервера и установите их зависимости. Еще раз вам понадобится установить Node.js и npm вместе с .Net Core 2.2 SDK.

Для зависимостей на стороне клиента:

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

Убедитесь, что @angularcli также установлен:

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

Для серверного кода создайте и восстановите зависимости и пакеты NuGet:

 ~ $ cd src/EmployeeManager/server/
~ $ dotnet restore

Управление средой

Чтобы запустить локальную среду на стороне клиента: используйте команды сценария npm в окне терминала/команды, находясь в каталоге ../client :

 # for Angular client
~ $ ng build -options

Это выводит мини-файл JavaScript в каталоге wwwroot API с помощью сценариев angular.json .

Чтобы запустить локальную среду на стороне сервера: используйте инструмент dotnet <COMMAND> <OPTIONS> , чтобы запустить ее в терминале, или используйте Visual Studio, чтобы запустить ее с помощью CTL + F5

Перейдите к localhost:5001 (или к ) в браузере, чтобы увидеть, как работает текущая сборка.

TODO

• Добавьте авторизацию и вход.
• Включите поиск по имени сотрудника.

Известные проблемы и ошибки

• Действие «Обновление» в классе конечной точки контроллера в ApiVersion 2 (т. е. api/v2/endpoint) имеет проблему с отправкой успешных запросов на сервер из-за того, что AutoMapper не может связать « EmployeeDto с EmployeeUpdateDto , поэтому вместо этого он использует контекстный класс. в версии 1 по маршруту /v1/... (проблема устранена)