Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Obair ar thionscadail il-stór

Ceacht 13 as 20 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Bainistiú castachta ailtireachtaí dáilte
  2. An fíorchostas d’athrú tras-ghearrtha
  3. Comhordú il-stórtha
  4. AGENTS.md a chumrú i mona-stór
  5. Dhá shreab oibre tagartha tras-ghearrtha
  6. Cad nach féidir le Codex a dhéanamh duit
  7. Príomhphointí

An ceacht nuashonraithe an 3 Samhain, 2026 bunaithe ar dhoiciméadú Codex Cloud: tá roinnt stórtha beo le chéile anois i dtimpeallacht Codex Cloud (níl an seoladh codex.openai.com ina phointe iontrála a thuilleadh). Foinse: Codex Cloud.

Bainistiú castachta ailtireachtaí dáilte

Is minic a sháraíonn tionscadail nua-aimseartha roinnt stórtha: feidhmchlár tosaigh (frontend), feidhmchlár cúil (backend), leabharlann roinnte, seirbhís íocaíochta. Tá timthriall saoil, píblíne CI, agus cothaitheoirí ar leith ag gach ceann acu. Oibríonn an socrú seo go foirfe—go dtí go dtrasnaíonn athrú teorainneacha stórtha. Sin áit a n-athraíonn Codex an cluiche: is féidir leis obair thar roinnt stórtha ag an am céanna.

An fíorchostas d’athrú tras-ghearrtha

Smaoinigh ar thasc gnáth: cuireann tú réimse le freagra API sa stór cúil. Ansin, ní mór duit an cliant API sa stór tosaigh, na cineálacha roinnte sa stór coiteann, an doiciméadú sa stór doiciméadachta, agus na tástálacha comhtháthaithe sa stór e2e a nuashonrú. Níl aon cheann de na ceithre thasc seo deacair ina n-aonar. Le chéile, ciallaíonn siad ceithre athrú comhthéacs, ceithre brainse, ceithre iarratas tarraingthe (pull request), agus ceithre sheans dearmad a dhéanamh ar cheann amháin. Go praiticiúil, déantar neamhaird ar an doiciméadú nó ar na tástálacha e2e, agus tagann an fhadhb chun cinn trí seachtaine ina dhiaidh sin mar fhabht nach féidir le duine ar bith a rianú ar ais go dtí an gealltanas bunaidh sin.

Comhordú il-stórtha

I Codex Cloud, is féidir le timpeallacht roinnt stórtha GitHub a thabhairt le chéile: roghnaíonn tú iad agus tú ag cruthú na timpeallachta, socraíonn Codex a spleáchais agus a n-uirlisí, agus oibríonn gach tasc a sheoltar sa timpeallacht sin thar an tacar iomlán. Déanann do leid cur síos ar an athrú ina iomláine in ionad blúirí a scaradh:

"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"

Cuirfidh Codex na hathruithe i bhfeidhm i ngach stór agus osclóidh sé iarratais tarraingthe comhordaithe. Leanann scaipeadh cineáil roinnte an loighic chéanna, le ceanglas breise ar chóir duit a lua go sonrach: fíoraigh go n-éiríonn leis an tiomsú (compilation) i ngach stór a ndéantar difear dó. Gan an treoir sin, faighidh tú amach faoin earráid chineáil i CI an stóir shoghluaiste dhá uair an chloig tar éis gach rud eile a chumasc.

"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 a chumrú i mona-stór

Má tá do thionscadal ina mhona-stór (Turborepo, Nx, Lerna), casann an loighic: roinneann pacáistí crann comhaid amháin, agus iompraíonn ordlathas comhaid AGENTS.md na difríochtaí eatarthu. Déanann an comhad fréamhe cur síos ar an struchtúr iomlán agus ar na rialacha a bhaineann le gach áit:

# 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`

Ansin, déanann gach fo-phacáiste tógáil ar an mbunús seo lena choinbhinsiúin féin, gan riamh an méid atá sa chomhad fréamhe a athrá:

# 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__/

Dhá shreab oibre tagartha tras-ghearrtha

Clúdaíonn an chéad cheann gné a sháraíonn an slabhra iomlán. Tabhair faoi deara an ceathrú treoir: d’fhéadfadh an nasc trasna idir iarratais tarraingthe a bheith roghnach, ach is é sin a ligeann don athbhreithnitheoir sa stór tosaigh tuiscint a fháil ar cén fáth a bhfuil an cnaipe sin ann gan an PR cúil comhfhreagrach a lorg.

"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"

Clúdaíonn an dara ceann aistriú API leaganaithe. Anseo, níl ord na gcéimeanna cosmaideach: ráthaíonn sé nach bhfanfaidh aon chliaint ar strae le linn an aistrithe, le v2 ina áit agus v1 fós beo ar fud na fuinneoige aistrithe do thomhaltóirí.

"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"

Cad nach féidir le Codex a dhéanamh duit

Oibríonn Codex stór ar stór, i ngaineamhlaigh ar leithligh. Ní féidir leis dhá stór a rith le chéile: mar shampla, ní féidir leat an feidhmchlár cúil agus an feidhmchlár tosaigh a sheoladh ag an am céanna le haghaidh tástáil chomhtháthaithe fíor. Maidir le tástálacha tras-stórtha, fanann an seicheamh láimhe:

  1. Cumaisc na PRanna aonair
  2. Rith tástálacha comhtháthaithe ó do phíblíne CI/CD
  3. Úsáid Codex chun aon fhadhbanna a braitheadh a shocrú

I bhfocail eile, ráthaíonn Codex comhsheasmhacht an chóid scríofa, ach ní ráthaíonn sé comhsheasmhacht an chórais atá ag rith. Fanann do CI/CD mar an breitheamh deiridh, agus molann an chúram gan sraith de PRanna comhordaithe a chur in úsáid go dtí go bhfuil a bhreithiúnas tugtha aige.

Príomhphointí

  • Is féidir le Codex PRanna comhordaithe a chruthú thar il-stórtha
  • Is cás úsáide idéalach é cineálacha roinnte do shreabha oibre il-stórtha
  • Cumraigh AGENTS.md i ngach pacáiste de mhona-stór
  • Ní mór fós tástálacha comhtháthaithe tras-stórtha a fhíorú i CI/CD
  • Doiciméadaigh spleáchais idir-stórtha in AGENTS.md