foster/forgejo
1
0
Fork 0
mirror of https://codeberg.org/forgejo/forgejo.git synced 2024-11-24 08:57:03 -05:00
Code Issues Wiki Activity

add some pictures

Browse source
This commit is contained in:
Michael Jerger 2024-03-27 19:26:55 +01:00
parent e75bcb2f89
commit 8eae48761f
1 changed files with 25 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

27
docs/unsure-where-to-put/adr-how-to-trigger-activities.md
View file

@ -10,12 +10,20 @@ While implementing the trigger of federated stars we have to handle the distribu
This must be done consistently and without circularity, such that a repository starring by a user leads to exactly one added star in every federated repository. This must be done consistently and without circularity, such that a repository starring by a user leads to exactly one added star in every federated repository.
```mermaid
flowchart TD
U(User) -->|Press Star on UI| A(A: repository - follow C by incident)
A ~~~ B(B: follow A)
B ~~~ C(C: follow B)
C ~~~ A
```
## Decision ## Decision
## Choices ## Choices
### 1. Star Activity Triggers Sending of Star Activity to Federated Repositories ### 1. Transient Federation
In this case the star federation process would look like: In this case the star federation process would look like:
@ -26,6 +34,14 @@ In this case the star federation process would look like:
Circular federation would lead to a infinite circular distribution of Like-Activities: Circular federation would lead to a infinite circular distribution of Like-Activities:
```mermaid
flowchart TD
U(User) -->|Press Star on UI| A(A: repository - follow C by incident)
A -->|federate Like Activity| B(B: follow A)
B -->|federate Like Activity| C(C: follow B)
C -->|federate Like Activity| A
```
1. Given a repo on the 3 instances A, B, C. 1. Given a repo on the 3 instances A, B, C.
Repo on instance A has set repo on instance B as federation repo. Repo on instance A has set repo on instance B as federation repo.
Repo on instance B has set repo on instance C as federation repo. Repo on instance B has set repo on instance C as federation repo.
@ -38,7 +54,14 @@ Circular federation would lead to a infinite circular distribution of Like-Activ
Thus, the repo on instance A gets another star by this user and sends Like-Activity to the repo on instance C. Thus, the repo on instance A gets another star by this user and sends Like-Activity to the repo on instance C.
7. The circular distribution of Like-Activities continues, since the actor is always the local FederatedUser of the sending instance. 7. The circular distribution of Like-Activities continues, since the actor is always the local FederatedUser of the sending instance.
### 2. Only Repository-Starring By Authenticated User Triggers Sending of Star Activity to Federated Repositories ### 2. Direct Federation
```mermaid
flowchart TD
U(User) -->|Press Star on UI| A(A: repository - follow C not allowed)
A -->|federate Like Activity| B(B: follow A)
A -->|federate Like Activity| C(C: follow B not allowed, has to follow A)
```
In this case the star federation process would look like: In this case the star federation process would look like: