-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathREADME.txt
105 lines (64 loc) · 3.97 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
Sproingg!
=========
What is Sproingg?
-----------------
Sproingg is an experiment at layering interpersonal communication on top of CouchDB's replication protocol.
Sproingg attempts to use a single simple substrate (CouchDB replication over HTTP) for a number of different modes of interpersonal communication, synchronous and asynchronous, individual, small group and large group. (HTTPS is outside scope for now)
Aside from using CouchDB replication to move structured data (message documents) Sproingg attempts to tackle the problem of endpoint addressing in the context of an HTTP based messaging system.
Does Sproingg work over vanilla CouchDB or does it need extensions?
-------------------------------------------------------------------
The goal is to work on vanilla CouchDB with some specific configuration for databases, some mandatory user(s), specific views and a CouchApp to embody all or large parts of it all (TBD).
To separate CouchDB's being used as Sproingg endpoints from regular CouchDB's the only difference (experimental) is to run the CouchDB to listen on a special port 3939.
How do you express the address of a Sproingg endpoint?
------------------------------------------------------
A Sproingg endpoint is a CouchDB host with a set of mandatory databases, one of which is sphead (sproingg head, kinda like postmaster in email). Only admin users are allowed to access sphead db.
* A typical Sproingg host has a base URL of the form http://mydomain.com:3939/sphead, alternately a URL of the form. Note that :3939 is not required but /sphead is required. Hence given any arbitrary known CouchDB installation, if it has an sphead database then it is assumed to be a Sproingg endpoint.
A CouchDB instance may continue to serve database duties while serving Sproingg requests at the same time.
How are Sproingg addresses discovered?
----------------------------------------
Initial list of Sproingg hosts will be created at sproingg.com/info
How does one initiate a Sproingg session?
-------------------------------------------
Sproingg sessions are *currently* loosely based on SMTP. This may change.
The sender host starts with an initial request to inquire whether the recipient host supports Sproingg i.e has an /sphead endpoint.
A positive response from the responding host is followed by a second request from the sender host to inquire if a specific named recipient exists in the _user db.
Assuming we have reached so far the Sproingg sender initiates a CouchDB replication pushing a Sproingg message on to the recipient hosts message queue via some filtered replication (TBD) that is expected to be present in a Sproingg host.
All of the above to be made specific in terms of endpoints, update handlers etc
What does a Sproingg message look like?
-----------------------------------------
A Sproingg message is a JSON imitation of an email MIME multipart object as follows
<pre>
{
# couchdb preamble
_id: <uuid>,
_rev: <uuid>,
# RFC 822-like
headers: {
from: <string>,
to: <string>,
... RFC822 like
},
# message text body
body: <UTF-8 string>,
# binary attachments
_attachments: {
mime : [
attachment1: { stuff that looks like MIME subpart },
attachment2: { stuff that looks like MIME subpart },
...
]
}
}
</pre>
What does a Sproingg message queue look like?
-----------------------------------------------
What does a Sproingg user database look like?
-----------------------------------------------
What does a Sproingg?
----------------------
Why the name Sproingg?
---------------------
Sproingg sprung out of Couch like a ... spring, making the sound "sproingg!!"
Sproingg is surprising, spontaneous, unexpected and fun all of which are suggested by the sound "Sproingg!".
It is required to use an exclamation mark as in Sproingg! as the mere Sproingg does not catch the spirit of it.
When speaking the word Sproingg! as extended 'g' sound as well as wide eyes and the expression of a jack-in-the-box are suggested.