Skip to content

Commit

Permalink
Merge pull request #12 from The-Standard-Organization/users/glhays/do…
Browse files Browse the repository at this point in the history
…cumentation-readme-init

DOCUMENTATION: Init Readme Setup
  • Loading branch information
hassanhabib authored May 30, 2024
2 parents fb1b863 + 6c43739 commit de7541d
Show file tree
Hide file tree
Showing 14 changed files with 270 additions and 2 deletions.
85 changes: 84 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,84 @@
# STX.SPAL.Core
![SPAL.Core](https://raw.githubusercontent.com/The-Standard-Organization/STX.SPAL.Core/main/Resources/Images/spalcore-gitlogo.png)

# STX.SPAL.Core

[![Build](https://github.com/The-Standard-Organization/STX.SPAL.Core/actions/workflows/build.yml/badge.svg)](https://github.com/The-Standard-Organization/STX.SPAL.Core/actions/workflows/build.yml)
[![Nuget](https://img.shields.io/nuget/v/STX.SPAL.Core?logo=nuget&style=default)](https://www.nuget.org/packages/STX.SPAL.Core)
[![Nuget](https://img.shields.io/nuget/dt/STX.SPAL.Core?logo=nuget&style=default&color=blue&label=Downloads)](https://www.nuget.org/packages/STX.SPAL.Core)
[![The Standard](https://img.shields.io/github/v/release/hassanhabib/The-Standard?filter=v2.10.1&style=default&label=Standard%20Version&color=2ea44f)](https://github.com/hassanhabib/The-Standard)
[![The Standard - COMPLIANT](https://img.shields.io/badge/The_Standard-COMPLIANT-2ea44f)](https://github.com/hassanhabib/The-Standard)
[![The Standard Community](https://img.shields.io/discord/934130100008538142?color=%237289da&label=The%20Standard%20Community&logo=Discord)](https://discord.gg/vdPZ7hS52X)

## Introduction
This is the Core library for Standardized Provider Abstraction Libraries (SPAL)

SPAL is a concept to provide a standardized way to interact with different providers, such as brokers, and other services.

The SPAL.Core library provides the basic building blocks for creating SPAL libraries.

![Broker Concept](https://raw.githubusercontent.com/hassanhabib/The-Standard/master/1.%20Brokers/Resources/Brokers-1.8.0.png)

SPAL.Core should provide the following features:
>`Extensibility` - Standardized provider abstraction libraries must be extensible to support more external providers.
>
>`Configurability` - For Standardized libraries to be usable with several providers, it must allow engineers to configure them to target a particular provider, local or remote.
>
>`Distributability` - Abstraction libraries must allow several engineers to publish their extensions of the library. The library does not need to have implementations of all providers in one binary. Instead, these libraries must provide an interface or a contract that all other extensions must implement to support a specific provider.
>
>`External Mockability (Cloud-Foreign)` - Standardized provider libraries must allow communications with mocked local phantom APIs.

#### For further information, please refer to this section of the [The-Standard](https://github.com/hassanhabib/The-Standard/blob/master/1.%20Brokers/1.8%20Broker%20Provider%20Abstraction.md)

### Engineering Architecture(InProgress)

![Current Engineering](https://raw.githubusercontent.com/The-Standard-Organization/STX.SPAL.Core/main/Resources/Diagrams/spal-diagram-05292024.png)

## Standard-Compliance
This library was built according to The Standard. The library follows engineering principles, patterns and tooling as recommended by The Standard.

This library is also a community effort which involves many hours of pair-programming, test-driven development and in-depth exploration, research, and design discussions.

## Standard-Promise
The most important fulfillment aspect in a Standard complaint system is aimed towards contributing to people, its evolution, and principles.
An organization that systematically honors an environment of learning, training, and sharing knowledge is an organization that learns from the past, makes calculated risks for the future,
and brings everyone within it up to speed on the current state of things as honestly, rapidly, and efficiently as possible.

We believe that everyone has the right to privacy, and will never do anything that could violate that right.
We are committed to writing ethical and responsible software, and will always strive to use our skills, coding, and systems for the good.
We believe that these beliefs will help to ensure that our software(s) are safe and secure and that it will never be used to harm or collect personal data for malicious purposes.

The Standard Community as a promise to you is in upholding these values.

## Contact Information

If you have any suggestions, comments or questions, please feel free to contact me on:

>[Twitter](https://twitter.com/hassanrezkhabib)
>
>[LinkedIn](https://www.linkedin.com/in/hassanrezkhabib/)
>
>[E-Mail](mailto:[email protected])
### Past Sessions

>Youtube
>
>[SPAL In Action](https://www.youtube.com/watch?v=gCDo24dJ5Fg)
>
>[Standard Provider Abstraction Libraries](https://www.youtube.com/watch?v=JEb0BA8CgFk)
>
>[Standard Provider Abstraction Libraries Part 2](https://www.youtube.com/watch?v=gvoskMQRqHU)
>
>[Standard Provider Abstraction Libraries Part 3](https://www.youtube.com/watch?v=98_9I2hpaKA&t=623s)
>
### Important Notice
A special thanks to all the community members, and the following dedicated engineers for their hard work and dedication to the project.
>Mr. Hassan Habib
>
>Mr. Christo du Toit
>
>Mr. Raul LBoullosa
>
>Mr. Gregory Hays
Loading

0 comments on commit de7541d

Please sign in to comment.