Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/oleksiiprykhodko/mikartenergy

It is my pet-project for practice .NET, Angular, SQL, Docker, Html, CSS. It is website for a distribution and engineering company engaged in industrial automation.
https://github.com/oleksiiprykhodko/mikartenergy

angular asp-net-core bootstrap5 c-sharp css docker docker-compose dot-net entity-framework-core fluent-validation font-awesome html ms-sql-server primeng scss serilog siemens sql typescript web-api

Last synced: about 1 month ago
JSON representation

It is my pet-project for practice .NET, Angular, SQL, Docker, Html, CSS. It is website for a distribution and engineering company engaged in industrial automation.

Awesome Lists containing this project

README 

        
# MikartEnergy



**This is my pet project.  

I decided to create the website of a fictitious company that automates production processes in the chemical industry and sells industrial automation components.**



## Extravagant technologies of this project that you won't find in any other Pet project:



- [ETIM](https://www.etim-international.com/) - the international classification standard for technical products. 

In short, the ETIM standardises the format in which equipment manufacturers provide detailed information about their products to distributors and partners. The ETIM also classifies the technical characteristics and parameters of the products. More details in the short official video [ETIM INTERNATIONAL Simpleshow](https://youtu.be/I1lp5QtDL5g?si=b8BfXdoHEKjjznqD).

In this project I use ETIM xml file with information about Siemens automation products (PLC S7-1500 and HMI Comfort). And file with information about ETIM Features and ETIM Values classes which I get using my own application. I have created a separate [ETIM-API-Saver](https://github.com/OleksiiPrykhodko/ETIM-API-Saver) application to receive ETIM Features and ETIM Values classes from ETIM API and save it to the XML file.



- [ELBRIDGE Interface](https://www.itek.de/en/beratung/standardisierung/elbridge/) - standard developed by ETIM Germany to connect wholesale shops to the product configurators of the industry. The interface technically standardizes the product selection process.

In brief, it is a standard according to which equipment manufacturers create their own web configurators, which can be further integrated into the partner's site for quick and error-free selection of equipment and transfer of created specifications to the order list on the partner's web shop. 

In my project this is used to select equipment from the Siemens catalogue. And adding the result to the order list. 



- [TIA Selection Tool](https://siemens.com/tst) - worldwide configurator of Siemens automation products wich uses ELBRIDGE Interface for passing the configuration result to the order list of the distributor's website.



## Technologies:



### Backend:

  - [.NET 7](https://dotnet.microsoft.com/download)

  - [ASP.NET Core Web API](https://dotnet.microsoft.com/en-us/apps/aspnet/apis)

  - [Entity Framework Core](https://docs.microsoft.com/ef/core)

  - [FluentValidation](https://github.com/JeremySkinner/FluentValidation)

  - [Serilog](https://serilog.net/)

  - [ELBRIDGE Interface](https://www.itek.de/en/beratung/standardisierung/elbridge/)

  - [ETIM](https://etimapi.etim-international.com/)



### Frontend:

- [Angular](https://angular.io/docs)

- [Bootstrap 5.2](https://getbootstrap.com/docs/5.2/getting-started/introduction/)

- [PrimeNG 17.3](https://primeng.org/installation)

- [Font Awesome](https://fontawesome.com/)

- [TIA Selection Tool - Siemens embedded configurator](https://www.siemens.com/global/en/products/automation/topic-areas/tia/tia-selection-tool.html)



### DerOps:

- [Docker](https://www.docker.com/)



## Startup project in docker with YAML file

0) Run command `npm install` in main frontend directory (MikartEnergy\frontend) with PowerShell or Command Prompt.

1) Copy the "DockerVolumes" directory with its contents to the C drive root (C:\DockerVolumes). This directory is for docker volumes.  

The database will be created in this directory when the containers are first time started and it already contains needed https development certificate. 

2) Start up Docker and download Microsoft SQL server image with command: 

`docker pull mcr.microsoft.com/mssql/server:2022-latest` 

3) Run command `docker-compose -p mikartenergy up` in main directory of App (with docker-compose.yml file). 

4) Open page `http://localhost:4200/` in your browser. 

5) Have fun! 



### Frontend Development server

Run `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The application will automatically reload if you change any of the source files.

### Frontend Build

Run `ng build` to build the project. The build artifacts will be stored in the `dist/` directory.



## MikartEnergy database diagram



![MikartEnergyDatabaseDiagram](DatabaseDiagram.png)