В кое място в структурната система се намира документацията за API, съответстваща на принципите на чистата архитектура?

Според принципите на чистата архитектура, документацията на API трябва да се намира на границата на системата, тоест в слоя на адаптерите на интерфейса или на нивото на външните интерфейси (например, HTTP обработчици, gRPC услуги).

Това е свързано с факта, че:

• Вътрешните слоеве (бизнес логика, домейн) не трябва да зависят от детайлите на реализирането на API.
• Документацията на API описва контрактите за взаимодействие с външния свят и трябва да отразява точно тези интерфейси.

Обикновено, документацията се намира до кода, който реализира адаптерите и интерфейсите, които свързват вътрешната логика с външните клиенти.

Например, в проект на Go, това може да бъде папка с HTTP обработчици и съответните swagger/openapi спецификации.