ParkPlaces

ParkPlaces is an all-in-one solution for managing and storing geographical information about parking zones.

This is a free and open source application and takes tremendous amount of time to maintain. If this project has helped you, consider buying me a coffee:

Third party libraries

A number of awesome third party libraries have helped the development of ParkPlaces:

• ParkPlaces.DotUtils by J-kit
• Newtonsoft.Json by JamesNK
• WatsonTcp by jchristn
• protobuf-net by mgravell
• GMap.NET.WindowsForms by radioman
• MySql.Data

Getting started

Prequsities

• .NET 4.6.1, .NET core 2.1 and .NET standard 2.0
• Visual Studio 2017 Community or other 2017 editions
• A MySQL database server

Building the project

Using prebuilt binaries

If you don't want to build everything yourself, you might grab the prebuilt release binaries from here.

Building from sources and targeting specific platforms

Building from Visual Studio 2017 (Windows only):

Open ParkPlaces.sln in Visual Studio and build the project. The client files will be in the ParkPlaces/bin/Release folder and the server files will be under PPServer/bin/Release.

Deploying the server

To build the deployable binaries of PPServer, select Publish-win-x86 or Publish-linux-x64 build configuration in Visual Studio and build the project. The deployable binaries will be in PPServer\Deploy folder. Note: Do not use binaries from PPServer\bin for production deployments.

Building from the CLI, Windows only (not recommended):

msbuild /p:WarningLevel=0 /p:Configuration=Release

or with deployable binaries:

msbuild /p:WarningLevel=0 /p:Configuration=Publish-win-x86

Building from Linux

PPServer can also run on Linux thanks to .NET core 2.1. To build the server navigate to PPServer and build with dotnet:

dotnet publish -c Release -r=linux-x64

The client is Windows only and cannot be built on Linux.

Setting up the server

You may skip this section if you plan to use the client without a server. PPServer is built to serve requests for the client and to manage the database. Navigate to \PPServer\bin\Release\ and set up the server configuration as follows:

PPServer.dll.config:

Specify the port the server is going to listen on. Configuring an IP address is not necessary as the server will try to guess it automatically. If you are not specifying an IP address, remember to set AutoConfig to true.

...
<ServerConfiguration>
   <add key="IPAddress" value="192.168.0.1" />
   <add key="Port" value="11000" />
   <add key="AutoConfig" value="true"/>
</ServerConfiguration>
...

Database configuration

There is a Main and an Alt database connection. This is useful when switcing between development and production environments. To specify which configuration the server will use, use either "alt" or "main" keyword as follows:

...
<appSettings>
   ...
   <add key="DBConnection" value="alt" />
   ...
</appSettings>
...

...
<AltDBConnection>
   <add key="server" value="localhost" />
   <add key="user" value="root" />
   <add key="password" value="" />
   <add key="database" value="parkplaces" />
   <add key="port" value="3306" />
</AltDBConnection>
...

Setting up the client

You may skip this section if you plan to use the client without the server. Navigate to \ParkPlaces\bin\Release\ and set the server port and ip address as follows:

ParkPlaces.exe.config:

...
<appSettings>
   ...
   <add key="ServerIP" value="192.168.1.100" />
   <add key="ServerPort" value="11000" />
   ...
</appSettings>
...

The ServerPort key can be left out. The default port number is 11000 unless else specified.

The default login credentials are

Username	Password
admin	admin