Skip to content

chore: delete redundant files #416

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zigzagdev merged 2 commits into from
Apr 13, 2026
Merged

chore: delete redundant files #416

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0855eee
chore: delete redundant files
zigzagdev Apr 13, 2026
5480ce3
Merge branch 'main' into chore/add-architecture-image
zigzagdev Apr 13, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
145 changes: 77 additions & 68 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,71 +1,82 @@
# World Heritage API
# World Heritage API / 世界遺産 API

Backend API for a world heritage study app targeting users preparing for the World Heritage Certification exam.
世界遺産検定を目指すユーザー向けの学習アプリのバックエンドAPIです。

Fetches and manages UNESCO World Heritage data, providing APIs for search, listing, and detail retrieval.
UNESCOの世界遺産データを取得・管理し、検索・一覧・詳細取得のAPIを提供します。

## Persona / ペルソナ

Persona
This API powers a study app for people preparing for the World Heritage Certification Exam.
Instead of carrying a heavy textbook, users can quickly look up heritage sites — their overview, location, and classification — from their smartphone or PC. The app targets anyone interested in the certification, regardless of age or experience.
Example User
Tanaka-san, 28, office worker
Decided to take the World Heritage Certification Exam (Level 2). During the commute, she wants to quickly look up heritage sites on her phone, but the official textbook is too heavy to carry around. 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.
このAPIは、世界遺産検定を受験する人向けの学習アプリを支えています。

## Tech Stack
Instead of carrying a heavy textbook, users can quickly look up heritage sites — their overview, location, and classification — from their smartphone or PC.
重いテキストを持ち歩かなくても、スマートフォンやPCから遺産の概要・場所・分類をすぐに調べられます。

- PHP / Laravel
- MySQL
- Algolia (Full-text search)
- Koyeb (Production hosting)
The app targets anyone interested in the certification, regardless of age or experience.
年齢や経験を問わず、検定に興味があるすべての人を対象としています。

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

Tanaka-san, 28, office worker.
Decided to take the World Heritage Certification Exam (Level 2).
During her commutation, she wants to quickly look up heritage sites on her phone,
but the official textbook is too heavy to carry around.
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.

## Getting Started
田中さん、28歳、会社員。
世界遺産検定2級の受験を決意。
通勤中にスマホでサッと調べたいけど、公式テキストは重くて持ち歩けない。
地図上の場所・カテゴリー・登録年を一度に確認できるツールを求めている。

## Tech Stack / 技術スタック

- PHP / Laravel
- MySQL (Aiven / クラウドデータベース管理)
- Algolia (Full-text search / 全文検索)
- Koyeb (Production hosting / 本番ホスティング)

## Getting Started / はじめに
```bash
cp .env.example .env
composer install
php artisan key:generate
php artisan migrate
```

## Building Data in Production

Run the following commands from the Koyeb console.

### Initial / Full rebuild

Dumps data from UNESCO and rebuilds the DB and Algolia index.

### Initial / Full rebuild / 初回・フル再構築
```bash
php artisan app:world-heritage-build --force --dump --jp --pretty
```

| Option | Description |
| Option | Description / 説明 |
|---|---|
| `--force` | Allow execution outside local/testing |
| `--dump` | Dump JSON from UNESCO |
| `--jp` | Import Japanese names |
| `--pretty` | Pretty print JSON output |

### Full rebuild including DB and Algolia (with table reset)
| `--force` | Allow execution outside local/testing / ローカル・テスト環境以外での実行を許可 |
| `--dump` | Dump JSON from UNESCO / UNESCOからJSONをダンプ |
| `--jp` | Import Japanese names / 日本語名をインポート |
| `--pretty` | Pretty print JSON output / JSON出力を整形 |

### Full rebuild including DB and Algolia / DBとAlgoliaを含むフル再構築
```bash
php artisan app:world-heritage-build --fresh --jp --pretty --algolia --algolia-truncate --force
```

> ⚠️ `--fresh` drops and recreates all tables. All existing data will be lost.

