agentic-dev 0.1.0 → 0.2.0

package/server/data/bootstrap/auth_accounts.json

@@ -0,0 +1,18 @@
+[
+  {
+    "id": "user-1",
+    "name": "Template Admin",
+    "email": "admin@example.com",
+    "role": "admin",
+    "status": "active",
+    "password_source": "bootstrap_admin_password"
+  },
+  {
+    "id": "user-2",
+    "name": "Template Operator",
+    "email": "operator@example.com",
+    "role": "operator",
+    "status": "active",
+    "password_source": "bootstrap_operator_password"
+  }
+]

package/server/data/bootstrap/catalog_products.json

@@ -0,0 +1,179 @@
+[
+  {
+    "id": "prd-1001",
+    "slug": "trailshell-pack-jacket",
+    "name": "TrailShell Pack Jacket",
+    "brand": "Northstar Supply",
+    "category": "outerwear",
+    "status": "active",
+    "short_description": "Waterproof shell that packs into its own chest pocket for commute-to-trail days.",
+    "description": "TrailShell Pack Jacket pairs a lightweight recycled nylon shell with taped seams, two-way ventilation, and a stowaway hood. The silhouette is cut for layering and ships with durable trims built for wet-weather commuting.",
+    "hero_image": {
+      "url": "https://images.templates.dev/catalog/trailshell-pack-jacket/hero.jpg",
+      "alt": "TrailShell Pack Jacket in basalt black"
+    },
+    "gallery": [
+      {
+        "url": "https://images.templates.dev/catalog/trailshell-pack-jacket/detail-1.jpg",
+        "alt": "Front zipper and storm flap detail"
+      },
+      {
+        "url": "https://images.templates.dev/catalog/trailshell-pack-jacket/detail-2.jpg",
+        "alt": "Packable pocket configuration"
+      }
+    ],
+    "price": {
+      "amount": 189000,
+      "currency": "KRW"
+    },
+    "compare_at_price": {
+      "amount": 219000,
+      "currency": "KRW"
+    },
+    "tags": ["best-seller", "spring-drop", "unisex"],
+    "attributes": [
+      {
+        "name": "Material",
+        "value": "100% recycled nylon shell"
+      },
+      {
+        "name": "Waterproof rating",
+        "value": "10,000 mm"
+      },
+      {
+        "name": "Fit",
+        "value": "Regular"
+      }
+    ],
+    "variants": [
+      {
+        "sku": "TSJ-BLK-S",
+        "name": "Basalt Black / S",
+        "option_values": ["Basalt Black", "S"]
+      },
+      {
+        "sku": "TSJ-BLK-M",
+        "name": "Basalt Black / M",
+        "option_values": ["Basalt Black", "M"]
+      },
+      {
+        "sku": "TSJ-SGE-M",
+        "name": "Sage / M",
+        "option_values": ["Sage", "M"]
+      }
+    ],
+    "created_at": "2026-03-01T09:00:00+09:00",
+    "updated_at": "2026-03-10T11:40:00+09:00"
+  },
+  {
+    "id": "prd-1002",
+    "slug": "commuter-utility-sling",
+    "name": "Commuter Utility Sling",
+    "brand": "Harbor Line",
+    "category": "bags",
+    "status": "draft",
+    "short_description": "Modular sling bag with removable organizer panels and hidden RFID pocket.",
+    "description": "Commuter Utility Sling is designed for phones, keys, wallets, and compact cameras. The draft assortment includes two neutral colorways, a quick-adjust strap, and a wipe-clean coated lining for daily transit use.",
+    "hero_image": {
+      "url": "https://images.templates.dev/catalog/commuter-utility-sling/hero.jpg",
+      "alt": "Commuter Utility Sling in sandstone"
+    },
+    "gallery": [
+      {
+        "url": "https://images.templates.dev/catalog/commuter-utility-sling/detail-1.jpg",
+        "alt": "Removable organizer panel"
+      },
+      {
+        "url": "https://images.templates.dev/catalog/commuter-utility-sling/detail-2.jpg",
+        "alt": "Rear hidden RFID pocket"
+      }
+    ],
+    "price": {
+      "amount": 129000,
+      "currency": "KRW"
+    },
+    "compare_at_price": null,
+    "tags": ["pre-launch", "travel", "edc"],
+    "attributes": [
+      {
+        "name": "Capacity",
+        "value": "6 L"
+      },
+      {
+        "name": "Shell",
+        "value": "Waxed recycled polyester"
+      },
+      {
+        "name": "Closure",
+        "value": "Magnetic flap + zip"
+      }
+    ],
+    "variants": [
+      {
+        "sku": "CUS-SND-STD",
+        "name": "Sandstone / Standard",
+        "option_values": ["Sandstone", "Standard"]
+      },
+      {
+        "sku": "CUS-MOS-STD",
+        "name": "Moss / Standard",
+        "option_values": ["Moss", "Standard"]
+      }
+    ],
+    "created_at": "2026-03-05T13:20:00+09:00",
+    "updated_at": "2026-03-12T18:15:00+09:00"
+  },
+  {
+    "id": "prd-1003",
+    "slug": "fieldstone-thermal-mug",
+    "name": "Fieldstone Thermal Mug",
+    "brand": "Fieldhouse",
+    "category": "drinkware",
+    "status": "archived",
+    "short_description": "Double-wall stoneware mug from a retired seasonal capsule with heat-lock lid.",
+    "description": "Fieldstone Thermal Mug was released as part of the winter capsule and is now archived. Remaining stock is still serviceable for support workflows, with matte glaze options and a spill-resistant press lid.",
+    "hero_image": {
+      "url": "https://images.templates.dev/catalog/fieldstone-thermal-mug/hero.jpg",
+      "alt": "Fieldstone Thermal Mug in ink blue"
+    },
+    "gallery": [
+      {
+        "url": "https://images.templates.dev/catalog/fieldstone-thermal-mug/detail-1.jpg",
+        "alt": "Stoneware mug texture detail"
+      }
+    ],
+    "price": {
+      "amount": 42000,
+      "currency": "KRW"
+    },
+    "compare_at_price": {
+      "amount": 52000,
+      "currency": "KRW"
+    },
+    "tags": ["archive", "winter-capsule"],
+    "attributes": [
+      {
+        "name": "Capacity",
+        "value": "355 ml"
+      },
+      {
+        "name": "Finish",
+        "value": "Matte glaze"
+      }
+    ],
+    "variants": [
+      {
+        "sku": "FTM-INK-12OZ",
+        "name": "Ink Blue / 12 oz",
+        "option_values": ["Ink Blue", "12 oz"]
+      },
+      {
+        "sku": "FTM-SND-12OZ",
+        "name": "Sand / 12 oz",
+        "option_values": ["Sand", "12 oz"]
+      }
+    ],
+    "created_at": "2025-12-15T10:00:00+09:00",
+    "updated_at": "2026-02-28T15:05:00+09:00"
+  }
+]

