Skip to content

Commit a2608d2

Browse files
committed
CLAUDE.mdにデータ統合問題のトラブルシューティングセクションを追加
以下の内容を追加: - データ統合問題に関するo3 MCPクエリテンプレート - Dojoが地図に表示されない場合の調査・修正手順 - dojo2dojo.csvのよくあるマッピング問題と解決方法 - 「さが」が表示されない問題の調査で得た知見を文書化
1 parent 1fe8dcf commit a2608d2

File tree

1 file changed

+54
-1
lines changed

1 file changed

+54
-1
lines changed

CLAUDE.md

Lines changed: 54 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -152,9 +152,62 @@ mcp__o3__o3-search "GitHub Actions Pages deploy Jekyll JEKYLL_ENV production 202
152152
2. **深堀り**: 使用している技術スタック(Jekyll 4.3, Ruby 3.4, Geolonia Maps)を含めて再検索
153153
3. **検証**: 公式ドキュメントや最新のGitHub Issuesを確認
154154

155+
#### データ統合問題
156+
```bash
157+
# 複数データソース統合時の名前マッチング問題
158+
mcp__o3__o3-search "GeoJSON data integration name mapping mismatch multiple sources 2025"
159+
160+
# CSVベースのマッピングファイル管理
161+
mcp__o3__o3-search "CSV mapping file data integration best practices version control 2025"
162+
163+
# データ不整合のデバッグ手法
164+
mcp__o3__o3-search "multi-source data integration debugging missing records troubleshooting 2025"
165+
```
166+
155167
### 結果の批判的評価
156168
o3の検索結果を使用する際は必ず:
157169
1. 情報の日付を確認(2024年以降の情報を優先)
158170
2. Jekyll/Ruby/APIのバージョン互換性を確認
159171
3. DojoMapの制約条件(静的サイト、GitHub Pages)と照合
160-
4. 小規模な変更でテストしてから本実装
172+
4. 小規模な変更でテストしてから本実装
173+
174+
## トラブルシューティング
175+
176+
### データ統合で特定のDojoが地図に表示されない場合
177+
178+
この問題は主にdojo2dojo.csvのマッピング不一致が原因です。以下の手順で調査・修正してください:
179+
180+
1. **データソースの確認**
181+
```bash
182+
# Clubs APIのデータ確認
183+
grep "対象Dojo名" dojos_earth.json
184+
185+
# Japan APIのデータ確認
186+
grep "対象Dojo名" dojos_japan.json
187+
```
188+
189+
2. **マッピングファイルの確認**
190+
```bash
191+
# dojo2dojo.csvでのマッピング確認
192+
grep "対象Dojo名" dojo2dojo.csv
193+
```
194+
195+
3. **問題の特定と修正**
196+
- Clubs APIでの登録名と完全一致するようにdojo2dojo.csvを修正
197+
- 例:「Coderdojo Saga」vs「Saga」のような不一致を修正
198+
199+
4. **GeoJSONの再生成**
200+
```bash
201+
bundle exec rake upsert_dojos_geojson
202+
```
203+
204+
5. **結果の確認**
205+
```bash
206+
grep "対象Dojo名" dojos.geojson
207+
```
208+
209+
### よくあるマッピング問題
210+
- **プレフィックスの不一致**: "Coderdojo XXX" vs "XXX"
211+
- **スペースの不一致**: "CoderDojo" vs "Coderdojo"
212+
- **記号の不一致**: "@" や "、" の有無
213+
- **日本語・英語の混在**: 漢字・ひらがな・カタカナ・ローマ字の不一致

0 commit comments

Comments
 (0)