Skip to content

Latest commit

 

History

History
85 lines (47 loc) · 5.79 KB

README.md

File metadata and controls

85 lines (47 loc) · 5.79 KB

hREA: The Holochain/REA coordination framework

About

hREA is a suite of functionally independent building blocks affording most functionality commonly used in supply chain systems, project management software, logistics management and enterprise resource planning; as well as post-capitalist economic paradigms such as gift and contributory economies.

Using holochain for data storage, data integrity, networking, and runtime, hREA comes with an adapter library for GraphQL in Javascript, which is the main way to interface with the hREA suite.

Releases of the Javascript GraphQL libraries happen through npm: main and more customizable

Releases of the Holochain "hApp"s are here on Github, and can be found in the releases page (the ones that are prefixed happ-).

What do we mean by "most functionality"?-

  • people & groups: use the agent kit to keep track of people and groups and build trust in the network
  • scheduled deliverables: use the plan kit to create a schedule of related operational processes with defined deliverables
  • agreements and contracts: use the agreement kit when handling market exchanges (e.g. purchases) or other contracts and mutual obligations
  • event ledger: use the observation kit to track the observed movements of resources, currencies and skills in any coordination space
  • coordination functions: use the planning kit to decide on future plans, manage agreements or coordinate actions with other participants
  • needs matching: use the proposal kit to group matched outcomes in order to describe bilateral and multilateral trade requests

All 6 of these come with the pre-packaged "full suite" that is the default configuration that is shipped.

These other capabilites are some of what's on the roadmap:

  • group management: manage groups of collaborators and permission access between groups, sub-projects and across organisations
  • knowledge sharing: use the recipe module to share structured production knowledge and easily repeat well-understood processes

A key aspect to note about these modules is that they require no technical knowledge to remix or re-architect into different social organising patterns. Different arrangements of network components can be used to address different use-cases in novel ways.

Most people making use of hREA will never have to delve into the software beyond this level. All modules in the suite have established APIs for interoperability and can be arranged into complex organisational patterns at runtime, like lego blocks.

Beyond this outer layer the system has been designed with flexibility, modularity and composability as core architectural concerns. The depth to which you will delve into the architecture depends on a project's needs; i.e. how much customisation is required.

Documentation

Documentation for use of the hREA libraries and packages can be found at docs.hrea.io.

Documentation for the underlying ValueFlows ontology can be found at valueflo.ws.

Documentation (warning: out of date) for potential collaborators and entrepreneurs can be found in the project's ecosystem wiki. This includes information on hREA's organisational goals, strategic mission, design philosophy, cultural background and ideological positioning.

For developers looking to work on the code in this repository, documentation can be found in the docs/ directory. We keep it within the codebase instead of in the wiki so that all contributors retain the information necessary to understand, configure and run the system. There is a quick start guide for those who want to spin up hREA locally for development or experimentation. To understand this whole repository and also how you might go about customising at different layers of the composable stack, check out repository structure.

hREA beyond Holochain

hREA is built to implement the ValueFlows protocol— a set of common vocabularies based on REA Accounting theory to describe flows of economic resources of all kinds within distributed economic ecosystems.

By building to align with the ValueFlows GraphQL spec, UI applications built for hREA are automatically compatible with other ValueFlows-compatible system backends like our partner project Bonfire.

The goal is to enable radical code reuse and cross-project interoperability between next-gen distributed backend systems and traditional web infrastructure, and to allow user interfaces to span multiple disparate apps.

Other names

Previously, this work was referred to as "Holo-REA" or sometimes "HoloREA". All these labels refer to the same project.

🌳 Oak Sponsors

Other contributors of different kinds can be viewed in CONTRIBUTORS.txt.

License

Licensed under an Apache 2.0 license.