AirTravel

Flight search API aggregator

About project

The project is a test task. The full description of the title can be read here EN of RU

Build info

Azure Build Status (master)/(dev)

dev	master

GitHub Build Status (master)/(dev)

dev	master

Preinstalled software

Windows:

Mac

Visual Studio 2022 for Mac or Microsoft VS Code
.Net Core 7
Intel
- Microsoft SQL Server or Docker image with (minimal version version 2019 and up)
or Apple Silicon
- Azure SQL Edge

Linux

Getting Started

Steps:

Install Microsoft SQL Server database or deploy database using docker
Set environment in appSettings.json and appSettings.Development.json
Migrate EF CORE or deploy a database backup
Build and run project (use dotnet commands or use IDEs(Visual Studio 2022 / Visual Studio for Mac or Microsoft VS Code)

Deploy databases

Possible Database deployment scenarios:

use Azure SQL databse in Microsoft Azure Cloud
use docker or docker-compose
deploy local database

Use Azure SQL databse in Microsoft Azure Cloud (main method)

To work with the database in Microsoft Azure, you need to remember to set a firewall rule for your IP address. Firewall configuration is done through the Microsoft Azure panel.

Use Docker or Docker compose(alternative method)

Run database use docker:

sudo docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=YourStrong@Passw0rd" \
   -p 1433:1433 --name sql1 --hostname sql1 \
   -d \
   mcr.microsoft.com/mssql/server:2019-latest

Run database use docker-compose: Create docker-compose.yaml file in root folder with code:

version: '3.7'

services:
  sql-data:
    image: mcr.microsoft.com/mssql/server:2019-latest
    container_name: sqldatacontainer

Create docker-compose.override.yaml in root folder with code:

For Intel / Amd CPU

version: '3.7'

services:
  sql-data:
    image: mcr.microsoft.com/mssql/server:2019-latest
    container_name: sqldatacontainer

For Apply Silicon CPU(M1/M2/M3)

version: '3.7'

services:
  sql-data:
    image: mcr.microsoft.com/azure-sql-edge
    container_name: sqldatacontainer

So, Now we can run docker-compose command for create local docker image if you use docker-compose for Intel / Amd CPU (x86/x64)

docker-compose -f docker-compose.yml -f docker-compose.override.yml up

if you use docker-compose for Apply Silicon CPU - M1/M2/M3 (ARM)

docker-compose -f docker-compose.yml -f docker-compose.override.yml -f docker-compose.override.arm.yml up

Deploy local database in your machine (alternative method)

Go to link for download Microsoft SQL Server. IInstall Microsoft SQL Server using the installer or any other method available.

Commit Formats

Types

API relevant changes
- feat Commits, that adds a new feature
- fix Commits, that fixes a bug
refactor Commits, that rewrite/restructure your code, however does not change any behaviour
- perf Commits are special refactor commits, that improves performance
style Commits, that do not affect the meaning (white-space, formatting, missing semi-colons, etc)
test Commits, that add missing tests or correcting existing tests
docs Commits, that affect documentation only
build Commits, that affect build components like build tool, ci pipeline, dependencies, project version, ...
devops Commits, that affect operational components like infrastructure, deployment, backup, recovery, ...
chore Miscellaneous commits e.g. modifying .gitignore

Subject

use imperative, present tense (eg: use "add" instead of "added" or "adds")
don't use dot(.) at end
don't capitalize first letter

Examples

```
feat(service): add and setup swagger
```

feat: remove ticket list endpoint

refers to JIRA-999
BREAKING CHANGES: ticket enpoints no longer supports list all entites.

fix: add missing parameter to service call

The error occurred because of <reasons>.

```
build(release): bump version to 1.0.0
```
```
build: update dependencies
```

refactor: implement calculation method as recursion

```
style: remove empty line
```

Build and run applications

Before launching, be sure to set the variables in the appsettings.json configuration files. It is important to specify the correct database connection string

 "ConnectionStrings": {
    "AirTravelConnection": "Server=tcp:<server>,<port>;Initial Catalog=<databasename>;Persist Security Info=False;User ID=<user>;Password=<password>;MultipleActiveResultSets=True;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
  },

Can use commands use terminal or use IDEs(Microsoft Visual Studio 2022 or VS Code):

dotnet build [options]
dotnet run [options]

live-dev999 / AirTravel