### Re-import Japanese names only
> :warning: `--fresh` drops and recreates all tables. All existing data will be lost.
> :warning: `--fresh` は全テーブルを削除して再作成します。

### Re-import Japanese names only / 日本語名のみ再インポート
```bash
php artisan world-heritage:import-japanese-names --force
```

## Testing

## Testing / テスト
```bash
./vendor/bin/phpunit ./app
```

## Architecture Overview
## Architecture Overview / アーキテクチャ概要

```
[Browser]
│
Expand All @@ -81,44 +92,42 @@ php artisan world-heritage:import-japanese-names --force
│ │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Presentation Layer │ │
│ │ Controller / FormRequest │ │
│ │ Controller / ViewModel │ │
│ └───────────────────┬──────────────────────────────────┘ │
│ ▲ ViewModel │
│ │ │
│ ┌───────────────────┴───────────────────────────────┐ │
│ │ Application Layer │ │
│ │ ListQuery / UseCase / DTO │ │
│ └───────────────────┬───────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ Domain Layer │ │
│ │ Entity │ │
│ └───────────────────┬───────────────────────────────┘ │
│ │ │
│ ┌───────────┴────────────┐ │
│ │ Write │ Read │
│ ▼ ▼ │
│ ┌───────────────┐ ┌─────────────────┐ │
│ │ Application │ │ Application │ │
│ │ UseCommand │ │ ListQuery │ │
│ └───────┬───────┘ └────────┬────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌───────────────┐ ┌─────────────────┐ │
│ │ Domain Layer │ │ QueryService │ │
│ │ UseCase │ │ DTO │ │
│ │ Entity │ └────────┬────────┘ │
│ │ ValueObject │ │ │
│ │ Repository │ │ │
│ └───────┬───────┘ │ │
│ │ │ │
│ ┌───────▼───────┐ │ │
│ │Infrastructure │ │ │
│ │ Eloquent │ │ │
│ │ Repository │ │ │
│ └───────┬───────┘ │ │
│ │ │ │
└──────────┼───────────────────────┼──────────────────────────┘
│ 一覧 / 詳細取得 │ キーワード検索
▼ ▼
┌─────────┐ ┌───────────┐
│ MySQL │◀─── ID ───│ Algolia │
│ (DB) │ │ (Search) │
└─────────┘ └───────────┘
│ ▼ │
│ ┌───────────────────────────────────────────────────┐ │
│ │ Infrastructure Layer │ │
│ │ Eloquent Repository / QueryService │ │
│ └───────────┬─────────────────────┬─────────────────┘ │
│ │ │ │
└──────────────┼─────────────────────┼────────────────────────┘
│ 一覧 / 詳細取得 │ キーワード検索
▼ ▼
┌─────────┐ ┌───────────┐
│ MySQL │◀─ ID ────│ Algolia │
│ (DB) │ │ (Search) │
└─────────┘ └───────────┘

Flow: ListQuery → Domain(Entity) → DTO → ViewModel → Presentation
流れ： ListQuery → Domain(Entity) → DTO → ViewModel → Presentation
```

## Related Repositories
## Related Repositories / 関連リポジトリ

| Role | Repository |
| Role / 役割 | Repository |
|---|---|
| Frontend | https://github.com/zigzagdev/world-heritage-frontend |
| Backend API | https://github.com/zigzagdev/world-heritage-api |
| Frontend / フロントエンド | https://github.com/zigzagdev/world-heritage-frontend |
| Backend API / バックエンドAPI | https://github.com/zigzagdev/world-heritage-api |
22 changes: 0 additions & 22 deletions src/app/Packages/Features/QueryUseCases/ListQuery/CreateWorldHeritageListQueryCollection.php
View file
Open in desktop

This file was deleted.

29 changes: 0 additions & 29 deletions src/app/Packages/Features/QueryUseCases/ListQuery/UpdateWorldHeritageListQueryCollection.php
View file
Open in desktop

This file was deleted.

Loading