???? ProCost BOM - Profesyonel Ürün Ağacı Yönetim Sistemi

???? Gıda ve Üretim Sektörü için Tasarlanmış, Güçlü ve Kullanımı Kolay BOM Yönetim Sistemi

???? Hızlı Başlangıç • ???? Özellikler • ???? Dokümantasyon • ???? Katkı

???? Neden ProCost BOM?

ProCost BOM, orta ölçekli üretim firmaları için geliştirilmiş, üretim maliyetlerinizi optimize etmenizi, kar marjlarınızı takip etmenizi ve stok yönetiminizi verimli hale getirmenizi sağlayan profesyonel bir yazılım çözümüdür.

???? Kimler İçin?

Sektör	Kullanım Alanı
???? Gıda Üretimi	Ürün reçeteleri, hammadde maliyetleri, fire hesaplama
???? Genel Üretim	BOM yönetimi, maliyet analizi, tedarik zinciri
???? Ambalaj	Malzeme maliyetleri, stok takibi, tedarikçi yönetimi
???? Kimya & Kozmetik	Formülasyon maliyetleri, hammadde yönetimi

⭐ Temel Özellikler

???? Dashboard & Anlık Takip

✅ Canlı İstatistikler: Ürün, malzeme, tedarikçi ve BOM sayıları
✅ Akıllı Uyarılar: Düşük stok ve düşük kar marjı bildirimleri
✅ Görsel Grafikler: Grup dağılımı ve maliyet trend analizi
✅ Son Aktiviteler: En son eklenen ürünler ve maliyet değişiklikleri

???? Ürün & Malzeme Yönetimi

✅ Esnek Gruplama: Hiyerarşik ürün ve malzeme kategorileri
✅ Detaylı Tanımlar: Kod, birim, fiyat, açıklama ve daha fazlası
✅ Toplu İşlemler: Verimli veri girişi ve güncelleme
✅ Aktif/Pasif Yönetim: Veri kaybı olmadan kayıt kontrolü

???? BOM (Ürün Ağacı) Yönetimi

✅ Sınırsız Malzeme: Her ürün için istediğiniz kadar malzeme
✅ Fire Oranı Hesaplama: Gerçekçi maliyet hesaplaması
✅ Otomatik Maliyet: Malzeme fiyatı değişince otomatik güncelleme
✅ Görsel Dağılım: Pasta grafikleri ile maliyet analizi

???? Maliyet & Kar Marjı Analizi

✅ Anlık Hesaplama: BOM bazlı otomatik maliyet hesabı
✅ Kar Marjı Takibi: Renk kodlu performans göstergeleri
✅ Grup Analizi: Kategori bazlı karlılık karşılaştırması
✅ Maliyet Geçmişi: Değişikliklerin tam kaydı

???? Stok Yönetimi

✅ Stok Hareketleri: Giriş, çıkış ve düzeltme işlemleri
✅ Minimum Stok Uyarısı: Otomatik uyarı sistemi
✅ Stok Geçmişi: Tüm hareketlerin detaylı kaydı

???? Tedarikçi Yönetimi

✅ Tedarikçi Kartları: Detaylı firma bilgileri
✅ Malzeme Eşleştirme: Tedarikçi-malzeme ilişkileri
✅ Fiyat Karşılaştırma: En uygun tedarikçi analizi

???? Kapsamlı Raporlama

✅ 10+ Hazır Rapor: Maliyet, stok, tedarikçi, KPI raporları
✅ Fiyat Simülasyonu: Senaryo analizi
✅ MRP Hesaplama: Malzeme ihtiyaç planlaması
✅ Fire Analizi: Sapma ve trend raporları

???? Güvenlik & Kullanıcı Yönetimi

✅ Rol Tabanlı Yetkilendirme: Admin, Manager, User, Demo
✅ Demo Kullanıcı İzolasyonu: Demo kullanıcılar için ayrı veritabanı desteği
✅ Aktivite Günlüğü: Tüm işlemlerin kaydı
✅ Güvenli Oturum: Kilitleme ve timeout
✅ CSRF Koruması: Form güvenliği

???? Güvenlik

ProCost BOM, güvenliği ön planda tutar:

Özellik	Açıklama
???? CSRF Koruması	Tüm formlarda token doğrulama
???? Dizin Koruması	.htaccess ile listeleme engeli
???? Hassas Dosya Koruması	config/, includes/, database/ erişim engeli
???? Şifre Politikası	Güçlü şifre zorunluluğu
⏱️ Oturum Güvenliği	Timeout ve kilitleme
???? Aktivite Günlüğü	Tüm işlemlerin kaydı

Güvenlik İpuçları

