Дочитал книгу Software Architecture: The Hard Parts. Мне понравилось, кажется, вместе с книгой Fundamentals of Software Architecture от тех же авторов, ее можно рекомендовать как базовый курс архитектуры для синьор разработчиков. Обе, кстати, изданы на русском языке.
Если в API вам нужно вернуть JSON массив, подумайте о том, чтобы завернуть его в объект, даже если кроме этого массива в объекте ничего не будет.
В мире распределенных систем выживают только параноики. Не полный список, с чем вам точно придется столкнуться:
В основе разработки ПО лежит управление сложностью. Добавляя новую функциональность в систему мы неизбежно увеличиваем ее сложность. Но правильные подходы к разработке и хорошо построенная архитектура может замедлить рост сложности.
Проблема только в том, что никто не знает как она должна выглядеть, эта хорошо построенная архитектура.
Но существуют метрики, которые помогают нам оценить архитектуру, о двух таких метриках я бы и хотел поговорить