Next.js × Go モノレポ構成：4ポータル × 4APIを1人で保守する設計【第3回】

1
2
3

packages:
  - "apps/*"
  - "packages/*"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": [".next/**", "dist/**"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    },
    "lint": {
      "dependsOn": ["^lint"]
    },
    "type-check": {
      "dependsOn": ["^build"]
    }
  }
}

1
2
3
4
5
6
7
8

# 全アプリをビルド
pnpm build

# 特定のアプリだけ開発
pnpm dev:system    # System Portalのみ

# 全体のlint + type-check
pnpm lint && pnpm type-check

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// packages/types/src/product.ts
export interface Product {
  id: string;
  code: string;
  name: string;
  status: ProductStatus;
  providerId: string;
  // ...
}

export type ProductStatus = 'draft' | 'published' | 'archived' | 'discontinued';

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

// packages/ui/src/components/ProductStatusBadge.tsx
import { ProductStatus } from '@repo/types';

const statusConfig = {
  draft: { label: '下書き', variant: 'secondary' },
  published: { label: '公開中', variant: 'success' },
  archived: { label: 'アーカイブ', variant: 'muted' },
  discontinued: { label: '販売終了', variant: 'destructive' },
};

export function ProductStatusBadge({ status }: { status: ProductStatus }) {
  const config = statusConfig[status];
  return <Badge variant={config.variant}>{config.label}</Badge>;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

// packages/api-client/src/hooks/useProducts.ts
import { useQuery, useMutation } from '@tanstack/react-query';
import type { Product } from '@repo/types';

export function useProducts() {
  return useQuery({
    queryKey: ['products'],
    queryFn: () => apiClient.get<Product[]>('/products'),
  });
}

export function useCreateProduct() {
  const queryClient = useQueryClient();
  return useMutation({
    mutationFn: (data: CreateProductRequest) =>
      apiClient.post<Product>('/products', data),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['products'] });
    },
  });
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

// packages/auth/src/index.ts
import NextAuth from 'next-auth';
import Keycloak from 'next-auth/providers/keycloak';

export const { auth, handlers, signIn, signOut } = NextAuth({
  providers: [
    Keycloak({
      clientId: process.env.KEYCLOAK_CLIENT_ID!,
      clientSecret: process.env.KEYCLOAK_CLIENT_SECRET!,
      issuer: process.env.KEYCLOAK_ISSUER!,
    }),
  ],
  // ...
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// backend/cmd/system-api/main.go
func main() {
    e := echo.New()

    // System API専用のルート
    systemRouter := router.NewSystemRouter(e, services)
    systemRouter.RegisterRoutes()

    e.Start(":8080")
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// backend/cmd/provider-api/main.go
func main() {
    e := echo.New()

    // Provider API専用のルート
    providerRouter := router.NewProviderRouter(e, services)
    providerRouter.RegisterRoutes()

    e.Start(":8081")
}

1
2
3
4
5
6
7
8

// backend/internal/application/product_service.go
type ProductService struct {
    repo repository.ProductRepository
}

func (s *ProductService) Create(ctx context.Context, req CreateProductRequest) (*Product, error) {
    // System API, Provider API 両方から呼ばれる
}

1
2
3
4

# packages/types/package.json
"scripts": {
  "generate:types": "openapi-typescript ../../specs/shared-schemas.yaml -o src/generated/shared-schemas.ts"
}

1
2

# 統合スクリプトで全サービス起動
./scripts/start-dev.sh

1
2
3

# 個別起動も可能
pnpm dev:system     # System Portalだけ
pnpm dev:provider   # Provider Portalだけ

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 認証（Keycloak）
KEYCLOAK_CLIENT_ID=xxx
KEYCLOAK_CLIENT_SECRET=xxx
KEYCLOAK_ISSUER=http://localhost:8180/realms/saru

# API接続
NEXT_PUBLIC_API_URL=http://localhost:808x

# NextAuth
NEXTAUTH_SECRET=xxx
NEXTAUTH_URL=http://localhost:300x

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

// ルートのpackage.json
{
  "scripts": {
    "dev": "turbo run dev",
    "dev:system": "turbo run dev --filter=system",
    "dev:provider": "turbo run dev --filter=provider",
    "build": "turbo run build",
    "lint": "turbo run lint",
    "type-check": "turbo run type-check"
  }
}