sfera/docs/architecture/ARCHITECTURE_INDEX.md

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