Skip to content

Commit 6f081e8

Browse files
committed
chore: Update README.md
1 parent 2ed0b58 commit 6f081e8

1 file changed

Lines changed: 17 additions & 6 deletions

File tree

README.md

Lines changed: 17 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,10 +19,10 @@ The app targets anyone interested in the certification, regardless of age or exp
1919

2020
**Example User / ユーザー例**
2121

22-
Tanaka-san, 28, office worker.
23-
Decided to take the World Heritage Certification Exam (Level 2).
24-
During her commutation, she wants to quickly look up heritage sites on her phone,
25-
but the official textbook is too heavy to carry around.
22+
Tanaka-san, 28, office worker.
23+
Decided to take the World Heritage Certification Exam (Level 2).
24+
During her commutation, she wants to quickly look up heritage sites on her phone,
25+
but the official textbook is too heavy to carry around.
2626
She needs a tool where she can check the location on a map along with the category and year of inscription — all in one place.
2727

2828
田中さん、28歳、会社員。
@@ -37,8 +37,19 @@ She needs a tool where she can check the location on a map along with the catego
3737
- Algolia (Full-text search / 全文検索)
3838
- Koyeb (Production hosting / 本番ホスティング)
3939

40+
## Challenge & Solution / 課題と解決策
41+
### 検索の「ストレス」を排除し、「学び」を支える
42+
43+
Challenge / 課題 (Algoliaを選んだ理由):
44+
Japanese search faces challenges with "notation fluctuations" (e.g., presence of middle dots or long vowels). Standard database queries often fail if even one character is different.
45+
日本語には「中黒(・)」や「長音(ー)」の有無など、表記の揺れが多く、通常のDB検索では「一文字違うだけでヒットしない」というストレスが発生します。
46+
47+
Solution(Why I choose Algolia) / 解決 (Algoliaを採用した理由):
48+
So, by implementing Algolia, the system automatically handles these fluctuations. This ensures users find the information they need instantly without being penalized for minor input variations.
49+
なので全文検索エンジンを採用し、表記の揺れをシステム側で自動吸収するようにしました。ユーザーは細かい入力を気にせず、情報に最短でたどり着けます。
50+
4051
## Building Data in Production / 本番データ構築
41-
Run the follwoing commands from the Koyeb console.
52+
Run the following commands from the Koyeb console.
4253
以下のコマンドをKoyebのコンソールから実行をしてください。
4354

4455
### Initial / Full rebuild / 初回・フル再構築
@@ -126,5 +137,5 @@ Flow: ListQuery → Domain(Entity) → DTO → ViewModel → Presentation
126137
| Backend API / バックエンドAPI | https://github.com/zigzagdev/world-heritage-api |
127138

128139
## Roadmap / 今後の予定
129-
Currently, the app is available in English only. Japanese language support is planned for a future release.
140+
Currently, the app is available in English only. Japanese language support is planned for a future release.
130141
現在、英語だけの表記となっておりますが、次のフェーズにて、日本語訳の対応もする予定です。

0 commit comments

Comments
 (0)