Опиши путь выполняемой задачи от ее получения до релиза на сервера

# Путь задачи от получения до релиза

0. Получение задачи (начало спринта)

Daily standup (9:30)

"Привет, сегодня начиная с TASK-1234: 
Добавить API endpoint для получения истории платежей пользователя"

Что я делаю

1. Читаю описание в JIRA

   • Требования
   • Acceptance Criteria
   • Attached screens/docs
   • Зависимости от других задач

2. Спрашиваю уточнения

   • Tech lead на slack: "Нужна ли пагинация?"
   • Product manager: "Какой срок хранения истории платежей?"
   • Designer: "Какой формат для фильтров?"

3. Обновляю статус в JIRA: In Progress

1. Планирование (1-2 часа)

Technical Design

// Черновик архитектуры
/*
GET /api/v1/users/{userId}/payments
Query params:
  - page: int (default 0)
  - size: int (default 20, max 100)
  - status: COMPLETED|FAILED|PENDING
  - from: ISO-8601 date
  - to: ISO-8601 date

Response:
{
  "content": [
    {
      "id": "uuid",
      "amount": 99.99,
      "currency": "USD",
      "status": "COMPLETED",
      "createdAt": "2025-03-22T10:30:00Z",
      "paymentMethod": "CARD"
    }
  ],
  "totalElements": 150,
  "pageNumber": 0,
  "pageSize": 20,
  "totalPages": 8
}

Database Query:
SELECT * FROM payments 
WHERE user_id = @userId
  AND status = @status
  AND created_at BETWEEN @from AND @to
ORDER BY created_at DESC
LIMIT @limit OFFSET @offset

Need indexes:
- (user_id, created_at DESC)
- (user_id, status, created_at DESC)
*/

Создаю задачи в мозголомке

• Написать тесты (controller + service + repository)
• Implement Repository query
• Implement Service business logic
• Implement Controller endpoint
• Add database index
• Integration test с real DB
• Manual testing (Postman, curl)
• Code review
• Merge to main

2. Тесты (TDD подход)

Написать тесты ДО реализации

// test/java/com/app/payment/PaymentControllerTest.java
@WebMvcTest(PaymentController.class)
class PaymentControllerTest {
    
    @MockBean
    private PaymentService paymentService;
    
    @Autowired
    private MockMvc mockMvc;
    
    @Test
    void shouldReturnUserPaymentsWithPagination() throws Exception {
        // Дано
        UUID userId = UUID.randomUUID();
        Page<PaymentDto> expectedPage = new PageImpl<>(List.of(
            new PaymentDto(UUID.randomUUID(), 99.99, "USD", "COMPLETED", ...),
            new PaymentDto(UUID.randomUUID(), 49.99, "USD", "COMPLETED", ...)
        ), PageRequest.of(0, 20), 2);
        
        when(paymentService.getUserPayments(
            eq(userId), 
            any(PaymentFilter.class),
            any(Pageable.class)
        )).thenReturn(expectedPage);
        
        // Когда
        mockMvc.perform(get("/api/v1/users/{userId}/payments", userId)
            .param("page", "0")
            .param("size", "20")
            .param("status", "COMPLETED"))
        
        // То
        .andExpect(status().isOk())
        .andExpect(jsonPath("$.content[0].amount").value(99.99))
        .andExpect(jsonPath("$.totalElements").value(2))
        .andExpect(jsonPath("$.pageNumber").value(0));
    }
    
    @Test
    void shouldReturnBadRequestIfPageSizeExceedsMax() throws Exception {
        mockMvc.perform(get("/api/v1/users/{userId}/payments", UUID.randomUUID())
            .param("size", "200"))  // Max is 100
        .andExpect(status().isBadRequest());
    }
}

// test/java/com/app/payment/PaymentServiceTest.java
class PaymentServiceTest {
    
    @Mock
    private PaymentRepository repository;
    
    private PaymentService service;
    
    @BeforeEach
    void setUp() {
        service = new PaymentService(repository);
    }
    
