Initial SFERA platform baseline

2026-05-16 19:03:49 +03:00
commit 3b845c8fce
282 changed files with 55045 additions and 0 deletions
@@ -0,0 +1,123 @@
+# Реальный порядок реализации
+
+## Phase 1 — Semantic Core
+
+1. `packages/sir`
+2. `rust/crates/bsl-parser`
+   - deterministic BSL parser;
+   - JSON CLI contract for Python semantic-kernel integration.
+3. `packages/semantic-kernel`
+   - current Python parser remains compatible;
+   - consumes Rust parser JSON as canonical BSL parse source when the CLI is configured or auto-discovered;
+   - metadata object to BSL module links via `CONTAINS`.
+4. `packages/projection-engine`
+5. `packages/incremental-indexer`
+
+## Phase 2 — Object Runtime
+
+1. `packages/one-c-normalizer`
+   - BSL source normalization;
+   - XML metadata extraction for core 1C objects.
+2. `packages/semantic-versioning`
+3. `packages/semantic-search`
+4. `packages/impact-engine`
+5. `packages/review-engine`
+
+## Phase 3 — Runtime Intelligence
+
+1. `runtime-overlays`
+2. `transaction-topology`
+3. `query-intelligence`
+4. `ui-semantics`
+5. `integration-topology`
+6. `job-topology`
+
+## Phase 4 — Knowledge System
+
+1. global/workspace/project knowledge; ✅
+2. BSP/vendor docs; ✅
+3. pattern mining; ✅
+4. knowledge coverage; ✅
+5. AI answer policy. ✅
+
+## Phase 5 — Collaboration
+
+1. users/workspaces/projects; ✅
+2. tasks/sessions; ✅
+3. comments/discussions; ✅
+4. activity feed; ✅
+5. ownership. ✅
+
+## Phase 6 — Governance/Operations
+
+RBAC ✅, privacy ✅, AI usage ✅, jobs ✅, observability ✅, reports ✅, marketplace ✅, licensing ✅, admin ✅.
+
+## Phase 7 — 1C IDE / Authoring
+
+Reference workflow: берём лучшие рабочие паттерны 1С Конфигуратора, но реализуем их как современную AI IDE. Обязательны дерево конфигурации, вкладки открытых объектов, режимы модуль/форма/свойства/события, инспектор, нижние панели проблем/output/diff и быстрый поиск. Дополнительно SFERA должна объединять версии, документацию, знания, обучение, audit и guarded apply.
+
+1. BSL editor foundation:
+   - syntax highlighting;
+   - diagnostics;
+   - outline;
+   - go to definition;
+   - find references;
+   - symbol search.
+2. Semantic autocomplete:
+   - current procedure/function context;
+   - local variables and parameters;
+   - object attributes;
+   - tabular sections and columns;
+   - form elements and commands;
+   - known 1C platform APIs;
+   - mixed Russian/English 1C syntax.
+3. AI pair programmer:
+   - code continuation;
+   - procedure/function generation;
+   - query generation;
+   - register movement generation;
+   - command/form handler generation;
+   - explanation of proposed code.
+4. 1C object designer:
+   - create/update document/catalog/register/common module metadata;
+   - create/update attributes and tabular sections;
+   - create/update commands, forms, form elements and reports.
+5. Semantic diff and guarded apply:
+   - preview every manual or AI change;
+   - impact analysis before apply;
+   - review findings before apply;
+   - privacy/RBAC checks;
+   - object-level version record;
+   - rollback point.
+6. IDE-grade UX:
+   - editor workspace;
+   - object tree;
+   - mode bar: module/form/properties/events/versions/docs/knowledge/training;
+   - properties inspector;
+   - form/report designer;
+   - terminal/command palette;
+   - AI assistant panel;
+   - problems/references/output panels.
+
+7. Documentation/knowledge/training inside IDE:
+   - docs linked to objects, forms, reports, events and routines;
+   - project/vendor/BSP knowledge available next to the code;
+   - team patterns, decisions and examples surfaced by current context;
+   - learning hints for the selected object and available variables;
+   - search across code, metadata, docs, versions and discussions.
+
+## Frontend/UI Gate
+
+Перед началом UI-этапа перечитать и применить актуальные требования:
+
+- `docs/design-system.md`
+- `docs/codex-ui-guidelines.md`
+- `docs/ui-ux-roadmap.md`
+- `docs/component-architecture.md`
+- `docs/frontend-stack.md`
+- `prompts/system-frontend-architect.md`
+- `prompts/ui-generation-prompt.md`
+
+Ключевой принцип: SFERA UI должен ощущаться как современная Enterprise AI IDE / Operating System для 1С, а не legacy CRM. Каждый экран обязан иметь AppShell-compatible layout, loading/error/empty/permission states, адаптивность, права доступа, audit trail для важных действий, таблицы с фильтрами/saved views/bulk actions и AI token/cost impact для AI-действий. Для authoring-экранов обязательны editor/object tree/properties inspector/problems/diff/preview/apply states.
+
+Язык UI/команд: русский по умолчанию, но каждый пользовательский экран должен иметь выбор английского интерфейса. Команды в интерфейсе также проектируются с русским вариантом по умолчанию и английским вариантом как доступным режимом. 1С-код может смешивать русские и английские ключевые слова в одном тексте; parser/review/UI не должны считать это ошибкой.