@armoyu/core 1.0.0

package/src/models/community/SchoolTeam.ts

@@ -0,0 +1,49 @@
+import { User } from '../auth/User';
+
+/**
+ * Type of School Team (Traditional Sports or E-sports).
+ */
+export type TeamType = 'ESPORTS' | 'TRADITIONAL_SPORTS';
+
+/**
+ * Represents a School Team (Okul Takımı) for specific games or sports.
+ */
+export class SchoolTeam {
+  id: string = '';
+  name: string = ''; // e.g., "UAV FB", "ARMOYU CS2"
+  gameOrSport: string = ''; // e.g., "Football", "Volleyball", "Counter-Strike 2"
+  type: TeamType = 'ESPORTS';
+  logo?: string = '';
+  
+  schoolId: string = '';
+  captain: User | null = null;
+  coach: User | null = null;
+  members: User[] = [];
+  memberCount: number = 0;
+  
+  achievements: string[] = [];
+
+  constructor(data: Partial<SchoolTeam>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a SchoolTeam object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): SchoolTeam {
+    return new SchoolTeam({
+      id: json.id || '',
+      name: json.name || '',
+      gameOrSport: json.gameOrSport || json.game_or_sport || '',
+      type: (json.type as TeamType) || 'ESPORTS',
+      logo: json.logo || '',
+      schoolId: json.schoolId || '',
+      captain: json.captain ? User.fromJSON(json.captain) : null,
+      coach: json.coach ? User.fromJSON(json.coach) : null,
+      members: Array.isArray(json.members) ? json.members.map(User.fromJSON) : [],
+      memberCount: json.memberCount || 0,
+      achievements: json.achievements || []
+    });
+  }
+}

package/src/models/community/Station.ts

@@ -0,0 +1,145 @@
+import { User } from '../auth/User';
+
+export type StationType = 'YEMEK' | 'INTERNET_KAFE' | 'HALI_SAHA' | 'SPOR_KOMPLEKSI';
+
+/**
+ * Represents a menu item or a product in a station.
+ */
+export class StationProduct {
+  id: string = '';
+  name: string = '';
+  price: number = 0;
+  category: string = '';
+  image?: string;
+  isDeal?: boolean;
+  discountRate?: string;
+
+  constructor(data: Partial<StationProduct>) {
+    Object.assign(this, data);
+  }
+
+  static fromJSON(json: Record<string, any>): StationProduct {
+    return new StationProduct({
+      id: json.id || '',
+      name: json.name || '',
+      price: json.price || 0,
+      category: json.category || '',
+      image: json.image,
+      isDeal: json.isDeal,
+      discountRate: json.discountRate,
+    });
+  }
+}
+
+/**
+ * Represents detailed hardware/equipment in a workstation setup.
+ */
+export class WorkstationEquipment {
+  id: string = '';
+  name: string = 'Standart Masa'; // e.g., "VIP Oda #1"
+  cpu: string = '';
+  gpu: string = '';
+  ram: string = '';
+  monitor: string = '';
+  keyboard: string = '';
+  mouse: string = '';
+  isAvailable?: boolean = true;
+
+  constructor(data: Partial<WorkstationEquipment>) {
+    Object.assign(this, data);
+  }
+
+  static fromJSON(json: Record<string, any>): WorkstationEquipment {
+    return new WorkstationEquipment({
+      id: json.id || '',
+      name: json.name || '',
+      cpu: json.cpu || '',
+      gpu: json.gpu || '',
+      ram: json.ram || '',
+      monitor: json.monitor || '',
+      keyboard: json.keyboard || '',
+      mouse: json.mouse || '',
+      isAvailable: json.isAvailable ?? true,
+    });
+  }
+}
+
+export interface StationPricing {
+  label: string;
+  price: number;
+  unit: string; // 'saat', 'gün', 'seans' vb.
+}
+
+export class StationCoupon {
+  code: string = '';
+  discount: string = '';
+  expiryDate: string = '';
+  description: string = '';
+
+  constructor(data: Partial<StationCoupon>) {
+    Object.assign(this, data);
+  }
+
+  static fromJSON(json: Record<string, any>): StationCoupon {
+    return new StationCoupon({
+      code: json.code || '',
+      discount: json.discount || '',
+      expiryDate: json.expiryDate || '',
+      description: json.description || '',
+    });
+  }
+}
+
+/**
+ * Represents a Station (İstasyon) in the aramizdakioyuncu.com platform.
+ */
+export class Station {
+  id: string = '';
+  name: string = '';
+  slug: string = '';
+  type: StationType = 'YEMEK';
+  description: string = '';
+  location: string = '';
+  logo: string = '';
+  banner: string = '';
+  rating: number = 0;
+  reviewCount: number = 0;
+  owner: User | null = null;
+  
+  // Refactored to unified classes
+  products?: StationProduct[] = [];
+  equipment?: WorkstationEquipment[] = [];
+  pricing?: StationPricing[] = [];
+  coupons?: StationCoupon[] = [];
+  facilities?: string[] = [];
+
+  constructor(data: Partial<Station>) {
+    Object.assign(this, data);
+    if (!this.slug && this.name) {
+      this.slug = this.name.toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '');
+    }
+  }
+
+  static fromJSON(json: Record<string, any>): Station {
+    return new Station({
+      id: json.id || '',
+      name: json.name || '',
+      slug: json.slug || '',
+      type: json.type || 'YEMEK',
+      description: json.description || '',
+      location: json.location || '',
+      logo: json.logo || '',
+      banner: json.banner || '',
+      rating: json.rating || 0,
+      reviewCount: json.reviewCount || 0,
+      owner: json.owner ? User.fromJSON(json.owner) : null,
+      products: json.products?.map((p: any) => StationProduct.fromJSON(p)) || [],
+      equipment: json.equipment?.map((e: any) => WorkstationEquipment.fromJSON(e)) || [],
+      pricing: json.pricing,
+      coupons: json.coupons?.map((c: any) => StationCoupon.fromJSON(c)) || [],
+      facilities: json.facilities,
+    });
+  }
+}

