Skip to content

assitant.agent.prompt.md

Latest commit

 

History

History
90 lines (80 loc) · 6.5 KB

assitant.agent.prompt.md

File metadata and controls

90 lines (80 loc) · 6.5 KB
description mode tools model
New prompt created from chat session
agent
extensions
codebase
usages
vscodeAPI
problems
changes
testFailure
terminalSelection
terminalLastCommand
openSimpleBrowser
fetch
findTestFiles
searchResults
githubRepo
getPythonEnvironmentInfo
getPythonExecutableCommand
installPythonPackage
configurePythonEnvironment
runTests
runCommands
runTasks
weather
editFiles
runNotebooks
search
new
Grok Code Fast 1 (Preview)
このレポジトリの内容を解析し、どういう実装がされているか解説してください。 このレポジトリは、DjangoベースのTech Blog CMS（コンテンツ管理システム）の実装例です。Docker Composeを使用してコンテナ化され、Nginxによるリバースプロキシ、PostgreSQLデータベース、Redisキャッシュ、Let's EncryptによるSSL証明書の自動取得・更新を統合しています。以下に主要な実装内容を解説します。

全体アーキテクチャ

  • Webフレームワーク: Django 4.2を使用。WSGIアプリケーションとしてGunicornで実行。
  • コンテナ化: Docker Composeで複数サービスを管理（Djangoアプリ、Nginx、PostgreSQL、Redis、Certbot）。
  • セキュリティ: HTTPS強制、セキュリティヘッダー、CSRF保護、環境変数による設定管理、強力なパスワード要件。
  • CI/CD: GitHub Actionsでテスト、ビルド、脆弱性スキャン（Trivy）を自動化。
  • テスト: pytestを使用したユニットテストと統合テスト。

主要コンポーネントの解説

  1. Djangoアプリケーション (techblog_cms/):

    • モデル (techblog_cms/models.py): Category, Tag, Articleモデルを実装。記事の作成・管理、カテゴリ分類、タグ付け機能をサポート。
    • ビュー (techblog_cms/views.py):
      • health_check: JSONレスポンスでヘルスチェック。
      • home_view: 公開記事のトップ10を表示。
      • article_list_view: 全公開記事を表示。
      • categories_view: カテゴリ一覧を表示。
      • category_view: カテゴリ別記事を表示。
      • article_detail_view: 記事詳細を表示（ログイン時は下書きも表示）。
      • login_view: ユーザー認証（CSRF保護付き）。
      • logout_view: ログアウト処理。
      • dashboard_view: 管理ダッシュボード（ページネーション付き記事一覧）。
      • article_editor_view: 記事作成・編集。
      • article_delete_view: 記事削除。
      • admin_guard: 管理画面アクセス制御。
    • URL設定 (techblog_cms/urls.py): 記事管理、カテゴリ、ログイン/ログアウト、管理画面などのURLマッピング。
    • 設定 (techblog_cms/settings.py): 環境変数でDEBUG、ALLOWED_HOSTS、DB接続を制御。PostgreSQLとRedisを統合。テストモードでのCSRF無効化。
    • テンプレート:
      • home.html: ホーム画面。
      • article_list.html: 記事一覧。
      • category_list.html: カテゴリ一覧。
      • category_detail.html: カテゴリ詳細。
      • article_detail.html: 記事詳細。
      • login.html: ログインフォーム。
      • dashboard.html: 管理ダッシュボード（ページネーション付き）。
      • article_editor.html: 記事編集フォーム。
      • article_delete_confirm.html: 削除確認。
      • article_delete_success.html: 削除成功。
    • WSGI (techblog_cms/wsgi.py): Djangoアプリのエントリーポイント。

  2. Docker設定:

    • Djangoコンテナ (Dockerfile.django): Python 3.11ベースで依存関係をインストールし、非rootユーザーで実行。
    • Nginxコンテナ (Dockerfile.nginx, Dockerfile.nginx.static): 静的ファイル配信とリバースプロキシ。SSL証明書をマウント。
    • Compose (docker-compose.yml): サービス間ネットワーク、ボリューム、環境変数を定義。Certbotで証明書更新を自動化。

  3. データベースとキャッシュ:

    • PostgreSQL: コンテナで実行され、永続ボリュームでデータを保持。
    • Redis: パスワード認証付きでキャッシュを提供。

  4. SSL証明書管理:

    • 初期化スクリプト (scripts/init-letsencrypt.sh): CertbotでLet's Encrypt証明書を取得し、Nginxに適用。
    • 更新スクリプト (scripts/renew-cert.sh): 証明書を定期更新。

  5. テストと品質管理:

    • テスト設定 (conftest.py, pytest.ini): Djangoテスト環境をSQLiteでセットアップ。
    • テストケース (techblog_cms/tests/test_views.py): ホーム画面のステータスコードとテンプレート使用を検証。
    • CIパイプライン (.github/workflows/docker-publish.yml): プッシュ時にテストを実行し、イメージをビルド・プッシュ。

  6. その他のファイル:

    • デプロイスクリプト (deploy.sh): Gitプル、コンテナ再ビルド、起動を自動化。
    • 環境設定 (.env.example): 秘密鍵やDB接続を環境変数で管理。
    • ドキュメント (README.md): セットアップ手順、技術スタック、ライセンスを記載。

この実装は、プロダクションレディなDjangoアプリのベストプラクティスを反映しており、セキュリティとスケーラビリティを重視しています。記事管理機能、ページネーション、ユーザー認証、CSRF保護などの機能を備えています。 AIへの指示とレポジトリの理解のため、AGENTS.mdの作成を行ってください。 AGENTS.mdファイルを作成しました。このファイルには、レポジトリの概要、技術スタック、プロジェクト構造、開発ガイドライン、AIアシスタント向けの具体的な指示をまとめています。これにより、AIがこのプロジェクトを効果的に支援できるようになります。

主な内容:

  • レポジトリの目的と技術スタックの説明
  • プロジェクト構造の詳細
  • コーディング標準とセキュリティ考慮事項
  • AIへのコード生成・支援時のガイドライン
  • 貢献プロセス

このファイルは今後、プロジェクトの変更に合わせて更新していくことをおすすめします。