仕様検討レビュー・改善提案書
1. 一貫性レビュー結果
1.1 ✅ 良好な点
| 項目 |
評価 |
詳細 |
| 要件の網羅性 |
◎ |
システム要件定義から関数・API仕様まで一貫して網羅 |
| ID管理 |
◎ |
要件ID（REQ-XXX）、機能ID（FUNC-XXX）、処理ID（PROC-XXX）、関数ID（AUTH-XXX等）、API ID（API-XXX）で体系的管理 |
| 多言語対応 |
◎ |
要件からデータベース設計まで一貫して8言語対応を考慮 |
| モジュール設計 |
◎ |
コア機能と拡張機能の分離が明確、柔軟な組み合わせが可能 |
| 外国人配慮 |
◎ |
在留資格、国籍、LINE Bot等、ターゲットユーザーのニーズを反映 |
1.2 ⚠️ 改善が必要な点
| 項目 |
課題 |
影響度 |
| セキュリティ仕様 |
具体的な実装方針が不足 |
高 |
| パフォーマンス要件 |
詳細な指標・測定方法が未定義 |
中 |
| 運用・監視 |
実装レベルの詳細が不足 |
中 |
| テスト仕様 |
テストケース・カバレッジ基準が未定義 |
高 |
| デプロイ戦略 |
CI/CD、環境管理の詳細が不足 |
中 |
2. Claude Code開発指示のための追記事項
2.1 技術的実装詳細
2.1.1 プロジェクト構成
rental-matching-app/
├── apps/
│ ├── web/ # React MPA (Vite + TypeScript)
│ ├── api/ # Node.js + Express API
│ └── line-bot/ # LINE Bot専用サービス
├── packages/
│ ├── shared/ # 共通型定義・ユーティリティ
│ ├── database/ # Prisma スキーマ・マイグレーション
│ ├── ui/ # 共通UIコンポーネント（LINE Design Language）
│ └── i18n/ # 多言語リソース
├── libs/
│ ├── auth/ # 認証ライブラリ
│ ├── search/ # 検索エンジンライブラリ
│ ├── ai-chat/ # AI処理ライブラリ
│ └── external-api/ # 外部API連携ライブラリ
└── configs/
├── eslint/
├── typescript/
└── tailwind/
2.1.2 技術スタック詳細
| カテゴリ |
技術 |
バージョン |
設定詳細 |
| フロントエンド |
React |
18.2+ |
MPA構成、TypeScript strict mode |
| ビルドツール |
Vite |
5.0+ |
HMR、プリロード最適化、コード分割 |
| スタイリング |
Tailwind CSS |
3.4+ |
LINE Design Language準拠のカスタム設定 |
| 状態管理 |
Zustand |
4.4+ |
軽量、TypeScript親和性 |
| フォーム管理 |
React Hook Form |
7.45+ |
Zod バリデーション統合 |
| API クライアント |
TanStack Query |
5.0+ |
キャッシュ、リアルタイム更新 |
| ルーティング |
React Router |
6.15+ |
MPA対応、ファイルベースルーティング |
2.1.3 データベース設定（Prisma）
generator client {
provider = "prisma-client-js"
previewFeatures = ["postgresqlExtensions", "fullTextSearch"]
}
datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
extensions = [postgis, pg_trgm]
}
2.1.4 環境変数設定
// apps/api/src/config/env.ts
import { z } from 'zod';
const envSchema = z.object({
NODE_ENV: z.enum(['development', 'production', 'test']),
DATABASE_URL: z.string().url(),
JWT_SECRET: z.string().min(32),
JWT_REFRESH_SECRET: z.string().min(32),
LINE_CHANNEL_SECRET: z.string(),
LINE_CHANNEL_ACCESS_TOKEN: z.string(),
GOOGLE_MAPS_API_KEY: z.string(),
GOOGLE_TRANSLATE_API_KEY: z.string(),
SMTP_HOST: z.string(),
SMTP_PORT: z.coerce.number(),
REDIS_URL: z.string().url(),
// 外部サイト連携用
JIMOTY_API_KEY: z.string().optional(),
UCHIKOMI_API_KEY: z.string().optional(),
});
export const env = envSchema.parse(process.env);
2.2 セキュリティ実装詳細
2.2.1 認証・認可
| 項目 |
実装方針 |
具体的設定 |
| JWT設定 |
RS256アルゴリズム |
アクセストークン: 15分、リフレッシュトークン: 7日 |
| パスワード |
bcrypt |
saltRounds: 12, 最小8文字、英数字記号必須 |
| レート制限 |
express-rate-limit |
API: 100req/15min, 認証: 5req/15min |
| CORS設定 |
許可ドメイン限定 |
本番: 指定ドメインのみ、開発: localhost許可 |
| CSP |
Content Security Policy |
script-src, style-src, img-src制限 |
2.2.2 データ保護
// packages/shared/src/crypto.ts
import crypto from 'node:crypto';
export class DataEncryption {
private static algorithm = 'aes-256-gcm';
private static key = Buffer.from(process.env.ENCRYPTION_KEY, 'hex');
static encrypt(text: string): EncryptedData {
const iv = crypto.randomBytes(16);
const cipher = crypto.createCipher(this.algorithm, this.key);
// 実装詳細...
}
}
2.3 パフォーマンス要件詳細
2.3.1 指標・監視
| メトリクス |
目標値 |
測定方法 |
アラート閾値 |
| ページ読込時間 |
< 3秒 |
Lighthouse CI |
> 4秒で警告 |
| API応答時間 |
< 1秒 |
APM監視 |
> 2秒で警告 |
| データベースクエリ |
< 500ms |
Prisma metrics |
> 1秒で警告 |
| 画像最適化 |
WebP変換、遅延読込 |
Bundle analyzer |
2MB超で警告 |
| メモリ使用量 |
< 512MB |
Docker monitoring |
> 1GB で警告 |
2.3.2 キャッシュ戦略
// libs/cache/src/redis-cache.ts
export class CacheManager {
// 検索結果: 5分キャッシュ
static readonly SEARCH_RESULTS_TTL = 300;
// 物件詳細: 1時間キャッシュ
static readonly PROPERTY_DETAILS_TTL = 3600;
// ユーザー設定: 24時間キャッシュ
static readonly USER_SETTINGS_TTL = 86400;
}
2.4 LINE Design Language実装詳細
2.4.1 Tailwind CSS設定
// configs/tailwind/line-design.config.js
module.exports = {
theme: {
extend: {
colors: {
// LINE緑色系
line: {
50: '#f0f9f3',
500: '#00c300', // メインカラー
600: '#00a300',
700: '#008000',
},
// 外国人向け配色
accent: {
blue: '#0084ff', // 情報表示
orange: '#ff8c00', // 注意喚起
red: '#ff3b30', // エラー
}
},
fontFamily: {
sans: ['Hiragino Sans', 'ヒラギノ角ゴ ProN', 'Noto Sans JP', 'sans-serif'],
en: ['Roboto', 'Arial', 'sans-serif'],
},
spacing: {
'line-xs': '4px',
'line-sm': '8px',
'line-md': '16px',
'line-lg': '24px',
'line-xl': '32px',
}
}
},
plugins: [
require('@tailwindcss/forms'),
require('@tailwindcss/typography'),
]
}
2.4.2 コンポーネント設計原則
// packages/ui/src/components/Button.tsx
interface ButtonProps {
variant: 'primary' | 'secondary' | 'ghost' | 'danger';
size: 'sm' | 'md' | 'lg';
fullWidth?: boolean;
loading?: boolean;
// LINE Design Language準拠のリップル効果
ripple?: boolean;
}
2.5 多言語対応実装詳細
2.5.1 i18n設定
// packages/i18n/src/config.ts
export const supportedLanguages = [
'ja', 'en', 'zh-CN', 'zh-TW', 'ko', 'vi', 'ne', 'tl'
] as const;
export const i18nConfig = {
defaultLanguage: 'ja',
fallbackLanguage: 'en',
// 自動翻訳のしきい値
autoTranslateThreshold: 0.8,
// RTL言語対応（将来のアラビア語等）
rtlLanguages: [],
};
2.5.2 翻訳リソース構造
packages/i18n/locales/
├── ja/
│ ├── common.json # 共通UI要素
│ ├── auth.json # 認証関連
│ ├── property.json # 物件関連
│ ├── chat.json # AI Chat関連
│ └── validation.json # バリデーションメッセージ
├── en/
├── zh-CN/
└── ...
2.6 テスト戦略詳細
2.6.1 テスト分類・カバレッジ目標
| テスト種別 |
フレームワーク |
カバレッジ目標 |
実行タイミング |
| 単体テスト |
Vitest |
90%以上 |
各PR |
| 結合テスト |
Testing Library |
80%以上 |
各PR |
| E2Eテスト |
Playwright |
主要フロー100% |
リリース前 |
| API テスト |
Supertest |
95%以上 |
各PR |
| パフォーマンステスト |
k6 |
基準値クリア |
週次 |
2.6.2 テストデータ管理
// packages/database/src/test-data/seed.ts
export const testUsers = {
landlord: {
email: 'landlord@test.com',
userType: 'landlord' as const,
// 暗号化された固定パスワード
},
foreignTenant: {
email: 'tenant@test.com',
userType: 'tenant' as const,
nationality: 'vietnam',
preferredLanguage: 'vi',
}
};
2.7 CI/CD・デプロイ戦略
2.7.1 GitHub Actions ワークフロー
# .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: postgis/postgis:15-3.3
env:
POSTGRES_PASSWORD: test
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '18'
cache: 'pnpm'
- name: Install dependencies
run: pnpm install --frozen-lockfile
- name: Run type checking
run: pnpm type-check
- name: Run linting
run: pnpm lint
- name: Run unit tests
run: pnpm test:unit --coverage
- name: Run E2E tests
run: pnpm test:e2e
2.7.2 環境構成
| 環境 |
用途 |
インフラ |
デプロイ方法 |
| development |
開発・テスト |
Docker Compose |
手動 |
| staging |
QA・受入テスト |
AWS ECS |
自動（develop ブランチ） |
| production |
本番運用 |
AWS ECS |
手動承認後（main ブランチ） |
2.8 監視・ログ戦略
2.8.1 ログ設定
// libs/logger/src/winston.config.ts
import winston from 'winston';
export const logger = winston.createLogger({
level: process.env.LOG_LEVEL || 'info',
format: winston.format.combine(
winston.format.timestamp(),
winston.format.errors({ stack: true }),
winston.format.json()
),
defaultMeta: {
service: process.env.SERVICE_NAME,
version: process.env.APP_VERSION
},
transports: [
new winston.transports.Console(),
new winston.transports.File({
filename: 'logs/error.log',
level: 'error'
}),
new winston.transports.File({
filename: 'logs/combined.log'
})
]
});
2.8.2 メトリクス・アラート
// libs/monitoring/src/metrics.ts
export const metrics = {
// ビジネスメトリクス
propertyViews: new Counter('property_views_total'),
inquirySent: new Counter('inquiry_sent_total'),
userRegistrations: new Counter('user_registrations_total'),
// 技術メトリクス
apiDuration: new Histogram('api_duration_seconds'),
dbQueryDuration: new Histogram('db_query_duration_seconds'),
cacheHitRate: new Gauge('cache_hit_rate'),
};
2.9 データマイグレーション戦略
2.9.1 Prisma マイグレーション
// packages/database/prisma/migrations/
// ゼロダウンタイム原則
// 1. カラム追加 → 2. データ移行 → 3. 旧カラム削除
// の3段階でマイグレーション実行
2.9.2 シードデータ
// packages/database/src/seed/production.ts
// 本番環境用の基本データ
export const productionSeed = {
amenities: [
{ code: 'wifi', nameJa: 'Wi-Fi', nameEn: 'Wi-Fi' },
{ code: 'aircon', nameJa: 'エアコン', nameEn: 'Air Conditioning' },
// ... 50種類の設備データ
],
faqs: [
// 8言語 × 20カテゴリ × 10質問 = 1600件のFAQデータ
]
};
3. Claude Code指示時の重要ポイント
3.1 開発優先順位
Phase 1 (MVP): 4ヶ月
├── 認証システム（多要素認証含む）
├── 物件基本管理（手動登録）
├── 検索・詳細表示
├── 多言語対応（8言語）
└── 基本的な問い合わせ機能
Phase 2 (差別化機能): 3ヶ月
├── AI Chat（LINE Bot統合）
├── 外部サイト連携
├── PDF自動取込
├── 地図機能強化
└── 分析ダッシュボード
Phase 3 (最適化): 2ヶ月
├── パフォーマンス最適化
├── 高度な検索機能
├── 通知システム強化
└── 運用ツール整備
3.2 技術的制約・注意事項
| 項目 |
制約・注意点 |
| 外部API制限 |
Google Maps: 月間40,000リクエスト制限 |
| スクレイピング |
robots.txt遵守、レート制限（1req/sec） |
| ファイルアップロード |
画像: 10MB、PDF: 50MB上限 |
| データベース |
PostgreSQL 15+、PostGIS拡張必須 |
| メモリ使用量 |
NODE_OPTIONS="--max-old-space-size=4096" |
3.3 品質基準
// package.json scripts
{
"type-check": "tsc --noEmit",
"lint": "eslint . --ext .ts,.tsx",
"lint:fix": "eslint . --ext .ts,.tsx --fix",
"format": "prettier --write .",
"test:unit": "vitest run",
"test:e2e": "playwright test",
"test:coverage": "vitest run --coverage",
"build": "vite build",
"preview": "vite preview"
}
4. 推奨実装順序
4.1 Week 1-2: プロジェクトセットアップ
- モノレポ構成（pnpm workspace）
- TypeScript設定（strict mode）
- ESLint + Prettier設定
- Tailwind + LINE Design Language設定
- データベース設計・マイグレーション
4.2 Week 3-6: 認証・基本機能
- 認証システム（JWT + 多要素認証）
- ユーザー管理（プロフィール、言語設定）
- 物件手動登録機能
- 基本検索・一覧表示
4.3 Week 7-10: 検索・表示機能
- 高度検索機能
- 地図統合
- 物件詳細ページ
- お気に入り機能
4.4 Week 11-14: コミュニケーション機能
- 問い合わせシステム
- 通知機能
- 入居申込みフロー
- 大家ダッシュボード
4.5 Week 15-16: 多言語対応・テスト
- 8言語リソース整備
- 自動翻訳統合
- E2Eテスト整備
- パフォーマンステスト
この詳細仕様により、Claude Codeに対して具体的で実装可能な指示を出すことができます。