This is an old revision of the document!


Socialuty

Socialuty aims to be a dinstributed social network: each user can have it's own ”web-pear” (that can host more than one user, anyway), and comunication among pears is made through the socialuty protocol, just in a p2p fashion.

Socialuty will be also the first “web-app” implementation of the pear in php, but ideally anyone could write it's own, even a desktop one, provided she respect the protocol.

This document is about both the protocol spec and the web-app requirements & design, written down while on the job…

Enjoy!

Login

spec

There is no protocol spec for login: each pear can implement its own.

requirements

To use the app users must be logged in.

This is done through an html form containing username and password field.
https protocol must be preferred.
Password are stored/sent as MD5 hashes.

design

users table:

users
usernamevarchar(20) PK
password varchar(20) not null (MD5 hash)
firstname varchar(20) not null
lastname varchar(20) not null
picture varchar(20) (url of the profile picture)

Registration

spec

An user can optionally register to the socialuty.org site as to allow people to find her.
Here is the http to the registration page:


POST /register.php HTTP/1.1
host: www.socialuty.org
User-Agent: <useragent>
Content-Type: application/x-www-form-urlencoded
Content-Length: <length>

firstname=[firstname]
&lastname=[lastname]
&country=[country]
&city=[city]
&home=[pear-url]


HTTP/1.1 200 OK
Content-Type: text/xml

<socialuty:response xmlns:socialuty="www.socialuty.org">
    <result>
        <code>S_OK</ code>
        <description>welcome</description>
        <details>...</details>
    </result>
    <data>
        <userid>1234567890</userid>
    </dat>
</socialuty:response>


Navigation
Personal Tools