GraphQL Federation Database Migration — คู่มือฉบับสมบูรณ์ 2026

Design Patterns และ Clean Code สำหรับ GraphQL Federation Database Migration

Design Patterns ที่ใช้บ่อยกับ GraphQL Federation Database Migration

SOLID Principles — หลักการเขียนโค้ดที่ดี

• Single Responsibility — แต่ละ class/function ทำหน้าที่เดียว ถ้า function ยาวเกิน 20 บรรทัด ควรแยกออก
• Open/Closed — เปิดสำหรับ extension ปิดสำหรับ modification ใช้ interface/abstract class
• Liskov Substitution — subclass ต้องแทนที่ parent ได้โดยไม่ทำให้ระบบพัง
• Interface Segregation — แยก interface ให้เล็กและเฉพาะเจาะจง อย่าสร้าง "God Interface"
• Dependency Inversion — depend on abstractions ไม่ใช่ implementations ใช้ Dependency Injection

Clean Code Practices

• Meaningful Names — ตั้งชื่อตัวแปร/function ให้สื่อความหมาย getUserById(id) ดีกว่า get(x)
• Small Functions — function ควรทำสิ่งเดียว ยาวไม่เกิน 20 บรรทัด
• DRY (Don't Repeat Yourself) — ถ้าเขียนโค้ดซ้ำ 3 ครั้ง ควร refactor เป็น function
• Error Handling — จัดการ error อย่างเหมาะสม ไม่ swallow exceptions
• Comments — โค้ดที่ดีอธิบายตัวเองได้ ใช้ comment เฉพาะเมื่อจำเป็น (why, not what)

Testing และ CI/CD สำหรับ GraphQL Federation Database Migration

Testing Strategy

// ═══════════════════════════════════════
// Unit Tests — Vitest
// ═══════════════════════════════════════

describe('GraphQL Federation Database Migration Core Functions', () => {
  // Setup
  beforeEach(() => {
    jest.clearAllMocks();
  });

  it('should process data correctly', () => {
    const input = { name: 'test', value: 42 };
    const result = processData(input);
    expect(result).toBeDefined();
    expect(result.status).toBe('success');
    expect(result.processedValue).toBe(84);
  });

  it('should handle null input gracefully', () => {
    expect(() => processData(null)).toThrow('Input cannot be null');
  });

  it('should handle empty object', () => {
    const result = processData({});
    expect(result.status).toBe('error');
    expect(result.message).toContain('missing required fields');
  });

  it('should validate input types', () => {
    const input = { name: 123, value: 'not a number' };
    expect(() => processData(input)).toThrow('Invalid input types');
  });
});

// ═══════════════════════════════════════
// Integration Tests
// ═══════════════════════════════════════
describe('API Integration Tests', () => {
  it('GET /api/v1/items should return 200', async () => {
    const res = await request(app).get('/api/v1/items');
    expect(res.status).toBe(200);
    expect(res.body.data).toBeInstanceOf(Array);
  });

  it('POST /api/v1/items should create item', async () => {
    const res = await request(app)
      .post('/api/v1/items')
      .send({ name: 'Test Item', value: 100 })
      .set('Authorization', `Bearer ${token}`);
    expect(res.status).toBe(201);
    expect(res.body.id).toBeDefined();
  });

  it('should return 401 without auth', async () => {
    const res = await request(app).post('/api/v1/items').send({});
    expect(res.status).toBe(401);
  });
});

CI/CD Pipeline

# .github/workflows/ci.yml
# ═══════════════════════════════════════
name: CI/CD Pipeline
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_PASSWORD: test
        ports: ['5432:5432']
      redis:
        image: redis:7
        ports: ['6379:6379']
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run lint
      - run: npm run type-check
      - run: npm test -- --coverage
      - uses: codecov/codecov-action@v4

  build:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: docker/build-push-action@v5
        with:
          push: ${{ github.ref == 'refs/heads/main' }}
          tags: ghcr.io/${{ github.repository }}:latest

  deploy:
    needs: build
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - run: echo "Deploying to production..."
      # Add your deployment steps here