@rsconcept/rstool 1.9.0 → 2.0.0

package/examples/access-control/anti/weakened.json

@@ -0,0 +1,439 @@
+{
+  "contractVersion": "3.3.0",
+  "state": {
+    "sessionId": "86dcdcd7-c202-42d2-9c8d-57f1e8388cc0",
+    "alias": "RBAC",
+    "title": "Антипример: weakened",
+    "comment": "Ролевое управление доступом. Эксплицировать роли, иерархию и эффективные права для проектирования подсистемы доступа и проверок при назначении ролей.\nL1. Исключено: журнал изменений и сроки хранения (п. 6); невыразимо: кто и когда выдал право, права на прошлую дату.\nL2. Исключено: аутентификация (п. 7); невыразимо: способ входа, учётная запись SSO.\nL3. Исключено: ресурсы как объекты: право — неделимый элемент; невыразимо: права на конкретный документ.\nDC1. иерархия ролей: отношение S3 — п. 2; роль может входить в несколько старших — дерево избыточно ограничивает.\nDC2. права пользователя: вывод через роли (F5, F6) — права пользователя не задаются отдельно — иначе разойдутся с ролями.\nDC3. разделение обязанностей: по эффективным ролям (A2) — п. 4: «в том числе через иерархию».\nDC4. симметричность несовместимости: без аксиомы — A2 запрещает пару в любом порядке; достаточно записать пару один раз.\nDC5. ацикличность иерархии: аксиома A1 через замыкание F1 — п. 2.",
+    "createdAt": "2026-10-25T18:34:35.451Z",
+    "updatedAt": "2026-10-25T18:34:35.455Z",
+    "revisions": [
+      {
+        "revisionId": "1aab62b6-8e68-4aa9-8e40-e55faf471229",
+        "at": "2026-10-25T18:34:35.455Z",
+        "message": "Антипример: weakened: шаг 1"
+      }
+    ],
+    "items": [
+      {
+        "id": 1,
+        "alias": "X1",
+        "cstType": "basic",
+        "definitionFormal": "",
+        "term": "пользователи",
+        "definitionText": "",
+        "convention": "Учётные записи пользователей системы.",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 3,
+              "baseID": "X1"
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 2,
+        "alias": "X2",
+        "cstType": "basic",
+        "definitionFormal": "",
+        "term": "роли",
+        "definitionText": "",
+        "convention": "Роли доступа (администратор, редактор, …).",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 3,
+              "baseID": "X2"
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 3,
+        "alias": "X3",
+        "cstType": "basic",
+        "definitionFormal": "",
+        "term": "права",
+        "definitionText": "",
+        "convention": "Элементарные права: действие над видом ресурса (чтение документов, …).",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 3,
+              "baseID": "X3"
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 4,
+        "alias": "S1",
+        "cstType": "structure",
+        "definitionFormal": "ℬ(X1×X2)",
+        "term": "назначения ролей",
+        "definitionText": "",
+        "convention": "Пара (пользователь, роль): роль назначена пользователю напрямую.",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 4,
+              "factors": [
+                {
+                  "typeID": 3,
+                  "baseID": "X1"
+                },
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                }
+              ]
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 5,
+        "alias": "S2",
+        "cstType": "structure",
+        "definitionFormal": "ℬ(X2×X3)",
+        "term": "права роли",
+        "definitionText": "",
+        "convention": "Пара (роль, право): право дано роли напрямую.",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 4,
+              "factors": [
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                },
+                {
+                  "typeID": 3,
+                  "baseID": "X3"
+                }
+              ]
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 6,
+        "alias": "S3",
+        "cstType": "structure",
+        "definitionFormal": "ℬ(X2×X2)",
+        "term": "иерархия ролей",
+        "definitionText": "",
+        "convention": "Пара (старшая, младшая): старшая роль включает права младшей.",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 4,
+              "factors": [
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                },
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                }
+              ]
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 7,
+        "alias": "S4",
+        "cstType": "structure",
+        "definitionFormal": "ℬ(X2×X2)",
+        "term": "несовместимые роли",
+        "definitionText": "",
+        "convention": "Пара ролей, которые нельзя иметь одному пользователю (разделение обязанностей).",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 5,
+            "base": {
+              "typeID": 4,
+              "factors": [
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                },
+                {
+                  "typeID": 3,
+                  "baseID": "X2"
+                }
+              ]
+            }
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 8,
+        "alias": "F1",
+        "cstType": "function",
+        "definitionFormal": "[ρ∈X2] R{σ:=Pr2(Fi1[{ρ}](S3)) | σ∪Pr2(Fi1[σ](S3))}",
+        "term": "младшие роли",
+        "definitionText": "Роли, которые данная роль включает напрямую или через цепочку.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X2"
+              }
+            },
+            "args": [
+              {
+                "alias": "ρ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X2"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 9,
+        "alias": "F2",
+        "cstType": "function",
+        "definitionFormal": "[ξ∈X1] Pr2(Fi1[{ξ}](S1))",
+        "term": "прямые роли",
+        "definitionText": "Роли, назначенные пользователю напрямую.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X2"
+              }
+            },
+            "args": [
+              {
+                "alias": "ξ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X1"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 10,
+        "alias": "F3",
+        "cstType": "function",
+        "definitionFormal": "[ξ∈X1] red(I{F1[ρ] | ρ:∈F2[ξ]})\\F2[ξ]",
+        "term": "унаследованные роли",
+        "definitionText": "Роли, которые пользователь получает только через иерархию.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X2"
+              }
+            },
+            "args": [
+              {
+                "alias": "ξ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X1"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 11,
+        "alias": "F4",
+        "cstType": "function",
+        "definitionFormal": "[ξ∈X1] F2[ξ]∪F3[ξ]",
+        "term": "эффективные роли",
+        "definitionText": "Прямые и унаследованные роли пользователя.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X2"
+              }
+            },
+            "args": [
+              {
+                "alias": "ξ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X1"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 12,
+        "alias": "F5",
+        "cstType": "function",
+        "definitionFormal": "[ξ∈X1] Pr2(Fi1[F2[ξ]](S2))",
+        "term": "назначенные права",
+        "definitionText": "Права прямых ролей пользователя.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X3"
+              }
+            },
+            "args": [
+              {
+                "alias": "ξ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X1"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 13,
+        "alias": "F6",
+        "cstType": "function",
+        "definitionFormal": "[ξ∈X1] Pr2(Fi1[F4[ξ]](S2))",
+        "term": "эффективные права",
+        "definitionText": "Права всех ролей пользователя, включая унаследованные.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 7,
+            "result": {
+              "typeID": 5,
+              "base": {
+                "typeID": 3,
+                "baseID": "X3"
+              }
+            },
+            "args": [
+              {
+                "alias": "ξ",
+                "type": {
+                  "typeID": 3,
+                  "baseID": "X1"
+                }
+              }
+            ]
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 14,
+        "alias": "A1",
+        "cstType": "axiom",
+        "definitionFormal": "∀ρ∈X2 ρ∉F1[ρ]",
+        "term": "иерархия без циклов",
+        "definitionText": "Роль не включает саму себя ни напрямую, ни через цепочку.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 6
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      },
+      {
+        "id": 15,
+        "alias": "A2",
+        "cstType": "axiom",
+        "definitionFormal": "∀ξ∈X1 ∀(α,β)∈S4 ¬(α∈F2[ξ] & β∈F2[ξ])",
+        "term": "разделение обязанностей",
+        "definitionText": "Ни у одного пользователя нет обеих ролей несовместимой пары, в том числе через иерархию.",
+        "convention": "",
+        "analysis": {
+          "success": true,
+          "type": {
+            "typeID": 6
+          },
+          "valueClass": "value",
+          "diagnostics": []
+        }
+      }
+    ],
+    "model": {
+      "items": []
+    }
+  },
+  "diagnostics": []
+}

