Size: a a a

2021 June 19

A

A in SPb CoA
Разработчики могут прикрепить ссылку на Swagger
источник

A

A in SPb CoA
Опишите, пожалуйста, алгоритм проектирования API. Мне не очень понятно, где обязанности аналитика переходят в обязанности разработчика

Аналитик составляет концептуальную модель данных, логическую модель данных. Они лягут в основу API

Кто отвечает за разбиение на методы?
Кто проектирует методы API: название, входные параметры, ответ?
источник

AD

Alexey Dronov in SPb CoA
Промолчу. Тоже не до конца понимаю, где работа аналитика при проектировании должна кончиться. Личный опыт подсказывает не доверять целиком разработчикам и хотя бы влезть посмотреть вместе с тестировщиком.
Если у кого-то есть правильный ответ, был бы рад узнать.
источник

A

A in SPb CoA
Скорее всего это зависит от компании. На больших проектах за это отвечают отдельные архитекторы. Они получают от бизнес-аналитика базовую информацию и далее разбивают на методы.

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

На небольших проектах эти обязанности может брать на себя и сам аналитик:
— Разбивает на методы на основе бизнес-логики
— Придумывает названия, методы, содержимое
— Пишет постановки на разработку каждого метода

Если нужно описать API для внешних пользователей, то наверняка аналитик сам должен сначала узнать, что им нужно. Как узнал, наверняка узнаешь:
— Как разбивать на функции. Из пользовательских требований: какие задачи API поможет решать внешним пользователям
— Какие данные они нам шлют. Из разговора с представителями внешних пользователей
— Какие данные мы им будет слать в ответ
— Формат обмена данными

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

F

Fagor in SPb CoA
Прям 1С начинает попахивать.
Нет, есть конечно отдельные направления, где требуются аналитик API, там вопросов нет он вообще все api проектирует. НО это отдельный пласт, выделенный, где есть свои требования к специализации. Арх. если он есть просто утверждает. А часто их несколько, которые просто получает со стороны аналитика контракты что и откуда и как должно.

Но когда вы озвучиваете "Максимум аналитик, который будет консультироваться с разработчиком", мы приходим к консультатнту-аналитику 1С, где встает вопрос а зачем разработчик нужен, т.е. когда у вас типовая конфигурация, где аналитик и кодит модуль (не систему же пишет, так правила обмена), и не объекты же реализует (так регистры не в счет, ну и 1 документ/справочник это разве много объектов), ну и тестирует, что там есть же на 1С авто тесты, ну а где нет, напишет, он же не систему кодит и не авто тесты пишет. И так далее.  Получается такой вроде умеет все, а вроде чуть за порог маленькой среды, не умеет вообще ничего.

В общем мое мнение что аналитик больше должен что и зачем, по каким правилам. А когда начинаются задачи КАК, это уже и жнец и швец и на дуде игрец. Начинают страдать много направлений, в самом проекте. В принципе допустимо, вопрос просто в том что за цели у проекта.
источник

KS

Konstantin Semenov in SPb CoA
Разрабы
источник
2021 June 20

ОИ

Олег Игонин... in SPb CoA
Я как системный рисую рест. Буквально по моему файлу YAML собирают API автогеном.
Да, приходится пристреливаться к API с разработчиком, несколько раз можно редактировать апи.
Аналитик сам может научиться развёртывать подобные приложения, например на java, чтобы смотреть, собираются ли они с ошибками.
С опытом заливаться такие файлы аналитиком начинают с первого раза.

Если API рисует разраб, то слава богу, если там будут понятные термины и структура. Порой бывает жесть - смотришь на апи и думаешь: "кому?", "зачем?", "что именно передаётся?".

В основном такие апи надо рисовать если апишка внешняя, которую надо согласовывать с большим кругом лиц или она будет интеграцией для вашего бизнеса.
источник

ОИ

Олег Игонин... in SPb CoA
Внутренний рест просто должен соответствовать бумажной постановке. Для этого просишь вывести в свагге и перед тестированием смотришь структуру.
источник

ОИ

Олег Игонин... in SPb CoA
Но это заход на территорию солюшн архитектора, т.к. ты проверяешь результат.  
Это чужая работа, также для этого нужны немного другие умения.
Делать или нет - зависит от каждого. Но в целом, системный не должен этим заниматься.
источник

ОИ

Олег Игонин... in SPb CoA
Короч солюш архи должен сделать решение аки конфетку, чтобы не только фантик (апи) были понятными и рабочими, но и внутренности (логика и хранение) были понятными и укладывались во входящие НФТ.
Для всего этого ему надо иметь общие требования к системе.
Он разбирается что и кому надо сделать в каком качестве (получает на вход).
Пишет спеку, подаёт её в печь разработки, а на выходе смотрит, что получается.
Т.е. глянуть что там в базе, глянуть что там в коде, запустить проверку на НФТ, заценить апи - соответствует ли.
Ну и сопровождать на первых парах интеграции.
источник

KS

Konstantin Semenov in SPb CoA
Это всего лишь симптом некомпетентности разработчиков. Или неясности задачи если они не понимают зачем и кому нужен API.
источник

А

Анастасия Воронова... in SPb CoA
Друзья, добрый день. Я работаю над проектом, одной из задачей которого является создание алгоритмов выявления наиболее важных ключевых навыков специалиста, исходя из вакансий. Чтобы проверить работу алгоритмов, мне необходимо экспертное мнение, поэтому обращаюсь к вам и прошу оценить с вашей точки зрения 20 ключевых навыков по 10-ти балльной шкале.
Пожалуйста, если вам не сложно, пройдите анонимный опрос по оценке навыков для аналитика из ИТ по данной ссылке, это займет всего минуту вашего времени. Заранее благодарю)
https://docs.google.com/forms/d/e/1FAIpQLSfZRNVWFMFA6n5u1jxnUkNvaTGGTQjo5MIliQiDyki1hF3tKA/viewform?usp=sf_link
источник

VK

Vladislav Kotov in SPb CoA
А результаты нам покажешь?
источник

А

Анастасия Воронова... in SPb CoA
Окей)
источник

VK

Vladislav Kotov in SPb CoA
Давай только уточним. Аналитик какой? Сферический в вакууме? Аналитик данных/статист или из ИТ?
источник

VK

Vladislav Kotov in SPb CoA
Это сильно влияет на ответы
источник

А

Анастасия Воронова... in SPb CoA
В данном случае рассматривается из ИТ аналитик
источник

А

Анастасия Воронова... in SPb CoA
Извиняюсь, не уточнила
источник

А

Анастасия Воронова... in SPb CoA
Системный и бизнес вместе
источник

DF

Dmitriy Filippov in SPb CoA
Нуден строитель!
Какой строитель, ИТР или прораб?
Да какая разница в КАДе проектировать или цемент замешиваеть, любой сгодится, они же оба строители
источник