sa-lessons/modules/module1/sections/07-architect-role-in-team.md

Роль архитектора в команде

Навигация

• 🏠 Главная страница курса
• 📚 Модуль 1

---

Введение

Solution Architect играет ключевую роль в команде разработки, выступая как технический лидер, наставник и мост между бизнесом и разработкой.

Основные роли архитектора

1. Технический лидер

Обязанности

• Принятие архитектурных решений — выбор технологий и подходов
• Техническое руководство — направление команды в технических вопросах
• Решение сложных проблем — помощь в решении технических вызовов
• Код-ревью — контроль качества кода и архитектурных решений

Примеры деятельности

// Архитектурное решение - выбор паттерна
public class OrderService {
    
    // Архитектор решает использовать Dependency Injection
    private final OrderRepository orderRepository;
    private final PaymentService paymentService;
    private final NotificationService notificationService;
    
    public OrderService(OrderRepository orderRepository,
                       PaymentService paymentService,
                       NotificationService notificationService) {
        this.orderRepository = orderRepository;
        this.paymentService = paymentService;
        this.notificationService = notificationService;
    }
    
    // Архитектор определяет бизнес-логику
    public Order processOrder(OrderRequest request) {
        // 1. Валидация
        validateOrder(request);
        
        // 2. Создание заказа
        Order order = createOrder(request);
        
        // 3. Обработка платежа
        PaymentResult payment = paymentService.processPayment(order);
        
        // 4. Сохранение и уведомление
        if (payment.isSuccess()) {
            order = orderRepository.save(order);
            notificationService.sendConfirmation(order);
        }
        
        return order;
    }
}

2. Наставник и ментор

Обязанности

• Обучение команды — передача знаний и опыта
• Развитие навыков — помощь в профессиональном росте
• Код-ревью — обучение через обратную связь
• Технические сессии — проведение технических презентаций

Примеры наставничества

// Обучение через примеры
public class UserService {
    
    // Показываем правильный подход к обработке ошибок
    public User findById(Long id) {
        if (id == null) {
            throw new IllegalArgumentException("User ID cannot be null");
        }
        
        return userRepository.findById(id)
            .orElseThrow(() -> new UserNotFoundException("User not found with ID: " + id));
    }
    
    // Демонстрируем правильное использование Optional
    public Optional<User> findByEmail(String email) {
        if (email == null || email.trim().isEmpty()) {
            return Optional.empty();
        }
        
        return userRepository.findByEmail(email.trim().toLowerCase());
    }
    
    // Показываем правильную валидацию
    public User createUser(CreateUserRequest request) {
        validateCreateUserRequest(request);
        
        User user = User.builder()
            .name(request.getName().trim())
            .email(request.getEmail().trim().toLowerCase())
            .password(encodePassword(request.getPassword()))
            .build();
            
        return userRepository.save(user);
    }
    
    private void validateCreateUserRequest(CreateUserRequest request) {
        if (request == null) {
            throw new IllegalArgumentException("Request cannot be null");
        }
        if (request.getName() == null || request.getName().trim().isEmpty()) {
            throw new IllegalArgumentException("Name is required");
        }
        if (request.getEmail() == null || !isValidEmail(request.getEmail())) {
            throw new IllegalArgumentException("Invalid email format");
        }
        if (request.getPassword() == null || request.getPassword().length() < 8) {
            throw new IllegalArgumentException("Password must be at least 8 characters");
        }
    }
}

3. Коммуникатор

Обязанности

• Взаимодействие с бизнесом — перевод бизнес-требований в технические решения
• Презентация решений — объяснение архитектурных решений стейкхолдерам
• Документирование — создание архитектурной документации
• Координация команд — обеспечение взаимодействия между командами

Примеры коммуникации

# Архитектурное решение: Выбор базы данных

## Проблема
Система должна обрабатывать 1M+ записей в день с требованиями к производительности < 100ms.

## Варианты решения
1. **PostgreSQL** - реляционная БД с ACID
2. **MongoDB** - документная БД с горизонтальным масштабированием
3. **Redis** - in-memory БД для кэширования

## Рекомендация
**PostgreSQL** + **Redis** для кэширования

## Обоснование
- PostgreSQL обеспечивает ACID и сложные запросы
- Redis обеспечивает быстрый доступ к часто используемым данным
- Комбинация дает лучшее из двух миров

## Влияние на команду
- Разработчики должны изучить Redis
- Нужно реализовать стратегию кэширования
- Мониторинг двух БД

4. Решатель проблем

Обязанности

