AI գործակալների համար

Այս վիքին գրված է միաժամանակ երկու լսարանի համար. մարդկանց, և AI գործակալների, որոնք աշխատում են apps/intelligence-ի ներսում (կամ ցանկացած ապագա գործակալի, որը կառուցված է այս հարթակի վրա)։ Սա հատուկ ինտեգրում չի պահանջում — դա պարզ markdown-ի վրա դրված պայմանավորվածություն է, այնպես որ ցանկացած գործակալ fetch/read գործիքով կարող է օգտագործել այն։

Մուտքի կետ. llms.txt

/llms.txt կայքի արմատում հարթ ինդեքս է. մեկ տող՝ մոդուլի կամ հնարավորության յուրաքանչյուր փաստաթղթի համար, մեկ նախադասությամբ ամփոփումով և հղումով։ Կարդա այն առաջինը, ամբողջ կայքը շրջելու փոխարեն — այն ասում է, թե որ մեկ էջն է, ամենայն հավանականությամբ, կպատասխանի տվյալ հարցին, նախքան որևէ այլ բան fetch անելը։

Յուրաքանչյուր մոդուլի/հնարավորության էջ ունի frontmatter

---
title: IAM — Authentication, Organizations, Roles & Permissions
module: iam
routes: [/auth/*, /org/:slug/roles, /org/:slug/members, /platform/organizations]
permissions: [portal:roles:manage, portal:members:manage, ...]
entities: [User, Organization, Membership, Role, Permission, Invitation]
relatedAdrs: [docs/iam/ADR-001-authentication.md, docs/iam/ADR-003-rbac.md]
lastVerified: 2026-08-04
---

• routes — պորտալի route-երը, որոնք ծածկում է այս փաստաթուղթը։ Օգտակար է, երբ գործակալին անհրաժեշտ է ուղղորդել օգտատիրոջը կոնկրետ էկրան («գնա /org/:slug/roles»)։
• permissions — մոդուլի գործողությունները փակող permission տողերի ճշգրիտ ցանկը։ Սա նույն բառապաշարն է, որ օգտագործվում է docs/iam/PERMISSIONS_CATALOG.md-ում և core-api-ի @RequirePermissions(...) decorator-ներում — գործակալը, որը մտածում է «կարո՞ղ է այս օգտատերը անել X-ը», պետք է համեմատի հենց այս տողերի հետ, ոչ թե կռահի։
• entities — ներգրավված Prisma մոդելները, այն գործակալների համար, որոնք նաև ունեն ուղղակի տվյալների հասանելիություն և պետք է իմանան, թե էջն իրականում ինչ է կարդում/գրում։
• relatedAdrs — որտեղ է ապրում ինչու-ն։ Այս վիքին միտումնավոր ծածկում է միայն ինչը/ինչպես-ը. մի հանիր ճարտարապետական հիմնավորումը այս էջերից — հետևիր հղմանը։
• lastVerified — ամսաթիվ, երբ մարդը վերջին անգամ հաստատել է, որ այս մոդուլն աշխատում է սկզբից մինչև վերջ իրական բրաուզերում (կապված docs/MANUAL_TESTING.md-ի հետ)։ Հնացած ամսաթիվը ազդանշան է, որ էջը կարող է նկարագրել մտադրություն, ոչ թե ընթացիկ վարքագիծ։

Ինչ չէ այս վիքին

Այն լիազորության որոշումների ճշմարտության աղբյուր չէ — միշտ հենվիր իրական guard/permission ստուգման վրա core-api-ում, հարցման պահին։ Վերաբերվիր այս վիքիին որպես փաստաթղթի, որի վրա կարելի է հիմնվել դատողություններում և մեջբերել, ոչ թե որպես runtime քաղաքականության աղբյուր։