nodebb-plugin-niki-loyalty 1.0.12 → 1.0.13

package/library.js

@@ -8,19 +8,19 @@ const Plugin = {};
 
 const SETTINGS = {
     pointsPerHeartbeat: 5,
-    dailyCap: 250,
+    dailyCap: 2500000,
     coffeeCost: 250
 };
 
-// --- LOG FONKSİYONLARI ---
+// --- LOG TUTMA YARDIMCILARI ---
 async function addUserLog(uid, type, amount, desc) {
     const logEntry = {
         ts: Date.now(),
-        type: type, // 'earn' veya 'spend'
+        type: type,   // 'earn' (kazanç) veya 'spend' (harcama)
         amt: amount,
         txt: desc
     };
-    // Listeye ekle ve son 50 işlemi tut
+    // Öğrencinin listesine ekle (Son 50 işlem)
     await db.listAppend(`niki:activity:${uid}`, logEntry);
     await db.listTrim(`niki:activity:${uid}`, -50, -1);
 }
@@ -33,7 +33,7 @@ async function addKasaLog(staffUid, customerName, customerUid) {
         cuid: customerUid,
         amt: SETTINGS.coffeeCost
     };
-    // Kasa geçmişine ekle ve son 100 işlemi tut
+    // Kasa defterine ekle (Son 100 işlem)
     await db.listAppend('niki:kasa:history', logEntry);
     await db.listTrim('niki:kasa:history', -100, -1);
 }
