ONEPiR, e-ticaret platformları için geliştirilmiş modern entegrasyon ve yönetim sistemidir. Çoklu mağaza yönetimi ve modüler yapısı ile genişletilebilir çözümler sunar.

• Production: https://onepir.com
• Stage: https://onepir.creatwins.tr
• GitHub: https://github.com/onepircom/onepircom
• GitLab Mirror: https://gitlab.com/onepircom/onepircom

• Framework: Next.js 15+
• Database: PostgreSQL + Drizzle ORM
• UI: shadcn/ui + HeroUI
• Styling: Tailwind CSS
• Authentication: NextAuth.js
• Payment: Sipay Integration
• E-Commerce API: İkas API Integration
• Deployment: Coolify + Docker
• CI/CD: GitHub Actions (primary), GitLab CE (mirror only)
• Monitoring: Prometheus, Grafana, Loki

• Multi-tenant mimari - Tek platform, çoklu mağaza yönetimi
• Modüler sistem - İhtiyaca göre genişletilebilir modüller
• İkas API entegrasyonu - Tam e-ticaret platform desteği
• Fiyat yönetimi - Otomatik fiyat güncelleme sistemi
• Ödeme sistemi - Sipay entegrasyonu
• Role-based access control - Gelişmiş yetki yönetimi
• GitHub → GitLab Mirror - Otomatik tek yönlü senkronizasyon

# Repository'yi klonla
git clone https://github.com/onepircom/onepircom.git
cd onepircom

# Bağımlılıkları yükle
pnpm install

# Environment variables'ları ayarla
cp env.example .env
# .env dosyasını düzenle

# Database migration'ları çalıştır
pnpm run db:migrate

# Geliştirme sunucusunu başlat
pnpm run dev

ONEPiR, Coolify ile kolay deployment için optimize edilmiştir.

• Coolify dashboard'unda projenizi açın
• Create New Resource butonuna tıklayın
• Public Repository veya Private Repository seçin

• Docker Compose build pack'i seçin
• Branch: main (veya istediğiniz branch)
• Base Directory: /
• Docker Compose Location: docker-compose.yml

Coolify UI'da aşağıdaki environment variables'ları ayarlayın:

# Database
POSTGRES_URL=postgresql://user:password@host:5432/database

# Authentication
JWT_SECRET=your_jwt_secret_here
NEXTAUTH_SECRET=your_nextauth_secret_here
NEXTAUTH_URL=https://your-domain.com

# Application
NEXT_PUBLIC_BASE_URL=https://your-domain.com

• Port: 3000 (default)
• Domain: İstediğiniz domain'i ayarlayın
• SSL: Otomatik olarak yönetilir

# Environment variables'ları ayarla
cp env.example .env
# .env dosyasını düzenle

# Docker Compose ile çalıştır
docker-compose up -d

# Logları kontrol et
docker-compose logs -f

onepircom/
├── app/                    # Next.js App Router
│   ├── (dashboard)/       # Dashboard sayfaları
│   ├── (login)/           # Authentication sayfaları
│   ├── admin/             # Admin panel
│   └── api/               # API routes
├── components/            # React bileşenleri
├── lib/                   # Utility fonksiyonlar
├── modules/               # Modüler sistem
├── public/                # Statik dosyalar
├── Dockerfile             # Docker build tanımı
├── docker-compose.yml     # Docker Compose konfigürasyonu
└── env.example           # Environment variables şablonu

# Geliştirme sunucusu
pnpm run dev

# Production build
pnpm run build

# Type checking
pnpm run type-check

# Linting
pnpm run lint

# Database migration
pnpm run db:migrate

# Database studio
pnpm run db:studio

Yeni modül oluşturmak için:

# Modül klasörü oluştur
mkdir modules/your-module

# Modül dosyalarını oluştur
touch modules/your-module/index.ts
touch modules/your-module/package.json
touch modules/your-module/README.md

• Primary CI/CD: GitHub Actions (tüm build, test, deploy işlemleri)
• Mirror Repository: GitLab CE (sadece kod senkronizasyonu)
• Otomatik Sync: GitHub → GitLab (tek yönlü)
• GitLab Pipeline: Devre dışı (artifact buildup önlenmesi için)

Detaylı geliştirme rehberi ve API dokümantasyonu için:

• PLANS/ klasöründeki plan dosyaları
• modules/ klasöründeki modül dokümantasyonları
• CHANGELOG.md dosyasındaki güncellemeler

Bu proje güvenlik en iyi uygulamalarını takip eder:

• Environment variables güvenliği
• Database güvenlik kuralları
• Role-based access control
• Audit logging sistemi

Güvenlik açığı bildirmek için lütfen iletişime geçin.

Katkılarınızı bekliyoruz! Lütfen şu adımları takip edin:

1. Fork yapın
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Commit yapın (git commit -m 'feat: add amazing feature')
4. Branch'i push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

Bu proje CreaTwins tarafından geliştirilmiş ticari bir üründür. Tüm hakları saklıdır.

• Website: onepir.com
• Email: info@onepir.com
• Twitter: @onepircom
• Instagram: @onepircom
• WhatsApp 05536564966
• Developer: Fatih Arslan (fatharsln.com)

© 2025 ONEPiR E-Commerce Integrator