Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 78 additions & 0 deletions ATTRIBUTION.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# Atıf ve kaynaklar

Bu dosya repodaki içeriğin nereden geldiğini ve hangi lisansla
kullanıldığını anlatır. Lisans metinlerinin kendisi ayrı dosyalarda:

| Ne | Lisans | Metin |
|---|---|---|
| Kaynak kod (repo'nun `src/content/` dışındaki her şeyi) | MIT | [`LICENSE`](LICENSE) |
| Soru içeriği (`src/content/`: sorular, örnek cevaplar, kavramlar) | CC BY-SA 4.0 | [`src/content/LICENSE`](src/content/LICENSE) |
| Dış kaynaktan türetilmiş içerik | Kaynağın lisansı (bugün yalnızca MIT) | [`src/content/THIRD_PARTY_NOTICES`](src/content/THIRD_PARTY_NOTICES) |

Uygulamada aynı üç metin alt bilgideki **Açık kaynak · Lisanslar**
panelinde, pakete gömülü olarak gösterilir (`src/content/licenses.ts`).

## Dış kaynaktan türetilmiş içerik

Her sorunun `origin` alanı kökenini taşır: `{ "kind": "own" }` ya da
`{ "kind": "external", "repo", "url", "license" }`.

| Kaynak | Lisans | Soru | Ne türetildi |
|---|---|---|---|
| [sudheerj/reactjs-interview-questions](https://github.com/sudheerj/reactjs-interview-questions) | MIT | 44 (react) | Soru metinleri çeviri. Cevaplar react.dev'e göre büyük ölçüde yeniden yazıldı. |

Geri kalan sorular kendi yazımımızdır (`origin.kind = "own"`).

MIT'in tek şartı telif ve izin metninin dağıtılan kopyalarda bulunması.
Bildirim `THIRD_PARTY_NOTICES`'ta ve uygulamanın Lisanslar panelinde.
MIT alt lisanslamaya izin verdiği için bu sorular CC BY-SA 4.0 içerikle
birlikte dağıtılabilir; MIT bildirimi kalkmaz.

## Başvurulan kaynaklar

Soruların `source` alanı, cevap yazılırken okunan birincil belgeleri
listeler ("Kendi derleme — <belge: bölüm>"). Bu belgelerden **metin
türetilmedi**: cevaplar kendi cümlelerimizle yazıldı. Bu yüzden bugün
aşağıdakilere yasal atıf borcu yok; liste, ileride birinden uyarlama
yapılırsa hangi kuralın geçerli olacağını gösterir.

| Kaynak | Lisans | Uyarlama yapılırsa |
|---|---|---|
| OWASP (Cheat Sheet Series, WSTG, Top 10, ASVS) | CC BY-SA 4.0 | Serbest; atıf ve aynı lisans. |
| MDN Web Docs | CC BY-SA 2.5 (kod örnekleri CC0) | Serbest; 2.5 §4(b) sonraki sürüme (4.0) izin veriyor. Atıf: "Mozilla Contributors". |
| react.dev, legacy.reactjs.org | CC BY 4.0 | Serbest; atıf. |
| Microsoft Learn | CC BY 4.0 (kod MIT) | Serbest; atıf. |
| WHATWG (HTML, Fetch, DOM) | CC BY 4.0 | Serbest; atıf. |
| Docker Docs, Spring belgeleri | Apache 2.0 | Serbest; lisans ve değişiklik bildirimi. |
| PostgreSQL belgeleri | PostgreSQL License | Serbest; telif bildirimi. |
| Node.js, webpack, Vite, TanStack belgeleri | MIT | Serbest; telif bildirimi. |
| NIST yayınları | ABD kamu malı | Serbest. |
| IETF RFC'leri | IETF Trust Legal Provisions | **Uyarlama yapılmaz**; alıntı ve başvuru serbest. |
| Oracle (Java SE, JLS, JVMS, MySQL kılavuzu) | Tüm hakları saklı / spesifikasyon lisansı | **Uyarlama yapılmaz.** |
| PortSwigger Web Security Academy | Tüm hakları saklı | **Uyarlama yapılmaz.** |
| W3C belgeleri | W3C Document License | **Uyarlama yapılmaz.** |
| GNU Bash Reference Manual | GFDL 1.3 | **Uyarlama yapılmaz**: GFDL CC BY-SA 4.0 ile uyumsuz. |
| Kitaplar ve makaleler (Effective Java, Fowler, R. C. Martin vb.) | Tüm hakları saklı | **Uyarlama yapılmaz**; fikirler serbest. |

Lisansı belirsiz ya da doğrulanmamış kaynaklar (Hibernate belgeleri,
ECMA-262, JEP'ler, OpenID, FIDO, lisans dosyası olmayan repolar) da
"uyarlama yapılmaz" sayılır. Tam döküm ve gerekçeler:
[`docs/content-audit.md`](docs/content-audit.md), bölüm 3.

## Katkı kuralları

- **Dış kaynaktan soru eklerken:**
- `origin`'i `external` olarak doldur.
- `source`'u `; soru kaynağı: <sahip/repo> (<lisans>)` ile bitir.
- Repo'nun lisans metnini telif satırıyla `THIRD_PARTY_NOTICES`'a ekle.
- Bu dosyadaki tabloyu güncelle.
- **Lisans kabul edilen listede değilse** (`EXTERNAL_LICENSES`,
`src/domain/question.ts`: MIT, CC BY 4.0, CC BY-SA 4.0, Apache 2.0),
önce CC BY-SA 4.0 ile uyumunu değerlendir; uyumluysa listeye ekle.
- **"Uyarlama yapılmaz" kaynaklardan** çeviri ya da yakın uyarlama
yapma. Bilgi için oku, cevabı kendi cümlelerinle yaz, `source`'ta belgeyi
an.
- **Gerçek mülakat soruları:** soru metnini olduğu gibi alma, şirket adı
ya da bağlamı yazma; aynı kavramı kendi cümlenle sor.
- `npm run check:content` ve `src/content/origin.test.ts`, `origin` ile
`source` arasındaki çelişkiyi ve bildirimi olmayan dış repo'yu reddeder.
22 changes: 21 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,16 @@ cevabını yazar, kavram bazlı geri bildirim alır.
kapatılmıştır, kapalı kalır. İçerikten kalkan bilinenlerden düşmez
(geri döndüğünde kapatılmışsa açılmasın), `CATEGORIES`'ten kalkan düşer.
Alanın yokluğu "eski kayıt" demek; şemaya default konmaz.
- **Kategori gizleme yalnızca frontend'de** (`HIDDEN_CATEGORIES`,
`content/index.ts`). Açık liste, soru sayısı eşiği değil. Gizli
kategorinin soruları yüklenir ve doğrulanır (`LOADED_QUESTIONS`) ama
`QUESTIONS`'a, çekilişe ve seçiciye girmez. Seeder'a ASLA filtre konmaz:
`upsertAndPrune` içerikte olmayan soruyu siliyor ve `question_progress`
`ON DELETE CASCADE`, kullanıcıların ilerlemesi ve denemeleri kalıcı olarak
giderdi. Sunucu gizli soruları tutmaya devam eder. Kullanıcının kayıtlı
seçimi korunur (`categoryHydration`, "içerikten kalkan" gibi). İçerik
testleri (`registry`, `contentFences`, `origin`) `LOADED_QUESTIONS`'la
çalışır.
- **`LEGACY_KNOWN_CATEGORIES` dondurulmuş bir listedir.** 1.0.1'de içeriği
olan kategoriler; alanı olmayan eski kayıt bunları görmüş sayılır. Yeni
kategori ASLA buraya eklenmez — eklenirse mevcut kullanıcılarda kapalı
Expand Down Expand Up @@ -115,7 +125,13 @@ shadcn/ui bileşenleri ihtiyaç oldukça tek tek eklenir, toplu kurulmaz.
- Three.js veya WebGL. Makine CSS 3D ve SVG ile çizilir.
- localStorage'a JWT yazma.
- Soru içeriğini başka sitelerden kopyalama. İçerik özgün yazılır,
`source` alanında türetildiği konu belirtilir.
`source` alanında türetildiği konu belirtilir. Kökeni `origin` taşır
(`own` ya da `external`: repo, url, lisans); zorunlu ve varsayılansız.
Dış kaynaklı soru `source`'ta "soru kaynağı: <sahip/repo> (<lisans>)"
ile biter, repo'nun lisans metni `THIRD_PARTY_NOTICES`'ta olur; çelişkiyi
`check:content` (çıkış 1) ve `content/origin.test.ts` reddeder. Lisans
`EXTERNAL_LICENSES`'ta değilse önce CC BY-SA 4.0 ile uyumu değerlendirilir
(`docs/content-audit.md`, bölüm 3).

## Derleme ve CI

Expand Down Expand Up @@ -530,6 +546,10 @@ shadcn/ui bileşenleri ihtiyaç oldukça tek tek eklenir, toplu kurulmaz.
döner (Europe/Istanbul). Leitner tamamlanma: o günkü `wasDue=true`
`self_eval` ÷ günün ilk `app_open.dueCount`'u, tavan 1, `dueCount = 0`
günleri hariç.
- **aliasResult'ta kırılma.** normalizeTr değişikliği (commit 5bcc44c, deploy
tarihi: <DEPLOY_TARİHİ>) öncesindeki aliasResult değerleri karşılaştırmaya
dahil edilmemeli: kelime içi tire ve alt çizgi o commit'ten sonra boşluk
sayılıyor, aynı cevap daha sık "all" alıyor. Not `queries.sql`'in başında da var.

### İstemci (`src/analytics/`)

Expand Down
2 changes: 2 additions & 0 deletions Dockerfile.frontend
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ COPY index.html vite.config.ts tsconfig.json tsconfig.app.json tsconfig.node.jso
COPY public public
COPY src src
COPY privacy privacy
# Lisanslar paneli kök LICENSE'ı pakete gömüyor (src/content/licenses.ts).
COPY LICENSE ./

# Alt bilgideki commit kısaltması için; vite.config.ts okuyor. Verilmezse
# boş kalır ve alt bilgi "dev" yazar.
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,8 @@ Bu repo iki farklı lisansla korunmaktadır:

İçerikleri dilediğin gibi kullanabilir, değiştirebilir ve paylaşabilirsin. Sadece kaynağı (bu repoyu) belirtmen ve türettiğin işleri de aynı lisansla paylaşman yeterli.

Hangi içeriğin nereden geldiği, başvurulan kaynakların lisansları ve dış kaynaktan soru eklerken uyulacak kurallar: [ATTRIBUTION.md](ATTRIBUTION.md). Uygulamada aynı metinler alt bilgideki "Açık kaynak · Lisanslar" panelinde.

---

<div align="center">
Expand Down
5 changes: 5 additions & 0 deletions docs/analytics/queries.sql
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
-- METRİK KIRILMASI — aliasResult: normalizeTr değişikliği (commit 5bcc44c,
-- deploy tarihi: <DEPLOY_TARİHİ>) öncesindeki aliasResult değerleri
-- karşılaştırmaya dahil edilmemeli. O commit'ten sonra kelime içi tire ve alt
-- çizgi boşluk sayılıyor; aynı cevap daha sık "all" alıyor.
--
-- Kullanım ölçümü analiz sorguları (analytics_event, V4 migration).
--
-- Her sorgu kendi başına çalışır; psql ya da herhangi bir istemcide tek tek
Expand Down
9 changes: 8 additions & 1 deletion scripts/content-check.ts
Original file line number Diff line number Diff line change
Expand Up @@ -9,17 +9,20 @@
/* scripts/content-check/README.md. */
/* ------------------------------------------------------------------ */

import { readFileSync } from "node:fs";
import { fileURLToPath } from "node:url";

import { analyze, summarize } from "./content-check/analyze.ts";
import { parseArgs, USAGE } from "./content-check/cli.ts";
import { originProblems, printOriginProblems } from "./content-check/origin.ts";
import { loadFromDir, loadFromRevision, overlay, readQuestions } from "./content-check/pool.ts";
import { loadProbeAnswers } from "./content-check/probes.ts";
import { printComparison, printDetails, printSummary } from "./content-check/report.ts";

const REPO_ROOT = fileURLToPath(new URL("..", import.meta.url));
const CONTENT_DIR = fileURLToPath(new URL("../src/content/tr", import.meta.url));
const PROBES_DIR = fileURLToPath(new URL("./content-check/probes", import.meta.url));
const NOTICES_PATH = fileURLToPath(new URL("../src/content/THIRD_PARTY_NOTICES", import.meta.url));

function main(argv: string[]): number {
const options = parseArgs(argv);
Expand All @@ -41,7 +44,11 @@ function main(argv: string[]): number {
printDetails(current, options.categories, options.verbose);
printSummary(summarize(current));
}
return 0;

// Köken her zaman bütün havuzda ve yalnızca çalışma ağacında denetlenir.
const origin = originProblems(pool, readFileSync(NOTICES_PATH, "utf8"));
printOriginProblems(origin);
return origin.length > 0 ? 1 : 0;
}

try {
Expand Down
15 changes: 13 additions & 2 deletions scripts/content-check/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ npm run check:content -- --base main # PR öncesi
| `--prefix` | Alt dize taramasında önek eşleşmelerini de listeler. |
| `-v` | Çiftlerde her kavramı hangi alias'ın tuttuğunu, doğal cevapta kaçan kavramları gösterir. |

Çıktıda önce ayrıntı bölümleri, en sonda kategori başına özet tablo gelir. Betik rapor üretir, kapı değildir: uyarı olsa da çıkış kodu 0. Dosya okunamazsa 1, seçenek yanlışsa 2 döner.
Çıktıda önce ayrıntı bölümleri, sonra kategori başına özet tablo, en sonda köken bölümü gelir. Betik çoğunlukla rapor üretir, kapı değildir: uyarı olsa da çıkış kodu 0. Tek istisna köken: sorun varsa 1 (bkz. Kontroller → Köken). Dosya okunamazsa 1, seçenek yanlışsa 2 döner.

**Sayıyı değil satırı karşılaştır.** Bir çift kalkıp yerine başka biri gelince kategorinin çift sayısı aynı kalır. `--base` bu yüzden çiftleri, uyarıları ve tuzakları tek tek karşılaştırır.

Expand Down Expand Up @@ -50,6 +50,17 @@ npm run check:content -- --base main # PR öncesi
- Kalın içinde kod ve tek yıldızlı italik yok, ikisi de çizilmiyor.
- followUp var; source `Kendi derleme — <birincil belge: bölüm>` ile başlıyor.

### Köken (`origin.ts`) — kapı

Her sorunun zorunlu bir `origin` alanı var: `{ "kind": "own" }` ya da `{ "kind": "external", "repo", "url", "license" }`. Alanı eksik soru şemadan geçmez, dosya okunamaz. Bu bölüm iki durumu daha reddeder:

- `origin` ile `source` çelişiyor. `source` `soru kaynağı: <sahip/repo> (<lisans>)` ile bitiyorsa `origin` `external` olmalı, repo ve lisans aynı olmalı; bitmiyorsa `own`.
- `external` bir repo'nun `src/content/THIRD_PARTY_NOTICES`'ta bölümü yok.

Sorun varsa çıkış kodu 1. Kurallar `src/domain/origin.ts`'te. Bu betik CI'da çalışmadığı için aynı kontrol `src/content/origin.test.ts` ile CI'da da çalışır. Kabul edilen lisanslar `EXTERNAL_LICENSES` (`src/domain/question.ts`); listeye ekleme önce `docs/content-audit.md` bölüm 3'teki uyum değerlendirmesinden geçer.

`--base` ile okunan eski revizyonlarda `origin` yoksa `source`'tan türetilir; yalnızca okunan kopyada, diske yazılmaz.

### Yarı isabet çiftleri (`pairs.ts`)

`hedef ← diğer` şu demek: diğer sorunun model cevabı, hedefin kavramlarının en az yarısını (`ceil(n/2)`) tutuyor. Çiftler üç sınıfa ayrılır:
Expand Down Expand Up @@ -96,7 +107,7 @@ Tek kaynak `generic.ts`. Listeyi değiştirirsen bu bölümü de güncelle.
## Dosyalar

- **Giriş:** `scripts/content-check.ts`.
- **Kontroller:** `rules.ts`, `format.ts`, `pairs.ts`, `substrings.ts`, `probes.ts`.
- **Kontroller:** `rules.ts`, `format.ts`, `pairs.ts`, `substrings.ts`, `probes.ts`, `origin.ts`.
- **Okuma:** `pool.ts` içeriği dizinden, git revizyonundan ya da `--edits` dosyalarından okur.
- **Çıktı:** `analyze.ts` ölçümleri toplar. `lines.ts` ve `report.ts` çıktıyı yazar, `compare.ts` karşılaştırmayı yapar.
- **Testler:** `checks.test.ts`, `npm test` ile birlikte çalışır.
Expand Down
29 changes: 29 additions & 0 deletions scripts/content-check/checks.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ import { parseArgs } from "./cli.ts";
import { diffLines } from "./compare.ts";
import { formatIssues, sentenceCount } from "./format.ts";
import { findPairs } from "./pairs.ts";
import { originProblems } from "./origin.ts";
import { overlay } from "./pool.ts";
import { conceptWarnings, indexAnswers } from "./rules.ts";
import { findSubstringTraps } from "./substrings.ts";
Expand All @@ -23,6 +24,7 @@ function question(id: string, overrides: Partial<Question> = {}): Question {
kind: "definition",
topic: "Index",
difficulty: 1,
origin: { kind: "own" },
prompt: `${id} nedir, açıkla?`,
modelAnswer: "Alfa ile beta birlikte çalışır. Gama ise ayrı durur.",
keyConcepts: [concept("a", ["alfa", "alpha"]), concept("b", ["beta", "bêta"]), concept("c", ["gama", "gamma"])],
Expand Down Expand Up @@ -148,3 +150,30 @@ describe("parseArgs", () => {
expect(parseArgs(["--base"])).toEqual({ error: "--base bir değer ister" });
});
});

describe("köken", () => {
const sudheerj = {
kind: "external",
repo: "sudheerj/reactjs-interview-questions",
url: "https://github.com/sudheerj/reactjs-interview-questions",
license: "MIT",
} as const;
const marker = "Kendi derleme — react.dev: Hooks; soru kaynağı: sudheerj/reactjs-interview-questions (MIT)";

it("source ile çelişen origin'i ve bildirimi olmayan repo'yu satır olarak verir", () => {
const pool = [
question("tutarli"),
question("celisen", { source: marker }),
question("dis", { source: marker, origin: sudheerj }),
];
expect(originProblems(pool, "başka bir bildirim")).toEqual([
"celisen: source dış kaynak diyor (sudheerj/reactjs-interview-questions), origin own",
"sudheerj/reactjs-interview-questions: THIRD_PARTY_NOTICES'ta bölümü yok",
]);
});

it("tutarlı havuzda boş", () => {
const pool = [question("tutarli"), question("dis", { source: marker, origin: sudheerj })];
expect(originProblems(pool, "sudheerj/reactjs-interview-questions")).toEqual([]);
});
});
25 changes: 25 additions & 0 deletions scripts/content-check/origin.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
import { originIssues, reposMissingFromNotices } from "../../src/domain/origin.ts";
import type { Question } from "../../src/domain/question.ts";

/* ------------------------------------------------------------------ */
/* Köken denetimi — betiğin tek kapısı */
/* */
/* Diğer kontroller ölçümdür, uyarı olsa da çıkış kodu 0. Köken ise */
/* lisans yükümlülüğü: source ile çelişen origin ya da bildirimi */
/* olmayan bir dış repo yayına çıkmamalı. Bu yüzden sorun varsa çıkış */
/* kodu 1. Eksik origin'i zaten şema reddediyor (dosya okunamaz). */
/* ------------------------------------------------------------------ */

/** Bulunan sorunlar, her biri bir satır; boş liste temiz demek. */
export function originProblems(pool: readonly Question[], notices: string): string[] {
const lines = pool.flatMap((question) => originIssues(question).map((issue) => `${question.id}: ${issue}`));
for (const repo of reposMissingFromNotices(pool, notices)) {
lines.push(`${repo}: THIRD_PARTY_NOTICES'ta bölümü yok`);
}
return lines;
}

export function printOriginProblems(lines: readonly string[]): void {
console.log(`\n== Köken (origin) (${lines.length})`);
for (const line of lines) console.log(` ${line}`);
}
18 changes: 17 additions & 1 deletion scripts/content-check/pool.ts
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@ import { execFileSync } from "node:child_process";
import { readdirSync, readFileSync } from "node:fs";
import { join } from "node:path";

import { originFromSource } from "../../src/domain/origin.ts";
import { parseQuestionFile } from "../../src/domain/question.ts";
import type { Question } from "../../src/domain/question.ts";

Expand Down Expand Up @@ -36,10 +37,25 @@ export function loadFromRevision(repoRoot: string, revision: string): Question[]
.sort()
.flatMap((path) => {
const ref = `${revision}:${path}`;
return parseQuestionFile(ref, JSON.parse(git("show", ref))).questions;
return parseQuestionFile(ref, withOrigin(JSON.parse(git("show", ref)))).questions;
});
}

/**
* origin alanı gelmeden önceki revizyonlarda soru şemadan geçmez. Kıyas
* yapılabilsin diye eksik origin source'tan türetilir; yalnızca okunan
* kopyada, diske yazılmaz. Alanı olan sorulara dokunulmaz.
*/
function withOrigin(file: { questions?: Record<string, unknown>[] }): unknown {
if (!Array.isArray(file.questions)) return file;
return {
...file,
questions: file.questions.map((question) =>
"origin" in question ? question : { ...question, origin: originFromSource(question.source as string | undefined) },
),
};
}

/**
* Düzenlenmiş sorular aynı id'li soruların yerine geçer, yeni id'ler sona
* eklenir. Diske yazılmaz: değişikliği merge-questions'tan önce denemek için.
Expand Down
Loading
Loading