Skip to content
This repository has been archived by the owner on Aug 25, 2024. It is now read-only.

Commit

Permalink
docs: arch: open architecture: Restructure and add references
Browse files Browse the repository at this point in the history
References grabbed via case insensitive search for: open architecture

.. code-block:: console

    $ git grep -i open\ architecture | sed -e 's/:.*//g' | sort | uniq

Signed-off-by: Alice A <[email protected]>
Signed-off-by: John Andersen <[email protected]>
  • Loading branch information
Open Architecture Working Group authored Jun 27, 2022
1 parent ba52c1e commit deddb14
Showing 1 changed file with 66 additions and 44 deletions.
110 changes: 66 additions & 44 deletions docs/arch/0009-Open-Architecture.rst
Original file line number Diff line number Diff line change
@@ -1,63 +1,85 @@
Open Architecture Working Group
Internet-Draft
Intended status: Draft
Expires: June 1, 2023
March 12, 2022
Open Architecture
#################

Version: 0.0.1
Date: 2022-04-17

Open Architecture: Methodology for interpreting directed graphs as
any system architecture
Status
******

Abstract
Proposed

This document describes the Open Architecture, aka Alice; a proxy format
for domain specific representations of architecture.
Description
***********

The Open Architecture is a methodology for intepretation of exisitng
well established, formats, protocols, and other domain specific
representations of architecture. We define a methodology for interpreting
a directed graph representing a system architecture.
The Open Architecture is a methodology for interpreting directed graphs as
any system architecture.

We provide implementations which interpret those graphs as software and hardware
architectures.
Context
*******

Status of This Memo
This document describes the Open Architecture; a proxy format for domain
specific representations of architecture.

This Internet-Draft will be submitted in full conformance with the
provisions of BCP 78 and BCP 79.
The Open Architecture is a methodology for intepretation of exisitng
well established, formats, protocols, and other domain specific
representations of architecture. We define a methodology for interpreting
a directed graph representing a system architecture.

This draft will expire on June 1st, 2023.
We provide implementations which interpret graphs as software and hardware
architectures.

Table of Contents
The Open Architecture also enables hybrid on/off chain smart contacts.
It does this by incorporating risk management into architecture definition /
smart contract. Smart contracts with understanding of risk are effectively
entities making decisions based on models. This allows for mutation in
implementation while maintaining principles.

1. Introduction
2. References
The smart contract is able to make its own decisions based on learned
experience so as to continue to operate until its strategic goals are meet.
As measured by oracle data ordained from trusted parties as is
applicable to context. Where chains of trust are established via Peer DIDs
between entities and data for provenance. Leveraging verifiable credentials
for review system to measure risk in absence of attestation.

1. Introduction
Intent
******

The Open Architecture enables hybrid on/off chain smart contacts.
It does this by incorporating risk management into architecture definition /
smart contract. Smart contracts with understanding of risk are effectively
entities making decisions based on models. This allows for mutation in
implementation while maintaining principles.
- ``upstream`` MUST be treated as the document itself if the document is a
domain sepcific architecture or manifest already.

The smart contract is able to make its own decisions based on learned
experience so as to continue to operate until its strategic goals are meet.
As measured by oracle data ordained from trusted parties as is
applicable to context. Where chains of trust are established via Peer DIDs
between entities and data for provenance. Leveraging verifiable credentials
for review system to measure risk in absence of attestation.
- ``overlay`` MUST be applied to upstream following overlay application process
describied in **TODO** `Overlay <https://github.com/intel/dffml/blob/alice/Overlay>`_ if given

2. References
- ``orchestrator`` SHOULD be loaded and inspected for compliance with top level
system context's policy (sandbox) before execution.

2.1. Normative References
References
**********

2.2. Informative References
- Living Threat Models

[alice-reveiw]
DFFML Authors, "Alice", May 2022,
<https://github.com/intel/dffml/pulls/1401>.
- John L Whiteman & John S Andersen, "Living Threat Models", June 11th 2022
- https://github.com/johnlwhiteman/living-threat-models

[living-threat-models]
John L Whiteman & John S Andersen, "Living Threat Models", June 11th 2022,
<https://github.com/johnlwhiteman/living-threat-models>.
- TODO

- Add content from discussion thread

- `docs/arch/alice/discussion/0004/reply_0005.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0004/reply_0005.md>`_
- `docs/arch/alice/discussion/0023/reply_0020.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0020.md>`_
- `docs/arch/alice/discussion/0023/reply_0022.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0022.md>`_
- `docs/arch/alice/discussion/0023/reply_0028.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0028.md>`_
- `docs/arch/alice/discussion/0023/reply_0037.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0037.md>`_
- `docs/arch/alice/discussion/0023/reply_0040.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0040.md>`_
- `docs/arch/alice/discussion/0023/reply_0055.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0023/reply_0055.md>`_
- `docs/arch/alice/discussion/0036/reply_0022.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0036/reply_0022.md>`_
- `docs/arch/alice/discussion/0036/reply_0045.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0036/reply_0045.md>`_
- `docs/arch/alice/discussion/0036/reply_0062.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0036/reply_0062.md>`_
- `docs/arch/alice/discussion/0036/reply_0066.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0036/reply_0066.md>`_
- `docs/arch/alice/discussion/0036/reply_0067.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0036/reply_0067.md>`_
- `docs/arch/alice/discussion/0039/index.md <https://github.com/intel/dffml/blob/alice/docs/arch/alice/discussion/0039/index.md>`_
- `docs/tutorials/rolling_alice/0000_architecting_alice/README.md <https://github.com/intel/dffml/blob/alice/docs/tutorials/rolling_alice/0000_architecting_alice/README.md>`_
- `docs/tutorials/rolling_alice/0000_forward.md <https://github.com/intel/dffml/blob/alice/docs/tutorials/rolling_alice/0000_forward.md>`_
- `docs/tutorials/rolling_alice/0000_preface.md <https://github.com/intel/dffml/blob/alice/docs/tutorials/rolling_alice/0000_preface.md>`_
- `docs/tutorials/rolling_alice/README.md <https://github.com/intel/dffml/blob/alice/docs/tutorials/rolling_alice/README.md>`_

0 comments on commit deddb14

Please sign in to comment.