{"id":15678001,"url":"https://github.com/ytake/cqrs-app-sample","last_synced_at":"2025-05-07T01:48:47.841Z","repository":{"id":39791795,"uuid":"148154680","full_name":"ytake/cqrs-app-sample","owner":"ytake","description":"PHP(Laravel) / ES+CQRS Sample Application","archived":false,"fork":false,"pushed_at":"2023-02-01T22:26:46.000Z","size":404,"stargazers_count":12,"open_issues_count":4,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-25T20:22:44.968Z","etag":null,"topics":["cqrs-es","elasticsearch","kafka","laravel","mysql","php"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ytake.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-09-10T12:51:28.000Z","updated_at":"2022-08-28T14:25:34.000Z","dependencies_parsed_at":"2024-10-23T13:27:55.048Z","dependency_job_id":null,"html_url":"https://github.com/ytake/cqrs-app-sample","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ytake%2Fcqrs-app-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ytake%2Fcqrs-app-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ytake%2Fcqrs-app-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ytake%2Fcqrs-app-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ytake","download_url":"https://codeload.github.com/ytake/cqrs-app-sample/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242884319,"owners_count":20201107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cqrs-es","elasticsearch","kafka","laravel","mysql","php"],"created_at":"2024-10-03T16:14:48.632Z","updated_at":"2025-03-10T16:31:28.233Z","avatar_url":"https://github.com/ytake.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CQRS Application Sample\n\nPHPを使って理解しやすいようなサンプルにしています。  \n実際に実践する場合は無理にPHPだけではやらずに適材適所な言語などを組み合わせてください。\n\n## Required \n\nPHP(Laravel), Apache Kafka(\u0026 zookeeper), MySQL、Elasticsearch\n\n### Apache Kafka\n\nrecommended [confluent platform](https://www.confluent.jp/)\n\n## 要件例\n\nいくつかキーワードを投稿して、そのキーワードを見れるのはもちろんなんですが、  \nワードクラウドみたいなものを実現したいんですよね！  \n\nキーワードはキーワードそのものと識別可能なユーザー情報、ここでは例としてuserIDだけにしましょう。  \nワードクラウドライクなものはどう実現したらよいでしょう？  \nキーワードとはまた違う概念になりそう（コール数の概念が加わります）で、Elasticsearchを使えば実現できそうです。\n\n## 処理の流れ\n\n### Command + Event Sourcing\n\n - PHP（フォーム） \n - MySQL(スナップショット/実際には他のものを利用してください)\n - Apache Kafka\n \n### 読み込みモデル更新処理\n\n - ReadModel Handler(Laravel CLI)\n - Elasticsearch\n\nsupervisorやsystemdで動かすと良いでしょう。\n\n### Query\n\n - Elasticsearch\n - PHP\n\n## なぜLaravelのQueueを使わないのですか？\n\nこの処理だけではおそらく実現できますが、  \n現実問題として同じQueueの中身を他のプロセスが処理するケースもあるでしょう。  \n例えばブログを投稿した、をトリガーにキーワードの内容をpublishしたとします。\n\nElasticsearchにinsertする以外にRDBMSに正規化して持たせたい場合にどうすればいいでしょうか？  \n同じプロセスで処理する場合は2フェーズコミットになりそうです。  \nこの場合、それぞれを担当するプロセスに分割した方は良さそうです。  \n必要とするのはラウンドロビンではない方法が望ましいです。  \n\nこれはフレームワークの範囲を超えているので、専用のミドルウェアを使った方が良いでしょう。\n\n## Run\n\n### 1. Setup\n\nアプリケーションを動かす前に実行してください\n\n```bash\n$ docker-compose up -d\n# 各ミドルウェアはコンテナですが起動に時間がかかります。\n# しばらくお待ちください。\n# これらのミドルウェアを使う場合、商用ではコンテナではなく物理的HDDで動かしましょう。\n$ docker-compose exec php composer install --prefer-dist --no-interaction \u0026\u0026 composer app-setup\n$ docker-compose exec php /var/www/html/artisan migrate\n```\n\n### 2. Elasticsearch\n\ntokenizerなどを設定します。\n\n```bash\n$ curl -X PUT 'http://localhost:9200/words' -H 'Content-Type: application/json' -d @dataset/mapping.json\n$ curl -X POST 'http://localhost:9200/_bulk?pretty' -H 'Content-Type: application/json' --data-binary @dataset/words.json\n```\n\n### 3. Topic Subscribe\n\n```bash\n$ docker-compose exec php /var/www/html/artisan sample:subscribe_es\n$ docker-compose exec php /var/www/html/artisan sample:subscribe_mysql\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytake%2Fcqrs-app-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fytake%2Fcqrs-app-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fytake%2Fcqrs-app-sample/lists"}