@@ -42,7 +42,7 @@ Plugin.init = async function (params) {
     const router = params.router;
     const middleware = params.middleware;
 
-    // 1. HEARTBEAT (Puan Kazanma)
+    // 1. HEARTBEAT (Ders Çalışma Puanı)
     router.post('/api/niki-loyalty/heartbeat', middleware.ensureLoggedIn, async (req, res) => {
         const uid = req.uid;
         const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
@@ -61,7 +61,7 @@ Plugin.init = async function (params) {
         return res.json({ earned: true, points: SETTINGS.pointsPerHeartbeat, total: newBalance });
     });
 
-    // 2. WALLET DATA (Cüzdan Bilgisi + Geçmiş)
+    // 2. WALLET DATA (Öğrenci Cüzdanı ve Geçmişi)
     router.get('/api/niki-loyalty/wallet-data', middleware.ensureLoggedIn, async (req, res) => {
         const uid = req.uid;
         const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
@@ -69,7 +69,7 @@ Plugin.init = async function (params) {
         const [userData, dailyData, history] = await Promise.all([
             user.getUserFields(uid, ['niki_points']),
             db.getObject(`niki:daily:${uid}:${today}`),
-            db.getListRange(`niki:activity:${uid}`, 0, -1)
+            db.getListRange(`niki:activity:${uid}`, 0, -1) // Geçmişi çek
         ]);
 
         const currentPoints = parseInt(userData.niki_points) || 0;
@@ -82,20 +82,21 @@ Plugin.init = async function (params) {
             dailyScore: dailyScore,
             dailyCap: SETTINGS.dailyCap,
             dailyPercent: dailyPercent,
-            history: (history || []).reverse() // En yeniden eskiye
+            history: (history || []).reverse() // En yeniden eskiye sırala
         });
     });
 
-    // 3. KASA GEÇMİŞİ (Staff Dashboard)
+    // 3. KASA GEÇMİŞİ (Personel Dashboard İçin) - EKSİK OLAN BUYDU
     router.get('/api/niki-loyalty/kasa-history', middleware.ensureLoggedIn, async (req, res) => {
         const isAdmin = await user.isAdministrator(req.uid);
         const isMod = await user.isGlobalModerator(req.uid);
         
         if (!isAdmin && !isMod) return res.status(403).json([]);
 
+        // Veritabanından listeyi çek
         const history = await db.getListRange('niki:kasa:history', 0, -1);
         
-        // Kullanıcı resimlerini de çekmek için zenginleştirme yapalım
+        // Kullanıcı resimlerini de ekleyerek zenginleştir
         const enrichedHistory = await Promise.all((history || []).reverse().map(async (item) => {
             const uData = await user.getUserFields(item.cuid, ['picture']);
             item.picture = uData.picture;
@@ -105,7 +106,7 @@ Plugin.init = async function (params) {
         res.json(enrichedHistory);
     });
 
-    // 4. QR OLUŞTUR
+    // 4. QR TOKEN ÜRET (Öğrenci Butona Basınca)
     router.post('/api/niki-loyalty/generate-qr', middleware.ensureLoggedIn, async (req, res) => {
         const uid = req.uid;
         const points = parseInt(await user.getUserField(uid, 'niki_points')) || 0;
@@ -114,12 +115,12 @@ Plugin.init = async function (params) {
 
         const token = Math.random().toString(36).substring(2) + Date.now().toString(36);
         await db.set(`niki:qr:${token}`, uid);
-        await db.expire(`niki:qr:${token}`, 120);
+        await db.expire(`niki:qr:${token}`, 120); // 2 dakika süre
 
         return res.json({ success: true, token: token });
     });
 
-    // 5. QR OKUT (Ödeme Alma)
+    // 5. QR OKUTMA (Personel Tarayınca)
     router.post('/api/niki-loyalty/scan-qr', middleware.ensureLoggedIn, async (req, res) => {
         const { token } = req.body;
         
@@ -128,25 +129,25 @@ Plugin.init = async function (params) {
         if (!isAdmin && !isMod) return res.status(403).json({ success: false, message: 'Yetkisiz' });
 
         const customerUid = await db.get(`niki:qr:${token}`);
-        if (!customerUid) return res.json({ success: false, message: 'Geçersiz Kod' });
+        if (!customerUid) return res.json({ success: false, message: 'Kod Geçersiz veya Süresi Dolmuş' });
 
         const pts = parseInt(await user.getUserField(customerUid, 'niki_points')) || 0;
         if (pts < SETTINGS.coffeeCost) return res.json({ success: false, message: 'Yetersiz Bakiye' });
 
-        // İŞLEM
+        // İŞLEMİ YAP (Puan düş)
         await user.decrementUserFieldBy(customerUid, 'niki_points', SETTINGS.coffeeCost);
         await db.delete(`niki:qr:${token}`);
 
-        // LOGLAMA (Detaylı metin ile)
+        // LOGLARI KAYDET (Bu kısım önceden yoktu, o yüzden geçmiş boş geliyordu)
         const customerData = await user.getUserFields(customerUid, ['username', 'picture']);
         
-        // Öğrenciye: "Kahve Keyfi" yazsın
+        // 1. Öğrencinin Cüzdanına: "Kahve Keyfi -250"
         await addUserLog(customerUid, 'spend', SETTINGS.coffeeCost, 'Kahve Keyfi ☕');
         
-        // Kasaya: Kimin aldığı yazsın
+        // 2. Kasa Defterine: "Ahmet'ten Ödeme Alındı"
         await addKasaLog(req.uid, customerData.username, customerUid);
 
-        return res.json({ success: true, customer: customerData, message: 'Onaylandı!' });
+        return res.json({ success: true, customer: customerData, message: 'İşlem Başarılı!' });
     });
 
     // SAYFA ROTASI
@@ -154,7 +155,7 @@ Plugin.init = async function (params) {
         const isAdmin = await user.isAdministrator(req.uid);
         const isMod = await user.isGlobalModerator(req.uid);
         if (!isAdmin && !isMod) return res.render('403', {});
-        res.render('niki-kasa', { title: 'Niki Kasa' });
+        res.render('niki-kasa', { title: 'Niki Kasa Terminali' });
     });
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodebb-plugin-niki-loyalty",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Niki The Cat Coffee Loyalty System - Earn points while studying on IEU Forum.",
   "main": "library.js",
   "nbbpm": {