feat(docs): Add comprehensive documentation for Vexer, Vulnerability Explorer, and Zastava modules
- Introduced AGENTS.md, README.md, TASKS.md, and implementation_plan.md for Vexer, detailing mission, responsibilities, key components, and operational notes. - Established similar documentation structure for Vulnerability Explorer and Zastava modules, including their respective workflows, integrations, and observability notes. - Created risk scoring profiles documentation outlining the core workflow, factor model, governance, and deliverables. - Ensured all modules adhere to the Aggregation-Only Contract and maintain determinism and provenance in outputs.
This commit is contained in:
		
							
								
								
									
										29
									
								
								docs/modules/orchestrator/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										29
									
								
								docs/modules/orchestrator/README.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,29 @@ | ||||
| # StellaOps Source & Job Orchestrator | ||||
|  | ||||
| The Orchestrator schedules, observes, and recovers ingestion and analysis jobs across the StellaOps platform. | ||||
|  | ||||
| ## Responsibilities | ||||
| - Track job state, throughput, and errors for Concelier, Excititor, Scheduler, and export pipelines. | ||||
| - Expose dashboards and APIs for throttling, replays, and failover. | ||||
| - Enforce rate-limits, concurrency and dependency chains across queues. | ||||
| - Stream structured events and audit logs for incident response. | ||||
|  | ||||
| ## Key components | ||||
| - Orchestrator WebService (control plane). | ||||
| - Queue adapters (Redis/NATS) and job ledger. | ||||
| - Console dashboard module and CLI integration for operators. | ||||
|  | ||||
| ## Integrations & dependencies | ||||
| - Authority for authN/Z on operational actions. | ||||
| - Telemetry stack for job metrics and alerts. | ||||
| - Scheduler/Concelier/Excititor workers for job lifecycle. | ||||
| - Offline Kit for state export/import during air-gap refreshes. | ||||
|  | ||||
| ## Operational notes | ||||
| - Job recovery runbooks and dashboard JSON as described in Epic 9. | ||||
| - Audit retention policies for job history. | ||||
| - Rate-limit reconfiguration guidelines. | ||||
|  | ||||
| ## Epic alignment | ||||
| - Epic 9: Source & Job Orchestrator Dashboard. | ||||
| - ORCH stories in ../../TASKS.md. | ||||
		Reference in New Issue
	
	Block a user