StandardGuide

🇬🇧 English  |  🇹🇷 Türkçe

Live site / Canlı site: https://standardguide.netlify.app

---

🇬🇧 English

StandardGuide is an open-source project that turns MIL-STD-461G (electromagnetic interference / EMI), DO-160G (aircraft environmental conditions), and MIL-STD-810H (military environmental testing) — usually scattered across hundreds of pages of English PDFs — into a single interactive, Turkish-language web guide.

For each test, the standard's definition, applicability conditions, the physical meaning of limit values, common design mistakes, precompliance tips, and explanatory images are gathered on one screen. A page-aware AI assistant answers questions specific to the test being viewed, grounded in the standard text. There's also an Experience Hub where engineers can share their own field experience.

Tech stack

React 19 + TypeScript, Vite 8, Tailwind CSS v4, Supabase (backend for notes), Google Gemini (AI assistant).

Quickstart

git clone https://github.com/furkanbulus123/StandardGuide.git
cd StandardGuide/emi-rehber
npm install
cp .env.local.example .env.local   # fill in your own Supabase/Gemini keys
npm run dev

Open http://localhost:5173 in your browser.

Production build: npm run build → deploy the dist/ folder to any static host (Netlify, Vercel, GitHub Pages...).

Project structure

emi-rehber/
  src/
    data/        ← standard and test content (pure TypeScript)
    lib/         ← services: AI context, notes repo, theme
    components/  ← reusable UI pieces
    pages/       ← route components
  db/            ← Supabase schema and seed scripts

See ARCHITECTURE.md for a deeper architecture/code walkthrough (currently in Turkish).

Contributing

Contributions are welcome! Please see CONTRIBUTING.md. All pull requests are reviewed and merged by the maintainer.

For bugs, suggestions, or content corrections, use Issues.

Maintainers

Maintained by @furkanbulus123. All changes to main go through pull request + maintainer approval.

License

MIT — free to use, modify, and distribute.

Note: MIL-STD-461G, DO-160G, and MIL-STD-810H themselves are public-domain documents published by the U.S. government. The content in this repo is our own summary/interpretation of the standards — it does not replace the official standard text.

---

🇹🇷 Türkçe

StandardGuide; MIL-STD-461G (elektromanyetik girişim / EMI), DO-160G (havacılık çevre koşulları) ve MIL-STD-810H (askeri çevresel test) standartlarını, dağınık ve İngilizce PDF'ler olmaktan çıkarıp tek bir etkileşimli, Türkçe web rehberinde toplayan açık kaynak bir projedir.

Her test için standart tanımı, uygulanabilirlik koşulları, limit değerlerinin fiziksel anlamı, sık yapılan tasarım hataları, ön-uyumluluk (precompliance) ipuçları ve açıklayıcı görseller tek ekranda toplanır. Sayfaya duyarlı bir yapay zeka asistanı, bakılan teste özel sorulara standart metnine dayanarak cevap verir. Ayrıca mühendislerin kendi saha deneyimlerini paylaşabildiği bir Notlar / Deneyim Havuzu bulunur.

Teknoloji

React 19 + TypeScript, Vite 8, Tailwind CSS v4, Supabase (Notlar için backend), Google Gemini (AI asistanı).

Hızlı başlangıç

git clone https://github.com/furkanbulus123/StandardGuide.git
cd StandardGuide/emi-rehber
npm install
cp .env.local.example .env.local   # kendi Supabase/Gemini anahtarlarınızı girin
npm run dev

Tarayıcıda http://localhost:5173 açılır.

Prodüksiyon derlemesi: npm run build → dist/ klasörünü herhangi bir statik host'a (Netlify, Vercel, GitHub Pages...) yükleyin.

Proje yapısı

emi-rehber/
  src/
    data/        ← standart ve test içerikleri (saf TypeScript)
    lib/         ← servisler: AI bağlamı, notlar deposu, tema
    components/  ← yeniden kullanılabilir UI parçaları
    pages/       ← rota bileşenleri
  db/            ← Supabase şema ve seed betikleri

Daha ayrıntılı mimari/kod dokümantasyonu için ARCHITECTURE.md dosyasına bakın.

Katkıda bulunma

Katkılar memnuniyetle karşılanır! Lütfen CONTRIBUTING.md dosyasına göz atın. Tüm pull request'ler proje sahibi tarafından incelenip onaylanır.

Hata bildirimi, öneri veya içerik düzeltmesi için Issues sekmesini kullanın.

Bakım / Maintainers

Proje @furkanbulus123 tarafından yönetilmektedir. main branch'ine tüm değişiklikler pull request + admin onayı ile girer.

Lisans

MIT — özgürce kullanabilir, değiştirebilir ve dağıtabilirsiniz.

Not: MIL-STD-461G, DO-160G ve MIL-STD-810H'nin kendisi ABD hükümeti tarafından yayınlanan kamu malı belgelerdir. Bu depodaki içerik, standartların kendi yorumumuza dayalı bir özeti/rehberidir — resmi standart metninin yerini tutmaz.