3 Commits

3 changed files with 238 additions and 27 deletions
+23 -27
View File
@@ -2,38 +2,34 @@ name: Deploy Iddaai Backend
on: on:
push: push:
branches: branches: [main]
- main
jobs: jobs:
deploy: build-and-deploy:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Checkout Code - name: Kodu Cek
uses: actions/checkout@v4 uses: actions/checkout@v4
- name: Install sshpass - name: Docker Build
run: sudo apt-get update && sudo apt-get install -y sshpass run: docker build -t iddaai-be:latest .
- name: Deploy to Raspberry Pi via rsync - name: Eski Konteyneri Sil
env: run: docker rm -f iddaai-be || true
SERVER_PASSWORD: ${{ secrets.SERVER_PASSWORD }}
SERVER_IP: "95.70.252.214" - name: Yeni Versiyonu Baslat
SERVER_PORT: "2222"
SERVER_USER: "haruncan"
run: | run: |
export SSHPASS=$SERVER_PASSWORD docker run -d \
sshpass -e rsync -avz --exclude node_modules --exclude .git --exclude dist --exclude .next --exclude .DS_Store --exclude venv --exclude 'ai-engine/venv' --exclude __pycache__ -e "ssh -o StrictHostKeyChecking=no -p $SERVER_PORT" ./ $SERVER_USER@$SERVER_IP:~/apps/iddaai/be/ --name iddaai-be \
--restart unless-stopped \
- name: Restart Backend Docker Service --network iddaai_iddaai-network \
uses: appleboy/ssh-action@v1.0.3 -p 127.0.0.1:1810:3005 \
with: -e NODE_ENV=production \
host: "95.70.252.214" -e DATABASE_URL='postgresql://iddaai_user:IddaA1_S4crET!@iddaai-postgres:5432/iddaai_db?schema=public' \
port: "2222" -e REDIS_HOST='iddaai-redis' \
username: "haruncan" -e REDIS_PORT='6379' \
password: ${{ secrets.SERVER_PASSWORD }} -e REDIS_PASSWORD='IddaA1_Redis_Pass!' \
script: | -e AI_ENGINE_URL='http://iddaai-ai-engine:8000' \
cd ~/apps/iddaai -e JWT_SECRET='b7V8jM2wP1L5mQxs2RdfFkAsLpI2oG!w' \
docker compose build backend -e JWT_ACCESS_EXPIRATION='1d' \
docker compose up -d backend iddaai-be:latest /bin/sh -c "npx prisma migrate deploy && node dist/src/main.js"
Executable
+59
View File
@@ -0,0 +1,59 @@
# Build stage
FROM node:20-alpine AS builder
# Add build tools for native canvas compilation (fixes 16k page size issues on RPi5 ARM64)
RUN apk add --no-cache python3 make g++ cairo-dev pango-dev jpeg-dev giflib-dev librsvg-dev
WORKDIR /app
# Copy package files
COPY package*.json ./
# Install dependencies
RUN npm ci
# Copy source code
COPY . .
# Generate Prisma client
RUN npx prisma generate
# Build the application
RUN npm run build
# Production stage
FROM node:20-alpine AS production
# Add runtime dependencies for canvas & prisma
RUN apk add --no-cache cairo pango jpeg giflib librsvg openssl
WORKDIR /app
# Copy package files
COPY package*.json ./
# Install production dependencies only (with build tools for canvas)
RUN apk add --no-cache --virtual .build-deps python3 make g++ cairo-dev pango-dev jpeg-dev giflib-dev librsvg-dev \
&& npm ci --omit=dev --build-from-source=canvas \
&& apk del .build-deps
# Copy Prisma schema and generate client
COPY prisma ./prisma
RUN npx prisma generate
# Copy built application
COPY --from=builder /app/dist ./dist
# Copy i18n files
COPY --from=builder /app/src/i18n ./dist/i18n
# Copy league filter config files (critical: without these, feeder stores ALL matches)
COPY top_leagues.json basketball_top_leagues.json ./
# Set environment
ENV NODE_ENV=production
# Expose port
EXPOSE 3000
# Start the application
CMD ["node", "dist/main.js"]
Executable
+156
View File
@@ -0,0 +1,156 @@
# 🤖 AI Assistant Context - NestJS Backend
> Bu dosya, AI asistanların (Claude, GPT, Gemini vb.) projeyi hızlıca anlaması için hazırlanmış bir referans dökümanıdır.
---
## 📚 Projeyi Anlamak İçin Önce Oku
1. **README.md** dosyasını oku - Projenin mimarisi, ADR'ler, teknoloji stack'i ve kurulum adımlarını içerir.
```
README.md
```
---
## 🎯 Referans Klasörü
`.agent/` klasörü best practice'ler, agent tanımları ve yardımcı scriptler içerir. Görev türüne göre ilgili referansları kullan:
### Skills (Beceri Setleri)
| Beceri | Konum | Ne Zaman Kullan |
| -------------------------- | ---------------------------------------- | ------------------------------- |
| **Senior Backend** | `.agent/skills/senior-backend/` | API geliştirme, servis yazarken |
| **Senior Fullstack** | `.agent/skills/senior-fullstack/` | End-to-end feature geliştirme |
| **Code Reviewer** | `.agent/skills/code-reviewer/` | Code review yaparken |
| **Receiving Code Review** | `.agent/skills/receiving-code-review/` | Review feedback işlerken |
| **Senior ML Engineer** | `.agent/skills/senior-ml-engineer/` | ML/AI entegrasyonları |
| **Senior Prompt Engineer** | `.agent/skills/senior-prompt-engineer/` | LLM prompt optimizasyonu |
### Agents (Roller)
| Agent | Konum | Açıklama |
| ---------------------- | -------------------------------------- | --------------------------- |
| **TypeScript Pro** | `.agent/agents/typescript-pro.md` | TypeScript best practices |
| **Code Reviewer** | `.agent/agents/code-reviewer.md` | Kod review yapma |
| **Debugger** | `.agent/agents/debugger.md` | Hata ayıklama |
| **Security Engineer** | `.agent/agents/security-engineer.md` | Güvenlik analizi |
| **Database Optimizer** | `.agent/agents/database-optimizer.md` | DB performans optimizasyonu |
| **API Documenter** | `.agent/agents/api-documenter.md` | API dokümantasyonu |
| **API Security Audit** | `.agent/agents/api-security-audit.md` | API güvenlik denetimi |
| **AI Engineer** | `.agent/agents/ai-engineer.md` | AI/ML entegrasyonları |
| **Data Scientist** | `.agent/agents/data-scientist.md` | Veri analizi |
---
## 🔧 Teknoloji Stack'i (Özet)
- **Framework:** NestJS
- **ORM:** Prisma
- **Database:** PostgreSQL
- **Cache:** Redis
- **Auth:** JWT + RBAC
- **i18n:** nestjs-i18n
- **Language:** TypeScript (Strict Mode)
---
## 🏗️ Proje Yapısı Özeti
```
src/
├── common/ # Shared (BaseService, BaseController, Filters, Interceptors)
├── config/ # App configuration
├── database/ # Prisma service
├── i18n/ # Translation files
└── modules/ # Feature modules (auth, users, admin, health)
```
---
## ✅ Görev Bazlı Referans Kullanımı
**API geliştirirken:**
```
.agent/skills/senior-backend/SKILL.md
.agent/skills/senior-backend/references/
```
**Code review yaparken:**
```
.agent/skills/code-reviewer/SKILL.md
.agent/skills/code-reviewer/references/common_antipatterns.md
```
**Güvenlik denetimi yaparken:**
```
.agent/agents/security-engineer.md
.agent/agents/api-security-audit.md
```
**Database optimizasyonu:**
```
.agent/agents/database-optimizer.md
```
---
## 🚨 VERİTABANI GÜVENLİĞİ — KRİTİK KURALLAR
> **Bu kurallar KESİNLİKLE ihlal edilemez. Canlı ortamda veri kaybına yol açacak herhangi bir komut çalıştırılması YASAKTIR.**
### ❌ YASAKLI Prisma Komutları (ASLA Kullanılmayacak)
| Komut | Neden Yasak |
| --- | --- |
| `prisma migrate reset` | Tüm tabloları siler ve veritabanını sıfırlar |
| `prisma db push --force-reset` | Schema'yı zorla uygular, mevcut verileri siler |
| `prisma migrate dev --create-only` sonrası manuel `DROP` | Veri kaybına yol açabilir |
| `DROP SCHEMA public CASCADE` | Tüm tabloları ve verileri kalıcı olarak siler |
| `DROP DATABASE` | Veritabanını tamamen yok eder |
| `TRUNCATE TABLE` (toplu) | Tüm kayıtları siler |
### ✅ İZİN VERİLEN Prisma Komutları
| Komut | Açıklama |
| --- | --- |
| `prisma migrate deploy` | Sadece bekleyen migration'ları uygular, veri silmez |
| `prisma generate` | Prisma Client'ı yeniden oluşturur, DB'ye dokunmaz |
| `prisma migrate dev` | **Sadece lokal geliştirme ortamında** kullanılabilir |
### ⚠️ Genel Kurallar
1. **Canlı veritabanı (production) üzerinde hiçbir destructive işlem yapılmamalıdır.**
2. **Migration dosyaları her zaman additive (eklemeli) olmalıdır.** Kolon silme veya tablo kaldırma gibi işlemler öncesinde mutlaka yedek alınmalı ve kullanıcıya danışılmalıdır.
3. **Deploy pipeline'ında sadece `prisma migrate deploy` kullanılır.** Bu komut yalnızca henüz uygulanmamış migration'ları çalıştırır ve mevcut verilere dokunmaz.
4. **Veritabanı şifreleri ve bağlantı bilgileri asla kod içinde veya commit'lerde açık metin olarak bulunmamalıdır.** Environment variable veya secret yönetimi kullanılmalıdır.
---
## 💡 Örnek Prompt'lar
### Yeni Module Oluşturma
> "`.agent/skills/senior-backend/` referanslarını kullanarak, `notifications` modülü oluştur. BaseService ve BaseController pattern'lerini kullan."
### Code Review
> "`.agent/skills/code-reviewer/references/common_antipatterns.md` dosyasına göre `src/modules/auth/` klasörünü review et."
### Güvenlik Analizi
> "`.agent/agents/api-security-audit.md` rolünü al ve projenin güvenlik açıklarını analiz et."
### Database Optimizasyonu
> "`.agent/agents/database-optimizer.md` rolünü al ve Prisma sorgularını optimize et."
---
**Frontend Projesi:** `../nextjs-boilerplate-full/prompt.md`