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-08-28 07:47:17 +00:00
6. Never step outside the framework without explicit approval (standing default 10).
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-08-28 07:47:17 +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` |
| Yetki kodları `PlatformConsts.AppCodes` (backend) + `constants/permission.constant.ts` (UI) |
| Seed yolları `SeedPathResolver` |
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ı ı ı ı
2. **Yeni ekran** → Wizard yolu. `Definitions` altı
bir kök menü oluştur, `Order = max(Order) + 1` .
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-08-26 18:44:53 +00:00
7. **Ekran içi hesap/koşul ihtiyacı → önce `EditorScript` (Script Builder tarifleri), sonra
`EditorOptions` ; kod yazmak son çare.
8. **SQL** → her zaman parametreli. String birleştirme ile sorgu kurma.
9. **Silme** → `DeleteCommand = DefaultDeleteCommand("{Tablo}")` ; ham SQL string'i yazma.
2026-08-28 07:47:17 +00:00
10. **Çerçeve sı ı ı → uygulama kendini kendi mekanizmaları ı
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-08-26 18:44:53 +00:00
### Cross-cutting: touching one thing means touching these too
- **`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-09-02 08:32:53 +00:00
- **Wizard seed dosyası `Wizard` bölümü yalnı
taşı `ListForm` /`Fields` içinde karşı ı ı ı
kı ı ı ı ı ı ı
tanı ı ı ı ı ı
doldurulur (`FromSeedJson`). Wizard'a yeni bir alan eklerken karşı ı ı
Dosyada kalan wizard alanları ı ı ı `Menu` , `Language` , `Groups` — ve
`ListFormCode` → `WizardCode` , `MenuParentModuleId` → `ModuleId` adı ı ı ı ı
alanlar (`CreateMenu: true`, boş `DataSourceConnectionString` ) hiç yazı ı
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.
- **Wizard ile üretilen ekran** → seed dosyası
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-08-26 18:44:53 +00:00
- **Yeni bir yetki** → `PlatformConsts.AppCodes` + `PermissionsData.json` + (UI'da kullanı
`permission.constant.ts` + `LanguagesData.json` .
- **Yeni bir dil anahtarı `LanguagesData.json` ; eklemeden önce anahtarı
olmadı ı ı
2026-09-05 18:20:18 +00:00
- **Custom component kaydı `data/App.DeveloperKit.CustomComponents.json`
(Custom Components ekranı ı ı
dosyada bir satı ı ı
kayı ı ı ı ı `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şı ı ı
- **Ş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`
→ `data` → `wizard` . Tablo eksikse önce scripti çalı ı ı
wizard ekranı **aynı yoldan geçer (`DeployWizardAsync`); dosyadaki `ListForm` /`Fields`
sözleşmesi olduğu gibi kullanı ı ı ı ı
değişikliklerini silerdi. Var olan ekrana dokunulmaz, her ekran kendi UoW'unda kurulur.
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`
bayrakları `data/{ListFormCode}.json` dosyası
2026-09-05 18:20:18 +00:00
yansı ı ı ı ı
(`CompleteImport`) `ListFormSeedDataApplier` dosyayı ı
eklenir, varsa dokunulmaz; import'ta `overwriteExisting` açı ı ı
değerlerle güncellenir ve soft delete izleri (`IsDeleted`/`DeletionTime`/`DeleterId`) temizlenir. Yeni bir kayı
senkronizasyon çağrı ı
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-08-31 14:17:50 +00:00
- **`MenusData.json`** → `Routes` bölümüne dokunma; yalnı `Modules` ve `Menus` .
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ı ı ı ı ı ı
- `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ı