package/server/data/bootstrap/fulfillment_events.json

@@ -0,0 +1,5 @@
+[
+  { "time": "09:05", "title": "Inbound slot capacity refreshed", "tone": "accent" },
+  { "time": "10:15", "title": "Packing queue reprioritized for express orders", "tone": "warning" },
+  { "time": "11:30", "title": "Outbound carrier window confirmed", "tone": "success" }
+]

package/server/data/bootstrap/fulfillment_notes.json

@@ -0,0 +1,5 @@
+[
+  { "id": "fn-1", "note": "Blocked tasks should stay visible in the board header until cleared.", "emphasis": "warning" },
+  { "id": "fn-2", "note": "Outbound handoff needs a tighter SLA once same-day carrier pickup goes live.", "emphasis": "accent" },
+  { "id": "fn-3", "note": "Marketplace orders tend to create exception handling work in address verification.", "emphasis": "neutral" }
+]

package/server/data/bootstrap/fulfillment_tasks.json

@@ -0,0 +1,50 @@
+[
+  {
+    "id": "ft-1",
+    "order_id": "ORD-24051",
+    "title": "Reserve inbound QA inspection slot",
+    "assignee": "Warehouse A",
+    "stage": "Inbound",
+    "status": "Queued",
+    "priority": "Critical",
+    "channel": "Marketplace",
+    "sla_minutes": 45,
+    "units": 1
+  },
+  {
+    "id": "ft-2",
+    "order_id": "ORD-24052",
+    "title": "Confirm packing checklist",
+    "assignee": "Ops Desk",
+    "stage": "Packing",
+    "status": "In progress",
+    "priority": "High",
+    "channel": "Direct",
+    "sla_minutes": 30,
+    "units": 2
+  },
+  {
+    "id": "ft-3",
+    "order_id": "ORD-24053",
+    "title": "Resolve address verification hold",
+    "assignee": "Exception Desk",
+    "stage": "Exception",
+    "status": "Blocked",
+    "priority": "Critical",
+    "channel": "Marketplace",
+    "sla_minutes": 20,
+    "units": 1
+  },
+  {
+    "id": "ft-4",
+    "order_id": "ORD-24054",
+    "title": "Hand off to outbound carrier",
+    "assignee": "Dispatch",
+    "stage": "Outbound",
+    "status": "Queued",
+    "priority": "Normal",
+    "channel": "Direct",
+    "sla_minutes": 60,
+    "units": 1
+  }
+]

package/server/data/bootstrap/inventory_levels.json

@@ -0,0 +1,80 @@
+[
+  {
+    "sku": "TSJ-BLK-S",
+    "product_id": "prd-1001",
+    "product_name": "TrailShell Pack Jacket",
+    "variant_name": "Basalt Black / S",
+    "location_id": "fc-seoul",
+    "location_name": "Seoul Fulfillment Center",
+    "on_hand": 18,
+    "reserved": 3,
+    "safety_stock": 4,
+    "reorder_point": 8,
+    "updated_at": "2026-03-13T08:30:00+09:00"
+  },
+  {
+    "sku": "TSJ-BLK-M",
+    "product_id": "prd-1001",
+    "product_name": "TrailShell Pack Jacket",
+    "variant_name": "Basalt Black / M",
+    "location_id": "fc-seoul",
+    "location_name": "Seoul Fulfillment Center",
+    "on_hand": 6,
+    "reserved": 1,
+    "safety_stock": 4,
+    "reorder_point": 8,
+    "updated_at": "2026-03-13T08:32:00+09:00"
+  },
+  {
+    "sku": "TSJ-SGE-M",
+    "product_id": "prd-1001",
+    "product_name": "TrailShell Pack Jacket",
+    "variant_name": "Sage / M",
+    "location_id": "fc-busan",
+    "location_name": "Busan Overflow Hub",
+    "on_hand": 11,
+    "reserved": 2,
+    "safety_stock": 3,
+    "reorder_point": 6,
+    "updated_at": "2026-03-13T09:10:00+09:00"
+  },
+  {
+    "sku": "CUS-SND-STD",
+    "product_id": "prd-1002",
+    "product_name": "Commuter Utility Sling",
+    "variant_name": "Sandstone / Standard",
+    "location_id": "fc-incheon",
+    "location_name": "Incheon Launch Warehouse",
+    "on_hand": 24,
+    "reserved": 0,
+    "safety_stock": 5,
+    "reorder_point": 10,
+    "updated_at": "2026-03-13T07:45:00+09:00"
+  },
+  {
+    "sku": "CUS-MOS-STD",
+    "product_id": "prd-1002",
+    "product_name": "Commuter Utility Sling",
+    "variant_name": "Moss / Standard",
+    "location_id": "fc-incheon",
+    "location_name": "Incheon Launch Warehouse",
+    "on_hand": 0,
+    "reserved": 0,
+    "safety_stock": 5,
+    "reorder_point": 10,
+    "updated_at": "2026-03-13T07:46:00+09:00"
+  },
+  {
+    "sku": "FTM-INK-12OZ",
+    "product_id": "prd-1003",
+    "product_name": "Fieldstone Thermal Mug",
+    "variant_name": "Ink Blue / 12 oz",
+    "location_id": "fc-seoul",
+    "location_name": "Seoul Fulfillment Center",
+    "on_hand": 7,
+    "reserved": 2,
+    "safety_stock": 3,
+    "reorder_point": 6,
+    "updated_at": "2026-03-13T06:55:00+09:00"
+  }
+]

package/server/data/bootstrap/orders.json

@@ -0,0 +1,62 @@
+[
+  {
+    "id": "ORD-24051",
+    "product_id": "prd-1",
+    "product_name": "Operations Console Starter",
+    "customer_name": "Seoul Commerce",
+    "seller_name": "Do4AI Mobility",
+    "status": "Pending",
+    "fulfillment_status": "Picking",
+    "created_at": "2026.03.14",
+    "amount_krw": 840000,
+    "risk": "risk",
+    "stage": "결제 대기",
+    "sla": "45 min",
+    "is_new_today": true
+  },
+  {
+    "id": "ORD-24052",
+    "product_id": "prd-2",
+    "product_name": "Customer App Foundation",
+    "customer_name": "Busan Retail Lab",
+    "seller_name": "Do4AI Commerce",
+    "status": "Paid",
+    "fulfillment_status": "Shipping",
+    "created_at": "2026.03.14",
+    "amount_krw": 620000,
+    "risk": "ok",
+    "stage": "배송 준비",
+    "sla": "70 min",
+    "is_new_today": true
+  },
+  {
+    "id": "ORD-24053",
+    "product_id": "prd-3",
+    "product_name": "Landing Funnel Experiment",
+    "customer_name": "Growth Studio",
+    "seller_name": "Growth Lab",
+    "status": "At risk",
+    "fulfillment_status": "Exception",
+    "created_at": "2026.03.13",
+    "amount_krw": 380000,
+    "risk": "risk",
+    "stage": "예외 검토",
+    "sla": "120 min",
+    "is_new_today": false
+  },
+  {
+    "id": "ORD-24054",
+    "product_id": "prd-1",
+    "product_name": "Operations Console Starter",
+    "customer_name": "West Hub Market",
+    "seller_name": "Do4AI Mobility",
+    "status": "Pending",
+    "fulfillment_status": "Queued",
+    "created_at": "2026.03.13",
+    "amount_krw": 560000,
+    "risk": "ok",
+    "stage": "출고 대기",
+    "sla": "55 min",
+    "is_new_today": false
+  }
+]

package/server/data/bootstrap/shipping_shipments.json

@@ -0,0 +1,50 @@
+[
+  {
+    "shipment_id": "shp-1001",
+    "order_id": "ORD-24052",
+    "carrier": "CJ Logistics",
+    "destination": "Busan Retail Lab",
+    "tracking_number": "CJ-24052-01",
+    "status": "In transit",
+    "eta": "2026.03.14 18:30",
+    "last_event": "부산 허브로 이동 중",
+    "route_name": "Seoul FC -> Busan Retail Lab",
+    "delivered_today": false
+  },
+  {
+    "shipment_id": "shp-1002",
+    "order_id": "ORD-24053",
+    "carrier": "Hanjin",
+    "destination": "Growth Studio",
+    "tracking_number": "HJ-24053-01",
+    "status": "Delayed",
+    "eta": "2026.03.15 11:00",
+    "last_event": "주소 재확인으로 허브 보류",
+    "route_name": "Incheon Hub -> Growth Studio",
+    "delivered_today": false
+  },
+  {
+    "shipment_id": "shp-1003",
+    "order_id": "ORD-24054",
+    "carrier": "Lotte Global",
+    "destination": "West Hub Market",
+    "tracking_number": "LT-24054-01",
+    "status": "Delivered",
+    "eta": "2026.03.14 09:10",
+    "last_event": "수령처 인도 완료",
+    "route_name": "Gimpo FC -> West Hub Market",
+    "delivered_today": true
+  },
+  {
+    "shipment_id": "shp-1004",
+    "order_id": "ORD-24051",
+    "carrier": "CJ Logistics",
+    "destination": "Seoul Commerce",
+    "tracking_number": "CJ-24051-01",
+    "status": "Out for delivery",
+    "eta": "2026.03.14 15:40",
+    "last_event": "배송 기사 배차 완료",
+    "route_name": "Dongdaemun Hub -> Seoul Commerce",
+    "delivered_today": false
+  }
+]

package/server/data/bootstrap/support_faqs.json

@@ -0,0 +1,26 @@
+[
+  {
+    "id": "faq-1",
+    "question": "주문 결제 확인은 언제 완료되나요?",
+    "answer": "결제 승인과 주문 검증이 끝나면 보통 몇 분 안에 완료됩니다.",
+    "category": "주문",
+    "visibility": "노출",
+    "updated_at": "2026-03-14"
+  },
+  {
+    "id": "faq-2",
+    "question": "배송 상태는 어디에서 확인하나요?",
+    "answer": "고객 알림 링크와 운영 대시보드의 배송 추적 카드에서 동시에 확인할 수 있습니다.",
+    "category": "배송",
+    "visibility": "노출",
+    "updated_at": "2026-03-14"
+  },
+  {
+    "id": "faq-3",
+    "question": "반품 요청은 어떻게 접수하나요?",
+    "answer": "주문 상세에서 반품 사유를 등록하면 운영팀 검토 큐로 바로 전달됩니다.",
+    "category": "반품",
+    "visibility": "노출",
+    "updated_at": "2026-03-14"
+  }
+]

package/server/data/bootstrap/users.json

@@ -0,0 +1,20 @@
+[
+  {
+    "id": "user-1",
+    "name": "Template Admin",
+    "email": "admin@example.com",
+    "role": "admin",
+    "status": "active",
+    "timezone": "Asia/Seoul",
+    "last_login_at": "2026-03-10T14:30:00+09:00"
+  },
+  {
+    "id": "user-2",
+    "name": "Template Operator",
+    "email": "operator@example.com",
+    "role": "operator",
+    "status": "active",
+    "timezone": "Asia/Seoul",
+    "last_login_at": "2026-03-10T11:12:00+09:00"
+  }
+]

package/server/data/bootstrap_loader.py

@@ -0,0 +1,15 @@
+import json
+from pathlib import Path
+from typing import Any
+
+
+DATA_ROOT = Path(__file__).resolve().parent
+BOOTSTRAP_ROOT = DATA_ROOT / "bootstrap"
+
+
+def load_bootstrap_json(filename: str) -> list[dict[str, Any]]:
+    with (BOOTSTRAP_ROOT / filename).open("r", encoding="utf-8") as handle:
+        payload = json.load(handle)
+    if not isinstance(payload, list):
+        raise ValueError(f"{filename} must contain a JSON list")
+    return payload

package/server/docker-entrypoint.sh

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+cd /app/server
+
+python - <<'PY'
+import os
+import socket
+import time
+from urllib.parse import urlparse
+
+
+DEFAULT_PORTS = {
+    "postgresql": 5432,
+    "postgresql+psycopg": 5432,
+    "mysql": 3306,
+    "mongodb": 27017,
+}
+
+
+def wait_for(url: str, label: str, timeout: float = 60.0) -> None:
+    parsed = urlparse(url)
+    host = parsed.hostname or "127.0.0.1"
+    port = parsed.port or DEFAULT_PORTS.get(parsed.scheme, 80)
+    deadline = time.time() + timeout
+    last_error = None
+
+    while time.time() < deadline:
+        try:
+            with socket.create_connection((host, port), timeout=1):
+                return
+        except OSError as exc:
+            last_error = exc
+            time.sleep(1)
+
+    raise SystemExit(f"Timed out waiting for {label} at {host}:{port}: {last_error}")
+
+
+backend = os.environ.get("DATABASE_BACKEND", "memory").lower()
+urls = {
+    "postgres": os.environ.get("POSTGRES_URL", ""),
+    "mysql": os.environ.get("MYSQL_URL", ""),
+    "mariadb": os.environ.get("MARIADB_URL", ""),
+    "mongodb": os.environ.get("MONGODB_URL", ""),
+}
+
+target_url = urls.get(backend)
+if backend != "memory" and target_url:
+    wait_for(target_url, backend)
+PY
+
+exec uvicorn api.http.app:app \
+    --host 0.0.0.0 \
+    --port "${SERVER_HTTP_PORT:-8000}" \
+    --reload \
+    --reload-dir /app/server

package/server/main.py

@@ -0,0 +1,3 @@
+from api.http.app import app
+
+__all__ = ["app"]

package/server/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "template-server"
+version = "0.1.0"
+description = "HTTP boilerplate with hexagonal and DDD structure"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+  "fastapi==0.116.1",
+  "uvicorn[standard]==0.35.0",
+  "pydantic-settings==2.10.1",
+  "email-validator==2.2.0",
+  "sqlalchemy==2.0.43",
+  "psycopg[binary]==3.2.13",
+  "pymysql==1.1.2",
+  "pymongo==4.14.1",
+  "python-jose[cryptography]==3.5.0",
+  "passlib[bcrypt]==1.7.4",
+  "bcrypt==4.0.1",
+]
+
+[project.optional-dependencies]
+dev = [
+  "httpx==0.28.1",
+  "pytest==8.4.1",
+  "ruff==0.12.11",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["api", "contexts", "shared"]
+
+[tool.pytest.ini_options]
+pythonpath = ["."]

package/server/shared/__init__.py

@@ -0,0 +1 @@
+__all__ = ["application", "infrastructure"]

package/server/shared/application/__init__.py

@@ -0,0 +1,3 @@
+from .health import health_response
+
+__all__ = ["health_response"]

package/server/shared/application/health.py

@@ -0,0 +1,2 @@
+def health_response() -> dict[str, str]:
+    return {"status": "ok"}

package/server/shared/infrastructure/__init__.py

@@ -0,0 +1,10 @@
+from .runtime import build_runtime_metadata
+from .security import decode_access_token, hash_password, issue_access_token, verify_password
+
+__all__ = [
+    "build_runtime_metadata",
+    "decode_access_token",
+    "hash_password",
+    "issue_access_token",
+    "verify_password",
+]

package/server/shared/infrastructure/runtime.py

@@ -0,0 +1,6 @@
+from config import get_settings
+
+
+def build_runtime_metadata() -> dict[str, str]:
+    settings = get_settings()
+    return {"app_name": settings.app_name, "environment": settings.environment}