• Диагностика проблем — анализ и выявление корневых причин
• Поиск решений — исследование и оценка вариантов
• Реализация решений — помощь в реализации сложных решений
• Предотвращение проблем — проактивное выявление потенциальных проблем

Примеры решения проблем

// Проблема: Медленные запросы к БД
// Решение: Добавление индексов и оптимизация запросов

@Entity
@Table(name = "orders", indexes = {
    @Index(name = "idx_order_customer", columnList = "customer_id"),
    @Index(name = "idx_order_status", columnList = "status"),
    @Index(name = "idx_order_created", columnList = "created_at")
})
public class Order {
    @Id
    private Long id;
    
    @Column(name = "customer_id")
    private Long customerId;
    
    @Enumerated(EnumType.STRING)
    private OrderStatus status;
    
    @Column(name = "created_at")
    private LocalDateTime createdAt;
    
    // Оптимизированный запрос
    @Query("SELECT o FROM Order o WHERE o.customerId = :customerId AND o.status = :status ORDER BY o.createdAt DESC")
    List<Order> findByCustomerIdAndStatus(@Param("customerId") Long customerId, 
                                         @Param("status") OrderStatus status);
}

// Проблема: Блокировки при одновременном доступе
// Решение: Использование оптимистичных блокировок

@Entity
public class Product {
    @Id
    private Long id;
    
    private String name;
    private Integer quantity;
    
    @Version
    private Long version; // Для оптимистичных блокировок
    
    public boolean decreaseQuantity(int amount) {
        if (this.quantity >= amount) {
            this.quantity -= amount;
            return true;
        }
        return false;
    }
}

Взаимодействие с разными ролями

1. С разработчиками

Формы взаимодействия

• Ежедневные стендапы — обсуждение технических вопросов
• Код-ревью — контроль качества и обучение
• Технические сессии — обмен знаниями
• Парное программирование — совместная работа над сложными задачами

Примеры взаимодействия

// Код-ревью комментарии
public class UserService {
    
    // ❌ Плохо: Слишком много ответственности
    public User createUser(String name, String email, String password) {
        // валидация
        if (name == null || name.isEmpty()) {
            throw new IllegalArgumentException("Name is required");
        }
        // ... много валидации
        
        // создание пользователя
        User user = new User(name, email, password);
        
        // отправка email
        emailService.sendWelcomeEmail(email);
        
        // логирование
        logger.info("User created: " + email);
        
        return userRepository.save(user);
    }
    
    // ✅ Хорошо: Разделение ответственности
    public User createUser(CreateUserRequest request) {
        validateRequest(request);
        User user = buildUser(request);
        User savedUser = userRepository.save(user);
        notifyUserCreated(savedUser);
        return savedUser;
    }
    
    private void validateRequest(CreateUserRequest request) {
        userValidator.validate(request);
    }
    
    private User buildUser(CreateUserRequest request) {
        return User.builder()
            .name(request.getName())
            .email(request.getEmail())
            .password(encodePassword(request.getPassword()))
            .build();
    }
    
    private void notifyUserCreated(User user) {
        eventPublisher.publishEvent(new UserCreatedEvent(user));
    }
}

2. С DevOps инженерами

Формы взаимодействия

• Планирование инфраструктуры — определение требований к инфраструктуре
• Автоматизация развертывания — настройка CI/CD
• Мониторинг и логирование — настройка observability
• Безопасность — обеспечение безопасности инфраструктуры

Примеры взаимодействия

# docker-compose.yml - совместная работа с DevOps
version: '3.8'
services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=docker
      - DATABASE_URL=jdbc:postgresql://db:5432/myapp
      - REDIS_URL=redis://redis:6379
    depends_on:
      - db
      - redis
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
      interval: 30s
      timeout: 10s
      retries: 3

  db:
    image: postgres:13
    environment:
      POSTGRES_DB: myapp
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user -d myapp"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:6-alpine
    ports:
      - "6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 3

volumes:
  postgres_data:

3. С QA инженерами

Формы взаимодействия

• Планирование тестирования — определение стратегии тестирования
• Техническая поддержка — помощь в понимании архитектуры
• Автоматизация тестов — помощь в создании тестов
• Анализ багов — помощь в диагностике проблем

Примеры взаимодействия

// Помощь в создании тестов
@SpringBootTest
@TestPropertySource(properties = {
    "spring.datasource.url=jdbc:h2:mem:testdb",
    "spring.jpa.hibernate.ddl-auto=create-drop"
})
class OrderServiceIntegrationTest {
    
    @Autowired
    private OrderService orderService;
    