package/src/models/community/Survey.ts

@@ -0,0 +1,53 @@
+import { User } from '../auth/User';
+import { SurveyAnswer } from './SurveyAnswer';
+
+/**
+ * Represents a community Survey (Anket) in the aramizdakioyuncu.com platform.
+ */
+export class Survey {
+  id: string = '';
+  question: string = '';
+  description?: string = '';
+  options: SurveyAnswer[] = [];
+  author: User | null = null;
+  createdAt: string = '';
+  expiresAt?: string = '';
+  totalVotes: number = 0;
+  
+  // Current user's interaction state
+  hasVoted: boolean = false;
+  myVoteId?: string = '';
+
+  constructor(data: Partial<Survey>) {
+    Object.assign(this, data);
+    this.totalVotes = this.options.reduce((sum, opt) => sum + opt.votes, 0);
+  }
+
+  /**
+   * Helper to get percentage for a specific option.
+   */
+  getOptionPercentage(optionId: string): number {
+    const option = this.options.find(o => o.id === optionId);
+    if (!option || this.totalVotes === 0) return 0;
+    return Math.round((option.votes / this.totalVotes) * 100);
+  }
+
+  /**
+   * Instantiates a Survey object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Survey {
+    return new Survey({
+      id: json.id || '',
+      question: json.question || '',
+      description: json.description || '',
+      options: Array.isArray(json.options) ? json.options.map((o: any) => SurveyAnswer.fromJSON(o)) : [],
+      author: json.author ? User.fromJSON(json.author) : null,
+      createdAt: json.createdAt || '',
+      expiresAt: json.expiresAt || '',
+      totalVotes: json.totalVotes || 0,
+      hasVoted: json.hasVoted || false,
+      myVoteId: json.myVoteId || '',
+    });
+  }
+}

package/src/models/community/SurveyAnswer.ts

@@ -0,0 +1,26 @@
+/**
+ * Represents an answer option in a Survey.
+ */
+export class SurveyAnswer {
+  id: string = '';
+  text: string = '';
+  votes: number = 0;
+  voterIds: string[] = [];
+
+  constructor(data: Partial<SurveyAnswer>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a SurveyAnswer object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): SurveyAnswer {
+    return new SurveyAnswer({
+      id: json.id || '',
+      text: json.text || '',
+      votes: json.votes || 0,
+      voterIds: json.voterIds || [],
+    });
+  }
+}

package/src/models/community/Team.ts

@@ -0,0 +1,24 @@
+/**
+ * Represents a Sports Team (Takım) in the aramizdakioyuncu.com platform.
+ */
+export class Team {
+  id: string = '';
+  name: string = '';
+  logo: string = '';
+  primaryColor: string = '';
+  shortName: string = '';
+
+  constructor(data: Partial<Team>) {
+    Object.assign(this, data);
+  }
+
+  static fromJSON(json: any): Team {
+    return new Team({
+      id: json.id || '',
+      name: json.name || '',
+      logo: json.logo || '',
+      primaryColor: json.primaryColor || '#1d4ed8',
+      shortName: json.shortName || ''
+    });
+  }
+}

package/src/models/community/Workplace.ts

@@ -0,0 +1,32 @@
+/**
+ * Represents a Workplace (İşyeri/Ofis) in the aramizdakioyuncu.com platform.
+ */
+export class Workplace {
+  id: string = '';
+  name: string = '';
+  description: string = '';
+  location: string = '';
+  logo: string = '';
+  website: string = '';
+  establishedDate: string = '';
+
+  constructor(data: Partial<Workplace>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Workplace object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Workplace {
+    return new Workplace({
+      id: json.id || '',
+      name: json.name || json.title || '',
+      description: json.description || '',
+      location: json.location || json.address || '',
+      logo: json.logo || json.logo_url || '',
+      website: json.website || '',
+      establishedDate: json.establishedDate || json.created_at || '',
+    });
+  }
+}

package/src/models/content/Game.ts

@@ -0,0 +1,39 @@
+/**
+ * Represents a Game in the aramizdakioyuncu.com platform.
+ */
+export class Game {
+  id: string = '';
+  name: string = '';
+  slug: string = '';
+  logo: string = '';
+  poster: string = '';
+  category: string = '';
+  developer: string = '';
+  description: string = '';
+
+  constructor(data: Partial<Game>) {
+    Object.assign(this, data);
+    if (!this.slug && this.name) {
+      this.slug = this.name.toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '');
+    }
+  }
+
+  /**
+   * Instantiates a Game object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Game {
+    return new Game({
+      id: json.id || '',
+      name: json.name || '',
+      slug: json.slug || '',
+      logo: json.logo || json.logo_url || '',
+      poster: json.poster || json.poster_url || '',
+      category: json.category || '',
+      developer: json.developer || '',
+      description: json.description || '',
+    });
+  }
+}

package/src/models/content/Media.ts

@@ -0,0 +1,30 @@
+/**
+ * Represents a Media item (Fotoğraf/Video) in the aramizdakioyuncu.com platform.
+ */
+export class Media {
+  title: string = '';
+  count: number = 0;
+  author: string = '';
+  date: string = '';
+  category: string = '';
+  image: string = '';
+
+  constructor(data: Partial<Media>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Media object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Media {
+    return new Media({
+      title: json.title || '',
+      count: json.count || 0,
+      author: json.author || '',
+      date: json.date || '',
+      category: json.category || '',
+      image: json.image || json.thumb || '',
+    });
+  }
+}

package/src/models/content/Mod.ts

@@ -0,0 +1,38 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a Game Mod (Oyun Modu) in the aramizdakioyuncu.com platform.
+ */
+export class Mod {
+  id: string = '';
+  name: string = '';
+  game: string = '';
+  version: string = '';
+  author: User | null = null;
+  description: string = '';
+  downloads: string = '';
+  image: string = '';
+  isFeatured: boolean = false;
+
+  constructor(data: Partial<Mod>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Mod object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Mod {
+    return new Mod({
+      id: json.id || '',
+      name: json.name || json.title || '',
+      game: json.game || '',
+      version: json.version || '',
+      author: json.author ? (json.author instanceof User ? json.author : User.fromJSON(json.author)) : (json.authorUsername ? new User({ username: json.authorUsername, displayName: json.authorName }) : null),
+      description: json.description || json.desc || '',
+      downloads: json.downloads || '0',
+      image: json.image || '',
+      isFeatured: json.isFeatured || false,
+    });
+  }
+}

package/src/models/content/News.ts

@@ -0,0 +1,43 @@
+import { User } from '../auth/User';
+
+/**
+ * Represents a News item (Haber) in the aramizdakioyuncu.com platform.
+ */
+export class News {
+  slug: string = '';
+  title: string = '';
+  excerpt: string = '';
+  content: string = '';
+  date: string = '';
+  category: string = '';
+  image: string = '';
+  author: User | null = null;
+
+  constructor(data: Partial<News>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Returns the absolute URL to the news article.
+   */
+  getUrl(): string {
+    return `/haberler/${this.slug}`;
+  }
+
+  /**
+   * Instantiates a News object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): News {
+    return new News({
+      slug: json.slug || '',
+      title: json.title || '',
+      excerpt: json.excerpt || json.summary || '',
+      content: json.content || '',
+      date: json.date || '',
+      category: json.category || '',
+      image: json.image || '',
+      author: json.author ? (json.author instanceof User ? json.author : User.fromJSON(json.author)) : (json.authorUsername ? new User({ username: json.authorUsername, displayName: json.authorName }) : null),
+    });
+  }
+}

package/src/models/content/Project.ts

@@ -0,0 +1,49 @@
+import { User } from '../auth/User';
+import { Group } from '../community/Group';
+
+export interface ProjectAuthor {
+  user: User;
+  role: string;
+}
+
+/**
+ * Represents a Project in the aramizdakioyuncu.com platform.
+ */
+export class Project {
+  id: string = '';
+  name: string = '';
+  description: string = '';
+  status: string = '';
+  image: string = '';
+  url: string = '';
+  githubUrl: string = '';
+  authors: ProjectAuthor[] = [];
+  group: Group | null = null;
+  techStack: string[] = [];
+
+  constructor(data: Partial<Project>) {
+    Object.assign(this, data);
+  }
+
+  /**
+   * Instantiates a Project object from a JSON object.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  static fromJSON(json: Record<string, any>): Project {
+    return new Project({
+      id: json.id || '',
+      name: json.name || json.title || '',
+      description: json.description || '',
+      status: json.status || '',
+      image: json.image || json.thumb || '',
+      url: json.url || json.demoUrl || '',
+      githubUrl: json.githubUrl || json.github || '',
+      authors: Array.isArray(json.authors) ? json.authors.map((a: any) => ({
+         user: a.user instanceof User ? a.user : User.fromJSON(a.user || a),
+         role: a.role || 'Geliştirici'
+      })) : [],
+      group: json.group ? (json.group instanceof Group ? json.group : Group.fromJSON(json.group)) : null,
+      techStack: Array.isArray(json.techStack) ? json.techStack : [],
+    });
+  }
+}

package/src/models/core/PlatformStats.ts

@@ -0,0 +1,74 @@
+import { GlobalStats } from '../../types/stats';
+
+/**
+ * Platform Statistics Class
+ * Bu sınıf, GlobalStats verisini sarmalar ve platform analitiği için yardımcı metodlar sunar.
+ */
+export class PlatformStats implements GlobalStats {
+  totalPlayers: number;
+  malePlayers: number;
+  femalePlayers: number;
+  totalForums: number;
+  totalPolls: number;
+  activeUsers24h: number;
+  totalMatchesPlayed: number;
+  totalGuilds: number;
+  monthlyVisitors: number;
+  totalNews: number;
+
+  constructor(data: GlobalStats) {
+    this.totalPlayers = data.totalPlayers;
+    this.malePlayers = data.malePlayers;
+    this.femalePlayers = data.femalePlayers;
+    this.totalForums = data.totalForums;
+    this.totalPolls = data.totalPolls;
+    this.activeUsers24h = data.activeUsers24h;
+    this.totalMatchesPlayed = data.totalMatchesPlayed;
+    this.totalGuilds = data.totalGuilds;
+    this.monthlyVisitors = data.monthlyVisitors;
+    this.totalNews = data.totalNews;
+  }
+
+  /**
+   * Cinsiyet Dağılım Oranlarını Döndürür
+   */
+  getGenderDistribution() {
+    const malePercent = Math.round((this.malePlayers / (this.malePlayers + this.femalePlayers)) * 100);
+    const femalePercent = 100 - malePercent;
+    return { malePercent, femalePercent };
+  }
+
+  /**
+   * Bir metrik için büyüme oranını hesaplar (Mock Veri)
+   */
+  getGrowthRate(metric: keyof GlobalStats): number {
+    // Gerçek bir veritabanında bu, dünkü veriye göre hesaplanırdı.
+    // Şimdilik tutarlı olması için statik mock değerler dönüyoruz.
+    const growthMap: Partial<Record<keyof GlobalStats, number>> = {
+      totalPlayers: 12.4,
+      activeUsers24h: 8.2,
+      monthlyVisitors: 5.7,
+      totalNews: 3.1,
+      totalGuilds: 1.5,
+    };
+    return growthMap[metric] || 0;
+  }
+
+  /**
+   * Harita verisi için günlük ziyaretçi trendini döndürür (Mock Veri)
+   */
+  getVisitorTrend() {
+    return [45, 52, 48, 70, 61, 85, 92]; // Son 7 günün büyüme trendi (%)
+  }
+
+  /**
+   * Forum, Anket ve Haberler bazında aktivite özeti
+   */
+  getActivityBreakdown() {
+    return [
+      { label: 'Forum Konuları', value: this.totalForums, color: '#3b82f6' },
+      { label: 'Haber İçerikleri', value: this.totalNews, color: '#10b981' },
+      { label: 'Aktif Anketler', value: this.totalPolls, color: '#f59e0b' },
+    ];
+  }
+}

package/src/models/core/SystemSettings.ts

@@ -0,0 +1,59 @@
+/**
+ * System Settings Model
+ * Platform genelindeki tüm ayarları tek bir noktadan yönetmek için tasarlanmıştır.
+ */
+export class SystemSettings {
+  siteTitle: string;
+  siteDescription: string;
+  isMaintenanceMode: boolean;
+  isRegistrationOpen: boolean;
+  contactEmail: string;
+  version: string;
+  socialLinks: {
+    discord?: string;
+    youtube?: string;
+    instagram?: string;
+    twitter?: string;
+    github?: string;
+  };
+  branding: {
+    logoUrl?: string;
+    faviconUrl?: string;
+    primaryColor?: string;
+  };
+
+  constructor(data: Partial<SystemSettings> = {}) {
+    this.siteTitle = data.siteTitle || 'ARMOYU - Aramızdaki Oyuncu';
+    this.siteDescription = data.siteDescription || 'Türkiye\'nin en büyük oyun topluluğu ve gelişim platformu.';
+    this.isMaintenanceMode = data.isMaintenanceMode || false;
+    this.isRegistrationOpen = data.isRegistrationOpen || true;
+    this.contactEmail = data.contactEmail || 'iletisim@armoyu.com';
+    this.version = data.version || 'v3.4.2-beta';
+    this.socialLinks = data.socialLinks || {
+      discord: 'https://discord.gg/armoyu',
+      youtube: 'https://youtube.com/armoyu',
+      instagram: 'https://instagram.com/armoyu',
+      twitter: 'https://twitter.com/armoyu',
+      github: 'https://github.com/armoyu'
+    };
+    this.branding = data.branding || {
+      logoUrl: 'https://v3.armoyu.com/logo.png',
+      faviconUrl: 'https://v3.armoyu.com/favicon.ico',
+      primaryColor: '#3b82f6'
+    };
+  }
+
+  /**
+   * Ayarların bir kopyasını oluşturur (State yönetimi için)
+   */
+  clone(): SystemSettings {
+    return new SystemSettings(JSON.parse(JSON.stringify(this)));
+  }
+
+  /**
+   * Bakım modunu hızlıca değiştirir
+   */
+  toggleMaintenance() {
+    this.isMaintenanceMode = !this.isMaintenanceMode;
+  }
+}