Merhabalar,
3 ay üzerinde uğraştığım, marketing kısmında bütçe anlamında eksik kaldığım için ilerletemediğim projemi satmak istiyorum. Tüm sosyal medyaları ve eticaret ile devredilecektir. Almayı düşünen firmalar veya kişiler anlık olarak satışa başlayabilecektir.
- Site adresi: Özel Mesaj İle Verilecektir.
- Site satış fiyatı: xxx.xxx₺
- Sitenin aylık getirisi: 5000 - 10000₺
- Sitenin açılış tarihi: 22.01.2024
- DA / PA Değerleri: Bilinmiyor
- Kategori / sitenin içeriği: Dijital Kartvizit - Masaüstü Akıllı Pleksi - Sosyal Medya Kartları - Sanal Kartvizit - Yaka Kartları
- Günlük hit sayısı: Bilinmiyor
- Ziyaretçi kaynağı: Bilinmiyor
- Domainin yaşı: 2
- Site tüm içeriği birlikte mi satılık? Sınırlama var ise neler?: Eticaret ve yazılımda sub domainde kurulu hepsi dahil.
- Hosting dahil mi?: Hayır
- Banlı olduğu sponsor var mı?: Bilindiği kadarıyla yok.
- Banlı olduğu arama motoru var mı?: Bilindiği kadarıyla yok.
- Kullanılan yazılımın lisansı satışa dahil mi?: Evet
- Yazılım lisans sonlanma zamanı: Sınırsız
- Sitenin satışında herhangi hukuki (telif hakkı v.b. bir problem var mı?: Bilindiği kadarıyla yok.
- Eklemek istediğiniz diğer detaylar ve görseller:
Proje Özeti
Dijital kartvizit oluşturma, yönetme ve paylaşma üzerine kurulmuş web tabanlı bir platformdur. Projede kullanıcı paneli, kurumsal panel, admin paneli, dijital kart oluşturma sihirbazı, QR/kart paylaşımı, dosya yükleme, aktivite kayıtları, analitik ekranları ve API dokümantasyonu bulunmaktadır.
Sistem üç ana parçadan oluşur:
client/: Kullanıcı arayüzü, React tabanlı frontend uygulaması.
server/: Node.js / Express tabanlı REST API.
docs-site/: VitePress ile hazırlanmış teknik dokümantasyon sitesi.
Kullanılan Yazılım Dilleri
Projede kullanılan başlıca diller:
JavaScript
: Backend API ve frontend uygulamasının ana dili.
JSX: React bileşenleri ve sayfaları için kullanılmıştır.
TypeScript: Sınırlı düzeyde, özellikle i18n yapılandırmasında kullanılmıştır.
SQL / T-SQL: Microsoft SQL Server tablo yapıları ve migration dosyaları için kullanılmıştır.
CSS: Tema, kart görünümü ve özel stil dosyalarında kullanılmıştır.
JSON: Paket yapılandırmaları, çeviri dosyaları ve API dokümantasyonu için kullanılmıştır.
Markdown: Teknik dokümantasyon ve kullanım kılavuzlarında kullanılmıştır.
Shell Script: Sunucu kurulum, build ve dosya izinleri gibi operasyonel işlemler için kullanılmıştır.
Frontend Teknolojileri
Frontend tarafı client/ klasöründe yer alır ve modern SPA mimarisiyle geliştirilmiştir.
Kullanılan başlıca teknolojiler:
React 19
Vite 6
Material UI 7
React Router 7
Axios
i18next / react-i18next
Swiper
qrcode.react
pdf-lib
xlsx
jszip
Frontend içerisinde kullanıcı, kurumsal kullanıcı ve admin rolleri için ayrı ekranlar bulunmaktadır. Uygulama responsive yapıdadır ve modern React component mimarisiyle geliştirilmiştir.
Öne çıkan frontend modülleri:
Kullanıcı girişi ve kayıt ekranları
Şifre sıfırlama akışı
Dijital kart oluşturma ve düzenleme
Kart listeleme
Public kart görüntüleme
QR kart görüntüleme
Kart oluşturma sihirbazı
Kullanıcı paneli
Kurumsal panel
Admin paneli
Analitik ekranları
Tema değiştirme desteği
Çoklu dil desteği
Backend Teknolojileri
Backend tarafı server/ klasöründe yer alır ve REST API mimarisiyle geliştirilmiştir.
Kullanılan başlıca teknolojiler:
Node.js
Express 5
Microsoft SQL Server
mssql
JWT tabanlı kimlik doğrulama
bcryptjs ile parola hashleme
multer ile dosya yükleme
nodemailer ile e-posta gönderimi
cors
dotenv
exceljs
qrcode
swagger-ui-express
Scalar API Reference
systeminformation
Backend API modüler dosya yapısına sahiptir. Auth, users, cards, admin, corporate, analytics, upload, wizard ve system gibi alanlar ayrı API modülleri olarak düzenlenmiştir.
Veri Tabanı
Projede veri tabanı olarak Microsoft SQL Server kullanılmaktadır.
Veri tabanı tarafında:
Kullanıcı kayıtları
Dijital kart verileri
Kurumsal firma/kullanıcı ilişkileri
Aktivite kayıtları
Analitik veriler
Wizard token yapıları
Sistem izleme tabloları
Dil desteğiyle ilgili alanlar
için SQL ve migration dosyaları bulunmaktadır.
Veri tabanı bağlantısı environment değişkenleriyle yönetilecek şekilde tasarlanmıştır. Satış dokümanında gerçek veritabanı adı, kullanıcı adı, parola, host veya bağlantı bilgileri paylaşılmamalıdır.
Dokümantasyon Projesi
Projede ayrıca bağımsız bir dokümantasyon sitesi bulunmaktadır.
Konum:
docs-site/
Teknoloji:
VitePress
Vue 3
Markdown
Docs projesinde API uçları ve sistem bileşenleri için Türkçe ve İngilizce dokümantasyon sayfaları yer almaktadır. Bu bölüm geliştirici onboardingi, API kullanımı ve teknik referans için kullanılabilir.
Dokümantasyon kapsamı:
Authentication API
Cards API
Users API
Admin API
Corporate API
Analytics API
Activities API
Upload API
Wizard API
Simple Wizard API
System API
Backend tarafında ayrıca Swagger/OpenAPI uyumlu dokümantasyon da bulunmaktadır.
API Yapısı
Backend REST API olarak çalışır. Başlıca API alanları:
/api/auth: Kimlik doğrulama işlemleri.
/api/users: Kullanıcı işlemleri.
/api/cards: Kart yönetimi.
/api/public: Public kart görüntüleme işlemleri.
/api/admin: Admin panel işlemleri.
/api/corporate: Kurumsal hesap işlemleri.
/api/analytics: Analitik veriler.
/api/activities: Aktivite kayıtları.
/api/upload: Dosya yükleme işlemleri.
/api/wizard: Kart oluşturma sihirbazı.
/api/simple-wizard: Basitleştirilmiş wizard akışı.
/api/system: Sistem bilgileri ve izleme APIleri.
/api/docs: API dokümantasyonu.
Çoklu Dil Desteği
Frontend uygulamasında çoklu dil altyapısı bulunmaktadır.
Desteklenen diller:
Türkçe
İngilizce
Almanca
Arapça
Rusça
Portekizce
Çeviri dosyaları JSON formatındadır ve i18next altyapısı kullanılmaktadır. Tarayıcı dili algılama ve localStorage üzerinden dil tercihi saklama desteği vardır.
Deployment ve Çalışma Ortamı
Projede frontend ve backend ayrı deploy edilebilecek şekilde yapılandırılmıştır.
Mevcut yapılandırma izleri:
Frontend için Vercel yapılandırması
Backend için Vercel Node yapılandırması
Render benzeri servisler için build scripti
cPanel/public hosting yönlendirme dosyaları
Environment değişkenleriyle yönetilen API ve veritabanı ayarları
Frontend production API adresi environment değişkeniyle değiştirilebilir. Development ortamında API varsayılan olarak lokal backende bağlanacak şekilde yapılandırılmıştır.
Geliştirme Komutları
Frontend geliştirme:
npm install --prefix client
npm run dev --prefix client
npm run build --prefix client
npm run lint --prefix client
Backend geliştirme:
npm install --prefix server
npm start --prefix server
Dokümantasyon sitesi:
npm install --prefix docs-site
npm run dev --prefix docs-site
npm run build --prefix docs-site
Güvenli Şekilde Paylaşılabilecek Teknik Bilgiler
Satış sürecinde aşağıdaki bilgiler güvenle paylaşılabilir:
Kullanılan programlama dilleri
Framework ve kütüphane isimleri
Genel sistem mimarisi
Frontend/backend/docs ayrımı
API modül başlıkları
Veri tabanı türü
Çoklu dil desteği
Admin, kurumsal ve kullanıcı paneli özellikleri
Dokümantasyon yapısı
Build ve deploy yaklaşımı
Test/lint durumu
Genel geliştirme komutları
Paylaşılmaması Gereken Bilgiler
Satış görüşmelerinde veya teknik dokümanda aşağıdaki bilgiler paylaşılmamalıdır:
.env içerikleri
Veritabanı host, kullanıcı adı, parola bilgileri
JWT secret değerleri
SMTP kullanıcı adı/parola bilgileri
Production API tokenları
Sunucu erişim bilgileri
Vercel/hosting erişim tokenları
Gerçek kullanıcı verileri
Admin hesap bilgileri
Log dosyalarında kişisel veri içerebilecek kayıtlar
Production veritabanı dumpı
Özel müşteri/kurum verileri
Teknik Değerlendirme
Proje, modern JavaScript ekosistemiyle geliştirilmiş tam kapsamlı bir web platformudur. React tabanlı kullanıcı arayüzü, Express tabanlı API katmanı ve MSSQL veri tabanı yapısıyla klasik üç katmanlı web uygulaması mimarisine sahiptir.
Ek olarak VitePress dokümantasyon sitesi ve Swagger/OpenAPI desteği, projenin geliştirici devri ve teknik bakım süreçlerini kolaylaştırmaktadır. Çoklu dil desteği, kurumsal panel, admin paneli, kart oluşturma sihirbazı ve analitik modülleri projeyi yalnızca basit bir kartvizit uygulaması olmaktan çıkarıp yönetilebilir bir SaaS platformu seviyesine taşımaktadır.