Премини към основното съдържание
Български— Изберете език
Меню

Работа с проекти с множество хранилища

Урок 13 от 20 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Управление на сложността на разпределените архитектури
  2. Реалната цена на промяна, засягаща няколко компонента
  3. Координиране на множество хранилища
  4. Конфигуриране на AGENTS.md в монорепозитори
  5. Два референтни работни потока, засягащи няколко компонента
  6. Какво Codex не може да направи за Вас
  7. Ключови изводи

Урокът е актуализиран на 3 ноември 2026 г. въз основа на документацията на Codex Cloud: множество хранилища вече съществуват заедно в среда на Codex Cloud (старият адрес codex.openai.com вече не е входната точка). Източник: Codex Cloud.

Управление на сложността на разпределените архитектури

Съвременните проекти често обхващат множество хранилища: фронтенд, бекенд, споделена библиотека, платежна услуга. Всяко от тях има собствен жизнен цикъл, CI пайплайн и поддържащи екипи. Тази настройка работи перфектно – докато промяна не премине границите на хранилищата. Тук Codex променя правилата на играта: той може да работи едновременно в множество хранилища.

Реалната цена на промяна, засягаща няколко компонента

Помислете за рутинна задача: добавяте поле към API отговор в бекенд хранилището. След това трябва да актуализирате API клиента във фронтенд хранилището, споделените типове в общото хранилище, документацията в docs хранилището и интеграционните тестове в e2e хранилището. Нито една от тези четири задачи не е трудна сама по себе си. Заедно те означават четири превключвания на контекста, четири клона, четири pull request-а и четири шанса да забравите нещо. На практика документацията или e2e тестовете се пропускат и проблемът изплува отново три седмици по-късно като бъг, който никой не може да проследи до първоначалния комит.

Координиране на множество хранилища

В Codex Cloud една среда може да обедини множество GitHub хранилища: Вие ги избирате при създаването на средата, Codex настройва техните зависимости и инструменти, и всяка задача, стартирана в тази среда, работи върху целия набор. Вашият промпт след това описва промяната като цяло, вместо да изолира фрагменти:

"In the backend repo (api-service):
- Add a GET /api/v2/products endpoint with pagination

In the frontend repo (web-app):
- Update the API client to use the new endpoint
- Add pagination to the ProductList component"

Codex прилага промените във всяко хранилище и отваря координирани pull request-и. Разпространението на споделен тип следва същата логика, с едно допълнително изискване, което трябва да посочите изрично: уверете се, че компилацията е успешна във всяко засегнато хранилище. Без тази инструкция ще откриете грешката в типа в CI на мобилното хранилище два часа след като сте обединили всичко останало.

"The Product type in shared-types/src/product.ts has been 
modified (added tags: string[] field). 
Update all usages in:
- api-service: routes and services that use Product
- web-app: components that display a Product
- mobile-app: screens that display a Product
Ensure each repo compiles without errors."

Конфигуриране на AGENTS.md в монорепозитори

Ако Вашият проект е монорепозитори (Turborepo, Nx, Lerna), логиката се обръща: пакетите споделят едно единствено дърво с файлове, а йерархията на файловете AGENTS.md носи разликите между тях. Кореновият файл описва общата структура и правила, които важат навсякъде:

# AGENTS.md (monorepo root)

## Structure
Turborepo monorepo with the following packages:
- packages/api — Fastify backend
- packages/web — Next.js frontend
- packages/shared — Shared types and utilities
- packages/e2e — Playwright end-to-end tests

## Rules
- Changes to packages/shared MUST be followed by a build 
  of all dependent packages
- Global build command: `turbo run build`
- Global test command: `turbo run test`

Всеки под-пакет след това надгражда тази основа със собствените си конвенции, без никога да повтаря онова, което вече е в кореновия файл:

# packages/api/AGENTS.md

## Backend API
- Framework: Fastify
- Validation: Zod (schemas in src/schemas/)
- Types from packages/shared are imported via @myorg/shared
- Every new route requires a test in __tests__/

Два референтни работни потока, засягащи няколко компонента

Първият обхваща функция, която преминава през цялата верига. Обърнете внимание на четвъртата инструкция: връзката между pull request-ите може да изглежда по избор, но именно тя позволява на ревизора на фронтенд хранилището да разбере защо съществува този бутон, без да търси съответния бекенд PR.

"New feature: favorites system.
1. shared-types: Add the Favorite type
2. api-service: CRUD /api/favorites with auth
3. web-app: Heart button on product cards
4. Create a PR in each repo with links 
   to the other repos' PRs in the description"

Вторият обхваща мигриране на версиониран API. Тук редът на стъпките не е козметичен: той гарантира, че никой клиент няма да остане изоставен по средата на миграцията, като v2 е на място, а v1 все още е активен през целия прозорец за миграция на потребителите.

"API v1 /users is deprecated. Create v2:
1. api-service: Add v2 routes with the new format
2. api-service: Mark v1 routes as deprecated (header)
3. web-app: Migrate all calls from v1 to v2
4. mobile-app: Migrate all calls from v1 to v2
5. docs: Update the API documentation"

Какво Codex не може да направи за Вас

Codex работи хранилище по хранилище, в отделни пясъчници. Той не може да стартира две хранилища заедно: например, не можете да стартирате едновременно бекенда и фронтенда за реален интеграционен тест. За тестове между хранилища последователността остава ръчна:

  1. Обединете индивидуалните PR-и
  2. Стартирайте интеграционните тестове от Вашия CI/CD пайплайн
  3. Използвайте Codex, за да поправите всички открити проблеми

С други думи, Codex гарантира съгласуваност на написания код, но никога съгласуваност на работещата система. Вашият CI/CD остава крайният арбитър и предпазливостта диктува, че не трябва да разполагате серия от координирани PR-и, докато той не произнесе своята присъда.

Ключови изводи

  • Codex може да създава координирани PR-и в множество хранилища
  • Споделените типове са идеален случай на употреба за работни потоци с множество хранилища
  • Конфигурирайте AGENTS.md във всеки пакет на монорепозитори
  • Интеграционните тестове между хранилища все още трябва да бъдат проверени в CI/CD
  • Документирайте зависимостите между хранилищата в AGENTS.md