    @Autowired
    private OrderRepository orderRepository;
    
    @Test
    @Transactional
    void shouldCreateOrderSuccessfully() {
        // Given
        CreateOrderRequest request = CreateOrderRequest.builder()
            .customerId(1L)
            .items(Arrays.asList(
                new OrderItemRequest(1L, 2),
                new OrderItemRequest(2L, 1)
            ))
            .build();
        
        // When
        Order result = orderService.createOrder(request);
        
        // Then
        assertThat(result).isNotNull();
        assertThat(result.getCustomerId()).isEqualTo(1L);
        assertThat(result.getItems()).hasSize(2);
        assertThat(result.getStatus()).isEqualTo(OrderStatus.CONFIRMED);
        
        // Проверяем, что заказ сохранен в БД
        Optional<Order> savedOrder = orderRepository.findById(result.getId());
        assertThat(savedOrder).isPresent();
    }
}

4. С Product Manager

Формы взаимодействия

• Планирование функций — оценка технической сложности
• Приоритизация — техническая оценка приоритетов
• Ограничения — объяснение технических ограничений
• Roadmap — техническое планирование

Примеры взаимодействия

# Техническая оценка функции: "Уведомления в реальном времени"

## Описание функции
Пользователи должны получать уведомления о статусе заказа в реальном времени.

## Технические варианты
1. **WebSockets** - прямое соединение
2. **Server-Sent Events** - односторонняя связь
3. **Polling** - периодические запросы

## Рекомендация
**WebSockets** + **Redis Pub/Sub**

## Оценка сложности
- **Время разработки**: 2-3 недели
- **Сложность**: Средняя
- **Зависимости**: Redis, WebSocket поддержка

## Технические требования
- Redis для pub/sub
- WebSocket endpoint
- Frontend WebSocket клиент
- Обработка переподключений

## Риски
- Сложность отладки
- Проблемы с масштабированием
- Совместимость с браузерами

## Альтернативы
- Server-Sent Events (проще, но менее функционально)
- Polling (проще, но менее эффективно)

Управление конфликтами

Типы конфликтов

1. Технические разногласия — разные мнения о технологиях
2. Приоритеты — конфликт между функциональностью и качеством
3. Ресурсы — нехватка времени или людей
4. Ответственность — размытые границы ответственности

Стратегии разрешения

// Пример: Разрешение технического конфликта
public class ConflictResolutionExample {
    
    // Конфликт: Выбор между синхронным и асинхронным подходом
    
    // Вариант 1: Синхронный (простой, но медленный)
    public Order processOrderSync(OrderRequest request) {
        Order order = createOrder(request);
        PaymentResult payment = paymentService.processPayment(order);
        if (payment.isSuccess()) {
            order.confirm();
            notificationService.sendConfirmation(order);
        }
        return order;
    }
    
    // Вариант 2: Асинхронный (сложный, но быстрый)
    public Order processOrderAsync(OrderRequest request) {
        Order order = createOrder(request);
        orderRepository.save(order);
        
        // Асинхронная обработка
        CompletableFuture.runAsync(() -> {
            PaymentResult payment = paymentService.processPayment(order);
            if (payment.isSuccess()) {
                order.confirm();
                orderRepository.save(order);
                notificationService.sendConfirmation(order);
            }
        });
        
        return order;
    }
    
    // Решение: Компромисс - гибридный подход
    public Order processOrderHybrid(OrderRequest request) {
        Order order = createOrder(request);
        
        // Быстрая валидация синхронно
        if (order.getAmount().compareTo(BigDecimal.valueOf(1000)) < 0) {
            return processOrderSync(request);
        } else {
            return processOrderAsync(request);
        }
    }
}

Развитие команды

1. Техническое развитие

• Обучение новым технологиям — проведение технических сессий
• Code review — обучение через обратную связь
• Парное программирование — передача опыта
• Технические вызовы — постановка интересных задач

2. Процессное развитие

• Внедрение лучших практик — Agile, DevOps, CI/CD
• Автоматизация — автоматизация рутинных процессов
• Метрики и мониторинг — внедрение метрик качества
• Документирование — улучшение документации

3. Культурное развитие

• Техническая культура — культура качества кода
• Открытость — открытость к новым идеям
• Экспериментирование — поощрение экспериментов
• Обучение — культура непрерывного обучения

Заключение

Роль Solution Architect в команде многогранна и требует баланса между техническими навыками, лидерскими качествами и коммуникативными способностями. Успешный архитектор не только принимает правильные технические решения, но и помогает команде расти и развиваться, создавая культуру качества и инноваций.