From c47e5373e2560a7f8de110e9891192d9fc10fdf5 Mon Sep 17 00:00:00 2001
From: IRBorisov <8611739+IRBorisov@users.noreply.github.com>
Date: Mon, 10 Jun 2024 11:57:48 +0300
Subject: [PATCH] Improve help UI

---
 rsconcept/frontend/public/robots.txt          |  1 -
 .../frontend/src/models/miscellaneous.ts      |  2 ++
 .../src/pages/ManualsPage/TopicPage.tsx       |  6 +++--
 .../ManualsPage/items/HelpConceptOSS.tsx      | 27 +++++++++++++++++++
 .../src/pages/ManualsPage/items/HelpOSS.tsx   | 10 -------
 .../pages/ManualsPage/items/HelpOssGraph.tsx  | 10 +++++++
 rsconcept/frontend/src/utils/labels.ts        |  2 ++
 7 files changed, 45 insertions(+), 13 deletions(-)
 create mode 100644 rsconcept/frontend/src/pages/ManualsPage/items/HelpConceptOSS.tsx
 delete mode 100644 rsconcept/frontend/src/pages/ManualsPage/items/HelpOSS.tsx
 create mode 100644 rsconcept/frontend/src/pages/ManualsPage/items/HelpOssGraph.tsx

diff --git a/rsconcept/frontend/public/robots.txt b/rsconcept/frontend/public/robots.txt
index 087e56dc..a7022980 100644
--- a/rsconcept/frontend/public/robots.txt
+++ b/rsconcept/frontend/public/robots.txt
@@ -1,3 +1,2 @@
 User-agent: *
-Allow: /
 Disallow: /library