    @Test
    void shouldFilterPaymentsByStatus() {
        // Дано
        UUID userId = UUID.randomUUID();
        Payment completed = Payment.builder()
            .id(UUID.randomUUID())
            .userId(userId)
            .status(PaymentStatus.COMPLETED)
            .amount(99.99)
            .build();
        
        Payment failed = Payment.builder()
            .id(UUID.randomUUID())
            .userId(userId)
            .status(PaymentStatus.FAILED)
            .amount(49.99)
            .build();
        
        when(repository.findByUserIdAndStatus(
            eq(userId),
            eq(PaymentStatus.COMPLETED),
            any(Pageable.class)
        )).thenReturn(new PageImpl<>(List.of(completed)));
        
        // Когда
        Page<PaymentDto> result = service.getUserPayments(
            userId,
            PaymentFilter.builder().status(PaymentStatus.COMPLETED).build(),
            PageRequest.of(0, 20)
        );
        
        // То
        assertThat(result.getContent())
            .extracting(PaymentDto::getStatus)
            .containsOnly("COMPLETED");
    }
}

// test/java/com/app/payment/PaymentRepositoryTest.java
@DataJpaTest
class PaymentRepositoryTest {
    
    @Autowired
    private TestEntityManager entityManager;
    
    @Autowired
    private PaymentRepository repository;
    
    @Test
    void shouldFindPaymentsByUserIdWithDateRange() {
        // Дано
        UUID userId = UUID.randomUUID();
        LocalDateTime from = LocalDateTime.parse("2025-03-01T00:00:00");
        LocalDateTime to = LocalDateTime.parse("2025-03-31T23:59:59");
        
        Payment march = createPayment(userId, from.plusDays(5), 99.99);
        Payment february = createPayment(userId, from.minusDays(5), 49.99);
        Payment april = createPayment(userId, to.plusDays(5), 29.99);
        
        entityManager.persistAndFlush(march);
        entityManager.persistAndFlush(february);
        entityManager.persistAndFlush(april);
        
        // Когда
        Page<Payment> result = repository.findByUserIdAndDateRange(
            userId, from, to, PageRequest.of(0, 20)
        );
        
        // То
        assertThat(result.getContent())
            .hasSize(1)
            .extracting(Payment::getAmount)
            .containsExactly(99.99);
    }
}

Все тесты падают (RED) - это нормально!

3. Реализация (2-4 часа)

3a. Database Migration (Goose)

-- migrations/0042_add_payment_indexes.sql
CREATE INDEX idx_payments_user_created 
  ON payments(user_id, created_at DESC);

CREATE INDEX idx_payments_user_status_created 
  ON payments(user_id, status, created_at DESC);

-- Проверить что миграция работает

3b. Repository слой

// java/com/app/payment/domain/PaymentRepository.java (Interface)
public interface PaymentRepository {
    Page<Payment> findByUserIdAndStatus(
        UUID userId,
        PaymentStatus status,
        Pageable pageable
    );
    
    Page<Payment> findByUserIdAndDateRange(
        UUID userId,
        LocalDateTime from,
        LocalDateTime to,
        Pageable pageable
    );
}

// java/com/app/payment/infrastructure/JpaPaymentRepository.java
@Repository
public class JpaPaymentRepository implements PaymentRepository {
    
    private final PaymentJpaRepository jpaRepo;
    
    @Override
    public Page<Payment> findByUserIdAndStatus(
        UUID userId,
        PaymentStatus status,
        Pageable pageable
    ) {
        return jpaRepo.findByUserIdAndStatus(userId, status, pageable)
            .map(this::toDomainModel);
    }
    
    @Override
    public Page<Payment> findByUserIdAndDateRange(
        UUID userId,
        LocalDateTime from,
        LocalDateTime to,
        Pageable pageable
    ) {
        return jpaRepo.findByUserIdAndCreatedAtBetween(
            userId, from, to, pageable
        ).map(this::toDomainModel);
    }
    
    private Payment toDomainModel(PaymentJpaEntity entity) {
        return Payment.builder()
            .id(entity.getId())
            .userId(entity.getUserId())
            .amount(entity.getAmount())
            .status(PaymentStatus.valueOf(entity.getStatus()))
            .createdAt(entity.getCreatedAt())
            .build();
    }
}

