Skip to content

Add documentation on front architecture - #41

Open
freddidierRTE wants to merge 1 commit into
mainfrom
docFront
Open

Add documentation on front architecture#41
freddidierRTE wants to merge 1 commit into
mainfrom
docFront

Conversation

@freddidierRTE

Copy link
Copy Markdown
Contributor

No description provided.

@coderabbitai

coderabbitai Bot commented Jul 28, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

Adds frontend architecture documentation, links it from Architecture.md, and catalogs frontend production dependencies by technical category.

Changes

Frontend architecture documentation

Layer / File(s) Summary
Frontend architecture overview
Architecture.md, FrontEnds/FrontEnds.md
Links to and documents frontend products, shared libraries, technical stack, visualization components, design system, and supported browsers.
Frontend dependency catalog
FrontEnds/FrontEndsDependencies.md
Categorizes frontend production libraries across UI, state, forms, visualization, networking, authentication, and mapping.

Suggested reviewers: ghilesa, jonenst

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Description check ❓ Inconclusive No pull request description was provided, so there is not enough content to assess beyond the change summary. Add a brief PR description explaining the documentation updates and their purpose.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately summarizes the addition of front-end architecture documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Signed-off-by: freddidierRTE <frederic-f.didier@rte-france.com>
@freddidierRTE
freddidierRTE marked this pull request as ready for review July 29, 2026 12:04

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@Architecture.md`:
- Line 13: Update the Markdown link in the front-end architecture documentation
reference to use descriptive text naming the destination, such as “front-end
architecture documentation,” instead of the generic “here,” while preserving the
existing FrontEnds/FrontEnds.md target.

In `@FrontEnds/FrontEnds.md`:
- Line 22: Correct the spreadsheet description in FrontEnds.md by changing “by
pass” to “bypass,” “extend” to “extends,” and removing the space before the
period, while leaving the surrounding wording and link unchanged.
- Around line 3-13: Update the overview text in FrontEnds.md to correct the
grammar and subject-verb agreement in the frontend and shared-code descriptions,
and remove the extra space before the common-ui link’s closing bracket. Preserve
the listed products and links.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 22fdfbc1-f86d-401b-8cb7-237e27455398

📥 Commits

Reviewing files that changed from the base of the PR and between 4259750 and 9cb1a52.

📒 Files selected for processing (3)
  • Architecture.md
  • FrontEnds/FrontEnds.md
  • FrontEnds/FrontEndsDependencies.md

Comment thread Architecture.md

You can find more details about the request routing in [RequestRouting.md](RequestRouting.md).

You can find the front-end architecture documentation [here](FrontEnds/FrontEnds.md).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Use descriptive link text instead of “here”.

Name the destination directly so the link remains understandable in rendered and assistive contexts.

Proposed fix
-You can find the front-end architecture documentation [here](FrontEnds/FrontEnds.md).
+You can find the [front-end architecture documentation](FrontEnds/FrontEnds.md).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
You can find the front-end architecture documentation [here](FrontEnds/FrontEnds.md).
You can find the [front-end architecture documentation](FrontEnds/FrontEnds.md).
🧰 Tools
🪛 markdownlint-cli2 (0.23.1)

[warning] 13-13: Link text should be descriptive

(MD059, descriptive-link-text)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@Architecture.md` at line 13, Update the Markdown link in the front-end
architecture documentation reference to use descriptive text naming the
destination, such as “front-end architecture documentation,” instead of the
generic “here,” while preserving the existing FrontEnds/FrontEnds.md target.

Source: Linters/SAST tools

Comment thread FrontEnds/FrontEnds.md
Comment on lines +3 to +13
Gridsuite is divided in products that each have their frontend :

- Grid Admin
- Grid Explore
- Grid Study
- Grid Monitor
- Grid Dyna

