{"id":25052520,"url":"https://github.com/devconn99/employee-manager","last_synced_at":"2026-05-05T12:33:07.151Z","repository":{"id":55302421,"uuid":"217102147","full_name":"devconn99/employee-manager","owner":"devconn99","description":"An Asp.Net Core application for managing individuals with Angular forms","archived":false,"fork":false,"pushed_at":"2022-10-28T23:39:28.000Z","size":3688,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-06T10:45:27.345Z","etag":null,"topics":["angular8","asp","asp-net-core","automapper","crud","dotnet-core","dto","swagger","typescript","webapi"],"latest_commit_sha":null,"homepage":"https://empmanagercore.azurewebsites.net/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devconn99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-23T16:21:14.000Z","updated_at":"2022-11-02T04:07:51.000Z","dependencies_parsed_at":"2023-01-20T14:32:54.989Z","dependency_job_id":null,"html_url":"https://github.com/devconn99/employee-manager","commit_stats":null,"previous_names":["devonconn99/employee-manager","devconn99/employee-manager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devconn99%2Femployee-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devconn99%2Femployee-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devconn99%2Femployee-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devconn99%2Femployee-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devconn99","download_url":"https://codeload.github.com/devconn99/employee-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246424194,"owners_count":20774918,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular8","asp","asp-net-core","automapper","crud","dotnet-core","dto","swagger","typescript","webapi"],"created_at":"2025-02-06T10:30:41.696Z","updated_at":"2026-05-05T12:33:02.121Z","avatar_url":"https://github.com/devconn99.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Employee Manager\n\n\u003e A management system using Angular version 8 for front end UI and Asp.Net Core for a back end web Api.\n\n## Scope\n\nThis is a project to demonstrate extending concepts into larger projects. It is an employee management system with form validation using Angular and ASP.Net Core. The concepts is to familiarize and combine a popular JavaScript framework with C#/ASP.Net Core, while providing Api Versioning, Controller End-point testing, and setup integration tests for future feature implementations.\n\nThe use of Data transfer objects (Dtos) using [Auto Mapper](https://automapper.org/) protects and maps the original entity classes found in the `Data\\Entities` directory of the Api to classes for specific tasks, i.e. fetch, create, and edit.\n\n![Screenshot](resources/Employeetable.png)\n\n![Screenshot](resources/EmployeeCreate.png)\n\n## Development Stack\n\nThe application was built using the following tools \u0026 frameworks:\n\n- C#/ASP.Net Core 2.2\n- Angular version 8.3\n- Bootstrap 4\n- SQL Server or PostgreSQL Database (easily configured in DbContext class)\n\n## Built-in Endpoint Testing\n\nThe project contains built in Api endpoint testing using [Swagger](https://github.com/domaindrivendev/Swashbuckle.AspNetCore). This was setup in the `Startup.cs`class in both the Configure services and IConfiguration to be used upon startup.\nAfter launching the project in a local environment, navigate to `https://localhost:5001/swagger` to view the test index page.\n\n![Screenshot](resources/Swagger.png)\n\n## Setup\n\nIn order to test/use this application, you will need the following:\n\n- Asp.Net Core 2.0 SDK, preferably 2.2.1\n- Node.js version 8 or higher\n- The Angular CLI\n- Microsoft SQL Server or pgAdmin for PostgreSQL\n\n## Installation\n\nGrab the repository either by downloading the zip file or clone the project.\n\nAfter cloning or unzipping the files, navigate to the directory containing the solution file:\n\n```sh\n~$ cd src/EmployeeManager/\n```\n\nIn either order, navigate to the client or api/server side files and install their dependencies. Once again, you will need Node.js and `npm` installed along with the .Net Core 2.2 SDK.\n\nFor client side dependencies:\n\n```sh\n~$ cd src/EmployeeManager/client\n~$ npm install\n```\n\nMake sure the `@angular\\cli` is installed as well:\n\n```sh\n# for Angular\n~$ npm install -g @angular/cli @angular/core\n```\n\nFor server side code, build and restore dependencies and NuGet packages:\n\n```sh\n~$ cd src/EmployeeManager/server/\n~$ dotnet restore\n```\n\n## Running the Environment\n\nTo run a local environment on the client side:\nUse `npm` script commands in a terminal/command box while in the `../client` directory:\n\n```sh\n# for Angular client\n~$ ng build -options\n```\n\nThis outputs a minified JavaScript file in the `wwwroot` directory of the API via the `angular.json` scripts.\n\nTo run a local environment on the server side:\nUse the `dotnet \u003cCOMMAND\u003e \u003cOPTIONS\u003e` tool to run it in a terminal or use Visual Studio to run it with `CTL` + `F5`\n\nNavigate to `localhost:5001` (or to ) in a browser to see the current build running.\n\n## TODO\n\n- Add Authorization and Login.\n- Enable searching by Employee name.\n\n## Known Issues and Bugs\n\n- ~~The Update action in the controller endpoint class under ApiVersion 2 (i.e. api/v2/endpoint) has an issue with sending successful requests to the server due to AutoMapper not able to bind the `EmployeeDto` to the `EmployeeUpdateDto`, so it is using the context class instead on version 1 under `/v1/...` route.~~ (issue has been fixed)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevconn99%2Femployee-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevconn99%2Femployee-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevconn99%2Femployee-manager/lists"}