# 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