Skip to content

Core model specifications (April, 11)

mkalam-alami edited this page Apr 12, 2012 · 7 revisions

Core model specifications (Work in progress)

<<< Back to [[Final soa model design]]

Introduction

This model has been initiated during the April, 11 "codecamp" attended by Open Wide, Nuxeo & EasiFab. Note that:

  • The vocabulary has yet to be refined (e.g. some words weren't translated from French to English)
  • The model is still incomplete and subject to changes, as it has to be tested against more use cases (including those from partners absent from the meeting)

Summary

  1. Concepts
  2. Global schema
  3. Implementation constraints
  1. Views

Resources

1. Concepts

The model is designed around three main categories of information:

  • Design
  • Implementation
  • Deployment

Each facet of the SOA matches different concepts that are, however, linked together.

Design-time concepts

  • Requirements (FR=Exigences): Set of documents that describe the design of a set of additions/changes to the SOA. Serves as a space of storage for design documents (both business design and application architecture), and as a collaborative space to work on design-related topics.
  • Service: A web service, that can be or not provided by the company hosting the EasySOA instance.
  • System: An coherent set of Services from a business point of view.
  • Provider: The orgnization that provides a Service.
  • SLR: Service-Level Requirements, or what is required from a Provider when implementing/deploying a Service.

Schema

Implementation-time concepts

  • Deliverable (FR=Livrable): Artifact needed for the implementation of services. It might directly implement one or more services, or be required by these.
    • Deployable artifact location
    • Source code location
    • Datasets / Tests
    • Technical requirements
    • Developer documentation
    • User documentation
    • Deployment recipes

Deployment-time concepts

  • Environment: Instance of the information system (or a part of it), deployed for a specific purpose (= production, staging, development...)
  • DeployedDeliverable (FR=Implantation): An instance of a Deliverable, deployed on an application server, within an Environment.
  • Endpoint: A Service made available through the web by a DeployedDeliverable, at a specific URL.
  • SLA: Service-Level Agreement. An agreement made between the provider and the consumer of an Endpoint regarding its Quality of Service.
  • SLM: Service-Level Reporting(?). Gathers relevant data that mainly ensures that an SLA has been succesfully satisfied.

Schema

Transversal concepts

  • Project:

2. Global schema

Schema

3. Implementation constraints

Versioning

Roles and rights

4. Views

The EasySOA model aims to support several navigation views (~ 1 per role), most of them having yet to be clearly specified.

  • Navigation by project: Allows all users to explore any resource related to a project. Thus, it gathers arbitrarily all Environments, Deliverables & Requirements that are worked on (through a dashboard?), and helps collaborating around them.
Clone this wiki locally