⚙️ Documentație Tehnică

// Câmpuri obligatorii Domain: - name: "exemplu" - extension: ".ro" - full_name: "exemplu.ro" - price: 100.00 - expire_at: "2026-12-31" - status: ACTIVE

// Query pentru licitații active SELECT * FROM auction WHERE status = ACTIVE AND start_at <= NOW() AND end_at >= NOW()

// frontend/modules/domain/models/BidForm.php // frontend/modules/bid/models/BidForm.php public function validateBidAmount($attribute, $params) { $auction = $this->auction; $bidAmount = $this->$attribute; $startPrice = (float)$auction->start_price; $step = (float)$auction->step; // Validare 1: Bid >= start_price if ($bidAmount < $startPrice) { $this->addError($attribute, "Minimum bid: {$startPrice}"); return; } // Validare 2: Pentru bid-uri ulterioare $highestBid = Bid::find() ->where(['auction_id' => $auction->id]) ->orderBy(['price' => SORT_DESC]) ->one(); if ($highestBid && $bidAmount < $highestBid->price + $step) { $this->addError($attribute, "Minimum: {$highestBid->price + $step}"); return; } // Validare 3: Diferența trebuie să fie multiplu de step $difference = $bidAmount - $startPrice; if (fmod($difference, $step) > 0.01) { $this->addError($attribute, "Bid must be multiple of step: {$step}"); } }

// console/controllers/AuctionController.php public function actionRun() { $count = 0; $this->stdout("[" . date('Y-m-d H:i:s') . "] Processing auctions...\n"); // Găsește licitații expirate $auctions = Auction::find() ->where(['status' => Auction::STATUS_ACTIVE]) ->andWhere(['<=', 'end_at', date('Y-m-d H:i:s')]) ->all(); foreach ($auctions as $auction) { // Găsește bid-ul câștigător $highestBid = Bid::find() ->where(['auction_id' => $auction->id]) ->orderBy(['price' => SORT_DESC]) ->one(); if ($highestBid) { // Generează factura proforma $this->saveProformaInvoice($highestBid, $auction->domain_id); // Trimite email câștigător $this->sendBrokerWinnerEmail($highestBid, $auction); // Update status-uri $auction->status = Auction::STATUS_PROCESSING; $auction->save(false); $highestBid->status = Bid::STATUS_PROCESSING; $highestBid->save(false); $count++; } } $this->stdout("[" . date('Y-m-d H:i:s') . "] Processed {$count} auction(s).\n"); }

// Manual (Admin confirmă) Backend → Invoices → Marchează ca plătită // Automat (Webhook procesator plată) $invoice->status = Invoice::STATUS_PAID; $invoice->paid_at = date('Y-m-d H:i:s'); $invoice->save();

// console/controllers/NextBrokerController.php public function actionRun() { $count = 0; $transferredCount = 0; $noOfDays = 2; // Configurabil $this->stdout("[" . date('Y-m-d H:i:s') . "] Checking unpaid auctions...\n"); // Găsește licitații cu facturi neplătite > 2 zile $auctions = Auction::find() ->where(['status' => Auction::STATUS_PROCESSING]) ->all(); foreach ($auctions as $auction) { $bid = Bid::find() ->where([ 'auction_id' => $auction->id, 'status' => Bid::STATUS_PROCESSING ]) ->one(); if (!$bid) continue; // Verifică factura $invoice = Invoice::findOne([ 'broker_id' => $bid->broker_id, 'status' => Invoice::STATUS_UNPAID ]); if (!$invoice) continue; // Verifică dacă au trecut 2 zile $issuedDate = new DateTime($invoice->issued_at); $currentDate = new DateTime(); $daysPassed = $currentDate->diff($issuedDate)->days; if ($daysPassed >= $noOfDays) { $count++; // Dezactivează bid-ul curent $bid->status = Bid::STATUS_INACTIVE; $bid->save(false); // Găsește următorul bid $nextBid = Bid::find() ->where([ 'auction_id' => $auction->id, 'status' => Bid::STATUS_ACTIVE ]) ->orderBy(['price' => SORT_DESC]) ->one(); if ($nextBid) { // Generează nouă factură proforma $this->saveProformaInvoice($nextBid, $auction->domain_id); // Trimite email $this->sendBrokerWinnerEmail($nextBid, $auction); // Update status $nextBid->status = Bid::STATUS_PROCESSING; $nextBid->save(false); $transferredCount++; } } } $this->stdout("[" . date('Y-m-d H:i:s') . "] Processed {$count} unpaid auction(s), transferred {$transferredCount} to next broker(s).\n"); }

// Creare subscription după confirmare plată $subscription = new Subscription(); $subscription->subscriber_id = $broker->id; $subscription->domain_id = $auction->domain_id; $subscription->start_at = $auction->valid_from; $subscription->end_at = $auction->valid_to; $subscription->price = $bid->price; $subscription->currency = $auction->currency; $subscription->status = Subscription::STATUS_ACTIVE; $subscription->save();