2026-03-25 05:52:55 +00:00
# Sozsoft Platform - Claude Instructions
This file provides Claude-specific operating rules for this repository.
Primary source of truth for platform behavior is:
- `.github/instructions/ai.instructions.md`
If there is any conflict, follow `.github/instructions/ai.instructions.md` .
2026-08-10 09:08:08 +00:00
## Communication Rules (apply to every response)
1. **Never introduce or summarize the platform.** Assume the user knows what this
application is, how it is built, and which technologies it uses. Do not open a response
with "Sozsoft Platform is a multi-tenant low-code engine…" or any equivalent framing.
2. **Answer the request, nothing more.** No unsolicited architecture overviews, no
restating the decision order, no re-explaining ListForm/DeveloperKit concepts unless
the user actually asked about them.
3. **No preamble, no epilogue.** Skip "Great question", "I reviewed the codebase",
summaries of what you are about to do, and closing recaps of what you just did.
4. **Match the question's size.** A yes/no question gets a sentence. A config question
gets the config. Only a full feature request gets a full proposal.
5. **Respond in the language the user writes in** (Turkish → Turkish).
6. Mention a rule from this file only when it changes the answer — never as boilerplate.
2026-03-25 05:52:55 +00:00
## Purpose
- Maximize delivery through runtime configuration.
- Minimize custom code.
- Preserve platform consistency, security, and tenant isolation.
Primary principle: Configuration first, code last.
## Mandatory Decision Order
2026-08-10 09:08:08 +00:00
For every request, evaluate in this order — internally. State the chosen step only when the
user is asking how to build something, and state it in one line, not as a walkthrough of the
options you rejected.
2026-03-25 05:52:55 +00:00
1. Dynamic configuration with existing ListForm ecosystem
2. SQL Query Manager + Custom Endpoint
3. Dynamic Service
4. Code change (last resort, justification required)
## Non-Negotiable Rules
1. Do not propose new custom React component/page development for standard feature requests.
2. Build new screens using platform configuration mechanisms.
2026-08-10 09:08:08 +00:00
3. Every implementation proposal must include tenant and permission design.
2026-03-25 05:52:55 +00:00
4. Never bypass platform authorization patterns.
5. Never hardcode secrets, tenant IDs, or connection strings.
2026-09-22 20:59:36 +00:00
6. Never step outside the framework without explicit approval (standing default 11).
2026-03-25 05:52:55 +00:00
Exception:
2026-08-10 09:08:08 +00:00
- Custom React/backend code is allowed only when the user explicitly requests implementation
and configuration is insufficient.
- In such cases, explain why configuration-first options are not enough — in a sentence or two.
2026-03-25 05:52:55 +00:00
## Architecture Guardrails
- Backend: Respect ABP module boundaries and explicit, auditable permissions.
- Frontend: Use existing dynamic view infrastructure and metadata-driven behavior.
- Data: Use parameterized SQL patterns and enforce tenant-safe access.
## Dynamic Platform Expectations
- Menus and routes are database-driven.
- Dynamic List/Form/Component infrastructure is the default solution path.
- Keep route, menu, permission, and datasource mappings coherent.
## Security and Compliance
- Enforce RBAC and permission-driven visibility in all layers.
- Never output real credentials, tokens, keys, or secrets.
- Use placeholders in examples.
- Maintain tenant isolation in every query and action.
## Response Contract
2026-08-10 09:08:08 +00:00
The list below applies **only** to a full implementation proposal for a new screen, module,
or integration. It is not a template for questions, debugging, code review, refactors,
explanations, or small changes.
Even for a full proposal: include only the items that carry real content for that request,
and drop the rest. An empty or obvious heading is noise.
2026-03-25 05:52:55 +00:00
1. Goal
2. Decision flow result (which step used)
3. Artifacts to configure
4. SQL/query/endpoint design (if needed)
5. Menu + route + component mapping
6. Permission and role mapping
7. Tenant isolation notes
8. Validation and test checklist
9. Rollback strategy
2026-08-26 18:44:53 +00:00
---
## Standing Context (read this before proposing anything)
These sections encode expectations the user will **not** repeat in every prompt.
`README.md` is the technical map of the platform; this file is how to act on it.
### Where the truth lives
| Konu | Kaynak |
| --- | --- |
| Platform davranı ı ı ı ı ı `.github/instructions/ai.instructions.md` |
| **Artefakt üretimi** : seed şemaları ı `.github/instructions/lowcode.instructions.md` |
2026-09-29 11:46:39 +00:00
| **Yetenek envanteri** : JSON kolonları ı ı ı ı `.github/instructions/lowcode-reference.instructions.md` |
2026-08-26 18:44:53 +00:00
| `api/` kod standardı ı `.github/instructions/dotnet.instructions.md` |
| Modül/liste ekleme prosedürü, seeder dosya sorumlulukları `.github/instructions/list.instructions.md` |
| Ne nerede yaşı ı `README.md` |
2026-10-07 08:17:46 +00:00
| Bir modülün nası ı ı ı ı `configs/seeds/docs/modules/{Menü}.md` (dizin: `README.md` §10.5) |
2026-08-26 18:44:53 +00:00
| Yetki kodları `PlatformConsts.AppCodes` (backend) + `constants/permission.constant.ts` (UI) |
| Seed yolları `SeedPathResolver` |
2026-10-06 11:24:30 +00:00
| SQL Server → PostgreSQL çeviri kuralları `.github/instructions/lowcode.instructions.md` §8.3.1 |
2026-08-26 18:44:53 +00:00
Bir çelişki varsa sı `ai.instructions.md` → `dotnet.instructions.md` → bu dosya → `README.md` .
### Standing defaults — do not ask again
1. **Yeni tablo** → tenant + tam audit kolonları ı `TenantId` ,
`CreationTime` , `CreatorId` , `LastModificationTime` , `LastModifierId` , `IsDeleted` ,
`DeletionTime` , `DeleterId` ). Kullanı ı ı ı
2026-09-28 09:28:56 +00:00
Yeni **tanı tablosu (tanı ı ı
sabit ad listesi yoktur) buna ek olarak `IsActive bit NOT NULL DEFAULT 1` ile gelir; liste + form alanı ı
2026-10-02 07:09:23 +00:00
`true` , Aktif/Pasif widget'ı ı
`IsActive` kolonu aynı ı `NOT NULL DEFAULT 1` (`create_table`'da
`isNullable: false` , `defaultValue: "1"` ), formda yeni kayı `true` ile açı ı
(`FormFieldsDefaultValueJson`). Ayrı ı `lowcode.instructions.md` §8.1.
2026-09-28 12:50:38 +00:00
Görsel tutan her kolon (fotoğraf, logo, avatar kopyası `nvarchar(MAX)` + editör `dxImageUpload` ;
değer base64 saklanı ı ı ı `dxImageViewer` kullanı
2026-08-26 18:44:53 +00:00
2. **Yeni ekran** → Wizard yolu. `Definitions` altı
2026-09-29 14:55:13 +00:00
bir kök menü oluştur, `Order = max(Order) + 1` . Yetki ağacı ı ı ı
2026-09-30 14:57:25 +00:00
yetkisi menüdeki dalı ı ı ı
yetkisine bağlanı
2026-08-26 18:44:53 +00:00
3. **Yeni ekran/menü** → yetki sözleşmesi olmadan önerilmez. Menü ve route aynı
sözleşmesini göstermeli.
4. **Kullanı ı → dil anahtarı
metin önerme.
5. **Runtime'da üretilen her artefakt** (wizard, custom component, crud endpoint) → ilgili seed
dosyası ı ı ı ı ı ı ı
2026-08-28 07:47:17 +00:00
6. **Yeni ekran/komponent talebi — yazı ı → dosya yazmadan önce **keşif turu** :
toplu sorularla (tur başı ı ı
kaynağı **onaylat** , sonra
`configs/seeds/` altı ı ı
varsayı
onaycı ı
görsel Tur 2'nin çoğunu cevaplar, yalnı
Bu kural yalnı **yeni üretim** içindir; düzeltme/alan ekleme/debug doğrudan yapı ı
Ayrı ı `lowcode.instructions.md` §0.6–
2026-09-22 20:59:36 +00:00
7. **Ziyaretçiye açı (public `RoutePath` taşı `Pub` menüsü,
yeni public sayfa) → SEO alanları ı
tanı ı `Seo*` kolonları ı `data/App.Menus.Routes.json` ya da
`data/App.DeveloperKit.CustomComponents/{Id}.json` . Metin `::Anahtar` ile dil anahtarı ı
Kullanı ı ı ı
`App.SiteManagement.Seo.*` ayarları ı ı ı `lowcode.instructions.md` §0.9.
8. **Ekran içi hesap/koşul ihtiyacı → önce `EditorScript` (Script Builder tarifleri), sonra
2026-08-26 18:44:53 +00:00
`EditorOptions` ; kod yazmak son çare.
2026-09-22 20:59:36 +00:00
9. **SQL** → her zaman parametreli. String birleştirme ile sorgu kurma.
10. **Silme** → `DeleteCommand = DefaultDeleteCommand("{Tablo}")` ; ham SQL string'i yazma.
11. **Çerçeve sı ı ı → uygulama kendini kendi mekanizmaları ı
2026-08-28 07:47:17 +00:00
var olan `ui` bileşenine eksik olay/prop/küçük yetenek ekleme — komponentin %70'i hazı
araçlarla kuruluyorsa kalanı ı ı
uyumlu tarif/seçenek/token ekleme).
Bunun dı ı ı ı
migration, platform tablosu şeması `Routes` , dı
yalnı ı ı ı ı ı
bitirilir. "Yapı ı `lowcode.instructions.md` §0.8.
2026-09-24 07:24:48 +00:00
12. **Liste ekranı → prompt/görsel/tarifle üretilen her liste ekranı `Grid` + `Card` +
`Pivot` + `Chart` açı `DefaultLayout: "grid"` ile gelir; "liste/grid" demek diğerlerini
kapatmak değildir. Bir görünüm yalnı ı ı ı ı ı ı `false` yazı ı
Tree/Gantt/Scheduler/Todo yalnı ı ı ı ı `lowcode.instructions.md` §9.8.
2026-09-28 09:28:56 +00:00
13. **Liste ekranı ı → Wizard ya da MCP `deploy_wizard` ile üretilen her List ekranı
sorulmadan **en az 3 kartlı `Widgets` ile gelir; kartlar tablonun durum / boolean bayrak /
tarih / tutar kolonları ı ı ı ı
tablosunda her kart `"TenantId" = '@TENANTID'` taşı `IsDeleted` koşulu yazı
2026-09-30 20:52:33 +00:00
alt form ve basit tanı ı **Alt form oluşturulurken widget oluşturulmaz** :
başka bir ekranı `SubForms` sekmesi olarak üretilen her ekran — menüsüz ya da kendi menüsü olan —
`Widgets: []` ile deploy edilir. Deploy menüsüz (`CreateMenu: false`) wizard'ı `Widgets` 'ı ı
ayrı ı ı ı
(`useListFormWidgets(…, isSubForm)`) — kart sorgusu ana kayda göre süzülmez. Ayrı ı
`lowcode.instructions.md` §4.6.1.
Alt form ekranı ı ı ı ı
`Form` sekmesi tek kayı `AllowAdding` /`AllowUpdating` açı `lowcode.instructions.md` §4.6.
2026-10-04 15:04:16 +00:00
14. **Modül dokümanı → MCP ya da wizard ile oluşturulan her modül çalı
2026-10-07 08:17:46 +00:00
`configs/seeds/docs/modules/{Menü}.md` dosyası ı ı ı
menünün kodudur (`App.Hr.md`, `App.Prc.md` , `App.Administration.md` ),
menünün altı `module-doc:section` bölümüdür. Bölüm keşif cevapları
onaylanan tarifi (analiz), ekranları ı ı ı ı ı
entegrasyonları ı ı ı ı ı
kendisi açar/yeniler; anlatı
`save_module_doc` (ekran/dal koduyla yalnı
bölümü tamamlanmadan `Testing` 'e alı ı ı ı ı
yalnı ı ı ı ı ı ı
2026-10-04 15:04:16 +00:00
"X nası ı ı ı ı `lowcode.instructions.md` §0.13.
15. **Ekran açı ı → wizard/MCP ile üretilen her liste ekranı ı
`DescTr` /`DescEn` metni ayrı ı ı ı ı ı ı
menüde nerede / hangi ekranı
ekranlar (`RichText` biçimi). MCP `deploy_wizard` 3 satı ı ı
Ayrı ı `lowcode.instructions.md` §4.4.2.
2026-10-06 11:24:30 +00:00
16. **İki veritabanı ı ı ı → uygulama SQL Server ile olduğu gibi PostgreSQL ile de çalı ı
(`SettingsConsts.DefaultDatabaseProvider`). Veritabanı
düşünülür ve yazı ı ı ı ı
- `configs/seeds/sql/{object,execute,host/…}/X.sql` yazı ı
`configs/seeds/postgres/…/X.sql` eşi aynı ı ı ı ı ı ı
şema PG'de `public` ). Biri olmadan diğeri commit edilmez; "PG sonra" yoktur.
- EF modeli SQL Server sözdizimiyle yazı ı ı
karşı ı ı `PostgreSqlModelSyntax` üzerinden `PlatformDbContext.ConfigureProviderSpecificModel` 'de
üretilir. Çeviriye girmeyen yeni bir sözdizimi eklenirse çeviri de eklenir.
- C#'ta üretilen SQL (Dapper, `QueryManager` , seeder komutları `*Command` /`LookupQuery`
metinleri) ya iki sağlayı ı ı ı ı ı ı `DataSourceType` 'a göre
dallanı
- SQL değişikliği doğrulanı ı ı ı ı ı
idempotent). Ayrı ı `lowcode.instructions.md` §8.3.1.
2026-10-07 19:34:49 +00:00
17. **Her prompt sonunda optimizasyon + ölü kod temizliği** → kullanı ı ı
kaldı ı ı ı ı
kullanı `using` /üye/parametre/tip/dil anahtarı
tarama, "Definition of done"), aynı ı ı ı
tekrar sorgu/dosya okuması ı ı ı **statik yazı — tablo adı
`TableNameResolver` 'dan, değer tablo/seed/ayar verisinden dinamik bulunur. Son mesajda ne
temizlendiği tek satı
18. **Yeni kaydı ı ı → Wizard ve MCP ile üretilen her listede form varsayı ı
kolonun veritabanı `DEFAULT` değeridir; deploy onu tablodan (katalog ya da seed
scripti) okuyup `FormFieldsDefaultValueJson` 'a yazar, değer koda gömülmez. Bu yüzden tablo
şu `DEFAULT` 'larla kurulur: `IsActive` → `1` (true), ölçü birimi (`*UomId`) → `'Adet'` , para birimi
(`*CurrencyId`/`*Currency`) → `'TRY'` (lookup'ı ı ı
varsa (Süre = 60) o da kolonun `DEFAULT` 'udur. Alana özel değer wizard öğesinin `DefaultValue` 'su ile
verilir. Ayrı ı `lowcode.instructions.md` §4.3.5.1.
2026-08-26 18:44:53 +00:00
### Cross-cutting: touching one thing means touching these too
2026-10-04 15:04:16 +00:00
- **Modül dokümanı `ModuleDocManager.RefreshAllAsync` wizard'ı ı ı
silme, `WizardSeedSynchronizer` , import kapanı ı ı ı
2026-10-07 08:17:46 +00:00
çağrı
(`ModuleDocCatalog`: dosya = kök menü, bölüm = beyan → alt formun ana ekranı ı
dal `data/App.Menus.Menu.json` 'dan okunur, sabit liste yoktur); envanter biçimi
2026-10-04 15:04:16 +00:00
`ModuleDocRenderer` 'dadı ı ı ı ı
`docs/modules/*.md` yolunu kabul eder.
2026-08-26 18:44:53 +00:00
- **`scriptRecipes.ts` (TS) ↔ `Domain.Shared/Editors/*.cs` ** — biri değişirse diğeri de değişir.
İkisinin çı ı ı **birebir aynı olmak zorundadı ı
dialogda "elle düzenlenmiş" sayı ı ı
2026-10-06 12:36:01 +00:00
- **`phoneFormat.ts` ↔ `DynamicReportPhoneFormatter.cs` ** — telefon token'ları ı `phoneTR` ,
`phoneIntl` , `phoneCountry` ) görüntü kuralı ı ı
Biri değişirse diğeri de değişir; yoksa liste ile rapor aynı ı ı
2026-10-07 18:08:10 +00:00
- **Liste popup'ı ı ı ı ı
(`list/shared/editingForm.ts`, `editingFormScripts.ts` , `cascade.ts` ); TagBox/GridBox/ImageUpload/ImageViewer'ı
tek uygulaması `form/editors/*` , liste hücresi yalnı `list/editors/cellEditors.tsx` adaptörüdür. Bir tarafa
yetenek eklenirken ortak yardı ı ı
`lowcode.instructions.md` §4.3.4.
2026-09-29 06:14:07 +00:00
- **`htmlEditorOptions.ts` ↔ `EditorOptions.Html` ** — HtmlEditor varsayı ı ı ı
bloklar birebir aynı ı ı
`toolbar` varsayı ı
çubuğunu gösterir.
2026-09-02 08:32:53 +00:00
- **Wizard seed dosyası `Wizard` bölümü yalnı
taşı `ListForm` /`Fields` içinde karşı ı ı ı
kı ı ı ı ı ı ı
tanı ı ı ı ı ı
2026-10-01 12:01:57 +00:00
doldurulur (`FromSeedJson`). Wizard'a yeni bir alan eklerken karşı ı ı
`CommandColumnJson` bu yolla taşı ı ı ı ı
2026-09-02 08:32:53 +00:00
Dosyada kalan wizard alanları ı ı ı `Menu` , `Language` , `Groups` — ve
2026-09-29 06:14:07 +00:00
`ListFormCode` → `WizardCode` , `MenuParentModuleId` → `ModuleId` , `LanguageTexts` → `Language.Texts`
adı ı ı ı ı `DataSourceConnectionString` , boş
`MenuParentPath` / `LanguageTexts` ) hiç yazı ı
2026-09-02 08:32:53 +00:00
sözleşmesi düzdür, dönüşüm `WizardSeedFileDto.ToSeedJson` / `FromSeedJson` içindedir. **Wizard
seed dosyası ı ı `JsonSerializer` çağrı ı
bölümleri sessizce düşürür.
2026-10-05 12:58:59 +00:00
- **Wizard ile üretilen ekran** → seed dosyası
2026-09-02 08:32:53 +00:00
wizard cevapları ı ı ı `GridOptionsEditDto` (`ListForm`) ve alanları
`ColumnFormatEditDto` (`Fields`) sözleşmesini taşı ı ı ı
(`ListFormsAppService`, `ListFormFieldsAppService` , `ListFormJsonRowAppService` ) bu bölümleri
ve `Wizard` bölümündeki karşı ı ı ı
yeni bir kayı ı ı
- **Wizard girdisinden ekran üretimi** → tek kaynak `ListFormWizardDto.BuildListForm/BuildFields` ,
entity'ye yazma `GridOptionsEditDto.ApplyTo` / `ColumnFormatEditDto.ApplyTo` . Deploy, seeder ve
senkronizasyon aynı ı ı ı ı
- **Katman sı ı ı `DbMigrator` Application'a referans vermez. Seeder ile AppService'in
paylaştı ı `Application.Contracts` 'ta DTO metodudur; entity'ye yazma Domain.Shared'deki
`IListFormArtifact` / `IListFormFieldArtifact` sözleşmeleri üzerinden yapı ı
Ayrı ı `dotnet.instructions.md` §5.
2026-09-17 17:54:23 +00:00
- **Yeni bir yetki** → `PlatformConsts.AppCodes` + `data/Abp.Identity.Permissions.json` + (UI'da kullanı
2026-09-24 19:39:00 +00:00
`permission.constant.ts` + `data/App.Languages.LanguageText.json` . Yetki ekranı ı `AbpPermissions.Order`
2026-09-20 20:23:39 +00:00
(grup için `AbpPermissionGroups.Order` ) sütunundan gelir ve seed satı ı `Order` alanı
yazı ı ı ı ı ı ı ı
yerine denk gelen numarayla ekle.
2026-09-17 09:01:14 +00:00
- **`/mcp` ucuna yeni bir araç** → üç yer birlikte değişir: `McpToolNames` (ad kayı
ilgili `Mcp*Tools` sı ı ı ı
(`Sozsoft.Mcp.Application.Contracts`). Arac adı `McpToolNames.All` içinde yoksa araç listesi
süzgecinden geçmez ve hiç görünmez; MCP Servers ekranı `AllowedTools` seçenekleri de
2026-09-18 13:47:23 +00:00
`SelectableTools` 'dan üretildiği için kendiliğinden güncellenir. Sunucu kaydı
`AllowedTools` 'tur: boşsa tüm araçlar, doluysa yalnı ı ı ı
2026-09-24 11:58:23 +00:00
bir bayrak yoktur, sı ı ı ı ı **İki MCP yetkisi vardı `.Invoke` uca
erişim ve okumadı ı ı ı `.Write` MCP üzerinden yapı
değişiklik yapan her araç `RequiredPermissions` 'ta `.Write` 'a bağlanı ı ı
yeni yetki açı **Kiracı : kiracı ı ı
araçlar `McpToolNames.TenantTools` ile sı ı ı ı `query_list` , `run_select` ,
`insert_row` /`update_row`/`delete_row`) ve `AllowedTools` bu kümeyi yalnı ı ı
yazma ekranı ı ı ı
yazabilen araç (procedure, Custom Endpoint) ve geliştirme araçları `TenantTools` 'a
eklenmez. Geliştirme işlemi yine Wizard / Custom Components AppService'inden geçer.
2026-09-24 13:29:53 +00:00
** `/mcp` istek düzeyindeki unit of work'ün dı ı ı
cevap SSE ile aktı ı ı
kapanı ı ı ı ı ı ı ı ı
kendi UoW'sini sonuç dönmeden tamamlar; bu istisna kaldı ı
2026-09-17 09:01:14 +00:00
Kapı `AddListToolsFilter` listeyi süzer, `McpAppService.EnsureToolAllowedAsync`
2026-09-24 11:58:23 +00:00
çağrı ı ı ı ı ı ı ı `Invoke`
uçta değil her MCP servisinin sı ı `[Authorize]` 'dadı
bu attribute'la açı ı
**Hata istemciye yalnı ı ; `McpToolErrorTranslator` (çağrı
filtresi) yetki reddini "şu yetkiniz yok" mesajı `UserFriendlyException` 'ı ı
Kullanı ı ı ı ı ı ı
bir yetkiyi `[Authorize]` attribute'uyla istiyorsa (ret mesajı ı ı ı
`McpToolNames.ServicePermissions` 'a eklenir; ekran yetkisi gereken araç yetkiyi
`IMcpListFormAccessFilter.GetPermissionNameAsync` + `CheckAsync` ile adı
Araç → yetki tablosu `README.md` §13.9'dadı
Hazı `McpDevelopPrompts` ) yalnı ı ı
etmez, `get_dev_guide` bölümüne yönlendirir. Bir kural bağlayı ı ı ı
(örnek: `Ready to Start` şartı `start_dev_request` 'tedir).
2026-09-25 06:39:34 +00:00
- **Wizard deploy veritabanı ı `deploy_wizard` ve düzenleme aynı
yoldan (`ListFormWizardAppService.Create`) geçer ve **yalnı ı : `wizard/{Ad}.json`
+ menü/modül/izin grubu/yetki/dil satı ı
`data/Abp.Identity.Permission{Groups,s}.json` , `data/App.Languages.LanguageText.json` ;
`WizardSeedRowStore` , anahtarlar `WizardSeedRowKeys` ). Kurulum yalnı
`WizardDataSeeder` ekrana özgü kayı ı ı ı ı
`ListFormSeedDataApplier` satı ı `Pending` yazar; Wizard Manager
onu "Migrate bekliyor" gösterir (`WizardFileInfoDto.IsPending`), migrate önceki sürümün kayı ı ı
(`Pending.Replaced`) kaldı ı ı `Pending` 'i siler. Yetkiler **hiçbir role
otomatik atanmaz** (admin dahil); rol ekranı ı
adı ı ı `lowcode.instructions.md` §4.0.
2026-09-24 11:58:23 +00:00
- **MCP ile demo veri** → geliştirme isteği örnek satı ı
görüntüsü) ekran `deploy_wizard` 'a `SeedData: true` ile gider (`SeedFilePath = data/{ListFormCode}.json`
2026-09-25 07:52:06 +00:00
+ `SeedSync*` açı `ListFormWizardDto.BuildListForm` ) ve satı ı ı `seedRows` ile
2026-10-05 12:58:59 +00:00
`configs/seeds/data/{ListFormCode}.json` dosyası ı ı ı
2026-09-25 07:52:06 +00:00
ekrana göre doğrulanı `Guid` anahtarı ı ı ı ı
ekler; MCP migrate'i beklemez. Talep döngüsü `Testing` 'de biter, `Staging` 'e kullanı ı ı ı
2026-09-24 11:58:23 +00:00
`SeedData` wizard ekranı
Ayrı ı `lowcode.instructions.md` §0.10.1.
- **Talepteki görsel** → `App.DevRequests` açı ı ı ı ı `data:` URI olarak
kalı `start_dev_request` / `get_dev_request` onu metinden ayı
(`McpDevRequestImages`) ve MCP resim içeriği (`ImageContentBlock`) olarak döndürür; metinde
2026-10-07 08:17:46 +00:00
`[image-N]` kalı ı ı ı ı ı
kalan pay görsellere bölünür, payı ı `IMcpImageShrinker` (Host'ta SkiaSharp) ile küçültülüp
JPEG'e çevrilir, yine sı ı
Açı `update_row` ile yeniden yazı `SubTasks` de
2026-09-28 09:28:56 +00:00
`add_dev_request_subtasks` ile yazı ı ı ı
2026-09-28 12:50:38 +00:00
sunucu doldurur, modele bı ı `Timesheets` 'i tamamen sunucu yazar
(`IMcpDevRequestTimesheetRecorder`): `get_dev_request` /`start_dev_request` talebi etkin talep yapar,
2026-10-07 18:46:45 +00:00
sonraki her üretim/veri yazma işlemi (`create_table`, `save_sql_object` , `generate_crud_endpoints` ,
`deploy_wizard` , `delete_wizard` ,
2026-10-01 12:01:57 +00:00
`save_component` , `delete_component` , `save_report_category` , `save_report_template` ,
`delete_report_template` , satı ı `save_dev_request_analysis` ,
2026-09-29 06:14:07 +00:00
`append_dev_request_note` , `add_dev_request_subtasks` ) ona `App.Mcp.Timesheet.*` anahtarı
açı ı ı `start_dev_request` satı ı ı ı ı
2026-09-29 14:18:47 +00:00
Satı ı ı ı ı ı
transaction'ı ı `Sas_H_DevRequest` kilidini EF'in ayrı ı ı ı ı
2026-09-28 09:28:56 +00:00
- **Talep analizi** → `Description` talebin yazı ı ı ı
üretim notları `Analysis` kolonundadı `AnalysisExpr` , Açı ı
Durum sı ı `Backlog → Analysis → Ready to Start → …` : "Analiz et" `save_dev_request_analysis`
2026-10-07 12:45:18 +00:00
ile yalnı `Backlog` /`Analysis` talebini analiz edip `Analysis` 'e alı
modül dokümanı ı ı
"2. Analiz ve kararlar" alt bölümüne üretimde `save_module_doc` ile yazı ı
2026-09-28 09:28:56 +00:00
`Ready to Start` 'a kullanı ı ı `append_dev_request_note` ile `Analysis` 'e eklenir.
Analiz standardı `lowcode.instructions.md` §0.12; prompt'lar oraya yönlendirir.
2026-09-17 09:01:14 +00:00
- **MCP şema araçları ı `Sas_H_DbTableColumn`
sözlüğünden okunur (`IMcpSchemaDictionary`). Sözlüğün alan adları
`dbo.Sas_H_ListFormFieldsDictionaryJson` prosedürünün ürettiği JSON ile birebir aynı ı
2026-09-30 22:54:21 +00:00
prosedür değişirse `McpDictionaryListForm` /`McpDictionaryField` de değişir. Sözlük tablo kataloğunu
değil ekranları ı ı ı ı
Modelin okuması `AbpUsers` 'ı
2026-09-17 09:01:14 +00:00
- **MCP OAuth** → bilinen sağlayı ı `Platform_Mcp` istemcisini,
2026-10-07 08:17:46 +00:00
yerel `mcp-remote` proxy'si açı ı `Platform_Mcp_Local` istemcisini,
2026-09-17 09:01:14 +00:00
diğer MCP istemcileri `/connect/register` ile üretilen `mcp_` önekli açı ı
kullanı `McpOAuthClientDataSeedContributor` ). Bilinen sağlayı ı
eklemek = DbMigrator'daki `Platform_Mcp:RedirectUris` listesine callback eklemek. MCP
istemcisi kararı `resource` parametresi yok sayı ı
token kullanı ı
korunur, yoksa connector web oturumunu düşürür.
2026-10-07 18:46:45 +00:00
- **MCP yalnı ı ı
`save_sql_object` , `generate_crud_endpoints` , `deploy_wizard` ) yalnı `configs/seeds/` altı
yazar, veritabanı ı ı ı ı
çağı ı ı ı `CrudEndpointSeedFileDto.Generate/Write` ;
diyaloğun servisi de aynı ı
düzeltilebilen girdi (bilinmeyen seçenek, boş/tekrar eden index) sessizce normalize edilir.
Kolon adları ı ı ı
seed-only tabloları `deploy_wizard`
girdisindeki `ListForm` /`Fields` bölümleri ekrana katman olarak uygulanı
+ `WizardScreenOverlay` ); `ListFormWizardDto` 'ya editörde karşı ı ı
kendiliğinden taşı
2026-09-17 09:01:14 +00:00
- **MCP yetki vermez** → yeni bir MCP aracı ı ı ı
ekranı
yetkisini aşan bir yetenek (ham SQL gibi) `McpToolNames.RequiredPermissions` 'a uygulamadaki
2026-09-24 11:58:23 +00:00
karşı ı `create_table` bu yüzden `.Write` 'a ek olarak `App.SqlQueryManager`
2026-09-18 13:47:23 +00:00
ister; tablo scriptini tasarı ı ı `generateCreateTableSql` çı ı ı ı
2026-10-07 12:45:18 +00:00
(`McpTableCreator`) ve **veritabanı ı ı — MCP veritabanı
kullanı ı ı ı ı ı ı ı ı ı
scriptinden okur (`PostgreSqlTableScript.ReadSeedColumns`) — tasarı ı ı ı ı ı
2026-10-06 11:24:30 +00:00
(`SaveTableScriptAsync`) ve `create_table` T-SQL dosyanı `PostgreSqlTableScript` ile
üretip `postgres/object/` altı
yoksa PG eşi yazı ı ı ı
2026-10-05 14:11:06 +00:00
- **Çalı ı ı ı
konmaz: menüsüz `App.Hr.My*` /`Team*` wizard + Intranet panosu widget'ı ı ı
Puantajı ı ı ı
(düzenle/sil yok, tek aksiyon izin talebi oluşturma); yeni persona
ekranı ı ı
kullanı ı ı ı ı `my-profile` ek alanları
sağlı ı ı ı ı ı `lowcode.instructions.md` §0.12.1.
2026-09-29 06:14:07 +00:00
- **Bildirim kapsamı ı ı
`Adm_T_NotificationType` , `Adm_T_NotificationRule` , `Adm_T_Notification` ; dördü de `IMultiTenant` ) ve ekranları ı
2026-09-22 09:48:14 +00:00
Administration › ı ı ı **Bildirimler**
ekranı ı ı ı × ı ı ı ı
(`list-form-dynamic-api/notification-insert`). Yeni kiracı ı
2026-10-05 12:58:59 +00:00
gelir: kendi veritabanı ı ı ı ı ı
`NotificationTenantDefaultsSeedContributor` aynı
aynı ı ı ı ı
2026-09-22 09:48:14 +00:00
`Scope` alanı `Tenant` ya da `Host ve Kiracı olmalı ı `Host` kapsamı ı
kiracı ı ı ı `PlatformBackgroundWorker` ).
2026-09-20 20:23:39 +00:00
- **Bildirim bayrakları ı `IsSent` (iletildi) olmadan `IsRead` yazı `IsRead`
ile `ReadTime` birlikte yazı ı `UiActivity` kayı ı ı `UiToast` /`Desktop`
tarayı ı `sent-many` ucu yalnı
kümeyi işaretler), kalan kanalları `NotificationWorker` işaretler — gönderim okuma değildir.
Kullanı ı `RecipientType = User` ) kural değildir, yalnı
kapatı ı ı ı `/notificationhub` ile
duyurulur (`INotificationRealtimeNotifier`; sözleşme bildirim modülünün Domain'inde, SignalR
gerçeklemesi barı ı ı ı ı ı
Ayrı ı `README.md` §13.3–
2026-09-22 20:59:36 +00:00
- **SEO** → **ayrı ; meta, yolu tanı ı
parça birlikte çalı ı ı `App.SiteManagement.Seo.*` ayarları ı
alanlar `Route.Seo*` ve `CustomComponent.Seo*` (ikisinin de `SeedSync*` bayrakları ı
istemci tarafı `SeoHead` . Üçü de uygulama konfigürasyonunun `seo` alanı
(`PlatformApplicationConfigurationContributor` → `SeoAppService.GetConfigAsync` ); `sitemap.xml`
ve `robots.txt` aynı `SeoController` ile yayı ı ı
tanı ı ı ı ı ı
**Ziyaretçiye açı ı ı (standing default 7).
Sitemap'e giren kaynaklar (`Pub` menüleri, aktif custom component rotaları ı ı
yazı ı `SeoAppService` içindedir; yeni bir public kaynak türü eklenirse toplayı ı
eklenir, yoksa sayfa sitemap'te görünmez. Yeni bir meta alanı `SeoRouteDto` +
`SeoFields` (seeder) + `SeoHead` birlikte.
2026-10-05 12:58:59 +00:00
- **Yeni bir dil anahtarı `configs/seeds/data/App.Languages.LanguageText.json` (EN + TR iki satı
2026-09-24 19:39:00 +00:00
`Id` = `Sas_H_LanguageText:{ResourceName}:{Key}:{CultureName}` adı ı ı
2026-08-26 18:44:53 +00:00
olmadı ı ı
2026-09-09 06:06:25 +00:00
- **Custom component sı ı ı ı ı
seed dosyası ı ı `ui/` dı ı ı ı ı `ui/safelist.txt`
sonuna da yazı ı
kalı ı
2026-09-21 19:40:13 +00:00
- **Custom component kaydı `data/App.DeveloperKit.CustomComponents/{Id}.json`
(Custom Components ekranı ı ı ı
dosyası ı ı ı
aynı ı ı ı `crud/{Entity}.json` .
2026-09-07 14:43:46 +00:00
- **Wizard dosyası ı ı **özyinelemeli bağı ı ı ı ı ı
taşı ı ı ı `SeedFilePath` veri
aynası ı ı `crud/` ve
`{sql|postgres}/{object|execute}/` dosyaları `Custom` yolunda `data/` girdisi yalnı
bileşen ve bağı ı ı ı ı ı
anahtar üzerinden birleştirilir. Kapanı ı ı ı
`WizardImportValidator` 'daki karşı ı ı
2026-09-30 07:28:12 +00:00
- **Talep bağı `deploy_wizard` wizard dosyası
(`IMcpDevRequestTimesheetRecorder.GetActiveRequestIdAsync`) `DevRequest { Id, Title }` olarak
yazar; bağ modelin girdisinden gelmez (`ListFormWizardDto.DevRequestId` `[JsonIgnore]` ). Elle
yapı ı ı ı
gösterir, kaydı ı ı ı
(`export-dev-request`; `WizardExportCollector.CollectAsync` birden çok dosya alı
dosyası ı `DevRequest` korunur — dosyayı
yazan yollar bunu kendiliğinden yapar.
2026-09-07 14:43:46 +00:00
- **Şema değişikliği** → ayrı **kayı göredir. Eksik kolon **eklenir** (kayı ı
`ALTER TABLE ADD` ), var olan kolon **hiçbir zaman değiştirilmez** , hiçbir kolon düşürülmez,
hiçbir tablo `DROP` edilmez. Ölçü farkı
fark somut olarak bildirilir; varsayı ı `NOT NULL` bir kolonun dolu tabloya eklenmesi
de durdurulur — hangi değerin yazı ı ı ı ı ı
(`SqlTableSchemaComparer`), analiz ve kapanı ı ı
Karşı ı **adı kullanı ı ı ı ı
metin karşı ı ı ı ı
metin olarak karşı ı
- **Veritabanı `EnsureImportNotBlocked` ile başlar. Analizdeki
engelleme kararı `blocked` dosyası
yoksa karar istemci tarafı
- **Wizard import'u** → analiz dosyalar yazı **önce** doğrular (`WizardImportValidator`);
`Error` seviyesinde bir bulgu varsa oturuma `blocked` işareti düşer ve `ApplyImport` reddeder.
Kapanı ı ı ı ı ı ı ı `sql/object` → `sql/execute` → `crud`
2026-09-25 06:39:34 +00:00
→ `data` → `wizard` . Tablo eksikse önce scripti çalı ı ı
**kurulmaz** : wizard dosyası `Pending` yazı ı
dosyadaki `ListForm` /`Fields` sözleşmesi olduğu gibi kullanı ı ı
türetilmez — türetmek tasarı ı ı ı ı ı
taşı ı `data` adı ı
2026-09-07 14:43:46 +00:00
Engelleyici bulgu iki sı ı ı **arşiv kaynaklı (`RequiresReexport` — bozuk/eksik dosya,
karşı ı ı ı **ortam kaynaklı
(eksik tablo, şema farkı `Error` eklerken hangisi olduğu işaretlenir.
Engelleme **oturum genelidir, dosya bazlı —
import ya bütün olarak çalı ı
olması ı `TableName` (+ tablo hedefte yoksa `TableMissing` )
doldurulur, istemci tablo tasarı ı ı ı
2026-09-04 09:05:26 +00:00
- **`ListForm.SeedFilePath` dolu bir ekran** → `SeedSyncInsert/SeedSyncUpdate/SeedSyncDelete`
2026-10-05 12:58:59 +00:00
bayrakları ı
(`ListFormSeedDataSynchronizer`); yalnı ı ı ı ı ı ı
veritabanı ı ı ı ı `.json` ile biten
2026-09-21 19:40:13 +00:00
değer **tek dosyadı (`data/{ListFormCode}.json`, bütün satı ı ı
**klasördür** (`data/{ListFormCode}/{anahtar}.json`, her satı ı
ilk kayı ı ı ı ı
2026-10-07 14:48:16 +00:00
(varsayı **Biçimin tek kaynağı ı ı ı ı ; diskte ne bulunduğu kararı
değiştirmez ve tanı ı
(senkronizasyon, export/import, temizleme, wizard satı ı ı
varsayı ı `ListFormSeedTarget` üzerinden gider; paylaşı ı ı ı
`ListFormWizardAppService.ReadSeedFilePathsAsync` ile okunup bileşenlere verilir. Applier `data/`
2026-09-21 19:40:13 +00:00
altı ı **bir klasörün tamamı ı uygular — ekran
tanı ı ı ı ı ı ı
2026-10-07 14:48:16 +00:00
dosyadaki `ListFormCode` boşsa ekran kodu klasör adı ı ı
yalnı ı ı ı ı ı ı ı
uyarı ı ı ı ı
yeniden wizard deploy'u tanı ı
2026-09-21 19:40:13 +00:00
Migrate/seed sı ı ı ı
2026-09-05 18:20:18 +00:00
(`CompleteImport`) `ListFormSeedDataApplier` dosyayı ı
eklenir, varsa dokunulmaz; import'ta `overwriteExisting` açı ı ı
2026-10-01 09:37:30 +00:00
değerlerle güncellenir ve soft delete izleri (`IsDeleted`/`DeletionTime`/`DeleterId`) temizlenir. Satı ı ı ı ı ı ı ı `MenuAppService` , aksi hâlde eski değeri dosyaya yazardı ı `RemoveRowsByFieldAsync` hemen çalı ı ı
2026-09-05 18:20:18 +00:00
senkronizasyon çağrı ı
2026-10-05 12:58:59 +00:00
- **Seed kapsamı `configs/seeds/` tek klasördür; `host/` ya da `tenants/{tenantId}/` yoktur.
Host ve kendi veritabanı ı ı ı
tenant'ta dosyalar yeniden uygulanmaz (`SeedFileScope`; migrate kararı `DataSeedContext` 'e yazar).
Dosyayı `SeedFileScope.IsEnabled` ile başlar. Dosyalar yalnı
bağlamı ı ı ı
(`Pending`) dosyaları ı ı
Tek istisna `{sql|postgres}/host/{object,execute}` : yalnı ı ı ı
karşı ı ı ı ı
Kendi veritabanı ı `IMultiTenant` varlı ı
ListForm, menü ve yetki tanı ı ı ı ı ı ı
adı ı ı `DataSource` üzerinden gider. Kiracı ı
kalı ı `DataSourceManager` kiracı ı
seed'de kiracı ı ı
DbMigrator'da dinamik yetki deposunun kapalı ı ı ı
gelen yetkileri göremez.
2026-09-25 06:39:34 +00:00
- **Seed dosyası ı `ListFormSeedDataFileDto.Serialize` , wizard dosyası
`WizardSeedFileDto.ToSeedJson` ile yazı ı `JsonSerializer.Serialize` + `File.WriteAllText`
kullanı ı ı
yazı ı ı `SeedJsonText.RestoreSurrogatePairs` 'ten
2026-09-25 07:52:06 +00:00
geçer. Veri dosyası ı `GeneratedAt` değeri oluşturma anı ı `Serialize` yalnı
hiçbir yazma yolu onu güncellemez — ekleyip geri kaldı ı
birebir önceki hâline döndürür. `crud/` dosyaları ı ı ı ı ı
2026-09-07 14:43:46 +00:00
- **`crud/{Entity}.json`** → uygulama kuralı `CrudEndpointSeedApplier` 'dadı
karşı ı ı ı ı ı ı `GeneratedAt` değeri
kaydı `LastModificationTime` /`CreationTime` değerinden yeniyse güncellenir/silinir. Migrate
kullanı ı ı ı
varsayı ı
2026-09-29 11:46:39 +00:00
- **Modül = menü = tablo öneki = yetki kökü** → kök menüler `Sas` (`App.Saas`), `Adm`
(`App.Administration`), `Hr` (`App.Hr`, İK) ve `Pub` modüllerindedir. Bir ekranı ı
taşı ı ı `TableNameResolver` (`MenuPrefix`) + `AppCodes` (Seed/Platform) +
`ListFormSeeder_{Saas,Administration,Hr}.cs` + `data/{ListFormCode}.json` adı
satı ı `Authority` . Yetki `Modules` değeri: Saas/Administration `Sas|Adm` , İK `Sas|Hr`
(`Sas` host, `Adm` /`Hr` kiracı `BranchId` zorunludur; seed
satı ı ı
2026-10-05 12:58:59 +00:00
- **Menü ağacı `configs/seeds/data/App.Menus.{Routes,Module,Menu}.json` ve
2026-09-17 17:54:23 +00:00
`Abp.Identity.Permission{Groups,s}.json` ; platformun kendi menü/yetki kayı ı
verisiyle aynı ı `Order`
2026-09-18 06:03:19 +00:00
alanı ı ı ı ı ı ı
2026-09-18 06:28:25 +00:00
şehir → ilçe (`App.Definitions.{CountryGroup,Country,City,District}.json`), bildirim tipi → kuralı
(`App.Notifications.Notification{Types,Rules}.json`). Para birimi, hitap, AI bot
(`App.Definitions.{Currency,ContactTitle,AiBot}.json`), ayar tanı ı
2026-09-24 19:39:00 +00:00
ve zamanlanmı
(`App.Languages.{Language,LanguageText}.json`; `LanguagesData.json` + `LanguageDataSeeder` kaldı ı ı ı `HostData.json`
2026-09-18 06:28:25 +00:00
kaldı ı ı `HostDataSeeder` yalnı ı ı ı ı ı
2026-09-18 06:03:19 +00:00
anahtarı ı ı `Guid` anahtarlı ı ı `Id` 'si iş anahtarı
2026-09-22 20:59:36 +00:00
sabit bir GUID'dir, satı ı `App.Menus.Routes.json` dosyası
yalnı ı ı `Seo*` alanları
silmek ya da yolunu değiştirmek çerçeve dı ı ı
2026-09-09 06:06:25 +00:00
- **Public site** → menü `Menu` tablosunda `ModuleId = "Pub"` altı
`App.Public.Header` hem üst menüyü hem alt bilgideki hı ı ı ı
`PublicNav` düğümü) ve ziyaretçiye uygulama konfigürasyonunun `publicMenus` alanı ı ı
(menü ucu `[Authorize]` ). Sayfa ise Custom Component'tir: `/admin/` ile
başlamayan `RoutePath` otomatik public route olur ve aynı
`RoutePath` boş bı ı ı
2026-09-21 19:40:13 +00:00
`data/App.DeveloperKit.CustomComponents/{Id}.json` satı ı `Pub` menü kaydı ı ı
2026-09-09 06:06:25 +00:00
Üst ve alt bilgi rotası `PublicFooter` ), layout ikisini de
`renderComponent` ile çizer; rotası `RoutePath` **NULL** yazı ı ı
dolu değerleri kapsar). Üst bilginin davranı ı `components/publicSite` katalog düğümlerinde,
yerleşimi tasarı ı ı
**Public bileşenlerin hepsi tasarı ı (`Props.visualDesigner`, `sourceMode: visual` );
kod belgeden üretilir (`generateDesignerCode`), elle yazı ı ı
`react-icons` /`react-router` yoktur — ikon `PlatformIcon` düğümü, gezinme `a` düğümü. Kanvası
doğrudan çizdiği katalog düğümleri tek sözlüktedir (`componentEditor/runtimeNodes.ts`); yeni bir
düğüm eklerken bileşen + bu sözlük + `catalog.ts` tanı ı ı ı ı
yazı ı ı ı ı ı ı ı `README.md` §10.4.
2026-09-01 13:44:05 +00:00
- **Çok değerli alan (`dxTagBox` / çoklu `dxGridBox` )** → tek metin kolonunda `|` ile saklanı
Ekran varsayı `list-form-data/*` ucundan kaydediyorsa birleştirmeyi `QueryHelper` yapar;
tipli DTO alan bir uca (`list-form-dynamic-api/...`, Custom Endpoint, Dynamic Service)
bağlı ı `[JsonConverter(typeof(MultiValueStringJsonConverter))]` eklenir —
yoksa istek `400` ile düşer. Ayrı ı `lowcode.instructions.md` §4.3.2.1.
2026-08-26 18:44:53 +00:00
### Definition of done
- Ölü kod bı ı `using` , private üye, alan, DTO, hook, servis, tip. Bir tip
silinmeden önce **repo geneli** (api + ui + configs) referans taraması ı ı
tipler düz metin araması ı
- Yorum satı ı ı ı ı ı
2026-10-04 15:04:16 +00:00
- Modül/ekran/bileşen ekleyen ya da davranı ı ı ı ı
2026-10-07 08:17:46 +00:00
(`configs/seeds/docs/modules/{Menü}.md`) yazar veya günceller; liste ekranı ı ı ı
2026-10-04 15:04:16 +00:00
ayrı ı ı ı –
2026-08-26 18:44:53 +00:00
- `api/` değişikliğinden sonra: `dotnet build -p:EnforceCodeStyleInBuild=true` — 0 hata, yeni
`IDE00xx` yok.
- `ui/` değişikliğinden sonra: `npm run typecheck` ve `npm run lint` .
- Yorumlar **neden**i anlatı ı ı ı ı ı ı
2026-09-04 09:05:26 +00:00
- **Dokümantasyon kodla birlikte güncellenir.** Platformun davranı ı ı
(yeni/kaldı ı
yeni yetki/dil anahtarı ı ı ı ı `.md`
dosyası ı ı ı `README.md` (ne nerede yaşı
`.github/instructions/lowcode*.instructions.md` (artefakt/yetenek sözleşmesi),
`dotnet.instructions.md` (kod standardı ı `CLAUDE.md` (çalı ı
Değişiklik hangi md'de karşı ı ı ı ı
düzeltilir; bayat kalan bir satı ı ı ı
2026-08-26 18:44:53 +00:00
### Tone
- Türkçe soruya Türkçe cevap.
- Platformu tanı ı ı ı ı ı ı
- Cevabı
