---
title: "Federated Architecture"
summary: "Model multi-repo systems, compose architecture across teams, and manage federated governance."
difficulty: "advanced"
topic: "federation"
description: "Master multi-repo architecture with Sruja federation: publishing bundles, composing system indexes, resolving conflicts, and scaling governance across teams."
estimatedTime: "3-4 hours"
---

# Federated Architecture

**Model multi-repo systems with Sruja federation.**

## Why This Course?

Modern organizations have dozens or hundreds of microservices spread across multiple repositories. Traditional architecture tools work per-repo, leaving you with fragmented views and no cross-repo visibility.

Federated architecture with Sruja gives you:
- ✅ **Single source of truth** across all repos
- ✅ **Cross-repo relationships** visible in one diagram
- ✅ **Conflict detection** before they cause problems
- ✅ **Consistent governance** across all teams
- ✅ **AI-ready context** for any editor

## What You'll Learn

- **Bundle Publishing**: Export repo architecture as portable bundles
- **System Composition**: Compose multiple bundles into a unified graph
- **Conflict Resolution**: Handle duplicate services across repos
- **Cross-Repo Relationships**: Model dependencies between repositories
- **Federated Governance**: Scale policies across all repos
- **AI Editor Integration**: Use federated context in AI coding

## Who This Course Is For

- Platform engineers managing multiple repos
- Architects overseeing microservices ecosystems
- DevOps teams needing cross-repo visibility
- Engineering leaders tracking architecture at scale

## Prerequisites

- Familiarity with Sruja DSL basics
- Understanding of microservices architecture
- Experience with multi-repo/monorepo setups
- Basic command line skills

## Estimated Time

3-4 hours

## Course Structure

### Module 1: Federation Fundamentals
Understand federation concepts and basic bundle creation.

**Lessons:**
- [What is Federation?](module-1-federation-fundamentals/lesson-1.md) - Core concepts and architecture
- [Publishing Bundles](module-1-federation-fundamentals/lesson-2.md) - Create and distribute repo bundles
- [Basic Composition](module-1-federation-fundamentals/lesson-3.md) - Compose bundles into system index

### Module 2: Cross-Repo Relationships
Model dependencies between repositories.

**Lessons:**
- [Canonical IDs](module-2-cross-repo-relationships/lesson-1.md) - Unique identification across repos
- [External References](module-2-cross-repo-relationships/lesson-2.md) - Linking to components in other repos
- [Ownership & Contracts](module-2-cross-repo-relationships/lesson-3.md) - Tracking ownership and interfaces

### Module 3: Conflict Resolution
Handle conflicts in federated architecture.

**Lessons:**
- [Detecting Conflicts](module-3-conflict-resolution/lesson-1.md) - Finding duplicate services
- [Resolution Strategies](module-3-conflict-resolution/lesson-2.md) - Approaches to resolving conflicts
- [Conflict Prevention](module-3-conflict-resolution/lesson-3.md) - Preventing future conflicts

### Module 4: Federated Governance
Scale policies and compliance across all repos.

**Lessons:**
- [Federated Policies](module-4-federated-governance/lesson-1.md) - Define policies that span repos
- [Compliance Reporting](module-4-federated-governance/lesson-2.md) - Generate cross-repo compliance reports
- [Governance Automation](module-4-federated-governance/lesson-3.md) - Automate governance with CI/CD

## Learning Outcomes

By the end of this course, you'll be able to:
- ✅ Publish architecture bundles from any repo
- ✅ Compose multiple repos into a unified system index
- ✅ Model cross-repo dependencies
- ✅ Detect and resolve conflicts
- ✅ Implement federated governance
- ✅ Use federated context in AI editors

## Real-World Application

This course uses patterns from:
- **Microservices platforms** with 50+ services
- **Multi-team organizations** with shared components
- **Acquisition integration** merging architectures
- **Monorepo to multi-repo migrations**