// JPA interface (for Spring Data)
@Repository
interface PaymentJpaRepository extends JpaRepository<PaymentJpaEntity, UUID> {
    Page<PaymentJpaEntity> findByUserIdAndStatus(
        UUID userId, String status, Pageable pageable
    );
    
    Page<PaymentJpaEntity> findByUserIdAndCreatedAtBetween(
        UUID userId, LocalDateTime from, LocalDateTime to, Pageable pageable
    );
}

3c. Service слой (бизнес-логика)

@Service
public class PaymentService {
    
    private final PaymentRepository repository;
    
    public Page<PaymentDto> getUserPayments(
        UUID userId,
        PaymentFilter filter,
        Pageable pageable
    ) {
        // Валидация
        if (pageable.getPageSize() > 100) {
            throw new ValidationException("Max page size is 100");
        }
        
        if (pageable.getPageNumber() < 0) {
            throw new ValidationException("Page must be >= 0");
        }
        
        // Получить платежи с фильтрацией
        Page<Payment> payments;
        if (filter.getStatus() != null && hasDateRange(filter)) {
            // Комбинированный фильтр сложнее - используем query
            payments = repository.findByComplexFilter(userId, filter, pageable);
        } else if (filter.getStatus() != null) {
            payments = repository.findByUserIdAndStatus(
                userId, filter.getStatus(), pageable
            );
        } else if (hasDateRange(filter)) {
            payments = repository.findByUserIdAndDateRange(
                userId, filter.getFrom(), filter.getTo(), pageable
            );
        } else {
            payments = repository.findByUserId(userId, pageable);
        }
        
        return payments.map(PaymentDto::from);
    }
}

3d. Controller слой (REST API)

@RestController
@RequestMapping("/api/v1/users/{userId}/payments")
public class PaymentController {
    
    private final PaymentService paymentService;
    private final UserService userService;
    
    @GetMapping
    public ResponseEntity<Page<PaymentDto>> getUserPayments(
        @PathVariable UUID userId,
        @RequestParam(defaultValue = "0") int page,
        @RequestParam(defaultValue = "20") int size,
        @RequestParam(required = false) PaymentStatus status,
        @RequestParam(required = false) 
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) 
        LocalDateTime from,
        @RequestParam(required = false) 
        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME) 
        LocalDateTime to
    ) {
        // Проверка прав доступа
        validateUserAccess(userId);
        
        // Подготовка фильтра
        PaymentFilter filter = PaymentFilter.builder()
            .status(status)
            .from(from)
            .to(to)
            .build();
        
        Pageable pageable = PageRequest.of(
            page, 
            Math.min(size, 100),  // Max 100
            Sort.by("createdAt").descending()
        );
        
        Page<PaymentDto> result = paymentService.getUserPayments(
            userId, filter, pageable
        );
        
        return ResponseEntity.ok(result);
    }
}

Тесты начинают проходить (GREEN) ✅

4. Code Review (1-2 часа)

Создаю Pull Request

Титл: TASK-1234: Add payment history API endpoint

Описание:

Описание проблемы:
Пользователи просили историю своих платежей. Сейчас они могут видеть только
последний платёж в личном кабинете.

Что добавлено:
- GET /api/v1/users/{userId}/payments endpoint
- Фильтрация по статусу, диапазону дат
- Пагинация (max 100 на страницу)
- Database индексы для оптимизации
- 15 unit + integration тестов

Диаграмма:

User Request → PaymentController → PaymentService → PaymentRepository → DB
                    ↓
                Validation
                    ↓
                PageRequest
                    ↓
                Query с индексами

Чего НЕТ:
- Кэширования (пока не нужно)
- Export в PDF/CSV (в backlog)
- Вебхуков о платежах (отдельная задача)

Тестирование:
- Все 15 тестов проходят
- Покрытие: 94%
- Manual test: curl примеры в комментарии

Performance:
- Query время: 50ms для 1000 платежей
- No N+1 problems

Code Review от tech lead

Reviewer feedback:

❌ Line 45: Нужна валидация userId - что если он не существует?
Рекомендация: добавить checkUserExists()

❌ Line 78: Magic number 100 - вынести в константу
Рекомендация: 
  private static final int MAX_PAGE_SIZE = 100;

