2021-04-20 Architecture Meeting Minutes

   CIECA 500 Westover Dr  #11617; Sanford,  NC  27330 

Date

Apr 20, 2021

Agenda

• Antitrust and Meeting minutes acceptance

• How do we want Phone Number (Formatted, straight numeric, multiple formats for number vs international, just international)

• Finalize and vote on SimpleTypes; we would like everyone to attend to make verify the guidelines being established

• Review and vote on Style Guide

• Versioning of CIECA API

Meeting Minutes

• Antitrust Agreed

• Meeting minutes were updated and approved

• Phone Number

  • Mike removed the US phone number and we only have the International Phone Number pattern in the schema now

  • Phone number extension is not part of the International phone number, however, it is a value that has use in the BMS and has recently been updated to be longer in length.

    • Team thinks it will be best to have Phone Number extension as its own property.

• Review of schema work since last meeting:

  • Year and Year Month was changed to be its own pattern.

    • We can make Month smarter in the future; so values above 12 can not be added.

• Common Global Types

  • Resources or components

    • To be defined as JSON; the Common Global Types will be components

• String

  • We have went back and forth on just going with String or going with String with a min and max; its suggested to look at the Char# values to see which ones are used numerous times and a few times.

  • We have values in the BMS, such as city and address that are defined differently in different sections. We need to make sure we standardize these values moving forward.

• Definition Schemas Vs Full Schema

  • If we only have a schema with definition; there is no way to test those definitions without including them in other messages. If we had full version; we could test all patterns with the definitions.

  • 3.1 allows the concepts that we want, but SwaggerHub and other tools are not available for 3.1 at this time;

    • Do we wait on the tools to be ready or do we move forward with 3.1

      • We looked at Json-schema.org to look at the versioning and what is available for the different versions. Please review this site to help move the conversation forward in our next meeting.

      • AJV is a Json validator built into the Git Hub build pipeline. We can use this to do automated testing for the latest version of JSON 2020-12.

      • We can use other tools besides swaggerHub if we want to move forward with 3.1. We will pick up here next week on the discussion of using 3.1 to get a consensus on the what version to use.

• Please send Paulette your GitHub user name; if you already have a GitHub user so you can be invited to join GitHub. If you do not have a GitHub account, we will use your email to invite you.

Good Meeting! Please review the Json-schema.org website documentation to help determine if we should use OpenAPI Spec 3.1 or a previous version.

Up Next

• Antitrust and Meeting minutes acceptance

• Discuss JSON 3.1 vs previous versions for CIECA APIs

• Finalize and vote on SimpleTypes; we would like everyone to attend to make verify the guidelines being established

• Review and vote on Style Guide

• Versioning of CIECA API

Participants

• Paulette Reed

• Dan Webster

• Mike Hastings

• Brad Broerman

• Aaron Daniele

• Mike Hastings

• Andy Bober

• Jeff Schroder

Participants in the meetings are noted for your information.  If you have questions on the committee’s activities, please contact a recent attendee. Architecture Committee