package/examples/access-control/brief-v1.json

@@ -0,0 +1,231 @@
+{
+  "version": 1,
+  "status": "confirmed",
+  "approach": "project",
+  "object": "Ролевое управление доступом",
+  "task": "Эксплицировать роли, иерархию и эффективные права для проектирования подсистемы доступа и проверок при назначении ролей",
+  "source": "requirements-v1.md",
+  "restrictions": [
+    {
+      "id": "L1",
+      "excludes": "журнал изменений и сроки хранения (п. 6)",
+      "inexpressible": ["кто и когда выдал право", "права на прошлую дату"]
+    },
+    {
+      "id": "L2",
+      "excludes": "аутентификация (п. 7)",
+      "inexpressible": ["способ входа", "учётная запись SSO"]
+    },
+    {
+      "id": "L3",
+      "excludes": "ресурсы как объекты: право — неделимый элемент",
+      "inexpressible": ["права на конкретный документ"]
+    }
+  ],
+  "expressiveness": [
+    {
+      "id": "E1",
+      "concept": "младшие роли (замыкание иерархии)",
+      "ref": "п. 2",
+      "via": "замыкание S3 через R{}",
+      "constituent": "F1"
+    },
+    {
+      "id": "E2",
+      "concept": "прямые роли пользователя",
+      "ref": "п. 3",
+      "via": "фильтр назначений",
+      "constituent": "F2"
+    },
+    {
+      "id": "E3",
+      "concept": "унаследованные роли пользователя",
+      "ref": "п. 5",
+      "via": "объединение младших ролей прямых ролей минус прямые",
+      "constituent": "F3"
+    },
+    {
+      "id": "E4",
+      "concept": "назначенные права",
+      "ref": "п. 3",
+      "via": "права прямых ролей",
+      "constituent": "F5"
+    },
+    {
+      "id": "E5",
+      "concept": "эффективные права",
+      "ref": "п. 3",
+      "via": "права прямых и унаследованных ролей",
+      "constituent": "F6"
+    }
+  ],
+  "distinctions": [
+    {
+      "id": "V1",
+      "between": ["E4", "E5"],
+      "text": "назначенные права ≠ эффективные",
+      "witness": "SC1"
+    },
+    {
+      "id": "V2",
+      "between": ["E2", "E3"],
+      "text": "прямая роль ≠ унаследованная",
+      "witness": "SC1"
+    }
+  ],
+  "invariants": [
+    {
+      "id": "I1",
+      "text": "В иерархии ролей нет циклов",
+      "ref": "п. 2",
+      "constituent": "A1",
+      "positive": "SC1",
+      "negative": "SC2"
+    },
+    {
+      "id": "I2",
+      "text": "Нет пользователя с обеими ролями несовместимой пары, в том числе через иерархию",
+      "ref": "п. 4",
+      "constituent": "A2",
+      "positive": "SC1",
+      "negative": "SC3"
+    }
+  ],
+  "decisions": [
+    {
+      "id": "DC1",
+      "topic": "иерархия ролей",
+      "alternatives": ["плоские роли без иерархии", "дерево: у роли одна старшая", "отношение S3 (старшая, младшая)"],
+      "choice": "отношение S3",
+      "rationale": "п. 2; роль может входить в несколько старших — дерево избыточно ограничивает"
+    },
+    {
+      "id": "DC2",
+      "topic": "права пользователя",
+      "alternatives": ["структура «права пользователя» S#", "вывод через роли"],
+      "choice": "вывод через роли (F5, F6)",
+      "rationale": "права пользователя не задаются отдельно — иначе разойдутся с ролями"
+    },
+    {
+      "id": "DC3",
+      "topic": "разделение обязанностей",
+      "alternatives": ["по прямым ролям", "по эффективным ролям"],
+      "choice": "по эффективным ролям (A2)",
+      "rationale": "п. 4: «в том числе через иерархию»"
+    },
+    {
+      "id": "DC4",
+      "topic": "симметричность несовместимости",
+      "choice": "без аксиомы",
+      "rationale": "A2 запрещает пару в любом порядке; достаточно записать пару один раз"
+    },
+    {
+      "id": "DC5",
+      "topic": "ацикличность иерархии",
+      "choice": "аксиома A1 через замыкание F1",
+      "rationale": "п. 2"
+    }
+  ],
+  "scenarios": [
+    {
+      "id": "SC1",
+      "title": "Администратор и наблюдатель-аудитор",
+      "values": {
+        "X1": ["ann", "bob"],
+        "X2": ["admin", "editor", "viewer", "auditor"],
+        "X3": ["read", "write", "delete", "audit"],
+        "S1": [
+          ["ann", "admin"],
+          ["bob", "viewer"],
+          ["bob", "auditor"]
+        ],
+        "S2": [
+          ["viewer", "read"],
+          ["editor", "write"],
+          ["admin", "delete"],
+          ["auditor", "audit"]
+        ],
+        "S3": [
+          ["admin", "editor"],
+          ["editor", "viewer"]
+        ],
+        "S4": [["admin", "auditor"]]
+      },
+      "expect": [
+        {
+          "of": "F1",
+          "args": ["admin"],
+          "value": ["editor", "viewer"]
+        },
+        {
+          "of": "F3",
+          "args": ["ann"],
+          "value": ["editor", "viewer"]
+        },
+        {
+          "of": "F3",
+          "args": ["bob"],
+          "value": []
+        },
+        {
+          "of": "F5",
+          "args": ["ann"],
+          "value": ["delete"]
+        },
+        {
+          "of": "F6",
+          "args": ["ann"],
+          "value": ["read", "write", "delete"]
+        },
+        {
+          "of": "F6",
+          "args": ["bob"],
+          "value": ["read", "audit"]
+        }
+      ]
+    },
+    {
+      "id": "SC2",
+      "title": "Цикл в иерархии",
+      "base": "SC1",
+      "values": {
+        "S3": [
+          ["admin", "editor"],
+          ["editor", "viewer"],
+          ["viewer", "admin"]
+        ]
+      },
+      "expect": [
+        {
+          "of": "A1",
+          "holds": false
+        }
+      ]
+    },
+    {
+      "id": "SC3",
+      "title": "Несовместимость через наследование",
+      "base": "SC1",
+      "values": {
+        "S1": [
+          ["ann", "admin"],
+          ["ann", "auditor"]
+        ],
+        "S4": [["editor", "auditor"]]
+      },
+      "expect": [
+        {
+          "of": "A2",
+          "holds": false
+        },
+        {
+          "of": "F2",
+          "args": ["ann"],
+          "value": ["admin", "auditor"]
+        }
+      ]
+    }
+  ],
+  "assumptions": ["право — неделимый элемент, без привязки к конкретному ресурсу"],
+  "openQuestions": []
+}