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,104 @@
+# Architecture Index
+
+## Core
+- SIR
+- Rust Parser
+  - `rust/crates/bsl-parser`
+  - JSON CLI contract: `cargo run -p bsl-parser -- <module.bsl>`
+  - output sections: `procedures`, `calls`, `queries`, `writes`, `diagnostics`
+- Semantic Kernel
+- Projection Engine
+- Incremental Indexer
+  - project-level delta rebuild for 1C `.bsl` and `.xml`
+  - preserves metadata object links and object-level impact consistency
+  - refreshes Neo4j projection after incremental updates for already-projected projects
+- Impact Engine
+  - routine-level impact
+  - 1C object-level impact from metadata owner to attributes/tabular sections/tabular section columns/modules/routines/tables/writes/forms/commands/command handlers
+  - role access included in object impact
+  - in-memory and Neo4j API surfaces
+
+## 1C Native
+- Designer CLI adapter primary
+- EDT optional
+- EPF/CFE agent later
+- XML metadata extraction
+  - Catalog / Document / Register / CommonModule
+  - ExchangePlan / ScheduledJob / BusinessProcess / Task / Role
+  - Form / Command / Attribute / TabularSection / Element
+  - Role rights as `GRANTS_ACCESS` edges
+  - metadata object `CONTAINS` BSL module links from 1C export paths
+  - Form commands linked to BSL handlers with `HANDLES`
+  - Object-scoped UI API for 1C forms, commands, elements, and handlers
+  - Scheduled jobs linked to routines with `RUNS`
+  - Integration topology from BSL and XML ExchangePlan metadata
+  - BSL integrations as `INTEGRATION_ENDPOINT` nodes and `USES_INTEGRATION` edges
+
+## Versioning
+- Semantic Object Store primary
+- Git optional adapter
+
+## Knowledge
+- Global / Workspace / Project / Session scopes
+- Knowledge packs
+  - BSP/vendor documentation pack import
+  - pack/vendor metadata enrichment for records
+- Vendor configs
+- BSP detection
+- 1C schema knowledge coverage
+  - review findings for schema nodes without knowledge records
+- Pattern mining
+  - repeated table read/write patterns
+  - repeated routine IO shapes
+
+## Collaboration
+- Users / workspaces / projects
+- Tasks / active task context / change sessions
+- Comments / discussions
+  - project comments API
+  - target-scoped discussion lookup
+- Activity feed
+- 1C object ownership
+  - project ownership API
+  - object-scoped owner lookup
+  - persisted ownership assignments
+
+## Governance
+- RBAC
+- 1C role rights graph
+  - object -> roles access API
+  - role -> objects access API
+  - project report security summary
+  - review warnings for objects without role access
+- Integration governance
+  - project report integration counters
+  - review findings for outbound external integration endpoints
+- Schema governance
+  - project report counters for attributes, tabular sections, columns, and empty tabular sections
+  - review findings for tabular sections without columns
+  - review hints for tabular sections without common subject columns
+- UI governance
+  - review findings for form commands with missing BSL handlers
+- Ownership governance
+  - project report ownership counters
+  - review findings for 1C objects without an assigned owner
+- Privacy modes
+- Privacy classification
+  - project privacy marker API
+  - object-scoped privacy lookup
+  - review hints for sensitive 1C fields without classification
+  - project report privacy counters
+- AI governance
+  - answer policy gate for knowledge context, privacy markers, token budget, and external model calls
+- AI usage governance
+  - AI usage event API
+  - project/user/model/operation usage summaries
+  - token limit policy endpoint
+  - project report AI usage counters
+- Token usage limits
+
+## Operations
+- Jobs / workers / queues
+- Admin console
+- Observability
+- Marketplace/download center