Merge pull request #17 from msmsrep/dev

紹介ページとユーザーガイドを3つの配布方法に合わせて更新する

Author: msmsrep

.github/workflows/release.yml

@@ -1,6 +1,6 @@
 # リリース（タグ v1.2.3 の push で起動）
 #   1. ビルドとテスト（ci.yml）
-#   2. 自己完結版 ZIP（win-x64 / linux-x64）を作って GitHub Release に添付する（build/Pack-Zip.ps1）
+#   2. 自己完結版 ZIP（win-x64 / linux-x64）とサンプルCSVの ZIP を作って GitHub Release に添付する（build/Pack-Zip.ps1）
 #   3. コンテナイメージ（linux/amd64・linux/arm64）を GHCR に登録する（Dockerfile）
 # v1.2.3-rc.1 のようなプレリリースのタグは Release をプレリリース扱いにし、イメージに latest を付けない
 # MSIX（Microsoft Store）は署名と提出が手作業なので対象外（docs-dev/MsixRelease.md）

Readme.md

@@ -5,6 +5,7 @@ APIが同一オリジンでWebクライアントも配信します。
 
 - **紹介ページ（画面写真でひととおり見る）**: [Parallel Factory MES の紹介](https://msmsrep.github.io/ParallelFactoryMES/intro.html)
 - **ユーザーガイド（操作マニュアル）**: [ユーザーガイド](https://msmsrep.github.io/ParallelFactoryMES/)
+- **入手**: [Microsoft Store](https://apps.microsoft.com/detail/9p9fqjzh23hc?hl=ja-JP&gl=JP)（1台で試す）／[ZIP](https://github.com/msmsrep/ParallelFactoryMES/releases/latest)（Windows / Linux）／Docker `ghcr.io/msmsrep/parallelfactorymes`
 
 ## ライセンス
 
@@ -94,12 +95,14 @@ DBファイル（`mesapp.db`）とJWT署名鍵（`jwt-signing.key`）は**デー
 
 書き方の見本として、そのまま取り込めるサンプルデータ一式を [`samples/master-csv/`](samples/master-csv/) に置いています
 （ファイル名の番号順に取り込むと、製造指図から出荷まで試せる状態になります）。
+ZIPにしたものを Releases に添付しています（[マスタ](https://github.com/msmsrep/ParallelFactoryMES/releases/latest/download/samples-master-csv.zip)・[実績](https://github.com/msmsrep/ParallelFactoryMES/releases/latest/download/samples-actual-csv.zip)）。
 
 ## 配布・本番相当の実行
 
 ビルド済みのものを使う場合（手順の詳細は [管理者向け運用](docs/operations.md)）:
 
-- **ZIP（自己完結版・.NET不要）**: [Releases](https://github.com/msmsrep/ParallelFactoryMES/releases) から
+- **Microsoft Store 版（1台で試す）**: [Microsoft Store](https://apps.microsoft.com/detail/9p9fqjzh23hc?hl=ja-JP&gl=JP) からインストールします。サーバー不要で、ほかの端末からは接続できません
+- **ZIP（自己完結版・.NET不要）**: [Releases](https://github.com/msmsrep/ParallelFactoryMES/releases/latest) から
   `ParallelFactoryMES-<版>-win-x64.zip` / `-linux-x64.zip` を取得し、展開して `start.cmd`（Linux は `sh start.sh`）で起動します（ポート 5000）
 - **Docker（amd64 / arm64）**: `docker compose up -d` で起動します（ポート 8080。PostgreSQL 付きは `compose.postgres.yaml`）
 

Spec.md

@@ -93,6 +93,7 @@
 改訂92: 2026-09-21（**3プロバイダー分のマイグレーションをまとめて追加するスクリプト**（`scripts/Migrations.ps1`）を用意し、4章の将来拡張から「3プロバイダー分を作る運用の省力化」を外した。1つのマイグレーションで3プロバイダーを兼ねる形は、列の型がプロバイダーごとに生成されるため手修正が毎回必要になり採らない。あわせて、マイグレーションに生SQLを書かない規約を4章に加えた）
 改訂93: 2026-09-22（7.8節：ストア提出で「予約していない表示名」として弾かれたため、MSIXの表示名をマニフェストへの直書きから`build/msix-identity.json`の`DisplayName`に移し、予約名と一致させる旨を明記）
 改訂94: 2026-09-22（**Zip配布とDocker配布を実装した**（7.2節。Phase 10完了）。自己完結版zip（win-x64 / linux-x64）とコンテナイメージ（linux/amd64・arm64、GHCR）を、タグpushでGitHub Actionsから公開する。7.7節のDocker構成のバックアップをボリューム退避の手順に改め、9章の構成を実配置に合わせた。あわせて、Linuxで`~/.local/share`が未作成のときデータ保存先がカレントディレクトリになる不具合を直した（4章`MesAppDataDirectory`））
+改訂95: 2026-09-22（7.2節：リリースにサンプルCSVのzipを添付することにした。紹介ページとユーザーガイドを3つの配布方法（Microsoft Store・zip・Docker）に合わせて更新）
 参考: みんなのMES（min-MES） https://min-mes.com/ / OSS: https://github.com/mihatama/open-mes-project
 
 ---
@@ -573,7 +574,7 @@ DBはバックエンド（MesApp.Api）のみが保持し、既定はSQLiteと
 
 ### 7.2 配布形態
 - **Windows Store（MSIX・単独PC向け）**: MesApp.Desktop。API・DB・Webクライアントを1つのパッケージに同梱し、1台のPCで完結して動作させる（7.8節）
-- **Zip配布**: MesApp.Api（Webクライアント静的ファイル同梱）を**自己完結版**（win-x64 / linux-x64。配布先に.NETランタイム不要）で発行してzip化し、社内サーバー等に手動配置できるようにする（`build/Pack-Zip.ps1`）。起動スクリプト（`start.cmd` / `start.sh`）・LICENSE・対応ソースの所在（コミット）を同梱する。zipはUnixの実行権限を保持しないため、`start.sh`が起動前に実行権限を付ける
+- **Zip配布**: MesApp.Api（Webクライアント静的ファイル同梱）を**自己完結版**（win-x64 / linux-x64。配布先に.NETランタイム不要）で発行してzip化し、社内サーバー等に手動配置できるようにする（`build/Pack-Zip.ps1`）。起動スクリプト（`start.cmd` / `start.sh`）・LICENSE・対応ソースの所在（コミット）を同梱する。zipはUnixの実行権限を保持しないため、`start.sh`が起動前に実行権限を付ける。リリースにはサンプルCSVのzip（`samples-master-csv.zip` / `samples-actual-csv.zip`）も添付する（リポジトリを持たないzip・ストア版の利用者が取込画面にそのまま渡せるよう。名前に版数を入れず`releases/latest/download/`の固定リンクで案内する）
 - **Docker配布**: MesApp.Api（Webクライアント同梱）をコンテナイメージ化し（`Dockerfile`。linux/amd64・linux/arm64）、`ghcr.io/msmsrep/parallelfactorymes`で公開する。非rootで動かし、DB（SQLite）とJWT署名鍵は`/data`ボリューム（`MESAPP_DATA_DIR=/data`）に置く。`TZ`の既定は`Asia/Tokyo`（業務日付の境界に効くため）。起動例として`compose.yaml`（SQLite）と`compose.postgres.yaml`（PostgreSQL）を置く。HTTPSはコンテナでは扱わず前段のリバースプロキシで終端する
 - **リリースの自動化**: タグ`vX.Y.Z`のpushでGitHub Actions（`.github/workflows/release.yml`）がビルド・テストの後にzipをGitHub Releaseへ添付し、イメージをGHCRへ登録する。版数はタグから取り（`-p:Version`）、既定値は`Directory.Build.props`。`-`を含むタグはプレリリース扱いにしてイメージに`latest`を付けない。MSIXは署名とストア提出が手作業のため対象外。push・PRごとのビルドとテストは`.github/workflows/ci.yml`（Windows。MesApp.Desktopを含むため）
 - MesApp.Client.Webは必ずMesApp.Apiが配信する（別配信は行わない。APIと同一オリジンに置き、CORSや配置の組み合わせを増やさないため）

build/Pack-Zip.ps1

@@ -5,6 +5,7 @@
 .DESCRIPTION
     自己完結版なので配布先に .NET / ASP.NET Core Runtime は要らない。
     ZIP には起動スクリプト（start.cmd / start.sh）・LICENSE・ソースの所在（AGPL-3.0 の対応ソース）を同梱する。
+    あわせて、取込画面に渡せるサンプルCSVのZIP（samples-master-csv.zip / samples-actual-csv.zip）を作る。
 
     ZIP は Unix の実行権限を保持しないため、start.sh が起動前に MesApp.Api へ実行権限を付ける
     （利用者は `sh start.sh` で起動する）。
@@ -121,3 +122,13 @@ Parallel Factory MES $Version（$rid・自己完結版）
     Remove-Item $stage -Recurse -Force
     Write-Host "作成: $zip ($([math]::Round((Get-Item $zip).Length / 1MB, 1)) MB)"
 }
+
+# --- 4. サンプルCSV -------------------------------------------------------------------------
+# ZIP版・ストア版の利用者はリポジトリを持たないため、取込画面にそのまま渡せる形で添付する。
+# 版数を名前に入れず、releases/latest/download/<名前> の固定リンクで案内できるようにする
+foreach ($kind in 'master-csv', 'actual-csv') {
+    $zip = Join-Path $OutputDirectory "samples-$kind.zip"
+    if (Test-Path $zip) { Remove-Item $zip -Force }
+    [IO.Compression.ZipFile]::CreateFromDirectory((Join-Path $repoRoot "samples/$kind"), $zip)
+    Write-Host "作成: $zip"
+}

docs/getting-started.md

@@ -9,35 +9,67 @@ next_url: basics.html
 next_title: 画面構成と共通操作
 ---
 
+## 入手方法を選ぶ
+
+| 方法 | 向いている使い方 | 入手先 | 開くURL |
+|---|---|---|---|
+| Microsoft Store 版 | 1台のPCで機能を試す・手順を検証する（ほかの端末からは接続できません） | [Microsoft Store](https://apps.microsoft.com/detail/9p9fqjzh23hc?hl=ja-JP&gl=JP) | アプリの画面がそのまま開きます |
+| ZIP（Windows / Linux） | 社内LANのサーバーに置き、現場の端末からブラウザで使う | [GitHub Releases](https://github.com/msmsrep/ParallelFactoryMES/releases/latest) | `http://<サーバー>:5000` |
+| Docker（amd64 / arm64） | 同上。コンテナで動かす | `ghcr.io/msmsrep/parallelfactorymes` | `http://<サーバー>:8080` |
+| ソースから動かす | 開発・改造 | [GitHub](https://github.com/msmsrep/ParallelFactoryMES) | `http://localhost:5288` |
+
+どの方法も無償で、アクティベーションやライセンスキーは不要です。ソースから動かす場合を除き、.NET のインストールも要りません。
+
 ## 利用に必要なもの
 
 | 項目 | 内容 |
 |---|---|
-| サーバー | .NET 10 SDK（実行のみなら ASP.NET Core 10 ランタイム）がインストールされたPC 1台 |
+| サーバー | Windows / Linux（x64）のPC 1台、または Docker が動く環境（amd64 / arm64）。Store 版は Windows 10（2004 以降）/ 11 |
 | データベース | 不要。既定ではSQLiteのファイル（`mesapp.db`）が自動生成されます。PostgreSQL / SQL Server も使えます（[管理者向け運用](operations.html#database)） |
 | 利用端末 | モダンブラウザ（Chrome / Edge など）。専用アプリのインストールは不要です |
 | ネットワーク | 端末からサーバーのURLにアクセスできること |
 
-アクティベーションやライセンスキーは不要です。サーバーにアクセスできる端末はすべて利用できます。
+## 起動する
+
+### Microsoft Store 版
+
+[Microsoft Store](https://apps.microsoft.com/detail/9p9fqjzh23hc?hl=ja-JP&gl=JP) からインストールし、スタートメニューの **Parallel Factory MES** を開きます。
+初期管理者は自動で作られ、ユーザー名と初期パスワードが画面の上に表示されます（下の「初期管理者アカウントを作る」は不要です）。
+
+### ZIP
+
+<ol class="steps">
+<li><a href="https://github.com/msmsrep/ParallelFactoryMES/releases/latest">Releases</a> から <code>ParallelFactoryMES-&lt;版&gt;-win-x64.zip</code>（Linux は <code>-linux-x64.zip</code>）をダウンロードして展開します。</li>
+<li>Windows は <strong>start.cmd</strong> をダブルクリック、Linux は <code>sh start.sh</code> を実行します。</li>
+<li>ブラウザで <code>http://localhost:5000</code> を開きます。</li>
+</ol>
 
-## サーバーを起動する
+<div class="warn">
+<p>Windows で「WindowsによってPCが保護されました」と表示された場合は、展開する前にZIPファイルのプロパティを開き、<strong>許可する</strong>にチェックを入れてから展開し直してください（<a href="troubleshooting.html#install">困ったときは</a>）。</p>
+</div>
 
-開発・動作確認用は、リポジトリのルートで次を実行します。
+### Docker
 
 ```bash
-dotnet run --project src/MesApp.Api
+docker run -d -p 8080:8080 -v mesapp-data:/data ghcr.io/msmsrep/parallelfactorymes
 ```
 
-既定では `http://localhost:5288` で起動します。ポートを変えたい場合は次のようにします。
+ブラウザで `http://localhost:8080` を開きます。`-v mesapp-data:/data` を付けないと、コンテナを作り直したときにデータが消えます。
+PostgreSQL と一緒に動かす場合は[管理者向け運用](operations.html#docker)を参照してください。
+
+### ソースから動かす（開発用）
+
+.NET 10 SDK を入れ、リポジトリのルートで次を実行します。既定では `http://localhost:5288` で起動します。
 
 ```bash
-dotnet run --project src/MesApp.Api --urls http://localhost:5210
+dotnet run --project src/MesApp.Api
 ```
 
-複数PCで使う本番相当の配置手順は[管理者向け運用](operations.html)を参照してください。
+同じLAN内の他のPCから使う場合の設定（ポート・ファイアウォール・HTTPS）は[管理者向け運用](operations.html)を参照してください。
 
 <div class="note">
-<p>データベースファイルと署名鍵は<strong>データ保存先</strong>（既定 <code>%LOCALAPPDATA%\ParallelFactoryMES</code>）に自動生成されます。データベースの作成作業は不要です。</p>
+<p>データベースファイルと署名鍵は<strong>データ保存先</strong>に自動生成されます。データベースの作成作業は不要です。
+保存先は既定で <code>%LOCALAPPDATA%\ParallelFactoryMES</code>（Linux は <code>~/.local/share/ParallelFactoryMES</code>、Docker は <code>/data</code>）です。</p>
 </div>
 
 ## 初期管理者アカウントを作る
@@ -98,3 +130,8 @@ dotnet run --project src/MesApp.Api --urls http://localhost:5210
 
 業務を始めるにはマスタ登録が必要です。特に **工程 → 品目 → 工順（BOP）** の順で登録しないと
 製造指図を工程展開できません。[マスタ管理](masters.html)へ進んでください。
+
+まず動きを試したい場合は、サンプルデータを入れると製造指図から出荷まで操作できる状態になります。
+[マスタのサンプル](https://github.com/msmsrep/ParallelFactoryMES/releases/latest/download/samples-master-csv.zip)を
+**マスタ管理**の「ZIPで一括取込」で、続けて[実績のサンプル](https://github.com/msmsrep/ParallelFactoryMES/releases/latest/download/samples-actual-csv.zip)を
+**管理 → 実績CSV取込**の「ZIPで一括取込」で取り込みます（[マスタ管理のCSV](masters.html#csv)）。

docs/index.md

@@ -61,9 +61,7 @@ next_title: 導入と初期設定
 | 出荷 | 出荷管理 | 物流・倉庫 | [物流・在庫管理](logistics.html) |
 | 設備・治工具 | 設備保全／治工具管理 | 設備保全 | [設備保全・治工具](maintenance.html) |
 
-## このバージョンでできること・できないこと
-
-**利用できます**
+## このバージョンでできること
 
 - 生産管理（製造指図・工程展開・進捗）
 - 製造実行（差立・段取り・チェックリスト・実績・トラブル報告）
@@ -73,10 +71,7 @@ next_title: 導入と初期設定
 - 設備保全（稼働記録・保全計画／指示／実績・手順書）と治工具寿命管理
 - 帳票・ラベル出力、バーコード／QRスキャン
 - データベースは SQLite（既定）・PostgreSQL・SQL Server から選択
-
-**まだ利用できません**
-
-- Docker イメージ・Zip パッケージでの配布
+- 配布は Microsoft Store 版（1台で試す）・ZIP（Windows / Linux）・Docker の3通り（[導入と初期設定](getting-started.html)）
 
 <div class="note">
 <p><strong>用語やステータスの意味を調べたいとき</strong>は<a href="reference.html">リファレンス</a>を、