Parking lot diagrams are used in Feature Driven Development (FDD) to visualize a rolled up project status. In addition to FDD projects, Parking lot diagrams also may be useful on XP or Scrum projects. To read more about parking lot diagrams, see Summarizing Progress with Parking Lot Diagrams.
This documentation is a little sparse. In between now and when I can fill it out, feel free to contact me with any questions.
This application's dependencies are managed by Composer. It is built using Box. The Makefile assumes that the box executable is in your path
A parking lot diagram is a high-level visualization of a project status. Traditionally, parking lot diagrams represent Feature Areas, Feature Sets, and Features. This may be analogous to a hierarchy of Epics, Features, and Stories.
To build, simply run make in the top level directory.
The executable will be built to bin/ParkingLotGenerator.phar. Again, the
Makefile assumes that the box and composer executables are in your PATH
(and named e.g. box, not box.phar).
The configuration file describes the feature areas, feature sets, and features from which the parking lot diagram will be built.
Feature Areas - Feature areas consist of a unique name and an array of feature sets.
Feature Sets - Feature sets consist of a feature set name (unique to the feature area), owner, and an array of features.
Features - Features consist of a feature name (unique to the feature set), due date, and status. The due date should be in the format "mm/dd/YYYY". The status may be "Open", "In Progress", or "Completed".
{
"feature_areas": [
{
"name": "Feature Area 1",
"feature_sets": [
{
"name: "Feature Set 1",
"owner": "MSS",
"features": [
{
"name": "feature 1",
"due_date": "01/07/2017",
"status": "Open"
},
{
"name": "feature 2",
"due_date": "01/07/2017",
"status": "In Progress"
},
{
"name": "feature 2",
"due_date": "01/07/2017",
"status": "Completed"
}
]
}
]
}
]
}Run php bin/ParkingLotGenerator.phar --help to display the help.
Description:
Generates a Parking Lot diagram from an input CSV.
Usage:
php ParkingLotGenerator.phar -h | --help
php ParkingLotGenerator.phar --version
php ParkingLotGenerator.phar --input <file path> [--output <file_path>]
Options:
-h --help Show Help
--version Show the version and git commit of this build
--project-name The name of the project
--input The input json file
--output Optional output file (default: './parking_lot.html')
Output: Outputs an html file that contains a ParkingLot Diagram
php bin/ParkingLotGenerator.phar --project-name "Example Project" --input "$HOME/example.json" --output "/var/www/html/parking_lot.html"
You will need to copy assets/css/* to the same destination directory
as your output html.
- I'm not all that great with CSS. The generated report could probably use a
face lift.
- No attempt has been made to ensure a consistent look and feel across different browsers.
- The style sheets from
assets/cssmust be manually copied to the destination directory. - While there is some input validation, it's not as robust as it could be. The
input config file could be better validated.
- WARNING: Some attempt has made to eliminate XSS vulnerabilities in The Parking Lot Generator. However, it is still recommended that untrested input not be processed, as the current XSS mitigations may be incomplete.
- There are currently no application level configuration options (e.g. the report title and "Generated" message are not configurable)
- This documentation is a little sparse. In between now and when I can fill it out, feel free to contact me with any questions.