docs(WIP): ドキュメントサイトを仮作成

package.json

@@ -8,6 +8,7 @@
     "backend": "pnpm -F \"kcms\"",
     "frontend": "pnpm -F \"kcmsf\"",
     "mock": "pnpm -F \"mock\"",
+    "site": "pnpm -F \"site\"",
     "start:backend": "pnpm backend start",
     "start:frontend": "pnpm frontend start",
     "dev:backend": "pnpm backend dev",

packages/site/.gitignore

@@ -0,0 +1,23 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+.vscode

packages/site/.prettierignore

@@ -0,0 +1 @@
+node_modules

packages/site/.prettierrc.json

@@ -0,0 +1,21 @@
+{
+  "plugins": ["prettier-plugin-astro", "prettier-plugin-organize-imports"],
+  "overrides": [
+    {
+      "files": "*.astro",
+      "options": {
+        "parser": "astro"
+      }
+    }
+  ],
+  "arrowParens": "always",
+  "bracketSameLine": false,
+  "bracketSpacing": true,
+  "jsxSingleQuote": false,
+  "printWidth": 80,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "useTabs": false
+}

packages/site/README.md

@@ -0,0 +1 @@
+# kcmsx/site

packages/site/astro.config.mjs

@@ -0,0 +1,48 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [
+    starlight({
+      title: "kcmsx",
+      locales: {
+        root: {
+          label: "日本語",
+          lang: "ja-JP",
+        },
+      },
+      social: [
+        {
+          icon: "github",
+          label: "GitHub",
+          href: "https://github.com/poporonnet/kcmsx",
+        },
+        {
+          icon: "external",
+          label: "Poporon Network",
+          href: "https://poporon.org",
+        },
+      ],
+      sidebar: [
+        {
+          label: "ガイド",
+          items: ["guides/what-is-kcmsx", "guides/getting-started"],
+        },
+        {
+          label: "ステップバイステップ",
+          items: ["step-by-step", "step-by-step/register-teams"],
+        },
+        {
+          label: "リファレンス",
+          autogenerate: { directory: "references" },
+        },
+      ],
+      editLink: {
+        baseUrl: "https://github.com/poporonnet/kcmsx/edit/main/packages/site",
+      },
+      lastUpdated: true,
+    }),
+  ],
+});

packages/site/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "site",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "format": "prettier --write \"src/**/*\"",
+    "check": "prettier --check \"src/**/*\" && astro check"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.36.2",
+    "astro": "^5.15.3",
+    "sharp": "^0.34.4"
+  },
+  "devDependencies": {
+    "prettier": "^3.6.2",
+    "prettier-plugin-astro": "^0.14.1",
+    "prettier-plugin-organize-imports": "^4.3.0"
+  }
+}

packages/site/src/content/config.ts

@@ -0,0 +1,6 @@
+import { docsSchema } from "@astrojs/starlight/schema";
+import { defineCollection } from "astro:content";
+
+export const collections = {
+  docs: defineCollection({ schema: docsSchema() }),
+};

packages/site/src/content/docs/guides/getting-started.md

@@ -0,0 +1,16 @@
+---
+title: はじめる
+description: 初めて kcmsx をセットアップするためのガイド。
+---
+
+## リポジトリをクローンする
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+## セットアップ
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+## 起動
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

packages/site/src/content/docs/guides/what-is-kcmsx.md

@@ -0,0 +1,14 @@
+---
+title: What is kcmsx?
+description: kcmsx の紹介。
+---
+
+kcmsx は、ご当地こどもロボコンのために構築された Web ベースの大会運営システムです。
+
+## ご当地こどもロボコンとは
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+## kcmsx
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

packages/site/src/content/docs/index.mdx

@@ -0,0 +1,42 @@
+---
+title: kcmsx
+description: kcmsx | ご当地こどもロボコン大会運営システム
+template: splash
+hero:
+  tagline: ご当地こどもロボコン 大会運営システム
+  image:
+    file: /public/dolphin.png
+  actions:
+    - text: はじめる
+      link: /guides/what-is-kcmsx/
+      icon: right-arrow
+    - text: poporonnet/kcmsx
+      link: https://github.com/poporonnet/kcmsx
+      icon: github
+      variant: secondary
+    - text: Poporon Network
+      link: https://poporon.org
+      icon: external
+      variant: minimal
+---
+
+import { Card, CardGrid, LinkCard } from "@astrojs/starlight/components";
+
+## 次のステップ
+
+<LinkCard title="kcmsx について知る" href="guides/what-is-kcmsx"></LinkCard>
+
+<CardGrid stagger>
+  <Card title="All in One" icon="star">
+    チーム登録から試合生成、採点、ランキング計算まで、大会運営を一貫してサポートします。
+  </Card>
+  <Card title="Simple" icon="heart">
+    シンプルで整理された UI/UX は、同時に使いやすさを重視して設計されています。
+  </Card>
+  <Card title="Modern & Standard" icon="rocket">
+    kcmsx はモダンかつ Web 標準の技術スタックで構築されています。
+  </Card>
+  <Card title="Customizable" icon="setting">
+    大会ごとに異なるテキストや採点ルールも、柔軟にカスタマイズ可能です。
+  </Card>
+</CardGrid>

packages/site/src/content/docs/references/customize.md

@@ -0,0 +1,10 @@
+---
+title: カスタマイズ
+description: 大会に応じて設定をカスタマイズする方法。
+---
+
+kcmsx では、大会に応じて試合の文言、ルールの内容、点数などをカスタマイズすることができます。
+
+## ファイル
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

packages/site/src/content/docs/step-by-step/index.md

@@ -0,0 +1,10 @@
+---
+title: このガイドについて
+description: ステップバイステップガイドについての説明。
+---
+
+これは、実際の大会運営の流れに対応して、ステップバイステップで各機能を説明するガイドです。
+
+## 大会の流れ
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

packages/site/src/content/docs/step-by-step/register-teams.md

@@ -0,0 +1,4 @@
+---
+title: チームを登録する
+description: システムにチームを登録する方法のガイド。
+---

packages/site/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [
+    ".astro/types.d.ts",
+    "**/*"
+  ],
+  "exclude": [
+    "dist"
+  ],
+  "mdx": {
+    "checkMdx": true,
+  }
+}