# Реальный порядок реализации

## 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 не должны считать это ошибкой.