This is a proxy class for describing relationships between users and can best be understood through an example.
The columns are labeled in a confusing manner:
- A contact has a user, that is you and the perspective we're using from now on.
- A contact has a person that is the other entity in the relationship.
- A connection is thus modeled through two contacts, stored in the database that the user belongs to (can be the same one for local connections). receiving means that the person is receiving posts from the user, given the person can see them (public or matching an aspect_membership).
- sharing is a pure indicator if the person is sharing with the user.
Given we have userA with personA and userB with personB we can have the following situations.
- No contacts at all or contacts with receiving = false and sharing = false: Users do not follow or share with each other.
- contactAB with receiving = true and sharing = false: Then we have contactBA with receiving = false and sharing = true. userA is following personB, userB is not following personA.
- contactBA with receiving = true and sharing = false: Then we have contactAB with receiving = false and sharing = true. userB is following personA, userA is not following personB.
- contactAB with receiving = true and sharing = true: Then we have contactBA with receiving = true and sharing = true. A fully bi-directional relationship, both users are following each other.
Receiving and sharing are synonym terms, their perspective is just a little bit different.