diff --git a/.kiro/specs/blog-feature/tasks.md b/.kiro/specs/blog-feature/tasks.md index 3443cbd..a101250 100644 --- a/.kiro/specs/blog-feature/tasks.md +++ b/.kiro/specs/blog-feature/tasks.md @@ -1,99 +1,96 @@ # Tasks: Blog/Column Feature -## Task 1: Install vitepress-plugin-blog +## Task 1: 記事データローダーを用意する ### Description -ブログプラグインをインストールする +`createContentLoader` で記事一覧データを生成する。 ### Files to modify -- `package.json` +- `docs/blog/posts.data.ts` ### Acceptance criteria -- [ ] `npm install vitepress-plugin-blog` が成功 -- [ ] package.json に依存関係が追加される +- [x] `createContentLoader` で `blog/posts/*.md` を読み込む +- [x] 公開フラグでフィルタリングできる +- [x] 日付降順でソートされる --- -## Task 2: Configure blog plugin in VitePress +## Task 2: 記事一覧ページを作成する ### Description -config.mts に blogPlugin を追加し、テーマを設定する +ブログ一覧ページを作成し、タグでフィルタリングできるようにする。 ### Files to modify -- `docs/.vitepress/config.mts` -- `docs/.vitepress/theme/index.ts` (新規作成) +- `docs/blog/index.md` ### Acceptance criteria -- [ ] blogPlugin が vite.plugins に追加される -- [ ] theme/index.ts で withBlogTheme が設定される -- [ ] 開発サーバーが正常に起動する +- [x] 記事一覧が表示される +- [x] タグフィルタが利用できる --- -## Task 3: Create blog directory structure +## Task 3: ブログディレクトリ構造を作成する ### Description -ブログ用のディレクトリ構造を作成する +ブログの投稿ディレクトリとサンプル記事を作成する。 ### Files to create -- `docs/blog/index.md` - `docs/blog/posts/` (ディレクトリ) +- `docs/blog/posts/2026-01-26-getting-started-with-isms.md` +- `docs/blog/posts/2026-01-27-risk-assessment-tips.md` +- `docs/blog/posts/2026-01-28-what-is-isms.md` ### Acceptance criteria -- [ ] docs/blog/index.md が BlogIndex コンポーネントを使用 -- [ ] docs/blog/posts/ ディレクトリが存在 +- [x] frontmatter が正しく設定されている（blogPost: true） +- [x] 記事一覧ページに表示される +- [x] タグが設定されている --- -## Task 4: Update navigation +## Task 4: ナビゲーションを追加する ### Description -ヘッダーナビとサイドバーにブログを追加する +ヘッダーナビとサイドバーにブログを追加する。 ### Files to modify - `docs/.vitepress/config.mts` ### Acceptance criteria -- [ ] nav に「ブログ」リンクが追加される -- [ ] sidebar に '/blog/' 設定が追加される -- [ ] ヘッダーからブログページにアクセスできる +- [x] nav に「ブログ」リンクが追加される +- [x] sidebar に '/blog/' 設定が追加される --- -## Task 5: Update OGP image generation +## Task 5: OGP画像生成のカテゴリにブログを追加する ### Description -ブログ記事用の OGP 画像生成設定を追加する +OGP 画像生成設定に blog のカテゴリを追加する。 ### Files to modify - `docs/.vitepress/config.mts` ### Acceptance criteria -- [ ] category.byPathPrefix に 'blog' が追加される -- [ ] ブログ記事の OGP 画像が生成される +- [x] category.byPathPrefix に 'blog' が追加される --- -## Task 6: Create sample blog posts +## Task 6: 機能拡張（未完） ### Description -サンプル記事を2本作成する - -### Files to create -- `docs/blog/posts/2026-01-26-getting-started-with-isms.md` -- `docs/blog/posts/2026-01-26-risk-assessment-tips.md` +ブログ機能として未実装の項目を追加する。 ### Acceptance criteria -- [ ] frontmatter が正しく設定されている（blogPost: true） -- [ ] 記事一覧ページに表示される -- [ ] タグが設定されている +- [ ] ページネーション +- [ ] 前後記事ナビゲーション +- [ ] 読了時間表示 +- [ ] RSS/Atom フィード --- -## Task 7: Verify build and functionality +## Task 7: ビルドと動作確認 ### Description -ビルドと機能動作を確認する +ビルドと動作を確認する。 ### Commands - `npm run build` @@ -102,10 +99,7 @@ config.mts に blogPlugin を追加し、テーマを設定する ### Acceptance criteria - [ ] ビルドが成功する - [ ] 記事一覧ページが表示される -- [ ] タグフィルタリングが動作する - [ ] 記事詳細ページが表示される -- [ ] 前後記事へのナビゲーションが動作する -- [ ] OGP 画像が生成される --- @@ -119,11 +113,11 @@ Task 1 → Task 2 → Task 3 → Task 4 → Task 5 → Task 6 → Task 7 | Task | Effort | |------|--------| -| Task 1 | 5 min | +| Task 1 | 10 min | | Task 2 | 15 min | | Task 3 | 10 min | | Task 4 | 10 min | | Task 5 | 5 min | -| Task 6 | 20 min | -| Task 7 | 15 min | -| **Total** | **~80 min** | +| Task 6 | 60 min | +| Task 7 | 20 min | +| **Total** | **~130 min** | diff --git a/.kiro/specs/ogp-generation/tasks.md b/.kiro/specs/ogp-generation/tasks.md index b4ab40d..bf3ce8d 100644 --- a/.kiro/specs/ogp-generation/tasks.md +++ b/.kiro/specs/ogp-generation/tasks.md @@ -72,15 +72,15 @@ export default defineConfig({ ``` ### Acceptance Criteria -- [ ] AC-1.1: og:titleがページごとに自動生成される -- [ ] AC-1.2: og:descriptionがページごとに自動生成される -- [ ] AC-1.3: og:urlがページごとに自動生成される -- [ ] AC-1.4: frontmatterのtitleがog:titleに使用される -- [ ] AC-1.5: frontmatterのdescriptionがog:descriptionに使用される -- [ ] AC-1.6: titleがない場合はサイトデフォルトが使用される -- [ ] AC-2.1: twitter:cardが生成される -- [ ] AC-2.2: twitter:titleが生成される -- [ ] AC-2.3: twitter:descriptionが生成される +- [x] AC-1.1: og:titleがページごとに自動生成される +- [x] AC-1.2: og:descriptionがページごとに自動生成される +- [x] AC-1.3: og:urlがページごとに自動生成される +- [x] AC-1.4: frontmatterのtitleがog:titleに使用される +- [x] AC-1.5: frontmatterのdescriptionがog:descriptionに使用される +- [x] AC-1.6: titleがない場合はサイトデフォルトが使用される +- [x] AC-2.1: twitter:cardが生成される +- [x] AC-2.2: twitter:titleが生成される +- [x] AC-2.3: twitter:descriptionが生成される --- diff --git a/.kiro/specs/ogp-image-generation/tasks.md b/.kiro/specs/ogp-image-generation/tasks.md index a87d1cd..a43e730 100644 --- a/.kiro/specs/ogp-image-generation/tasks.md +++ b/.kiro/specs/ogp-image-generation/tasks.md @@ -1,58 +1,73 @@ # Tasks: OGP画像自動生成 -## Task 1: vitepress-plugin-og-imageのインストール +## Task 1: @nolebase/vitepress-plugin-og-image の導入 ### Description -OGP画像生成用のVitePressプラグインをインストールする。 +OGP画像生成用プラグインを導入する。 ### Commands ```bash -npm install vitepress-plugin-og-image -D +npm install @nolebase/vitepress-plugin-og-image -D ``` ### Acceptance Criteria -- [ ] package.jsonにvitepress-plugin-og-imageが追加される +- [x] package.jsonに`@nolebase/vitepress-plugin-og-image`が追加される --- -## Task 2: OgImagePluginの設定 +## Task 2: buildEnd でOGP画像生成を実行 ### Description -config.mtsにOgImagePluginを設定し、buildEndフックで画像を生成する。 +VitePressの`buildEnd`でOGP画像を生成する。 ### Files to Modify - `docs/.vitepress/config.mts` ### Implementation ```typescript -import { OgImagePlugin } from 'vitepress-plugin-og-image' - -const ogImagePlugin = new OgImagePlugin({ - destDir: '/og', +import { buildEndGenerateOpenGraphImages } from '@nolebase/vitepress-plugin-og-image/vitepress' + +export default defineConfig({ + // ... + async buildEnd(siteConfig) { + await buildEndGenerateOpenGraphImages({ + baseUrl: 'https://isms-guide.com', + category: { + byPathPrefix: [ + { prefix: 'controls', text: '管理策' }, + { prefix: 'requirements', text: '要求事項' }, + { prefix: 'templates', text: 'テンプレート' }, + { prefix: 'glossary', text: '用語集' }, + { prefix: 'about', text: 'サイト情報' }, + { prefix: 'isms/guidelines', text: 'ガイドライン' }, + { prefix: 'isms/policies', text: '方針' }, + { prefix: 'isms/procedures', text: '手順書' }, + { prefix: 'isms/records', text: '記録' }, + { prefix: 'isms/plans', text: '計画書' }, + { prefix: 'isms/registers', text: '台帳' }, + { prefix: 'isms/soa', text: '適用宣言書' }, + { prefix: 'isms/manual', text: 'マニュアル' }, + { prefix: 'blog', text: 'ブログ' }, + ], + }, + maxCharactersPerLine: 12, + svgFontBuffers: [mplus1p], + })(siteConfig) + } }) - -export default withMermaid( - defineConfig({ - // ... 既存設定 - - buildEnd(siteConfig) { - ogImagePlugin.buildEnd(siteConfig) - } - }) -) ``` ### Acceptance Criteria -- [ ] OgImagePluginがインポートされる -- [ ] destDirが'/og'に設定される -- [ ] buildEndフックで画像生成が呼び出される +- [x] buildEndでOGP画像生成が呼び出される +- [x] カテゴリラベルがパスプレフィックスで付与される +- [x] フォントバッファが指定される --- -## Task 3: transformHeadにog:image設定を追加 +## Task 3: transformHead に og:image / twitter:image を追加 ### Description -既存のtransformHead関数にog:imageとtwitter:imageメタタグを追加する。 +ページごとにOGP画像のメタタグを出力する。 ### Files to Modify - `docs/.vitepress/config.mts` @@ -65,12 +80,12 @@ transformHead({ pageData }) { // ... 既存のOGP設定 - // og:image - const ogImageMeta = ogImagePlugin.transformHead({ pageData }) - head.push(...ogImageMeta) + const ogImagePath = pageData.relativePath + .replace(/\.md$/, '.png') + .replace(/([^/]+)\.png$/, 'og-$1.png') + const ogImageUrl = `${siteUrl}/${ogImagePath}` - // twitter:image (og:imageと同じURLを使用) - const ogImageUrl = `${siteUrl}/og/${pageData.relativePath.replace(/\.md$/, '.png').replace(/index\.png$/, 'index.png')}` + head.push(['meta', { property: 'og:image', content: ogImageUrl }]) head.push(['meta', { name: 'twitter:image', content: ogImageUrl }]) return head @@ -78,8 +93,8 @@ transformHead({ pageData }) { ``` ### Acceptance Criteria -- [ ] AC-1.4: og:imageメタタグが設定される -- [ ] AC-1.5: twitter:imageメタタグが設定される +- [x] og:imageメタタグが設定される +- [x] twitter:imageメタタグが設定される --- @@ -97,12 +112,12 @@ npm run build 2. 画像ディレクトリ確認 ```bash -ls -la docs/.vitepress/dist/og/ +ls -la docs/.vitepress/dist | rg '^og-' ``` 3. 画像仕様確認 ```bash -file docs/.vitepress/dist/og/index.png +file docs/.vitepress/dist/og-index.png ``` 4. メタタグ確認 @@ -111,7 +126,7 @@ grep -E 'og:image|twitter:image' docs/.vitepress/dist/index.html ``` ### Expected Output -- `/og/`ディレクトリに各ページのPNG画像が生成される +- ルートや各ディレクトリに `og-*.png` が生成される - 画像サイズは1200x630px - HTMLに`og:image`と`twitter:image`メタタグが含まれる @@ -119,14 +134,14 @@ grep -E 'og:image|twitter:image' docs/.vitepress/dist/index.html - [ ] AC-1.1: OGP画像が自動生成される - [ ] AC-2.1: 画像サイズが1200x630px - [ ] AC-2.2: 画像形式がPNG -- [ ] AC-2.3: 画像が`/og/`ディレクトリに出力される +- [ ] AC-2.3: `og-*.png` が出力される --- ## Implementation Order -1. **Task 1**: プラグインインストール（2分） -2. **Task 2**: OgImagePlugin設定（10分） +1. **Task 1**: プラグイン導入（2分） +2. **Task 2**: buildEnd設定（10分） 3. **Task 3**: transformHead更新（5分） 4. **Task 4**: ビルド検証（10分） diff --git a/.kiro/specs/physical-security-controls/tasks.md b/.kiro/specs/physical-security-controls/tasks.md index 389d7ab..4154134 100644 --- a/.kiro/specs/physical-security-controls/tasks.md +++ b/.kiro/specs/physical-security-controls/tasks.md @@ -2,64 +2,64 @@ ## Phase 1: 管理策ページ作成（境界・入退管理） -- [ ] **Task 1.1**: `docs/controls/a-7-1.md` を作成（物理的セキュリティ境界） +- [x] **Task 1.1**: `docs/controls/a-7-1.md` を作成（物理的セキュリティ境界） - セキュリティゾーンの定義と実装 - 境界の物理的強度、入口管理 - Mermaid によるセキュリティゾーン図 - _Requirements: AC-1.1, AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 1.2**: `docs/controls/a-7-2.md` を作成（物理的入退） +- [x] **Task 1.2**: `docs/controls/a-7-2.md` を作成（物理的入退） - 入退室管理の方法、認証方式 - 訪問者管理、ログ記録 - Mermaid による入退室フロー図 - _Requirements: AC-1.2, AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 1.3**: `docs/controls/a-7-3.md` を作成（オフィス・施設のセキュリティ） +- [x] **Task 1.3**: `docs/controls/a-7-3.md` を作成（オフィス・施設のセキュリティ） - オフィスレイアウトのセキュリティ考慮 - 施設の物理的保護 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ ## Phase 2: 管理策ページ作成（監視・作業管理） -- [ ] **Task 2.1**: `docs/controls/a-7-4.md` を作成（物理的セキュリティの監視） +- [x] **Task 2.1**: `docs/controls/a-7-4.md` を作成（物理的セキュリティの監視） - 監視カメラ、センサー、巡回 - 監視記録の保存 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 2.2**: `docs/controls/a-7-6.md` を作成（セキュリティ領域での作業） +- [x] **Task 2.2**: `docs/controls/a-7-6.md` を作成（セキュリティ領域での作業） - セキュリティエリアでの作業ルール - 立会い、記録 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ ## Phase 3: 管理策ページ作成（装置管理） -- [ ] **Task 3.1**: `docs/controls/a-7-8.md` を作成（装置の設置及び保護） +- [x] **Task 3.1**: `docs/controls/a-7-8.md` を作成（装置の設置及び保護） - 装置の物理的保護 - 環境条件（温度、湿度、電源） - _Requirements: AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 3.2**: `docs/controls/a-7-12.md` を作成（ケーブル配線のセキュリティ） +- [x] **Task 3.2**: `docs/controls/a-7-12.md` を作成（ケーブル配線のセキュリティ） - ケーブル保護、ラベリング - 傍受防止 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 3.3**: `docs/controls/a-7-13.md` を作成（装置の保守） +- [x] **Task 3.3**: `docs/controls/a-7-13.md` を作成（装置の保守） - 保守計画、記録 - 外部保守業者の管理 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ -- [ ] **Task 3.4**: `docs/controls/a-7-14.md` を作成（装置の処分又は再利用） +- [x] **Task 3.4**: `docs/controls/a-7-14.md` を作成（装置の処分又は再利用） - データ消去方法 - 処分・再利用の手順 - _Requirements: AC-1.3, AC-1.4, AC-3.1_ ## Phase 4: ナビゲーション更新 -- [ ] **Task 4.1**: VitePress sidebar 設定を更新 +- [x] **Task 4.1**: VitePress sidebar 設定を更新 - `docs/.vitepress/config.mts` に物理的管理策グループを追加 - _Requirements: AC-2.2_ -- [ ] **Task 4.2**: `docs/controls/index.md` を更新 +- [x] **Task 4.2**: `docs/controls/index.md` を更新 - 物理的管理策セクション（7.1〜7.14）に詳細ページリンクを追加 - 関連テンプレートリンクを追加（存在する場合） - _Requirements: AC-2.1, AC-2.2, AC-2.3_ @@ -106,10 +106,10 @@ graph TD ## Completion Criteria -- [ ] 9つの管理策ページ（A.7.1, A.7.2, A.7.3, A.7.4, A.7.6, A.7.8, A.7.12, A.7.13, A.7.14）が作成されている -- [ ] 各ページに管理策の概要、目的、実施のポイント、実装例、関連管理策が含まれている -- [ ] VitePress sidebar に物理的管理策グループが追加されている -- [ ] 管理策一覧ページから各詳細ページへのリンクが機能する +- [x] 9つの管理策ページ（A.7.1, A.7.2, A.7.3, A.7.4, A.7.6, A.7.8, A.7.12, A.7.13, A.7.14）が作成されている +- [x] 各ページに管理策の概要、目的、実施のポイント、実装例、関連管理策が含まれている +- [x] VitePress sidebar に物理的管理策グループが追加されている +- [x] 管理策一覧ページから各詳細ページへのリンクが機能する - [ ] VitePress ビルドが成功する - [ ] Mermaid 図が正しくレンダリングされる diff --git a/.kiro/specs/site-setup/tasks.md b/.kiro/specs/site-setup/tasks.md index 3c282c5..82cf084 100644 --- a/.kiro/specs/site-setup/tasks.md +++ b/.kiro/specs/site-setup/tasks.md @@ -48,7 +48,7 @@ - footer, outline, docFooter 等の翻訳 - _Requirements: AC-1.1_ -- [ ] **Task 2.8**: ダークモードを確認する +- [x] **Task 2.8**: ダークモードを確認する - VitePress デフォルトのダークモード動作確認 - _Requirements: AC-2.2_ @@ -70,7 +70,7 @@ - 用語集ページの骨格 - _Requirements: AC-1.1_ -- [ ] **Task 3.5**: docs/public/ に静的アセットを配置する +- [x] **Task 3.5**: docs/public/ に静的アセットを配置する - favicon.ico, og-image.png（プレースホルダー） - _Requirements: NFR-7_ diff --git a/.kiro/specs/virtual-organization/tasks.md b/.kiro/specs/virtual-organization/tasks.md index 5bb051e..701a181 100644 --- a/.kiro/specs/virtual-organization/tasks.md +++ b/.kiro/specs/virtual-organization/tasks.md @@ -2,37 +2,37 @@ ## Phase 1: ドキュメント作成 -- [ ] **Task 1.1**: `docs/templates/virtual-organization.md` を作成 +- [x] **Task 1.1**: `docs/templates/virtual-organization.md` を作成 - フロントマター（title, description） - 「このドキュメントについて」セクション - _Requirements: AC-3.2_ -- [ ] **Task 1.2**: 組織概要セクションを作成 +- [x] **Task 1.2**: 組織概要セクションを作成 - 基本情報（名称、業種、規模） - 事業内容 - 経営理念・方針 - _Requirements: AC-1.1, AC-2.2_ -- [ ] **Task 1.3**: 組織構造セクションを作成 +- [x] **Task 1.3**: 組織構造セクションを作成 - 組織図（Mermaid） - 部門・役職一覧（表形式） - ISMS 推進体制 - _Requirements: AC-1.2, AC-2.2_ -- [ ] **Task 1.4**: 拠点情報セクションを作成 +- [x] **Task 1.4**: 拠点情報セクションを作成 - 本社情報 - 開発センター情報 - データセンター情報 - リモートワーク環境 - _Requirements: AC-1.3, AC-2.2_ -- [ ] **Task 1.5**: 情報資産セクションを作成 +- [x] **Task 1.5**: 情報資産セクションを作成 - 情報資産分類表 - 主要システム一覧 - 機密レベル定義 - _Requirements: AC-1.4, AC-2.2_ -- [ ] **Task 1.6**: 物理的環境セクションを作成 +- [x] **Task 1.6**: 物理的環境セクションを作成 - オフィスレイアウト概要 - セキュリティゾーン図（Mermaid） - 入退室管理の概要 @@ -40,13 +40,13 @@ ## Phase 2: カスタマイズガイド -- [ ] **Task 2.1**: 置き換えチェックリストを作成 +- [x] **Task 2.1**: 置き換えチェックリストを作成 - 組織基本情報の置き換え項目 - 拠点情報の置き換え項目 - 組織構造の置き換え項目 - _Requirements: AC-2.1_ -- [ ] **Task 2.2**: 規模別の調整ポイントを作成 +- [x] **Task 2.2**: 規模別の調整ポイントを作成 - 小規模組織（〜50名）向けガイド - 中規模組織（50〜300名）向けガイド - 大規模組織（300名〜）向けガイド @@ -54,16 +54,16 @@ ## Phase 3: ナビゲーション・リンク -- [ ] **Task 3.1**: VitePress sidebar 設定に仮想組織を追加 +- [x] **Task 3.1**: VitePress sidebar 設定に仮想組織を追加 - `docs/.vitepress/config.mts` を更新 - _Requirements: AC-3.1_ -- [ ] **Task 3.2**: テンプレート一覧ページを更新 +- [x] **Task 3.2**: テンプレート一覧ページを更新 - `docs/templates/index.md` に仮想組織への言及を追加 - リンクを追加 - _Requirements: AC-3.1_ -- [ ] **Task 3.3**: フォーク利用ガイドを更新 +- [x] **Task 3.3**: フォーク利用ガイドを更新 - `docs/templates/fork-guide.md` に仮想組織への参照を追加 - 置き換え手順の補足 - _Requirements: AC-2.1_ @@ -117,13 +117,13 @@ graph TD ## Completion Criteria -- [ ] `docs/templates/virtual-organization.md` が作成されている -- [ ] 組織概要、組織構造、拠点情報、情報資産、物理的環境が定義されている -- [ ] Mermaid による組織図・セキュリティゾーン図が含まれている -- [ ] 置き換えチェックリストが含まれている -- [ ] 規模別の調整ポイントが含まれている -- [ ] VitePress sidebar から仮想組織ドキュメントにアクセスできる -- [ ] テンプレート一覧ページから仮想組織ドキュメントへのリンクがある +- [x] `docs/templates/virtual-organization.md` が作成されている +- [x] 組織概要、組織構造、拠点情報、情報資産、物理的環境が定義されている +- [x] Mermaid による組織図・セキュリティゾーン図が含まれている +- [x] 置き換えチェックリストが含まれている +- [x] 規模別の調整ポイントが含まれている +- [x] VitePress sidebar から仮想組織ドキュメントにアクセスできる +- [x] テンプレート一覧ページから仮想組織ドキュメントへのリンクがある - [ ] VitePress ビルドが成功する ## GitHub Issue diff --git a/.kiro/steering/structure.md b/.kiro/steering/structure.md index f739ca5..521d7b8 100644 --- a/.kiro/steering/structure.md +++ b/.kiro/steering/structure.md @@ -28,7 +28,7 @@ isms-guide/ │ ├── guide/ # フォーク・カスタマイズ手順 │ -└── DEVELOPMENT_PLAN.md # 開発計画書 +└── PLAN-EXPORT.md # 開発計画書（エクスポート） ``` ## Site URL Design @@ -54,8 +54,8 @@ isms-guide/ ### 相互リンク設計 -- テンプレート → 解説: 見出し内にインラインリンク（例: `## 3. [リスクアセスメント](/requirements/6-1-2)プロセス`） -- 解説 → テンプレート: 「関連テンプレート」セクションにリンク一覧 +- テンプレート → 解説: 見出し直下の「関連」行でリンク（例: `> 関連: [6.1.2](/requirements/6-1-2)`） +- 解説 → テンプレート: 「関連テンプレート」行にリンク一覧 ## Fork Usage Image @@ -80,9 +80,9 @@ isms-guide/ ### Files -- ファイル名: `kebab-case`（例: `risk-assessment.md`） -- 箇条番号を含む場合: `6-1-2-risk-assessment.md` -- 管理策番号を含む場合: `a-5-23-cloud-security.md` +- ファイル名: `kebab-case`（例: `risk-assessment-procedure.md`） +- 箇条番号を含む場合: `6-1-2.md` +- 管理策番号を含む場合: `a-5-23.md` ### Directories diff --git a/.kiro/steering/tech.md b/.kiro/steering/tech.md index 8da206c..0566dfb 100644 --- a/.kiro/steering/tech.md +++ b/.kiro/steering/tech.md @@ -29,7 +29,7 @@ | 項目 | 技術 | |------|------| | ホスティング | Cloudflare Pages | -| ドメイン | isms-guide.jp（取得予定） | +| ドメイン | isms-guide.com | | バージョン管理 | GitHub | | CI/CD | Cloudflare Pages（GitHub連携による自動デプロイ） | diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 00756ee..3c3a99c 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -16,10 +16,9 @@ export default withMermaid( lang: 'ja-JP', // Ignore dead links to pages not yet created + // Controls detail pages are partial; keep only this temporary ignore. ignoreDeadLinks: [ - /^\/controls\/a-\d+-\d+$/, - /^\/requirements\/\d+-\d+(-\d+)?$/, - /^\/controls$/ + /^\/controls\/a-\d+-\d+$/ ], // Sitemap (Cloudflare Pages) diff --git a/docs/isms/index.md b/docs/isms/index.md index 1ccfe80..67f6f2b 100644 --- a/docs/isms/index.md +++ b/docs/isms/index.md @@ -11,7 +11,6 @@ ISO/IEC 27001:2022 認証取得に必要な文書テンプレート集です。 ``` isms/ -├── README.md # このファイル ├── manual/ # ISMS マニュアル │ └── isms-manual.md ├── soa/ # 適用宣言書 diff --git a/guide/index.md b/guide/index.md index 0a56dc3..e6145dc 100644 --- a/guide/index.md +++ b/guide/index.md @@ -1,69 +1,6 @@ # フォークガイド -このリポジトリをフォークして、組織専用の ISMS ガイドを構築する方法を説明します。 +フォーク手順は `docs/templates/fork-guide.md` に統合しました。 -## クイックスタート - -### 1. リポジトリのフォーク - -GitHub で「Fork」ボタンをクリックして、リポジトリをフォークします。 - -### 2. ローカルにクローン - -```bash -git clone https://github.com/YOUR-ORG/isms-guide.git -cd isms-guide -npm install -``` - -### 3. 開発サーバーの起動 - -```bash -npm run dev -``` - -ブラウザで `http://localhost:5173` を開いて確認します。 - -## カスタマイズ - -### サイト設定の変更 - -`docs/.vitepress/config.mts` を編集して、組織に合わせた設定に変更します： - -```typescript -export default defineConfig({ - title: 'YOUR-ORG ISMS Guide', - description: 'YOUR-ORG の ISMS ガイド', - // ... -}) -``` - -### コンテンツの追加 - -- `docs/requirements/`: 要求事項の詳細解説を追加 -- `docs/controls/`: 管理策の実装ガイドを追加 -- `docs/glossary/`: 組織固有の用語を追加 - -### テンプレートの活用 - -`isms/` ディレクトリに組織の ISMS 文書を配置します。 - -## デプロイ - -### GitHub Pages - -1. リポジトリの Settings > Pages を開く -2. Source で「GitHub Actions」を選択 -3. main ブランチにプッシュすると自動デプロイ - -### その他のホスティング - -```bash -npm run build -``` - -`docs/.vitepress/dist/` を任意のホスティングサービスにデプロイします。 - -## サポート - -質問や問題がある場合は、Issue を作成してください。 +- 公開サイト: https://isms-guide.com/templates/fork-guide +- リポジトリ内: `docs/templates/fork-guide.md`