✅ .env dosyasını asla versiyon kontrolüne eklemeyin
✅ Veritabanı için güçlü şifre kullanın (en az 12 karakter)
✅ Varsayılan admin şifresini ilk girişte değiştirin
✅ Üretim ortamında APP_DEBUG=false ayarlayın

???? Menü Yapısı

1. ???? Dashboard

Genel istatistikler ve grafikler
Son eklenen ürünler
Düşük kar marjlı ürün uyarıları
Düşük stoklu malzeme uyarıları
Maliyet değişiklik takibi

2. ???? Ürün Yönetimi

Ürün Listesi ve Detayları
Ürün Ekle / Düzenle
Ürün Grupları
Satış Fiyatı ve Maliyet Takibi

3. ???? Malzeme Yönetimi

Malzeme Listesi ve Detayları
Malzeme Ekle / Düzenle
Malzeme Grupları
Stok Takibi
Tedarikçi Yönetimi

4. ???? BOM (Ürün Ağacı)

BOM Listesi
BOM Oluşturma
Fire Oranı Hesaplama
Otomatik Maliyet Hesaplama
Maliyet Dağılımı Grafikleri

5. ???? Maliyet Analizi

Kar Marjı Hesaplama
Grup Bazlı Analiz
Maliyet Geçmişi Takibi
Detaylı Raporlar ve Grafikler

6. ???? Raporlar

Maliyet Dağılımı
Grup Maliyet Raporu
Kar Marjı Trend Analizi
Malzeme İhtiyaç Listesi (MRP)
Üretim Maliyet Özeti
Düşük Stok Uyarıları
Tedarikçi Karşılaştırma
Fiyat Simülasyonu
Yönetim KPI'ları
Fire Analizi
Aktivite Günlüğü

7. ???? Kullanıcı Yönetimi

Kullanıcı Listesi
Rol Tabanlı Yetkilendirme
Aktivite Günlüğü
Güvenli Oturum Yönetimi

8. ⚙️ Sistem Yönetimi

Birim Yönetimi
Veritabanı Bakımı
Sistem Ayarları
Ortam Değişkenleri (.env)
Demo Kullanıcı Veritabanı Ayarları ????

9. ❓ Yardım & Destek

Kullanım Kılavuzu
SSS (Sıkça Sorulan Sorular)

???? Rol Bazlı Erişim

Rol	Yetkiler
???? Admin	Tüm menüye erişim, kullanıcı ve sistem yönetimi
???? Manager	Ürün, malzeme, BOM, maliyet, raporlar, tedarikçi
???? User	Görüntüleme + sınırlı düzenleme
???? Demo	Ayrı demo veritabanında tam erişim (izole test ortamı)

???? Yeni: Demo kullanıcılar artık tamamen ayrı bir veritabanında çalışır! Detaylı kurulum için DEMO_DATABASE_SETUP.md dosyasına bakın.

????️ Teknik Altyapı

Teknoloji	Kullanım
???? CoreUI Bootstrap	Modern ve responsive admin arayüzü
???? Saf PHP	Hızlı ve güvenilir backend
???? MySQL	Güçlü veritabanı yönetimi
???? Chart.js	Etkileyici grafikler ve görselleştirme
???? Font Awesome	Profesyonel ikonlar

Kurulum Talimatları

Paylaşımlı Sunucu Kurulum Rehberi

Bu rehber, ProCost BOM uygulamasını paylaşımlı sunucularda (shared hosting) güvenli bir şekilde kurmanız için gereken klasör izinlerini ve yapılandırma adımlarını açıklar.

???? Klasör Yapısı ve İzinler

Önerilen Klasör İzinleri

Paylaşımlı sunucularda güvenlik için aşağıdaki izin yapısını kullanın:

Klasör/Dosya	İzin (chmod)	Açıklama
`/` (kök dizin)	755	Ana dizin - okuma ve çalıştırma
`config/`	750	Yapılandırma dosyaları - kısıtlı erişim
`database/`	750	Veritabanı şema dosyaları - kısıtlı erişim
`includes/`	750	PHP include dosyaları - kısıtlı erişim
`layouts/`	755	Şablon dosyaları
`pages/`	755	Sayfa dosyaları
`.env`	600	Ortam değişkenleri - sadece sahip okuyabilir
`.htaccess`	644	Apache yapılandırması
`*.php` dosyaları	644	PHP dosyaları

İzinleri Ayarlama

FTP veya SSH üzerinden aşağıdaki komutları kullanarak izinleri ayarlayabilirsiniz:

# Klasör izinleri
chmod 755 /public_html
chmod 750 config
chmod 750 database
chmod 750 includes
chmod 755 layouts
chmod 755 pages

# Hassas dosya izinleri
chmod 600 .env
chmod 644 .htaccess
chmod 644 index.php

# Tüm PHP dosyaları için (isteğe bağlı)
find . -name "*.php" -type f -exec chmod 644 {} \;

