This is currently an API focused solution. Right click bkw.auto.api and set it as the default project. Press F5 to run the api

Video Demos

• https://www.youtube.com/watch?v=xX8LWwvoD44
• https://www.youtube.com/watch?v=MdCpxKtAO_c

This experimetal vehicle modeling concept is designed to allow a dealership to show 4 popular types (i.e. VehicleKind) of cars for sale, and available options for those cars. Conceivably, users could select from available options and request a quote - but I haven't taken the API that far (and there's no UI outside the Swagger UI at the moment)

Initially the modeling of the car was conceived as a long list of IVehicleOption objects, but to aid a possible UI design, I decided to group options into smaller IVehicleOptionModels centered around DriveTrain, Interior and Exterior

I can imagine a UI implementation binding to an instance of IVehicle as a kind of ViewModel - and present it's available options for DriveTrain, Interior and Exterior on separate tabs or dedicatd DOM sections.

The IVehicleOptionModel features two collections, one for explaining all the available options for the given VehicleKind, and another for holding actual selections that the user could make and submit for a possible quote or query for availablity. In a more mature solution, I might move the user-selection business into in a dedicated ViewModel library - but I believe this simplicity for now is OK.

In this library I created hard implemenations of IVehicleOptionModel:

1. drivetrains/HeavyDriveTrain
2. drivetrains/StandardDriveTrain
3. exterior/FactoryExterior
4. exterior/AftermarketExterior
5. interior/DeluxeInterior
6. interior/StandardInterior

The above option models derive from a common base class in order to share common utility logic e.g. ToString()

I also created a hard instance of IVehicle, per each VehicleKind - these each feature a static BuildCar() factory method.

1. EconomyCar
2. SportsCar
3. TruckCommercial
4. TruckPickup

We can then implement the desired specialty options within each kind of vehicle class. For example: the EnconomyCar employs an instance of StandardDriveTrain while the TruckCommerical has a HeavyDriveTrain. The SportsCar has a DeluxeInterior and AftermarketExterior whereas some of the other vehicles have standard/factory options.

There is a bkw.auto.api.tests project for testing out some of the logic in this bkw.auto.biz library

Example C# Program

IVehicleOptionsProvider vehicleOptionsProvider = new bkw.auto.provider.CompiledVehicleOptionsProvider();

IVehicle fordPinto = EconomyCar.BuildCar("Ford Pinto", vehicleOptionsProvider);

Console.WriteLine($"{fordPinto}");//short description will print with default ToString implementation

Console.WriteLine($"{fordPinto.ToLongString()}");//special long description

Example Console Output

This Ford Pinto is a Economy Car that has a StandardDriveTrain (w/4 available options) , StandardInterior (w/3 available options) and FactoryExterior (w/4 available options)
This Ford Pinto is a Economy Car that has a 2 DriveType options [Front Wheel Drive, Rear Wheel Drive], 2 Tire options [All Weather Radial, All Weather Radial - Whitewall], AC Delco A/C package: Single Temp Dash Control, 2 Seats options [Vinyl-Bucket, Vinyl-Standard] and 2 Color options [Plain Red, Powder White]

Most of my professional experience is with ASP.NET WebAPI 2 - and manually adding Swashbuckle into the mix (with a little pain and suffering on the side fiddling with an EDMX model). I thought I'd give the dotnet 6 webapi template a whirl - WHAT A DIFFERENCE - and the integration of the Swagger UI is already a done deal! This Web API can serve up a list of Vehicle options, as well as complete instances of IVehicle.

There is currently no database, and the options are loaded in memory by a CompiledVehicleOptionsProvider (which is also used in the bkw.auto.biz.tests project)

Example Web API response - GET /api/Vehicle?kind=EconomyCar

{
  "driveTrain": {
    "requirements": [
      "DriveType",
      "Tire"
    ],
    "availableOptions": [
      {
        "compatibileKinds": 2,
        "brand": "Ford",
        "name": "DriveType",
        "description": "Front Wheel Drive",
        "quantity": 1
      },
      {
        "compatibileKinds": 2,
        "brand": "Ford",
        "name": "DriveType",
        "description": "Rear Wheel Drive",
        "quantity": 1
      },
      {
        "compatibileKinds": 18,
        "brand": "Michelin",
        "name": "Tire",
        "description": "All Weather Radial",
        "quantity": 4
      },
      {
        "compatibileKinds": 18,
        "brand": "Michelin",
        "name": "Tire",
        "description": "All Weather Radial - Whitewall",
        "quantity": 4
      }
    ],
    "selectedOptions": []
  },
  "interior": {
    "requirements": [
      "A/C",
      "Seats"
    ],
    "availableOptions": [
      {
        "compatibileKinds": 30,
        "brand": "Ford",
        "name": "Seats",
        "description": "Vinyl-Bucket",
        "quantity": 1
      },
      {
        "compatibileKinds": 30,
        "brand": "Ford",
        "name": "Seats",
        "description": "Vinyl-Standard",
        "quantity": 1
      },
      {
        "compatibileKinds": 30,
        "brand": "AC Delco",
        "name": "A/C",
        "description": "Single Temp Dash Control",
        "quantity": 1
      }
    ],
    "selectedOptions": []
  },
  "exterior": {
    "requirements": [
      "Color"
    ],
    "availableOptions": [
      {
        "compatibileKinds": 2,
        "brand": "Ford",
        "name": "Color",
        "description": "Plain Red",
        "quantity": 1
      },
      {
        "compatibileKinds": 2,
        "brand": "Ford",
        "name": "Color",
        "description": "Powder White",
        "quantity": 1
      },
      {
        "compatibileKinds": 2,
        "brand": "--",
        "name": "Towing",
        "description": "(NONE OFFERED)",
        "quantity": 0
      },
      {
        "compatibileKinds": 2,
        "brand": "--",
        "name": "LuggageRack",
        "description": "(NONE OFFERED)",
        "quantity": 1
      }
    ],
    "selectedOptions": []
  },
  "name": "Ford Escape",
  "description": "Economy Car"
}