⚠️ Line 92: Есть потенциальный timezone issue
Комментарий: LocalDateTime в Java - naive (без timezone)
Рекомендация: использовать ZonedDateTime с UTC

✅ Отличная работа с тестами!
✅ Индексы - правильные

Approve с 3 замечаниями

Я исправляю замечания

// Добавить валидацию
@GetMapping
public ResponseEntity<Page<PaymentDto>> getUserPayments(
    @PathVariable UUID userId,
    // ... остальные параметры
) {
    // Проверить, что пользователь существует
    if (!userService.exists(userId)) {
        throw new ResourceNotFoundException("User not found: " + userId);
    }
    // ...
}

// Вынести константу
private static final int MAX_PAGE_SIZE = 100;

if (size > MAX_PAGE_SIZE) {
    size = MAX_PAGE_SIZE;
}

// Timezone
LocalDateTime.now(ZoneId.of("UTC"))  // ✅ Правильно

Я обновляю PR → Tech lead смотрит → Approves ✅

5. Merge в main

# Локально проверяю
git checkout main
git pull origin main

# Запускаю тесты
mvn clean test  # 15 тестов pass ✅
mvn integration-test  # Интеграционные тесты pass ✅

# Merge PR
# (GitHub UI или
git merge feature/TASK-1234
git push origin main

CI/CD pipeline автоматически:

• Запускает все тесты
• Проверяет code coverage (>80%)
• Проверяет linting
• Создаёт artifacts

6. Deploy на staging (1 час)

Staging environment

# DevOps запускает deployment
# (Часто автоматический после merge в main)

# Проверяю на staging
curl https://staging-api.app.com/api/v1/users/\
  550e8400-e29b-41d4-a716-446655440000/payments?page=0&size=20

# Результат:
{
  "content": [ { "id": "...", "amount": 99.99, ... } ],
  "totalElements": 45,
  "pageNumber": 0,
  "pageSize": 20,
  "totalPages": 3
}

# ✅ Работает!

QA тестирует

QA checklist:
✅ GET endpoint работает
✅ Фильтр по статусу работает
✅ Диапазон дат работает
✅ Пагинация работает
✅ Сортировка DESC по дате
✅ Валидация: size > 100 возвращает ошибку
✅ Валидация: несуществующий userId - 404
✅ Performance: 50ms для 1000 платежей ✅
✅ На мобильном: работает ✅

7. Deploy на production (15 минут)

Production deployment

# DevOps (или я, если в его отпуске) выполняет:
# 1. Backup базы данных
# 2. Run миграция (Goose - индексы создаются)
# 3. Blue-green deploy (без downtime)
# 4. Health check
# 5. Rollback plan в случае проблем

# Мониторинг (первые 30 минут)
- Error rate: 0% ✅
- Latency: 45-55ms ✅
- Database CPU: 5% (was 3% before) ✅
- No alerts ✅

8. Post-launch (начало следующего дня)

Monitoring

Дашборд показывает:
- Количество запросов: 2,345 успешных
- P99 latency: 120ms
- Ошибок: 0
- Most common filter: status=COMPLETED (78%)

Инсайт: Большинство запросов - для завершённых платежей
Действие: Подумаём о кэшировании в следующем спринте

Feedback от пользователей

Пользователи говорят:
"Finally! Я могу видеть всю историю платежей 🎉"
"Отлично, что есть фильтры по датам"

Закрыть задачу в JIRA

JIRA TASK-1234:
Statuz: Done ✅
Comment: Развёрнуто на production
          Мониторинг показывает все хорошо
          Ready for next sprint

Итоговый путь

📋 Получение задачи
  ↓
🤔 Планирование & Design (1-2h)
  ↓
🧪 Тесты (RED) (1-2h)
  ↓
💻 Реализация (GREEN) (2-4h)
  ↓
👀 Code Review (1-2h)
  ↓
✅ Merge in main
  ↓
🧪 CI/CD pipeline (автоматический)
  ↓
🟢 Staging deployment (1h)
  ↓
🧪 QA тестирование (30min)
  ↓
🟢 Production deployment (15min)
  ↓
📊 Мониторинг (ongoing)
  ↓
✅ Done!

Время: ~8-12 часов кодирования + waiting for reviews
Время фактическое: 2-3 дня (с reviews и QA)