# Tüm alt klasörler için
find . -type d -exec chmod 755 {} \;

???? Güvenlik Yapılandırması

.htaccess Koruması

Uygulama, aşağıdaki güvenlik önlemlerini .htaccess dosyasında zaten içerir:

Hassas Dosya Koruması: .env, .sql, .log vb. dosyalara doğrudan erişim engellenir
Gizli Dosya Koruması: . ile başlayan dosyalara erişim engellenir
Klasör Koruması: config/, includes/, database/ klasörlerine doğrudan erişim engellenir

Ek Güvenlik Önlemleri

PHP Dosyalarına Doğrudan Erişimi Engelleyin

config/ klasörüne bir .htaccess dosyası ekleyin:

# config/.htaccess
# Apache 2.4+
<IfModule mod_authz_core.c>
    Require all denied
</IfModule>

# Apache 2.2 fallback
<IfModule !mod_authz_core.c>
    Order Allow,Deny
    Deny from all
</IfModule>

includes/ Klasörünü Koruyun

includes/ klasörüne bir .htaccess dosyası ekleyin:

# includes/.htaccess
# Apache 2.4+
<IfModule mod_authz_core.c>
    Require all denied
</IfModule>

# Apache 2.2 fallback
<IfModule !mod_authz_core.c>
    Order Allow,Deny
    Deny from all
</IfModule>

database/ Klasörünü Koruyun

database/ klasörüne bir .htaccess dosyası ekleyin:

# database/.htaccess
# Apache 2.4+
<IfModule mod_authz_core.c>
    Require all denied
</IfModule>

# Apache 2.2 fallback
<IfModule !mod_authz_core.c>
    Order Allow,Deny
    Deny from all
</IfModule>

Not: Bu .htaccess dosyaları hem Apache 2.4+ hem de eski 2.2 sürümlerinde çalışacak şekilde yapılandırılmıştır.

???? Kurulum Adımları

1. Dosyaları Yükleyin

Tüm dosyaları FTP veya dosya yöneticisi ile sunucunuza yükleyin (genellikle public_html klasörü).

2. .env Dosyasını Oluşturun

cp .env.example .env

.env dosyasını düzenleyerek veritabanı bilgilerinizi girin:

APP_NAME="ProCost BOM"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://sizinalanadınız.com

DB_HOST=localhost
DB_PORT=3306
DB_NAME=veritabani_adi
DB_USER=veritabani_kullanici
DB_PASS=guclu_sifre_123

3. Veritabanını Oluşturun

cPanel veya phpMyAdmin üzerinden:

Yeni veritabanı oluşturun
Veritabanı kullanıcısı oluşturun
Kullanıcıya tam yetki verin
database/schema.sql dosyasını içe aktarın

4. İzinleri Kontrol Edin

cPanel Dosya Yöneticisi üzerinden veya FTP ile izinleri ayarlayın.

⚠️ Sık Karşılaşılan Sorunlar

"Permission Denied" Hatası

Çözüm: İlgili klasörün izinlerini kontrol edin:

chmod 755 klasor_adi

.env Dosyası Okunamıyor

Çözüm: .env dosyasının izinlerini kontrol edin:

chmod 600 .env

Eğer 600 çalışmazsa, 644 deneyin (bazı paylaşımlı sunucularda gerekli olabilir).

"500 Internal Server Error"

Çözüm:

.htaccess dosyasındaki mod_rewrite'ın etkin olduğundan emin olun
PHP sürümünün 7.4 veya üzeri olduğunu kontrol edin
Hata günlüklerini kontrol edin

Config/Includes Klasörlerine Erişilemiyor

Bu normal bir davranıştır! Bu klasörlere tarayıcıdan doğrudan erişim güvenlik nedeniyle engellenmiştir.

???? Ek Güvenlik Önerileri

SSL/HTTPS Kullanın: Hosting panelinizden ücretsiz Let's Encrypt sertifikası alın
Düzenli Yedekleme: Veritabanı ve dosyalarınızı düzenli olarak yedekleyin
Şifreleri Güçlü Tutun: Veritabanı ve admin şifreleri en az 12 karakter olmalı
Debug Modunu Kapatın: Üretim ortamında APP_DEBUG=false kullanın
Dosya Sahipliği: Mümkünse dosya sahipliğini web sunucusu kullanıcısına ayarlayın:
```
chown -R www-data:www-data /path/to/procost
```

Lütfen Para Birimi Seçiniz

ProCost BOM, orta ölçekli üretim firmaları için geliştirilmiş, üretim maliyetlerinizi optimize etmenizi, kar marjlarınızı takip etmenizi ve stok yönetiminizi verimli hale getirmenizi sağlayan profesyonel bir yazılım çözümüdür.

$69 (Tek Sefer)