Kodmob

Kurumsal site ve çok kullanıcılı yönetim paneli çatısı: Laravel 12 API ve Vite + Alpine.js + Tailwind ön yüz. Kimlik, roller, çok dil, SEO, yedek, panel ve sistem sağlığı hazır; siz yalnızca projenize özgü kodu yazarsınız. Paylaşımlı hostinge sunucuda derleme gerekmeden kurulur. kodmob.com bu çatının ilk sitesidir.

Geliştirici belgeleri: kodmob.github.io/kodmob · sürümler: CHANGELOG.md · bilinen sınırlar: docs/dikkat.md

In English: Kodmob is an MIT-licensed starter framework for company websites with a multi-user admin panel (Laravel 12 API, Vite + Alpine.js + Tailwind front end). It installs on shared hosting without a server-side build, runs several projects from one installation, and supports SQLite, MySQL and PostgreSQL. It ships users, roles, two-factor sign-in, an activity log, content types, multilingual URLs and translations, SEO, encrypted backups, mail and SMS, background jobs, a page builder, AI providers and a tool marketplace (shop, bookings, newsletter). The panel and the documentation are in Turkish for now; English issues and pull requests are welcome. Quick start below.

Neler hazır

• Panel: kullanıcılar, roller ve yetkiler, iki adımlı doğrulama, işlem geçmişi, panel araması, Kullanım Kılavuzu (tur ve rehberler), Sistem Sağlığı, bildirimler, tablolar (süzgeç, toplu işlem, CSV).
• İçerik: içerik türleri (alanlar şemadan; liste, form, çeviri, yedek, arama kendiliğinden), blog, medya, Sayfa düzenleyici (sürükle-bırak bloklar, taslak ve yayın geçmişi), blok sayfaları, yasal belgeler.
• Çok dil ve SEO: dile göre adresler, 301 adres geçmişi, 404 önerileri, site haritası, yapısal veri, llms.txt, yönlendirmeler, yapay zekâ botları için görünürlük raporu, sunucuda HTML (SSR) ve sayfa önbelleği.
• Altyapı: otomatik yedek (uzak depoya şifreli), e-posta ve SMS, arka plan işleri, tek kurulumdan çok proje, SQLite / MySQL / PostgreSQL, çatı güncellemesi (kodmob:upgrade).
• İsteğe bağlı araçlar: Mağaza (Stripe, PayTR), Rezervasyon, Oteller, Bülten, talepler, Jarvis yapay zekâ asistanı (Claude, OpenAI, Gemini), domain arama; Araç Pazarı'ndan proje başına açılıp kapanır. Topluluk araç paketleri: docs/arac-paketi.md.
• Yapay zekâ ile geliştirmeye hazır: asistan rehberi (CLAUDE.md, AGENTS.md), kayıt tabanlı mimari, koddan üretilen sözleşme ve OpenAPI (docs/contracts/), niyet dosyasından içerik türü.

Hızlı başlangıç

Node.js 20+, PHP 8.4 (pdo_sqlite, mbstring, openssl, zip, gd) ve Composer. Yerelde veritabanı SQLite dosyasıdır: MySQL ya da Apache gerekmez. PHP PATH'te değilse KM_PHP ortam değişkeniyle gösterilir.

git clone https://github.com/kodmob/kodmob.git benim-projem && cd benim-projem
cd kodmob-core && composer install
php artisan kodmob:install --profile=benim-sitem      # .env, anahtarlar, SQLite, tablolar, ilk yönetici, profil
cd ../kodmob-frontend && npm ci && npm run deploy:local && npm run serve:local
# site: http://127.0.0.1:8090/   panel: http://127.0.0.1:8090/panel/

kodmob:install sitenizin profilini başlangıçtan kopyalar (kodmob-frontend/src/profiles/benim-sitem/) ve etkin yapar; yönetici adı ve e-postası sorulur (--admin, --email, --password; şifre verilmezse rastgele üretilip bir kez gösterilir). Var olan .env'e ve anahtarlara dokunmaz. Sonrası: 01 Kurulum, 02 Mimari.

Sık kullanılan komutlar

# Testler
cd kodmob-core && php artisan test        # backend (SQLite, bellek içi)
cd kodmob-frontend && npm run test:db                 # backend: SQLite + MySQL + PostgreSQL (yerel PostgreSQL kendiliğinden)
cd kodmob-frontend && npm test                        # ön yüz birim testleri
cd kodmob-frontend && npm run e2e                     # uçtan uca (kurulu Chrome)

# Yeni içerik türü (panelde liste, form, yetki, yedek, arama kendiliğinden)
cd kodmob-core && php artisan kodmob:module courses --label=Kurslar --singular=Kurs
cd kodmob-core && php artisan kodmob:module --intent=kurslar.intent.json        # niyet dosyasından

# Araç paketi (topluluk aracı)
cd kodmob-core && php artisan kodmob:tool new stok-takibi --label="Stok takibi"
cd kodmob-core && php artisan kodmob:add <klasör | zip | katalogdaki anahtar>

# Sistem sağlığı ve canlı paket (release/)
cd kodmob-core && php artisan kodmob:health && php artisan kodmob:links
node build.mjs --bump minor

# Çatı güncellemesi: yalnızca projede değişmemiş çatı dosyaları yenilenir
cd kodmob-core && php artisan kodmob:lock                     # projede bir kez
cd kodmob-core && php artisan kodmob:upgrade --from=kodmob-3.0.1.zip --dry-run

Klasörler

Klasör	İçerik
kodmob-core/	Laravel 12 API: çekirdek (app/Core), modüller (app/Modules), testler. Canlıda kodmob-core/
kodmob-frontend/	Ön yüz: site sayfaları ve panel (Vite 7, Alpine 3, Tailwind 4, Nunjucks), uçtan uca testler
docs/	Geliştirici belgeleri (gelistirici/, sitesi VitePress), sözleşme ve OpenAPI (contracts/), şablonlar
build.mjs	Tek komutla canlı paketi (node build.mjs)

Projenin kendi dosyaları ayrıdır; çatı güncellemesi onlara dokunmaz:

This is the beginning of the README. Read the rest at the original. Read the full README ↗