{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Table Of Contents","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"8c635803-dd4b-4e4a-9ea4-96b2c5857f22"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Needed Stories","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"LIFESPAN not to be supported in Casablanca.","type":"text"}]},{"type":"paragraph","content":[{"text":"Chameleon/Gallifrey need to handle all deployment stories (dockerization/runbook/etc), and adhere to junit coverage - amdocs to create these stories","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Historical Meta-properties","type":"text"}]},{"type":"paragraph","content":[{"text":"Outlined in the following ppt: ","type":"text"},{"text":"historyScenarios.pptx","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/download/attachments/16285105/historyScenarios.pptx?version=1&modificationDate=1525805504000&cacheVersion=1&api=v2"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Historical Work Breakdown","type":"text"}]},{"type":"paragraph","content":[{"text":"Historical Tracking Iterations Story Assignment.xlsx","type":"text","marks":[{"type":"link","attrs":{"href":"https://lf-onap.atlassian.net/wiki/download/attachments/16285105/Historical%20Tracking%20Iterations%20Story%20Assignment.xlsx?version=1&modificationDate=1525816306000&cacheVersion=1&api=v2"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"mS Pros/Cons","type":"text"}]},{"type":"paragraph","content":[{"text":"Why are we breaking the functionality out into these granular levels (mainly for scalability, deployment/maintenance flexibility)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Independent Development","type":"text","marks":[{"type":"strong"}]},{"text":" – All microservices can be easily developed based on their individual functionality","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Independent Deployment","type":"text","marks":[{"type":"strong"}]},{"text":" – Microservices can be individually deployed in any application","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fault Isolation","type":"text","marks":[{"type":"strong"}]},{"text":" – Even if one service of the application does not work, the system still continues to function and the fault is easily detectable","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mixed Technology Stack","type":"text","marks":[{"type":"strong"}]},{"text":" – Different languages and technologies can be used to build different services of the same application","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Granular Scaling","type":"text","marks":[{"type":"strong"}]},{"text":" – Individual components can scale as per need, there is no need to scale all components together","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ease of Unit Testing","type":"text","marks":[{"type":"strong"}]},{"text":" - unit testing is easier to maintain as functionality per mS is isolated","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Some disadvantages of splitting out the functionality into these granular microservices are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Full stack error log traceability","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Latency introduced","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deployment more complicated","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"e2e testing more complicated","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"more points of failure","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"High Level Design of microservice flow","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":30.0},"content":[{"type":"media","attrs":{"width":464,"id":"9d98d665-41ef-42b2-a026-8dc73c093db9","collection":"contentId-16285105","type":"file","height":302}}]},{"type":"paragraph","content":[{"text":"Resources","type":"text","marks":[{"type":"strong"}]},{"text":" - Client exposed endpoints","type":"text"}]},{"type":"paragraph","content":[{"text":"Gizmo","type":"text","marks":[{"type":"strong"}]},{"text":" - CRUD abstraction subsystem","type":"text"}]},{"type":"paragraph","content":[{"text":"Synapse","type":"text","marks":[{"type":"strong"}]},{"text":" - Data/request router, will handle the traffic proxying to various microservices based on its built in rules","type":"text"}]},{"type":"paragraph","content":[{"text":"Champ","type":"text","marks":[{"type":"strong"}]},{"text":" - General purpose graph database abstraction","type":"text"}]},{"type":"paragraph","content":[{"text":"Spike","type":"text","marks":[{"type":"strong"}]},{"text":" - publishes dmaap or kafka events and attempts to ensure order","type":"text"}]},{"type":"paragraph","content":[{"text":"Chameleon","type":"text","marks":[{"type":"strong"}]},{"text":" - Subsystem that processes spike events from the real-time graph updates and formats the events, entry point to gallifrey/time machine, and enforces/formats the requests into the format needed by Gallifrey/Time Machine","type":"text"}]},{"type":"paragraph","content":[{"text":"Gallifrey/Time Machine","type":"text","marks":[{"type":"strong"}]},{"text":" - Subsystem that makes & retrieves historical assertions","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"PUT/POST/PATCH/DELETE to real-time flow","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Resources > Gizmo > Champ > Real-time DB Cluster","type":"text"}]},{"type":"paragraph","content":[{"text":"this triggers the historical storage flow","type":"text"}]},{"type":"paragraph","content":[{"text":"Champ > Spike > Chameleon > Gallifrey > Historical Champ > Historical DB Cluster","type":"text"}]},{"type":"paragraph","content":[{"text":"GET of real-time data","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Resources > Gizmo > Synapse > Real-time Champ > Real-time DB Cluster","type":"text"}]},{"type":"paragraph","content":[{"text":"GET of historical data","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Resources > Gizmo > Synapse > Chameleon > Gallifrey/Time Machine > Historical Champ > Historical DB Cluster","type":"text"}]},{"type":"paragraph","content":[{"text":"I feel Chameleon could be bypassed for this flow, treating chameleon's functionality as just the dmaap history processor, and synapse would call gallifrey/tm directly. This way if chameleon goes down, gallifrey/tm could still service historical GET requests.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]}]},{"type":"paragraph","content":[{"text":"Resources > Gizmo > Synapse > Chameleon > Gallifrey/Time Machine > Historical Champ > Historical DB Cluster","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Resources API Spec","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Resources will be updated to accept a timestamp or a network timestamp and will trickle down through gizmo to synapse then to chameleon.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the timestamp was sent on a non-singular node call then we would return a message stating that this functionality is not supported.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Gallifrey/Time Machine API Spec:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"Query Params","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Champ Interaction","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"relationship/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"2156339c-60ac-41d2-b5ea-1dfcc24a184f"}},{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Retrieve a relationship by ID","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Champ needs to handle accepting a relationship id and the timestamp to run a historical query on the graph db","type":"text"}]},{"type":"paragraph","content":[{"text":"A subgraph strategy will be used in champ to filter on the relative timestamp provided.","type":"text"}]},{"type":"paragraph","content":[{"text":"meta=","type":"text","marks":[{"type":"strong"}]},{"text":"[true/false] if true, payload retrieved will hold the metaproperties at t-k or t-t","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"relationship//lifespan","type":"text"}]},{"type":"paragraph","content":[{"text":"NOT in scope for Casablanca - decided on call 5/23/2018","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]},{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"None","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Retrieve all the timestamps for create, update, delete operations against this relationship","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Champ would be called to retrieve the lifespan on the relationship with meta=true and t-k=lifespan to retrieve all the metaproperties on the relationship","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"entity/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"587c1f4e-8d31-4b09-9768-b0a680f9d421"}},{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Retrieve an entity by ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Champ needs to handle accepting an entity id and the timestamp to run a historical query on the graph db retrieving the asserted state. Default not sending back metaproperties, if metaproperties are needed a parameter would need to be sent to champ.","type":"text"}]},{"type":"paragraph","content":[{"text":"A subgraph strategy will be used in champ to filter on the relative timestamp provided.","type":"text"}]},{"type":"paragraph","content":[{"text":"meta=","type":"text","marks":[{"type":"strong"}]},{"text":"[true/false] if true, payload retrieved will hold the metaproperties at t-k","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"entity//lifespan","type":"text"}]},{"type":"paragraph","content":[{"text":"NOT in scope for Casablanca - decided on call 5/23/2018","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"None","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Retrieve all the timestamps for create, update, delete operations against this entity","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Champ would be called to retrieve the lifespan on the entity with meta=true and t-k=lifespan to retrieve all the metaproperties on the entity","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"relationship/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"actor","type":"text","marks":[{"type":"strong"}]},{"text":"=name of the system making the assertion","type":"text"}]},{"type":"paragraph","content":[{"text":"changes-only","type":"text","marks":[{"type":"strong"}]},{"text":"=[true|false] if true, gallifrey/tm will actually determine what has changed between the PUT payload and the most recent set of assertions for the relationship. If false, the entire PUT body will be considered as a new set of assertions whether something has changed or not.","type":"text"}]},{"type":"paragraph","content":[{"text":"create=","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"c3eaf0f7-b90e-4b96-bee7-be50310a37a8"}},{"type":"strong"}]},{"text":"[true|false] if true, Gallifrey/TM assumes that this is a create request, if false it assumes it is an update","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"c3eaf0f7-b90e-4b96-bee7-be50310a37a8"}}]}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"annotation","attrs":{"annotationType":"inlineComment","id":"cc390622-7282-4623-a45f-1f02524b82f3"}},{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Asserts that a relationship is to be created or updated (depending on the query parameters that are passed in). This API appends new assertions against the specified relationship.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generated in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"},{"text":" (why are we generating this here? if there is a maintenance issue our timings would be out of sync with when these took place in the real-time db)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff0000"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"create = false (changes-only true (execute diff)/false(assume everything changed))","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When an assertion is being made without a network timestamp gallifrey/tm will call champ requesting the relationship with it's most current metaproperties. Gallifrey/TM would then adjust the metaproperties (of the updated properties) and would send the payload back to champ with a new current state and an updated previous state's metaproperties. Champ would override it's current metaproperty (for the updated/deleted properties) with the old and current metaproperties sent from Gallifrey/TM. For added properties, they would be added directly with the metaproperties sent from Gallifrey/TM.","type":"text"}]},{"type":"paragraph","content":[{"text":"When an assertion is being made with a network timestamp gallifrey/tm will call champ requesting the relationship with all of its metaproperties. Gallifrey/TM would then insert the new assertion where appropriate (and adjust neighboring metaproperties) and send the modified payload back to champ for a replace.","type":"text"}]},{"type":"paragraph","content":[{"text":"create = true","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"POST - this would be a new create and Gallifrey/TM would pass the metaproperties on each of it's property values and on the relationship itself","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"PUT","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"entity/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"actor","type":"text","marks":[{"type":"strong"}]},{"text":"=name of the system making the assertion","type":"text"}]},{"type":"paragraph","content":[{"text":"changes-only","type":"text","marks":[{"type":"strong"}]},{"text":"=[true|false] if true, gallifrey/tm will actually determine what has changed between the PUT payload and the most recent set of assertions for the entity. If false, the entire PUT body will be considered as a new set of assertions whether something has changed or not.","type":"text"}]},{"type":"paragraph","content":[{"text":"create=","type":"text","marks":[{"type":"strong"}]},{"text":"[true|false] if true, Gallifrey/TM assumes that this is a create request, if false it assumes it is an update","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Asserts that an entity is to be created or updated (depending on the query parameters that are passed in). This API appends new assertions against the specified entity.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generated in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"create = false (changes-only true (execute diff)/false(assume everything changed))","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When an assertion is being made without a network timestamp gallifrey/tm will call champ requesting the entity with it's most current metaproperties. Gallifrey/TM would then adjust the metaproperties (of the updated properties) and would send the payload back to champ with a new current state and an updated previous state's metaproperties. Champ would override it's current metaproperty (for the updated/deleted properties) with the old and current metaproperties sent from Gallifrey/TM. For added properties, they would be added directly with the metaproperties sent from Gallifrey/TM.","type":"text"}]},{"type":"paragraph","content":[{"text":"When an assertion is being made with a network timestamp gallifrey/tm will call champ requesting the entity with all of its metaproperties. Gallifrey/TM would then insert the new assertion where appropriate (and adjust neighboring metaproperties) and send the modified payload back to champ for a replace.","type":"text"}]},{"type":"paragraph","content":[{"text":"create = true","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"POST - this would be a new create and Gallifrey/TM would pass the metaproperties on each of it's property values and on the entity itself","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"relationship/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"actor","type":"text","marks":[{"type":"strong"}]},{"text":"=name of the system making the assertion","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Asserts that a relationship has been deleted.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generated in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Gallifrey/TM would request the latest relationship from champ and would set all of it's properties dbEndTimes to t-k along with the dbEndTime on the relationship itself.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[60.69]},"content":[{"type":"paragraph","content":[{"text":"DELETE","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[142.93]},"content":[{"type":"paragraph","content":[{"text":"entity/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[326.59]},"content":[{"type":"paragraph","content":[{"text":"actor","type":"text","marks":[{"type":"strong"}]},{"text":"=name of the system making the assertion","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.11]},"content":[{"type":"paragraph","content":[{"text":"Asserts that an entity has been deleted.","type":"text"}]},{"type":"paragraph","content":[{"text":"Generated in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[381.68]},"content":[{"type":"paragraph","content":[{"text":"Gallifrey/TM would request the latest entity from champ and would set all of it's properties dbEndTimes to t-k along with the dbEndTime on the entity itself.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Chameleon API Spec","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[52.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[127.0]},"content":[{"type":"paragraph","content":[{"text":"URI","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[835.0]},"content":[{"type":"paragraph","content":[{"text":"Query Params","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[52.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[127.0]},"content":[{"type":"paragraph","content":[{"text":"relationship/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[835.0]},"content":[{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve a relationship by ID","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[52.0]},"content":[{"type":"paragraph","content":[{"text":"GET","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[127.0]},"content":[{"type":"paragraph","content":[{"text":"entity/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[835.0]},"content":[{"type":"paragraph","content":[{"text":"t-k","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies knowledge ie: when we received the assertion in Gallifrey/TM","type":"text"}]},{"type":"paragraph","content":[{"text":"t-t","type":"text","marks":[{"type":"strong"}]},{"text":"=Timestamp that specifies a time assertion made by the client for when the change (update/add/delete) occurred in the network","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[197.0]},"content":[{"type":"paragraph","content":[{"text":"Retrieve an entity by ID","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Between Chameleon->Gallifrey/TM, the following calls are made:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"PUT entity/?actor=aai&create=true","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT relationship/?actor=aai&create=true","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT entity/?actor=aai&changes-only=true","type":"text"}]},{"type":"paragraph","content":[{"text":"PUT relationship/?actor=aai&changes-only =true","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE entity/?actor=aai","type":"text"}]},{"type":"paragraph","content":[{"text":"DELETE relationship/?actor=aai","type":"text"}]},{"type":"paragraph","content":[{"text":"GET entity/?t-k=","type":"text"}]},{"type":"paragraph","content":[{"text":"GET relationship/? t-k=","type":"text"}]},{"type":"paragraph","content":[{"text":"Need Chameleon updated with this:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"GET entity/?t-t=","type":"text"}]},{"type":"paragraph","content":[{"text":"GET relationship/? t-t=","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Champ API Spec","type":"text"}]},{"type":"paragraph","content":[{"text":"Every entity/relationship/property must have a metaproperty or set of meta properties, this will be enforced in champ.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"POST an entity- For History provide meta-properties in the payload","type":"text"}]},{"type":"paragraph","content":[{"text":"Method=POST\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve an entity across its lifespan","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"(called when updating with network time)","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/&meta=latest ","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"(called when updating with only db time)","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve an object for a given database timestamp","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?t-k=t1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?t-k=t1&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve an object for a given network timestamp","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?t-t=t1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?t-t=t1&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UPDATE an object","type":"text"}]},{"type":"paragraph","content":[{"text":"Method=PUT - default=[patch=false] which means full replace\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?patch=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"DELETE an object - DELETE","type":"text"}]},{"type":"paragraph","content":[{"text":"Method=PUT - default=[patch=false] which means full replace\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"https://:9522/services/champ-service/v1/objects/?patch=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"POST a relationship - For History provide meta-properties in the payload","type":"text"}]},{"type":"paragraph","content":[{"text":"Method: POST","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve a relationship across its lifespan","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve a relationship for a given database timestamp","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/?t-k=t1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/?t-k=t1&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Retrieve a relationship for a given network timestamp","type":"text"}]},{"type":"paragraph","content":[{"text":"Method= GET, As default,meta=false\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/?t-t=t1","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/?t-t=t1&meta=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"UPDATE an object","type":"text"}]},{"type":"paragraph","content":[{"text":"Method=PUT - default=[patch=false] which means full replace\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/?patch=true","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"DELETE an object - DELETE","type":"text"}]},{"type":"paragraph","content":[{"text":"Method=PUT - default=[patch=false] which means full replace\n","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"text":"URL: https://:9522/services/champ-service/v1/relationships/","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Historical Tracking Metaproperties","type":"text"}]},{"type":"paragraph","content":[{"text":"dbStartTime - when an entity/property value/relationship was added to db","type":"text"}]},{"type":"paragraph","content":[{"text":"dbEndTime - when and entity or relationship was deleted from the db or a property's value was asserted to another state","type":"text"}]},{"type":"paragraph","content":[{"text":"ntStartTime - asserted by the client as to when the change took place in the network","type":"text"}]},{"type":"paragraph","content":[{"text":"ntEndTime - set when an assertion provided by the client make's the current state no longer true","type":"text"}]},{"type":"paragraph","content":[{"text":"startSOT - the source of truth that made the assertion","type":"text"}]},{"type":"paragraph","content":[{"text":"endSOT- the source of truth that made an assertion to make the current state no longer true","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Schema","type":"text"}]},{"type":"paragraph","content":[{"text":"Separate db edge rules file: with all relationships many to many except parent child which could be one to many","type":"text"}]},{"type":"paragraph","content":[{"text":"Separate schema file: no properties on vertices are unique except for aai-uuid","type":"text"}]},{"type":"paragraph","content":[{"text":"Open question: what happens in the event that db edge rules change etc. (migrations)","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"When To Record T-K value (Live DB vs Historical DB)","type":"text"}]},{"type":"paragraph","content":[{"text":"Below is an explanation of the thoughts around when to record the t-k value, examples explaining outcome of storing at live vs historical DB and their pros/cons.","type":"text"}]},{"type":"paragraph","content":[{"type":"mediaInline","attrs":{"id":"2a96a18a-4616-407c-8758-1706713a0a4b","collection":"contentId-16285105"}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"GUI Mocks","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"New integrated functionality (updates for history)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":23.0},"content":[{"type":"media","attrs":{"width":979,"id":"e0ba3dc1-d6fc-4af8-b7b8-38ade5dd5cf7","collection":"contentId-16285105","type":"file","height":822}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Existing GUI","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Topology Current view","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":26.0},"content":[{"type":"media","attrs":{"width":1114,"id":"81ee6d17-d951-4012-a63c-07af3d829f5b","collection":"contentId-16285105","type":"file","height":830}}]},{"type":"paragraph","content":[{"text":"Updates include a history button, which pops up a date/time picker to replace the topology view with that historical topology. In the bottom right, it will designate the time period, and if not current the ability to revert back to current.","type":"text"}]},{"type":"paragraph","content":[{"text":"Compare pops up different date/time picker for a secondary topology. to compare against.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Compare View","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":13.0},"content":[{"type":"media","attrs":{"width":1114,"id":"bd12b707-84d8-4977-9afd-47a453bf926e","collection":"contentId-16285105","type":"file","height":1566}}]}],"version":1}

Browser not supported