\ No newline at end of file
diff --git a/rsconcept/frontend/src/models/miscellaneous.ts b/rsconcept/frontend/src/models/miscellaneous.ts
index ce0f686c..84a1d892 100644
--- a/rsconcept/frontend/src/models/miscellaneous.ts
+++ b/rsconcept/frontend/src/models/miscellaneous.ts
@@ -47,6 +47,7 @@ export enum HelpTopic {
   UI_FORMULA_TREE = 'ui-formula-tree',
   UI_CST_STATUS = 'ui-rsform-cst-status',
   UI_CST_CLASS = 'ui-rsform-cst-class',
+  UI_OSS_GRAPH = 'ui-oss-graph',
 
   CONCEPTUAL = 'concept',
   CC_SYSTEM = 'concept-rsform',
@@ -91,6 +92,7 @@ export const topicParent: Map<HelpTopic, HelpTopic> = new Map([
   [HelpTopic.UI_FORMULA_TREE, HelpTopic.INTERFACE],
   [HelpTopic.UI_CST_STATUS, HelpTopic.INTERFACE],
   [HelpTopic.UI_CST_CLASS, HelpTopic.INTERFACE],
+  [HelpTopic.UI_OSS_GRAPH, HelpTopic.INTERFACE],
 
   [HelpTopic.CONCEPTUAL, HelpTopic.CONCEPTUAL],
   [HelpTopic.CC_SYSTEM, HelpTopic.CONCEPTUAL],
diff --git a/rsconcept/frontend/src/pages/ManualsPage/TopicPage.tsx b/rsconcept/frontend/src/pages/ManualsPage/TopicPage.tsx
index b15e55b0..85f44997 100644
--- a/rsconcept/frontend/src/pages/ManualsPage/TopicPage.tsx
+++ b/rsconcept/frontend/src/pages/ManualsPage/TopicPage.tsx
@@ -4,6 +4,7 @@ import { HelpTopic } from '@/models/miscellaneous';
 import HelpAccess from './items/HelpAccess';
 import HelpAPI from './items/HelpAPI';
 import HelpConcept from './items/HelpConcept';
+import HelpConceptOSS from './items/HelpConceptOSS';
 import HelpConceptRelations from './items/HelpConceptRelations';
 import HelpConceptSynthesis from './items/HelpConceptSynthesis';
 import HelpConceptSystem from './items/HelpConceptSystem';
@@ -17,7 +18,7 @@ import HelpFormulaTree from './items/HelpFormulaTree';
 import HelpInfo from './items/HelpInfo';
 import HelpInterface from './items/HelpInterface';
 import HelpLibrary from './items/HelpLibrary';
-import HelpOSS from './items/HelpOSS';
+import HelpOssGraph from './items/HelpOssGraph';
 import HelpPortal from './items/HelpPortal';
 import HelpPrivacy from './items/HelpPrivacy';
 import HelpRSFormCard from './items/HelpRSFormCard';
@@ -60,13 +61,14 @@ function TopicPage({ topic }: TopicPageProps) {
   if (topic === HelpTopic.UI_FORMULA_TREE) return <HelpFormulaTree />;
   if (topic === HelpTopic.UI_CST_STATUS) return <HelpCstStatus />;
   if (topic === HelpTopic.UI_CST_CLASS) return <HelpCstClass />;
+  if (topic === HelpTopic.UI_OSS_GRAPH) return <HelpOssGraph />;
 
   if (topic === HelpTopic.CONCEPTUAL) return <HelpConcept />;
   if (topic === HelpTopic.CC_SYSTEM) return <HelpConceptSystem />;
   if (topic === HelpTopic.CC_CONSTITUENTA) return <HelpCstAttributes />;
   if (topic === HelpTopic.CC_RELATIONS) return <HelpConceptRelations />;
   if (topic === HelpTopic.CC_SYNTHESIS) return <HelpConceptSynthesis />;
-  if (topic === HelpTopic.CC_OSS) return <HelpOSS />;
+  if (topic === HelpTopic.CC_OSS) return <HelpConceptOSS />;
 
   if (topic === HelpTopic.RSLANG) return <HelpRSLang />;
   if (topic === HelpTopic.RSL_TYPES) return <HelpRSLangTypes />;
diff --git a/rsconcept/frontend/src/pages/ManualsPage/items/HelpConceptOSS.tsx b/rsconcept/frontend/src/pages/ManualsPage/items/HelpConceptOSS.tsx
new file mode 100644
index 00000000..bf7940a3
--- /dev/null
+++ b/rsconcept/frontend/src/pages/ManualsPage/items/HelpConceptOSS.tsx
@@ -0,0 +1,27 @@
+import LinkTopic from '@/components/ui/LinkTopic';
+import { HelpTopic } from '@/models/miscellaneous';
+
+function HelpConceptOSS() {
+  return (
+    <div>
+      <h1>Операционная схема синтеза</h1>
+      <p>
+        Работа со сложными предметными областями требует многократного{' '}
+        <LinkTopic text='синтеза' topic={HelpTopic.CC_SYNTHESIS} /> для построения целевых понятий. Последовательность
+        синтезов концептуальных схем задается с помощью <b>Операционной схемы синтеза (ОСС)</b> в форме Графа синтеза.
+      </p>
+      <p>
+        Отдельные операции в рамках ОСС задаются <b>таблицами отождествлений</b> понятий из синтезируемых схем. Таким
+        образом <LinkTopic text='конституенты' topic={HelpTopic.CC_CONSTITUENTA} /> в каждой КС разделяются на
+        наследованные, отождествленные и дописанные.
+      </p>
+      <p>
+        Портал поддерживает <b>сквозные изменения</b> в рамках ОСС. Изменения, внесенные в исходные концептуальные схемы
+        автоматически проносятся через граф синтеза (путем обновления наследованных конституент). Формальные определения
+        наследованных конституент можно редактировать только путем изменения исходных конституент.
+      </p>
+    </div>
+  );
+}
+
+export default HelpConceptOSS;
diff --git a/rsconcept/frontend/src/pages/ManualsPage/items/HelpOSS.tsx b/rsconcept/frontend/src/pages/ManualsPage/items/HelpOSS.tsx
deleted file mode 100644
index 58d54ff4..00000000
--- a/rsconcept/frontend/src/pages/ManualsPage/items/HelpOSS.tsx
+++ /dev/null
@@ -1,10 +0,0 @@
-function HelpOSS() {
-  return (
-    <div>
-      <h1>Операционная схема синтеза</h1>
-      <p>TBD.</p>
-    </div>
-  );
-}
-
-export default HelpOSS;
diff --git a/rsconcept/frontend/src/pages/ManualsPage/items/HelpOssGraph.tsx b/rsconcept/frontend/src/pages/ManualsPage/items/HelpOssGraph.tsx
new file mode 100644
index 00000000..9cfe4040
--- /dev/null
+++ b/rsconcept/frontend/src/pages/ManualsPage/items/HelpOssGraph.tsx
@@ -0,0 +1,10 @@
+function HelpOssGraph() {
+  return (
+    <div>
+      <h1>Граф синтеза</h1>
+      <p>TBD.</p>
+    </div>
+  );
+}
+
+export default HelpOssGraph;
diff --git a/rsconcept/frontend/src/utils/labels.ts b/rsconcept/frontend/src/utils/labels.ts
index c79bb834..604763fa 100644
--- a/rsconcept/frontend/src/utils/labels.ts
+++ b/rsconcept/frontend/src/utils/labels.ts
@@ -372,6 +372,7 @@ export function labelHelpTopic(topic: HelpTopic): string {
     case HelpTopic.UI_FORMULA_TREE: return 'Дерево разбора';
     case HelpTopic.UI_CST_STATUS:   return 'Статус конституенты';
     case HelpTopic.UI_CST_CLASS:    return 'Класс конституенты';
+    case HelpTopic.UI_OSS_GRAPH:    return 'Граф синтеза';
 
     case HelpTopic.CONCEPTUAL:      return 'Концептуализация';
     case HelpTopic.CC_SYSTEM:       return 'Система определений';
@@ -419,6 +420,7 @@ export function describeHelpTopic(topic: HelpTopic): string {
     case HelpTopic.UI_FORMULA_TREE: return 'просмотр дерева разбора <br/>родоструктурного выражения';
     case HelpTopic.UI_CST_STATUS:   return 'нотация статуса конституенты';
     case HelpTopic.UI_CST_CLASS:    return 'нотация класса конституенты';
+    case HelpTopic.UI_OSS_GRAPH:    return 'графическая форма <br/>операционной схемы синтеза';
 
     case HelpTopic.CONCEPTUAL:      return 'основы концептуализации';
     case HelpTopic.CC_SYSTEM:       return 'концептуальная схема <br/>как система понятий';