# ニッチェ・ライフ - ウェブ生物雑誌サイト

Astro 5 + Starlightで構築された無料公開のウェブ生物雑誌プラットフォーム。分離アーキテクチャによる効率的なデータ管理を採用。

## プロジェクトの目的とニーズ

- **メインユーザー**: 生物学研究者、アマチュア自然愛好家、編集委員
- **目標**: 学術的に引用可能な生物記録の蓄積と、生物多様性の魅力発信
- **特徴**: 投稿無料・全文無料公開のオンラインジャーナル
- **技術的要求**: 高速な表示、SEO対応、Cloudflareへのデプロイ

## コードスタイル

- TypeScript strict mode、`any`型は禁止
- named exportを優先（default exportは避ける）
- CSS: TailwindCSSのユーティリティクラスのみ使用
- 画像最適化: Astroの`<Image>`コンポーネントを必ず使用
- ファイル命名: kebab-case（例：`volume-detail.astro`）

## コマンド

- `npm run dev`: 開発サーバー起動（ポート4321）
- `npm run build`: 本番ビルド
- `npm run preview`: ビルド済みサイトのプレビュー
- `wrangler pages deploy`: Cloudflareへのデプロイ

## アーキテクチャ

- `/src/pages/`: 動的ルーティング（バックナンバー、個別巻号ページ）
- `/src/content/`: Starlightコンテンツ（MDX記事、編集委員情報）
- `/src/components/`: 再利用可能コンポーネント
- `/src/data/`: 分離されたデータファイル
  - `volumes.json`: 巻情報マスター
  - `articles/volume-*.json`: 各巻の記事データ
- `/src/assets/cover/`: 表紙画像（`volume-{番号}.jpg`形式）
- `/src/utils/`: データ取得ユーティリティ

## データ管理規約

- IMPORTANT: 巻データと記事データは必ず分離して管理すること
- 表紙画像は`volume-{番号}.jpg`の命名規則を厳守
- 新巻号追加時は3つのファイルを更新: 表紙画像、volumes.json、記事JSONファイル
- DOIリンクは必ずhttps形式で記録

## 重要な注意事項

- NEVER 画像の直接パスを使用しない。必ず`getCoverImage()`を経由すること
- 記事リンクは学術的引用に使用されるため、URLの変更は慎重に行う
- J-STAGEとの同期を意識したデータ構造を維持
- 表紙画像の推奨サイズ: 180×254px（縦横比1:1.41）

## 入稿ワークフロー

新巻号追加の詳細手順: @docs/submission-workflow.md
画像処理ガイドライン: @docs/image-guidelines.md
SEO最適化チェックリスト: @docs/seo-checklist.md

## サイト構造・ナビゲーション設計

サイト全体の構造設計: @docs/site-structure.md
UI/UXデザインガイドライン: @docs/ui-ux-guidelines.md
情報アーキテクチャ: @docs/information-architecture.md
メニュー改善提案: @docs/menu-improvement-proposal.md

## 方針
- 投稿フォームやお問い合わせフォームなどは自前で作らず、Google formなど外部ツールを利用する