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-10-11 19:57:23 +00:00
6. Never add a new Core feature (`api/`, `ui/` code) without the command "core sisteme ekle" (standing default 11).
2026-03-25 05:52:55 +00:00
Exception:
2026-10-11 19:57:23 +00:00
- Custom React/backend code is written only on the user's command ("core sisteme ekle" or a
request that names the code change) — never because configuration seemed insufficient.
- When Core would be needed, say why the ListForm inventory is 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-10-14 19:26:03 +00:00
Tanı **olmayan** (işlem/belge) yeni tablo `TenantId` gibi `BranchId uniqueidentifier NOT NULL`
2026-10-14 21:12:14 +00:00
(PG `uuid NOT NULL` ) da taşı ı `IsBranch: true` . **Şube alanı ı
gelir** (`BranchId` kolonu taşı ı ı ı ı ı
şubelerdir (`Sas_T_BranchUsers`, Kullanı ı › › `LookupQueryValues.UserBranchValues` ),
yeni kayı **ilk seçeneğiyle** açı ı `LookupQueryValues.UserDefaultBranchValue`
ile aynı ı
2026-10-14 19:26:03 +00:00
Bu tablodan okuyan view/rapor ekranı `BranchId` 'yi taşı `IsBranch: true` olur. Ana kayda
bağlı ı ı ı
(`CascadeParentFields: BranchId`) + alt form ilişkisi `BranchId → BranchId` . Ayrı ı
`lowcode.instructions.md` §8.1 (İşlem tablosu → `BranchId` ).
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-18 21:22:40 +00:00
`true` , Aktif/Pasif widget'ı ı **olmayan** tabloya (işlem/belge tablosu, onun alt formları
satı `IsActive` eklenmez; yalnı ı ı ı
isterse aynı ı `NOT NULL DEFAULT 1` (`create_table`'da
2026-10-02 07:09:23 +00:00
`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.
2026-10-17 18:51:10 +00:00
**Kullanı ı ı → aktif kültürle: UI'da `localeFormat.ts`
(`formatLocaleDate/Time/DateTime/Number/Currency/Fixed`), API'de `CultureFormat` + `CultureInfo.CurrentCulture` ;
DevExtreme kolon/editörü adlı ı `shortDateShortTime` , `shortTime` , `decimal` ,
`fixedPoint` , `currency` ). Sabit desen (`DD.MM.YYYY`, `dd/MM/yyyy` ), `'tr-TR'` sabiti, `toLocaleString()` ve
görüntülenen ondalı `toFixed` yazı `<input type=date>` ) `ui/README.md` 'de.
2026-08-26 18:44:53 +00:00
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ı ı
2026-10-19 14:35:08 +00:00
tanı ı `Seo*` kolonları ı `data/Sas.Menus.Routes.json` ya da
`data/Sas.DeveloperKit.CustomComponents/{Id}.json` . Metin `::Anahtar` ile dil anahtarı ı
2026-09-22 20:59:36 +00:00
Kullanı ı ı ı
2026-10-19 14:35:08 +00:00
`Adm.SiteManagement.Seo.*` ayarları ı ı ı `lowcode.instructions.md` §0.9.
2026-09-22 20:59:36 +00:00
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.
2026-10-11 19:57:23 +00:00
11. **Core'a yeni özellik yalnı → Core = `api/` + `ui/` kaynak kodu; çerçeve =
`configs/seeds/` artefaktları ı ı ** "core sisteme ekle"** (ya da Core değişikliğini adı
isteyen eşdeğer komut) demedikçe Core'a yeni özellik yazı ı
fark etmez: DTO alanı `EditorOptions` anahtarı
React bileşeni/sayfası ı
`Routes` , dı ı
(`lowcode-reference.instructions.md` §0– `lowcode` §4– ı ı
bitirilir, son mesajda tek bir "Core gerektiren kı ı ı ı
Bildirilen hatanı ı ı
geçen değişikliği kapsar, sonraki talebe taşı ı ı ı
cevabı ı ı `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 /
2026-10-19 14:35:08 +00:00
tarih / tutar kolonları ı ı ı ı
2026-09-28 09:28:56 +00:00
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ı ı ı ı
2026-10-19 14:35:08 +00:00
menünün kodudur (`Hr.md`, `Prc.md` , `Adm.md` ),
2026-10-07 08:17:46 +00:00
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ı
2026-10-14 09:07:11 +00:00
Kapsam seed artefaktları ı ı
aynı ı ı ı ı ı ı ı ı ı
SQL nesnesi (tablo, view, yordam, fonksiyon), menüsüz ve referanssı ı `data/`
dosyası ı ı ı ı
`lowcode.instructions.md` §8.6.
2026-10-07 19:34:49 +00:00
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-10-07 20:27:23 +00:00
19. **Sabit lookup seçenekleri** → RadioGroup/SelectBox/TagBox/Autocomplete'in `StaticData` seçeneklerinde
2026-10-19 14:35:08 +00:00
`name` düz metin değil `Sas.StaticLookup.*` dil anahtarı ı ı ı ı ı ı
2026-10-07 20:27:23 +00:00
Deploy düz metni kendisi anahtara çevirir (aynı ı
`ListFormWizardAppService.LocalizeStaticLookupsAsync` , `lowcode.instructions.md` §4.3.4.1.
2026-10-07 22:07:28 +00:00
20. **EditorScript** → MCP/wizard script'i elle yazmaz, Script Builder kuralları ı
kurallardan üretir (`EditorScript.Rebuild`). `str/num/bool` alan **adı alı
değil). `setValue` 'da `true` /`false` mantı ı ı ı `0` /`1` deploy'da çevrilir).
MCP ve Script Builder aynı ı ı `set` zinciri derinlik sı ı ı ı
script hatası ı ı ı ı `lowcode.instructions.md` §4.4, §5.3, §5.6.
21. **Demo veri ≠ seed senkronu** → `SeedData: true` yalnı `SeedFilePath` açar;
`SeedSyncInsert/Update/Delete` istekte açı `false` 'tur (wizard cevabı `SeedSync` ).
2026-10-09 11:23:24 +00:00
22. **Wizard adı → yeni wizard'ı ı ı ı ı `{ModuleId}_{Ad}` 'dı
2026-10-17 18:51:10 +00:00
(`Prc_RejectReason.json`, `Hr_RejectionReason.json` ); aynı ı
2026-10-09 11:23:24 +00:00
için öneksiz ad dosya çakı ı ı
`MenuParentModuleId` 'den eklenir (`ListFormWizardDto.ResolveWizardName`); analiz ve üretim planı
2026-10-09 11:33:26 +00:00
dosya adı ı ı `configs/seeds/wizard/` altı
dosya yalnı ı ı ı
2026-10-17 18:51:10 +00:00
`lowcode.instructions.md` §4.10 (Adı
2026-10-09 14:01:18 +00:00
23. **Otomatik numara Sequence'tan** → wizard/MCP üretiminde talep otomatik numara istediğinde ya da
analiz bir alanı `OrderNo` , `RequestNo` …) otomatik numaralanması
2026-10-19 14:35:08 +00:00
alan `Adm.Definitions.Sequence` numaratörüne bağlanı ı
2026-10-09 14:01:18 +00:00
girmez. Numaratör
2026-10-19 14:35:08 +00:00
`data/Adm.Definitions.Sequence.json` 'a satı ı ı ı ı
2026-10-09 14:01:18 +00:00
alanı ı ı `FormFieldsDefaultValueDto` 'da `CustomValueType: 5` , `Value` = numaratörün `Name` 'i.
`@AUTONUMBER` , `MAX + 1` sorgusu ya da SQL ile numara üretilmez (boşluksuz numara açı
Ayrı ı `lowcode.instructions.md` §4.3.5.2.
2026-10-10 20:11:12 +00:00
24. **İş akı ı → tablo, tasarı ı ı `WorkflowDto`
yalnı ı `ApprovalUserName` nvarchar(256), `ApprovalStatus` nvarchar(50),
`ApprovalDate` datetime, `ApprovalDescription` nvarchar(200) (PG: varchar/timestamp). Ayrı
kolonu (`Status`), Guid onaycı ı ı ı
düğüm başlı ı ı `RejectReason` listesinden seçilip açı ı ı
Bu dört alan popup düzenleme formunda yer almaz (akı
Ayrı ı `lowcode.instructions.md` §4.7.
2026-10-14 09:07:11 +00:00
25. **Not yalnı ı → kayı ı
StoredProcedure, TableValuedFunction) Not yoktur: `PermissionJson.N` boş, `ShowNote` kapalı `{Kod}.Note` yetki satı ı
satı ı ı ı ı ı ı ı
(`ListFormWizardDto.HasNote`), C# seeder'da `DefaultPermissionJson(name, hasNote: false)` yazı ı ı ı
`lowcode.instructions.md` §4.2 (Üretilen yetkiler).
26. **Özel komutun parametreleri boş bı ı → MCP/prompt/wizard ile üretilen ya da düzenlenen ekranda yazı
`InsertCommand` /`UpdateCommand`/`DeleteCommand` ve `*BeforeCommand` /`*AfterCommand` ile aynı
`Insert/Update/DeleteFieldsDefaultValueJson` da tamamlanı `@Parametre` gönderilen alana, `IsTenant` 'ı
eklediği `@TenantId` 'ye ya da listedeki bir satı `LastModifierId=@USERID` , `DeleterId=@USERID` ,
`CreatorId=@USERID` , `*Time=@NOW` ) bağlanı ı
Wizard'ı ı ı ı ı
`SelectFieldsDefaultValueJson` çalı ı `DefaultFilter` 'a yazı ı ı ı
`lowcode.instructions.md` §4.3.5.3.
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ı ı
2026-10-19 14:35:08 +00:00
dal `data/Sas.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-11 19:57:23 +00:00
- **`Sequence.GetNextSequence` (C#) ↔ `Adm_P_SequenceNext.sql` (SQL Server + PG)** — numaratörün biçim
(`FormatTemplate` token'ları `PaddingSize` ) ve sı ı ı ı ı
formdan açı ı ı ı ı ı
2026-10-17 18:51:10 +00:00
Biri değişirse diğeri de değişir; yoksa aynı ı ı ı ı
ayrı ı ı ı ı ı
(`ISequenceRepository.TryAdvanceAsync`, `SequenceManager` yeniden dener) — entity izlenerek okunup `UpdateAsync`
ile yazı ı ı ı ı
2026-10-07 18:08:10 +00:00
- **Liste popup'ı ı ı ı ı
2026-10-09 19:40:51 +00:00
(`list/shared/editingForm.ts`, `editingFormScripts.ts` , `cascade.ts` ); TagBox/GridBox/ImageUpload/ImageViewer/Rating'in
2026-10-07 18:08:10 +00:00
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-10-20 08:52:23 +00:00
- **Wizard seed dosyası `Wizard` bölümüdür** → dosyada `ListForm` /`Fields` bölümü yoktur; ekranı
bütün sözleşmesi `Wizard` bölümündedir. ListForm detayı ı
`Insert` /`Update`/`Delete`, `FormDefaults` , `Permission` , `FilterRow` … `PivotOption` , görünüm option
blokları `ExtraFilters` , `CommandColumns` , `SubForms` , `Widgets` , `WorkflowDto` , `ChartOptions` ), alan
detayı ı `Groups[].Items[]` öğesinin bir alanı ı `Filter` ,
`Header` , `Grouping` , `TotalSummary` /`GroupSummary`, `Join` , `ValidationRules` , `Styling` , `Permission` ,
`PivotSettings` , `ListOrderNo` …). Wizard alanları `Menu` , `Language` , `Data` , `Details` , `Layout`
başlı ı ı `ListFormCode` → `WizardCode` , `MenuParentModuleId` → `ModuleId` ,
`LanguageTexts` → `Language.Texts` adı ı ı ı ı
`DataSourceConnectionString` , boş `MenuParentPath` / `LanguageTexts` ) hiç yazı ı
(`AllowAdding/AllowUpdating/AllowDeleting/AllowDetail/OpenDetailAfterInsert/ConfirmDelete`,
`SeedData` /`SeedSync`, öğedeki `IsRequired` ) **dosyaya yazı : `Editing` , `Data.SeedFilePath` /`SeedSync*`
ve `ValidationRules` 'tan türetilir (`SyncDerivedAnswers`); deploy girdisinde yazı ı ı
dosya biçimidir; C# sözleşmesi düzdür, dönüşüm `WizardSeedFileDto.ToSeedJson` / `FromSeedJson` içindedir.
**Wizard seed dosyası ı ı ; düz `JsonSerializer` çağrı ı ı ı
ve türetilen kı ı `FromSeedJson` eski biçimin `ListForm` /`Fields` bölümlerini
okuyup `RefreshFrom` ile `Wizard` 'a aktarı ı
- **Wizard ile üretilen ekran** → ListForm detayı ı ı
`ListFormFieldsAppService` , `ListFormJsonRowAppService` ) seed dosyası ı `Wizard` bölümünü
`ListFormWizardDto.RefreshFrom(listForm, fields)` ile geri yazar (`WizardSeedSynchronizer`). Bu üçlüden
birine yeni bir kayı ı ı
**Eşlik kuralı `GridOptionsEditDto` /`ColumnFormatEditDto`'ya eklenen her alanı
`ListFormWizardDto` /`WizardColumnItemInputDto`'da karşı ı ı `RefreshFrom` + `BuildListForm/BuildFields`
eşlemesi olmak zorundadı ı ı ı
- **Wizard girdisinden ekran üretimi** → tek hat `ListFormWizardDto.ApplyDefaults(isDeleted, isCreated,
isModified)` (boş blokları `WizardDefaults` + `WizardConsts` ile doldurur; yetki adları ı ı
durum anahtarı `BuildListForm()` / `BuildFields()` (salt eşleme,
parametresiz) → `RefreshFrom` (üretilen ekran cevaplara geri yazı ı
yazma `GridOptionsEditDto.ApplyTo` / `ColumnFormatEditDto.ApplyTo` . Deploy, seeder (`WizardDataSeeder`
dosyadan `Wizard.BuildListForm()/BuildFields()` ) ve senkronizasyon aynı ı ı ı
üretim kopyası
2026-09-02 08:32:53 +00:00
- **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-10-19 14:35:08 +00:00
`permission.constant.ts` + `data/Sas.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çı ı
2026-10-10 22:03:36 +00:00
**MCP'nin kendi reddi istisna değildir, modelle konuşmadı : eksik/hatalı ı
kapalı `McpProblem` olarak döner — MCP AppService'leri `McpOutcome<T>` /
`McpProblem?` döndürür, domain servisleri (`McpSqlGuard`, `McpTableCreator` , `McpSqlObjectWriter` )
de öyle; araç katmanı `McpToolResult.From` ile hata sonucuna (`CallToolResult.IsError`) çevirir,
model mesajı `throw new UserFriendlyException` ve `AuthorizationService.CheckAsync`
MCP kodunda kullanı ı ı ı `ERR` üretir); yetki
`McpAppService.CheckPermissionAsync` ile adı ı ı ı
beklenmeyen durum). Arkadaki platform servisinin (wizard, custom component, ListForm verisi) attı ı
`UserFriendlyException` /yetki reddi ile sı ı `[Authorize]` reddi `McpToolErrorTranslator`
(çağrı ı ı `[Authorize]`
attribute'uyla istiyorsa (ret mesajı ı ı ı `McpToolNames.ServicePermissions` 'a
eklenir; ekran yetkisi gereken araç yetkiyi `IMcpListFormAccessFilter.GetPermissionNameAsync` +
`CheckPermissionAsync` ile adı
2026-09-24 11:58:23 +00:00
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`
2026-10-19 14:35:08 +00:00
+ menü/modül/izin grubu/yetki/dil satı ı
`data/Abp.Identity.Permission{Groups,s}.json` , `data/Sas.Languages.LanguageText.json` ;
2026-09-25 06:39:34 +00:00
`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-10-07 22:07:28 +00:00
; `SeedSync*` bayrakları **kapalı kalı ı ı ı
yansı ı ı ı `SeedSync: true` , wizard ekranı ı `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.
2026-10-19 14:35:08 +00:00
- **Talepteki görsel** → `Sas.DevRequests` açı ı ı ı ı `data:` URI olarak
2026-09-24 11:58:23 +00:00
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-10-19 14:35:08 +00:00
`append_dev_request_note` , `add_dev_request_subtasks` ) ona `Sas.Mcp.Timesheet.*` anahtarı
2026-09-29 06:14:07 +00:00
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-09 17:02:27 +00:00
ile yalnı ı
2026-10-07 12:45:18 +00:00
modül dokümanı ı ı
2026-10-09 14:01:18 +00:00
"2. Analiz ve kararlar" alt bölümüne üretimde `save_module_doc` ile yazı ı
`productionReady` ile belirler: "Üretime hazı `Ready to Start` , şartlı ı
`Analysis` (kullanı ı ı `append_dev_request_note` ile `Analysis` 'e eklenir.
2026-09-28 09:28:56 +00:00
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`
2026-10-20 08:52:23 +00:00
girdisi dosya biçimi (`{"Wizard": {...}}`, başlı ı ı
bloklar isteğe bağlı ı ı `ApplyDefaults` ile dolar), kı
eski biçimin `ListForm` /`Fields` bölümleri reddedilir (`Sas.ListForm.WizardError.LegacySectionsNotAccepted`);
`get_wizard` yeni biçimi döner.
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-10-19 14:35:08 +00:00
karşı ı `create_table` bu yüzden `.Write` 'a ek olarak `Sas.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ı ı ı ı
2026-10-19 14:35:08 +00:00
konmaz: menüsüz `Hr.My*` /`Team*` wizard + Intranet panosu widget'ı ı ı
2026-10-05 14:11:06 +00:00
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ı ı
2026-10-19 14:35:08 +00:00
parça birlikte çalı ı ı `Adm.SiteManagement.Seo.*` ayarları ı
2026-09-22 20:59:36 +00:00
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-19 14:35:08 +00:00
- **Yeni bir dil anahtarı `configs/seeds/data/Sas.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`
2026-10-16 21:13:31 +00:00
dosyası ı ı
uygulama sunucuda stilsiz kalı ı ı ı
sı ı `src/assets/styles/tailwind/index.css` 'teki `@source inline`
satı ı ı ı ı `rounded-sm` , `bg-black/50` ,
`shrink-0` , `x!` ); tema `tailwind.config.ts` 'te değil aynı ı `@theme` bloğundadı
2026-10-19 14:35:08 +00:00
- **Custom component kaydı `data/Sas.DeveloperKit.CustomComponents/{Id}.json`
2026-09-21 19:40:13 +00:00
(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ı ı
2026-10-20 08:52:23 +00:00
dosyanı `Wizard` bölümündeki bloklar olduğu gibi uygulanı ı
yeniden üretilmez — tasarı ı ı ı ı ı
2026-09-25 06:39:34 +00:00
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-10-19 14:35:08 +00:00
- **Modül = menü = tablo öneki = yetki kökü** → platformun C# seeder'lı `Sas` ,
`Adm` , `Hr` (İK) ve `Pub` (kök menü `Pub.Header` ) modüllerindedir
2026-10-17 18:51:10 +00:00
(`TableNameResolver.MenuPrefix` yalnı ı
2026-10-19 14:35:08 +00:00
tablo önekiyle gelir — `Prj` , `Prc` , `Stk` (`Stk_`),
`Mnt` (`Mnt_`), `Prd` (`Prd_`); tam liste `data/Sas.Menus.Menu.json`
2026-10-17 18:51:10 +00:00
kök satı ı ı ı ı
2026-09-29 11:46:39 +00:00
taşı ı ı `TableNameResolver` (`MenuPrefix`) + `AppCodes` (Seed/Platform) +
2026-10-19 14:35:08 +00:00
`ListFormSeeder_{Sas,Adm,Hr}.cs` + `data/{ListFormCode}.json` adı
satı ı `Authority` . Yetki `Modules` değeri: Sas/Adm `Sas|Adm` , İK `Sas|Hr`
2026-09-29 11:46:39 +00:00
(`Sas` host, `Adm` /`Hr` kiracı `BranchId` zorunludur; seed
satı ı ı
2026-10-19 14:35:08 +00:00
- **Menü ağacı `configs/seeds/data/Sas.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-10-19 14:35:08 +00:00
şehir → ilçe (`Sas.Definitions.{CountryGroup,Country,City,District}.json`), departman → onaycı `Adm.Definitions.Approver` ), bildirim tipi → kuralı
(`Adm.Notifications.Notification{Types,Rules}.json`). Para birimi, hitap, AI bot
(`Sas.Definitions.{Currency,ContactTitle,AiBot}.json`), ayar tanı ı
ve zamanlanmı
(`Sas.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-10-19 14:35:08 +00:00
sabit bir GUID'dir, satı ı `Sas.Menus.Routes.json` dosyası
2026-09-22 20:59:36 +00:00
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ı
2026-10-19 14:35:08 +00:00
`Pub.Header` hem üst menüyü hem alt bilgideki hı ı ı ı
2026-10-20 09:20:27 +00:00
`PublicNav` düğümü) ve ziyaretçiye uygulama konfigürasyonunun `menus.public` alanı ı ı
2026-09-09 06:06:25 +00:00
(menü ucu `[Authorize]` ). Sayfa ise Custom Component'tir: `/admin/` ile
başlamayan `RoutePath` otomatik public route olur ve aynı
`RoutePath` boş bı ı ı
2026-10-19 14:35:08 +00:00
`data/Sas.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-14 09:07:11 +00:00
- Seed tarafı ı
wizard ve veri dosyası `sql/` dosyası ı `postgres/` eşi var; kullanı ı
wizard'ı `Language.Texts` /`InsertedRecords`'undan ve dil dosyası ı ı ı
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ı
