巨大ソフトウェアはどのように開発・管理・維持されるのか？— SWアップデートシステムまで

company-repo/
  frontend/
  backend/
  mobile/
  infra/
  shared-libs/
  tools/

# APIゲートウェイルーティング例
routes:
  - path: /api/users
    service: user-service
    methods: [GET, POST]
  - path: /api/orders
    service: order-service
    methods: [GET, POST, PUT]
  - path: /api/payments
    service: payment-service
    methods: [POST]

# サーキットブレーカー擬似コード
class CircuitBreaker:
    def __init__(self, threshold=5, timeout=30):
        self.failure_count = 0
        self.threshold = threshold
        self.timeout = timeout
        self.state = "CLOSED"  # CLOSED, OPEN, HALF_OPEN

    def call(self, func):
        if self.state == "OPEN":
            if self.timeout_expired():
                self.state = "HALF_OPEN"
            else:
                raise CircuitOpenError("Service unavailable")
        try:
            result = func()
            self.on_success()
            return result
        except Exception as e:
            self.on_failure()
            raise e

    def on_failure(self):
        self.failure_count += 1
        if self.failure_count >= self.threshold:
            self.state = "OPEN"

    def on_success(self):
        self.failure_count = 0
        self.state = "CLOSED"

# GitHub Actions CIパイプライン例
name: CI Pipeline
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install dependencies
        run: npm ci
      - name: Lint
        run: npm run lint
      - name: Unit Tests
        run: npm run test:unit
      - name: Build
        run: npm run build

// フィーチャーフラグ使用例
const featureFlags = {
  newCheckoutFlow: false,
  darkMode: true,
  aiRecommendation: false,
};

function renderCheckout() {
  if (featureFlags.newCheckoutFlow) {
    return renderNewCheckout();
  }
  return renderLegacyCheckout();
}

import { autoUpdater } from 'electron-updater';

autoUpdater.setFeedURL({
  provider: 'github',
  owner: 'my-org',
  repo: 'my-app',
});

autoUpdater.on('update-available', (info) => {
  log.info('新バージョン発見:', info.version);
  showUpdateNotification(info);
});

autoUpdater.on('update-downloaded', (info) => {
  showRestartDialog(info.version);
});

setInterval(() => {
  autoUpdater.checkForUpdates();
}, 4 * 60 * 60 * 1000);

全体アップデート：v1.0 (200MB) -> v1.1 (200MB) = 200MBダウンロード
デルタアップデート：v1.0 (200MB) -> v1.1 (200MB) = 15MBダウンロード（差分のみ）

# ArgoCDを利用したGitOpsベースのサーバーアップデート
apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: my-service
spec:
  project: default
  source:
    repoURL: https://github.com/my-org/k8s-manifests
    path: services/my-service
    targetRevision: main
  destination:
    server: https://kubernetes.default.svc
    namespace: production
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

意図的 + 慎重：「今はシンプルな実装で行き、来期リファクタリングしよう」
意図的 + 無謀：「設計は後で、まず速く作ろう」
非意図的 + 慎重：「実装後に振り返るとより良い設計があった」
非意図的 + 無謀：「レイヤードアーキテクチャって何？」

オンコールローテーション例：

週間1：エンジニアA (Primary)、エンジニアB (Secondary)
週間2：エンジニアB (Primary)、エンジニアC (Secondary)

アラートエスカレーション：
  0分：PagerDuty -> Primaryエンジニア
  5分：無応答 -> Secondaryエンジニア
 15分：無応答 -> チームリード
 30分：未解決 -> VP of Engineering

一般的な企業開発：
  チームA -> ライブラリX依頼 -> チームB -> バックログ待ち（2-3ヶ月）

InnerSource方式：
  チームA -> ライブラリXにPR提出 -> チームBレビュー -> マージ（1-2週間）

アーキテクチャ
  [ ] サービス境界が明確に定義されているか？
  [ ] APIバージョン管理戦略があるか？
  [ ] サーキットブレーカー/リトライポリシーが実装されているか？

CI/CD
  [ ] コードコミットからプロダクションデプロイまで自動化されているか？
  [ ] ロールバックが5分以内に可能か？

アップデートシステム
  [ ] 自動アップデートが実装されているか？
  [ ] アップデートファイルの整合性検証をしているか？
  [ ] アップデート失敗時のロールバック機構があるか？

モニタリング
  [ ] SLI/SLOが定義されているか？

技術的負債
  [ ] 技術的負債を定期的に測定しているか？
  [ ] リファクタリングに割り当てられたエンジニアリング時間があるか？

ドキュメンテーション
  [ ] ADRを書いているか？
  [ ] APIドキュメントが自動生成されているか？