Backend

.github/workflows/ci.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: ["backend"]
+  pull_request:
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.13.3"]
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: "pip"
+          cache-dependency-path: |
+            backend/requirements.txt
+            backend/requirements-dev.txt
+            backend/pyproject.toml
+
+      - name: Install deps
+        working-directory: backend
+        run: |
+          python -m pip install --upgrade pip
+          if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
+          if [ -f requirements-dev.txt ]; then pip install -r requirements-dev.txt; fi
+
+      - name: Lint (pylint)
+        run: |
+          pylint ./backend
+
+      - name: Test (pytest)
+        run: |
+          pytest -q
+
+

backend/.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13.3"
+          cache: pip
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run tests
+        run: scripts/test.sh
+
+      - name: Run pylint
+        env:
+          PYLINTHOME: .pylint.d
+        run: pylint app

backend/.pylintrc

@@ -0,0 +1,13 @@
+[MASTER]
+ignore-paths=.venv
+
+[MESSAGES CONTROL]
+disable=
+    missing-module-docstring,
+    missing-class-docstring,
+    missing-function-docstring,
+    broad-except,
+    too-few-public-methods
+
+[FORMAT]
+max-line-length=100

backend/AGENTS.md

@@ -0,0 +1,41 @@
+# Repository Guidelines
+
+## プロジェクト構成とモジュール
+- `app/`: FastAPIアプリ本体。API (`app/main.py`)、モデル、各サービス。
+- `test/`: pytestのテスト一式（例: `test/test_main.py`, `test/test_store.py`）。
+- `templates/`: PDF生成に使うJinja2テンプレート（`templates/index.html.j2`）。
+- `scripts/`: 開発/運用向けスクリプト（`scripts/dev.sh`, `scripts/test.sh`, `scripts/print_pdf.sh`）。
+- `data/`: 実行時に生成されるジョブ状態や成果物（JSON、PDF）。
+- `font/`: PDFレンダリング用フォント（`font/ipamjm.ttf`）。
+- `output/`: 生成物置き場。必要性が明示されない限り一時ファイル扱い。
+
+## ビルド/テスト/開発コマンド
+- `pip install -r requirements.txt`: 依存関係のインストール。
+- `scripts/dev.sh`: リロード付きでFastAPIを起動（`uvicorn app.main:app`）。
+- `scripts/test.sh`: pytestでテスト実行（`pytest -q`）。
+- `scripts/print_pdf.sh <pdf> [copies] [printer]`: CUPSの`lp`でPDF印刷。
+
+## コーディング規約と命名
+- Python、インデントは4スペース、PEP 8準拠を意識。
+- 関数/変数は`snake_case`、クラスは`PascalCase`。
+- 可能な範囲で型ヒントを付与（`app/store.py`参照）。
+- APIエンドポイントは`app/main.py`に集約し、追加サービスは`app/`配下へ。
+
+## テスト方針
+- フレームワーク: pytest。
+- 命名規則: ファイルは`test_*.py`、関数は`test_*`。
+- 実行方法: `scripts/test.sh`または`pytest -q`。
+- 新規APIやジョブの状態遷移にはテスト追加を推奨。
+
+## コミット & PR ガイドライン
+- 履歴は説明的な文体（日本語が多め）。同じトーンで具体的に書く。
+- PRには概要、実行したテスト、設定変更や必要な環境変数を記載。
+
+## 設定と環境
+- ローカル開発では`.env`を`app/config.py`が自動読み込み。
+- 主要変数: `GEMINI_API_KEY`, `GEMINI_MODEL`, `BASE_URL`, `PRINTER_NAME`, `DATA_DIR`, `JOBS_DIR`, `IDEM_DIR`, `ARTIFACTS_DIR`。
+
+## gemini_transformの実装方針
+- ESP32から0か1のデータ5個送信されます。それに基づいて場合分けしてプロンプトを変える処理をしたいです
+- 最終的にそのgemini apiにデータを送信して結果をjson形式で返します
+- 整合性についてはほかファイルの仕様を優先して取ってください

backend/app/config.py

@@ -0,0 +1,20 @@
+import os
+from pydantic import BaseModel
+from dotenv import load_dotenv
+
+# .env を自動読み込み（ローカル開発向け）
+load_dotenv()
+
+class Settings(BaseModel):
+    gemini_api_key: str | None = os.getenv("GEMINI_API_KEY")
+    gemini_model: str = os.getenv("GEMINI_MODEL", "gemini-2.5-flash")
+    base_url: str = os.getenv("BASE_URL", "http://localhost:8000")
+    printer_name: str | None = os.getenv("PRINTER_NAME") or None
+
+    data_dir: str = os.getenv("DATA_DIR", "data")
+    jobs_dir: str = os.getenv("JOBS_DIR", "data/jobs")
+    idem_dir: str = os.getenv("IDEM_DIR", "data/idem")
+    llm_dir: str = os.getenv("LLM_DIR", "data/llm")
+    artifacts_dir: str = os.getenv("ARTIFACTS_DIR", "data/artifacts")
+
+settings = Settings()

backend/app/design_tool.py

@@ -0,0 +1,54 @@
+import argparse
+import json
+import os
+from jinja2 import Environment, FileSystemLoader, select_autoescape, TemplateNotFound
+from app.config import settings
+
+
+def generate_preview(job_id: str) -> str | None:
+    loader = FileSystemLoader("templates")
+    env = Environment(
+        loader=loader,
+        autoescape=select_autoescape(["html", "xml"]),
+    )
+
+    llm_path = os.path.join(settings.llm_dir, f"{job_id}.json")
+    if not os.path.exists(llm_path):
+        print(f"エラー: LLMデータが見つかりません: {llm_path}")
+        return None
+
+    try:
+        template = env.get_template("default.html.j2")
+    except TemplateNotFound as e:
+        print(f"エラー: テンプレートが見つかりません。\n詳細: {e}")
+        return None
+
+    try:
+        with open(llm_path, "r", encoding="utf-8") as f:
+            data = json.load(f)
+    except json.JSONDecodeError as e:
+        print(f"エラー: JSONの読み込みに失敗しました。\n詳細: {e}")
+        return None
+
+    html_str = template.render(**data)
+
+    output_dir = os.path.join(settings.data_dir, "html")
+    os.makedirs(output_dir, exist_ok=True)
+    output_filename = os.path.join(output_dir, f"{job_id}.html")
+    with open(output_filename, "w", encoding="utf-8") as f:
+        f.write(html_str)
+
+    print("-" * 30)
+    print(f"成功！ '{output_filename}' を作成しました。")
+    print("このファイルをブラウザで開いてデザインを確認してください。")
+    print("-" * 30)
+    return output_filename
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(
+        description="LLM JSONをdefault.html.j2に埋め込み、HTMLを生成します。"
+    )
+    parser.add_argument("job_id", help="LLM JSONのjob_id (llm/{job_id}.json)")
+    args = parser.parse_args()
+    generate_preview(args.job_id)