Each frontend share common feature & code that are stored in the [common-ui library ](https://github.com/gridsuite/commons-ui)

To build a new frontend, a template frontend is define in [https://github.com/gridsuite/gridapp-template](https://github.com/gridsuite/gridapp-template)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Fix grammar and link spacing in the overview.

The text contains several agreement errors, and the link has an extra space before its closing bracket.

Proposed fix
-Gridsuite is divided in products that each have their frontend : 
+Gridsuite is divided into products, each with its own frontend:

-Each frontend share common feature & code that are stored in the [common-ui library ](https://github.com/gridsuite/commons-ui)
+Each frontend shares common features and code that are stored in the [common-ui library](https://github.com/gridsuite/commons-ui).

-To build a new frontend, a template frontend is define in [https://github.com/gridsuite/gridapp-template](https://github.com/gridsuite/gridapp-template)
+To build a new frontend, use the template frontend defined in [gridapp-template](https://github.com/gridsuite/gridapp-template).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Gridsuite is divided in products that each have their frontend :
- Grid Admin
- Grid Explore
- Grid Study
- Grid Monitor
- Grid Dyna
Each frontend share common feature & code that are stored in the [common-ui library ](https://github.com/gridsuite/commons-ui)
To build a new frontend, a template frontend is define in [https://github.com/gridsuite/gridapp-template](https://github.com/gridsuite/gridapp-template)
Gridsuite is divided into products, each with its own frontend:
- Grid Admin
- Grid Explore
- Grid Study
- Grid Monitor
- Grid Dyna
Each frontend shares common features and code that are stored in the [common-ui library](https://github.com/gridsuite/commons-ui).
To build a new frontend, use the template frontend defined in [gridapp-template](https://github.com/gridsuite/gridapp-template).
🧰 Tools
🪛 markdownlint-cli2 (0.23.1)

[warning] 11-11: Spaces inside link text

(MD039, no-space-in-links)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@FrontEnds/FrontEnds.md` around lines 3 - 13, Update the overview text in
FrontEnds.md to correct the grammar and subject-verb agreement in the frontend
and shared-code descriptions, and remove the extra space before the common-ui
link’s closing bracket. Preserve the listed products and links.

Source: Linters/SAST tools

Comment thread FrontEnds/FrontEnds.md

## Spreadsheet

To by pass the limitation of agGrid community edition, we create a spreadsheet component that extend the agGrid component . More information about the spreadsheet component can be found in the [spreadsheet documentation](https://github.com/gridsuite/gridstudy-app/blob/main/src/components/spreadsheet-view/README.md)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Correct the spreadsheet description.

Use “bypass” and “extends”, and remove the space before the period.

Proposed fix
-To by pass the limitation of agGrid community edition, we create a spreadsheet component that extend the agGrid component . More information about the spreadsheet component can be found in the [spreadsheet documentation](https://github.com/gridsuite/gridstudy-app/blob/main/src/components/spreadsheet-view/README.md)
+To bypass the limitations of the AG Grid Community Edition, we created a spreadsheet component that extends AG Grid. More information can be found in the [spreadsheet documentation](https://github.com/gridsuite/gridstudy-app/blob/main/src/components/spreadsheet-view/README.md).
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
To by pass the limitation of agGrid community edition, we create a spreadsheet component that extend the agGrid component . More information about the spreadsheet component can be found in the [spreadsheet documentation](https://github.com/gridsuite/gridstudy-app/blob/main/src/components/spreadsheet-view/README.md)
To bypass the limitations of the AG Grid Community Edition, we created a spreadsheet component that extends AG Grid. More information can be found in the [spreadsheet documentation](https://github.com/gridsuite/gridstudy-app/blob/main/src/components/spreadsheet-view/README.md).
🧰 Tools
🪛 LanguageTool

[grammar] ~22-~22: Ensure spelling is correct
Context: ...readsheet To by pass the limitation of agGrid community edition, we create a spreadsh...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)


[grammar] ~22-~22: Ensure spelling is correct
Context: ...a spreadsheet component that extend the agGrid component . More information about the ...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)


[grammar] ~22-~22: Ensure spelling is correct
Context: ...mponent that extend the agGrid component . More information about the spreadsheet...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@FrontEnds/FrontEnds.md` at line 22, Correct the spreadsheet description in
FrontEnds.md by changing “by pass” to “bypass,” “extend” to “extends,” and
removing the space before the period, while leaving the surrounding wording and
link unchanged.

Source: Linters/SAST tools

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant