Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🏗️(docs) init architecture documentation #536

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

olaurendeau
Copy link

Purpose

Provide a better understanding of how doc was built and the current status of the architecture

Screenshot 2025-01-06 at 15 24 44

@olaurendeau olaurendeau changed the title (docs) init architecture documentation 🏗️(docs) init architecture documentation Jan 6, 2025
@AntoLC
Copy link
Collaborator

AntoLC commented Jan 6, 2025

Nice ! Yes it is almost that !
Maybe we can do it in Mermaid wdyt ?

  graph TD;
      A-->B;
      A-->C;
      B-->D;
      C-->D;
Loading

@olaurendeau
Copy link
Author

It's in mermaid :)
https://github.com/suitenumerique/docs/pull/536/files#diff-140eef3ba41bdcf401d507408084181f2c0ac627532b61e0f7906ea7cc926782R5-R18

@AntoLC AntoLC requested review from sampaccoud and AntoLC January 7, 2025 10:04
Comment on lines 7 to 17
User -- HTTP --> Front("Frontend (NextJS)")
Front -- REST API --> Back("Backend (Django)")
Front <-- WebSocket --> Yserver("Microservice Yjs (Express)")
Back <-- WebSocket --> Yserver
Back -- REST API --> Yserver
Back --> DB("Database (PostgreSQL)")
Back <--> Celery --> DB
Front ----> S3
Front -- OIDC ---> Keycloak
Keycloak -- OIDC --> ProConnect
Crowdin
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The archi is more like that.

Suggested change
User -- HTTP --> Front("Frontend (NextJS)")
Front -- REST API --> Back("Backend (Django)")
Front <-- WebSocket --> Yserver("Microservice Yjs (Express)")
Back <-- WebSocket --> Yserver
Back -- REST API --> Yserver
Back --> DB("Database (PostgreSQL)")
Back <--> Celery --> DB
Front ----> S3
Front -- OIDC ---> Keycloak
Keycloak -- OIDC --> ProConnect
Crowdin
User -- HTTP --> Front("Frontend (NextJS SPA)")
Front -- REST API --> Back("Backend (Django)")
Front <-- WebSocket --> Yserver("Microservice Yjs (Express)")
Front -- OIDC --> Back -- OIDC ---> Keycloak
Back -- REST API --> Yserver
Back --> DB("Database (PostgreSQL)")
Back <--> Celery --> DB
Back ----> S3("Minio (S3)")
Keycloak -- OIDC --> ProConnect

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

About the ADR, it is a nice, maybe in another PR, we need a bit of time to work on it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alright, I've updated the PR with your corrections and removed the ADR part

@AntoLC AntoLC added the documentation Improvements or additions to documentation label Jan 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants