Software architecture notes

This article or section is a stub. Stubs are articles that have not yet received substantial attention from the authors. They are short or insufficient pieces of information and require additions to further increase the article's usefulness. The project values stubs as useful first steps toward complete articles. See Wiki workflow and Wikipedia:Stub for more details on this process. See all the stubs in Category:Stubs

This specification describes what is required for setting up a platform, an organisation designed to form a network of completely independent nodes with other platforms, which we call the platform network. The high-level conceptual development path for platform technology is described here. We will describe our requirements and use cases in order to determine the correct components to use for various aspects. These requirements are based on our research over the past ten years or so regarding what is required for a decentralised, robust and efficient solution to maximise personal empowerment, freedom and privacy and allow for the emergence of bottom-up and grass-roots solutions, and organisations, based on the needs of the people. In our manifesto we describe the principles and values that guide our work and are foundational to these specifications, in particular the four criteria:

• Openness
• Completeness
• Think Global, Act Local
• All Aspects Changeable

Personal Platform

Beginning with the relevance to the individual, the platform is a software package that enables the user to organise his or her own life, to maintain an overview of goals, values, tasks and commitments, much as described by the GTD movement, for personal organisation. In addition, we require communications tools and common office productivity software such as email and schedule, web browser and an office suite. These needs are rounded off by online private and secure file storage services to ensure backup of vital data and synchronisation across multiple devices.

This can all be done now...

Now these things taken individually are nothing special, anyone can choose to set up a computer with a free or paid-for operating system, such as Linux, Apple or even Windows, then install free or paid-for applications to achieve office productivity and personal organisation requirements, followed by setting up online user accounts to access services and even applications in the "cloud". However, there are a number of limitations that become obvious when currently trying to fulfil even these basic personal requirements using off-the-shelf software available on the market today. Without going into full detail, the key issues are:

Fragmentation of data and user accounts

This toolbar along the bottom of a blog article allows people to share the information using their favourite service, possibly several services. Each of these services would have a separate log in and separate data such as user profiles that will need to be kept up to date.

Lack of privacy, especially with free-to-use cloud services

Who has time to read through all that boring legalese, just to set up an account or install some software? Unfortunately it turns out that some terms and conditions are anything but reasonable, claiming ownership and perpetual use of all of the data you upload or share on that service.

Having to pay for proprietary software

Use a lot of online services? Those costs can add up, not to mention being prohibitively expensive in so-called "emerging markets".

Lack of offline synchronisation with most cloud services

Got no Internet? Tough, if your e-life is in the cloud. Most services don't allow for easy offline synchronisation.

Freedom in The Cloud

For more information on the aspects of privacy and fragmentation, view Eben Moglen's talk that inspired the creation of a unified, private open source alternative to Facebook and similar services: Diaspora.

What we want instead

In contrast, what platform offers is an integrated, consistent user interface, with the context being navigated the users areas of interest and personal projects, rather than fragmented applications. We envisage a fully packaged installation file (ISO) that allows an operating system to be set up from scratch on any device, offering a web browser interface to allow the user to define their areas of interest and projects, import legacy data and access any applications as required to do work or just socialise online.

The Platform is a self-contained solution that could for instance run on a laptop, whether or not there is Internet available, which could fetch updates, messages or files as and when connectivity is available. Imagine having one place from which everything is managed, messages and updates are sent from, a private, secure online home with a unified inbox, set of files, bookmarks, documents, contacts, to be easily shared, in a system that just works and is completely self-contained.

The good news is that this is all possible now, by way of integrating existing open source technologies using the right kind of "glue". Further on we will identify our current candidates for fulfilling various aspects described here.

The glue that holds it all together

The framework that we are building platform from can be thought of as a glue that holds together a number of existing technologies and allows new technologies to be integrated as they become available. The structure of the glue is the tree that represents the ontology of the user or organisation being viewed. This tree needs to replace any hierarchical navigation structures being used by existing applications, such as the folder trees of email programs, file managers or bookmarking programs. In addition, there needs to be a global system of tags, that applies across application boundaries and can be used in conjunction with the tree to filter down what is being viewed. For example, imagine you are viewing the tree of "Open Corporation" and wish to follow up on some sales opportunities. You would have selected the "Sales" branch, which gives you the sales portal in the right hand application view. In addition you select "Opportunities" in the tag cloud of "Open Corporation". Then, in the right hand pane you select "Contacts" from the items button. You now have the total amount of contacts filtered down by contacts assigned to the sales department, tagged with "opportunity". The tree manipulation required is as follows:

• Forms-based set up and editing
• User account synchronisation and storage
• Smart caching of content
• High-level portal structure
• User interface and preferences
• Definition of objects and queries, easy creation and adjustment of such
• Subscription to packages of content and functionality across underlying applications
• Robot framework for import, synchronisation, account logins

Record Administration

One aspect of our prototype wiki organisation system has which we haven't been able to find in existing open source solutions is the ability to replicate our portal structure. It's based on the idea of extending the CMS/Wiki to allow the users to adjust their portal structure to suit their own needs using wiki organisation packages as an initial starting point.

In terms of functionality requirements of the portal structure, the foundation concept is that of records and record-types. Records are sets of properties that can be associated with an article. A record-type consists of a form which is used to edit the records of that type, and a template which defines how that set of properties should look in the page.

In conjunction with this is the ability to create simple queries based on property values and resulting in a set of matching records. The results can be rendered as a table or a list, and can be further transformed by using the host CMS's templating system, for example to render the results as a select list in a form, or be adjusted to suit a javascript widget, report or chart.

Queries can be done in a user-friendly way since the templates that need to be added to an article to create them can themselves be record-types so that they're created and modified via their forms rather than difficult syntax.

This approach allows the organisation members to effectively define their own applicational structure which is a dynamic and integral part of their documentation and knowledge structure.

Current solutions and functionality to integrate

• Groupware applications --> emails, contacts, calendars, tasks, projects and Group decisions
• Global accounts and synching via robot framework - OpenID?
• Personal portal and broadcast centre
• CMS
  • Content (procedures, roles, etc.)
  • Ontology portals structure
  • Records, forms & queries
  • Organisational setup (forms) and org. templates
• E-commerce
  • Payment methods/merchant accounts
  • Accounts management
  • Invoicing & reporting
  • Book keeping
• Physical network