agentic-dev 0.2.9 → 0.2.11

package/server/contexts/user/infrastructure/adapters/mongodb.py

@@ -1,41 +0,0 @@
-from pymongo import ASCENDING, MongoClient, ReturnDocument
-
-from contexts.user.domain import UserRecord, UserSummary
-
-
-class MongoUserRepository:
-    def __init__(self, mongodb_url: str, database_name: str) -> None:
-        self.client = MongoClient(mongodb_url)
-        self.collection = self.client[database_name]["users"]
-
-    def initialize(self) -> None:
-        self.collection.create_index([("email", ASCENDING)], unique=True)
-
-    def seed_users(self, users: list[UserRecord]) -> None:
-        for user in users:
-            self.collection.update_one({"id": user.id}, {"$set": user.model_dump()}, upsert=True)
-
-    def get_by_id(self, user_id: str) -> UserRecord | None:
-        record = self.collection.find_one({"id": user_id}, {"_id": 0})
-        return UserRecord(**record) if record else None
-
-    def list_summaries(self) -> list[UserSummary]:
-        return [
-            UserSummary(
-                id=record["id"],
-                name=record["name"],
-                email=record["email"],
-                role=record["role"],
-                status=record["status"],
-            )
-            for record in self.collection.find({}, {"_id": 0}).sort("id", ASCENDING)
-        ]
-
-    def update_status(self, user_id: str, status: str) -> UserRecord | None:
-        record = self.collection.find_one_and_update(
-            {"id": user_id},
-            {"$set": {"status": status}},
-            return_document=ReturnDocument.AFTER,
-            projection={"_id": 0},
-        )
-        return UserRecord(**record) if record else None

package/server/contexts/user/infrastructure/adapters/sqlalchemy.py

@@ -1,94 +0,0 @@
-from sqlalchemy import String, create_engine, select
-from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, sessionmaker
-
-from contexts.user.domain import UserRecord, UserSummary
-
-
-class Base(DeclarativeBase):
-    pass
-
-
-class UserTable(Base):
-    __tablename__ = "users"
-
-    id: Mapped[str] = mapped_column(String(64), primary_key=True)
-    name: Mapped[str] = mapped_column(String(128))
-    email: Mapped[str] = mapped_column(String(255), unique=True, index=True)
-    role: Mapped[str] = mapped_column(String(64))
-    status: Mapped[str] = mapped_column(String(32))
-    timezone: Mapped[str] = mapped_column(String(64))
-    last_login_at: Mapped[str] = mapped_column(String(64))
-
-
-class SqlAlchemyUserRepository:
-    def __init__(self, database_url: str) -> None:
-        self.engine = create_engine(database_url, future=True)
-        self.session_factory = sessionmaker(bind=self.engine, expire_on_commit=False)
-
-    def initialize(self) -> None:
-        Base.metadata.create_all(self.engine)
-
-    def seed_users(self, users: list[UserRecord]) -> None:
-        with self.session_factory() as session:
-            for user in users:
-                existing = session.get(UserTable, user.id)
-                if existing is None:
-                    session.add(UserTable(**user.model_dump()))
-                    continue
-                for field, value in user.model_dump().items():
-                    setattr(existing, field, value)
-            session.commit()
-
-    def get_by_id(self, user_id: str) -> UserRecord | None:
-        with self.session_factory() as session:
-            record = session.get(UserTable, user_id)
-            return self._to_record(record)
-
-    def list_summaries(self) -> list[UserSummary]:
-        with self.session_factory() as session:
-            records = session.scalars(select(UserTable).order_by(UserTable.id)).all()
-            return [
-                UserSummary(
-                    id=record.id,
-                    name=record.name,
-                    email=record.email,
-                    role=record.role,
-                    status=record.status,
-                )
-                for record in records
-            ]
-
-    def update_status(self, user_id: str, status: str) -> UserRecord | None:
-        with self.session_factory() as session:
-            record = session.get(UserTable, user_id)
-            if record is None:
-                return None
-            record.status = status
-            session.commit()
-            return self._to_record(record)
-
-    @staticmethod
-    def _to_record(record: UserTable | None) -> UserRecord | None:
-        if record is None:
-            return None
-        return UserRecord(
-            id=record.id,
-            name=record.name,
-            email=record.email,
-            role=record.role,
-            status=record.status,
-            timezone=record.timezone,
-            last_login_at=record.last_login_at,
-        )
-
-
-class PostgresUserRepository(SqlAlchemyUserRepository):
-    pass
-
-
-class MySqlUserRepository(SqlAlchemyUserRepository):
-    pass
-
-
-class MariaDbUserRepository(SqlAlchemyUserRepository):
-    pass

package/server/contexts/user/infrastructure/factory.py

@@ -1,28 +0,0 @@
-from functools import lru_cache
-from typing import TYPE_CHECKING
-
-from config import get_settings
-from contexts.user.infrastructure.adapters.memory import MemoryUserRepository
-from contexts.user.infrastructure.adapters.mongodb import MongoUserRepository
-from contexts.user.infrastructure.adapters.sqlalchemy import (
-    MariaDbUserRepository,
-    MySqlUserRepository,
-    PostgresUserRepository,
-)
-
-if TYPE_CHECKING:
-    from contexts.user.application.ports import UserRepository
-
-
-@lru_cache
-def get_user_repository() -> "UserRepository":
-    settings = get_settings()
-    if settings.database_backend == "postgres":
-        return PostgresUserRepository(settings.postgres_url)
-    if settings.database_backend == "mysql":
-        return MySqlUserRepository(settings.mysql_url)
-    if settings.database_backend == "mariadb":
-        return MariaDbUserRepository(settings.mariadb_url)
-    if settings.database_backend == "mongodb":
-        return MongoUserRepository(settings.mongodb_url, settings.mongodb_database)
-    return MemoryUserRepository()

package/server/data/README.md

@@ -1,24 +0,0 @@
-`data/`는 sample payload, fixture, seed data를 두는 루트다.
-
-기본 정책:
-
-- domain/application logic는 `contexts/*`에 둔다
-- 재사용 가능한 fixture와 seed payload는 `data/`에 둔다
-- adapter별 local bootstrap 데이터도 이 루트에 둔다
-
-현재 canonical bootstrap:
-
-- `bootstrap/auth_accounts.json`: auth credential/account bootstrap 원본
-- `bootstrap/users.json`: user profile bootstrap 원본
-- `bootstrap/catalog_products.json`: catalog product 원본
-- `bootstrap/inventory_levels.json`: inventory level 원본
-- `bootstrap/orders.json`: web/admin order surface 원본
-- `bootstrap/fulfillment_tasks.json`: mobile fulfillment board task 원본
-- `bootstrap/fulfillment_events.json`: mobile fulfillment timeline 원본
-- `bootstrap/fulfillment_notes.json`: mobile fulfillment note 원본
-- `bootstrap/support_faqs.json`: admin support surface 원본
-
-규칙:
-
-- 코드 안에 seed 레코드를 하드코딩하지 않는다
-- memory/postgres/mysql/mariadb/mongodb adapter는 같은 `data/bootstrap/*` 원본을 consume한다

package/server/data/bootstrap/alerts.json

@@ -1,38 +0,0 @@
-[
-  {
-    "id": "alr-1001",
-    "source": "orders",
-    "title": "예외 검토 대기",
-    "message": "주소 검증 보류 거래가 2건 누적되었습니다.",
-    "tone": "danger",
-    "created_at": "2026-03-14 09:12",
-    "read": false
-  },
-  {
-    "id": "alr-1002",
-    "source": "shipping",
-    "title": "배송 지연 감지",
-    "message": "Hanjin 라인에서 지연 shipment가 1건 발생했습니다.",
-    "tone": "warning",
-    "created_at": "2026-03-14 08:40",
-    "read": false
-  },
-  {
-    "id": "alr-1003",
-    "source": "inventory",
-    "title": "안전재고 임계치",
-    "message": "TSJ-BLK-S sku가 safety stock에 근접했습니다.",
-    "tone": "neutral",
-    "created_at": "2026-03-13 18:30",
-    "read": false
-  },
-  {
-    "id": "alr-1004",
-    "source": "support",
-    "title": "운영 지원 처리 완료",
-    "message": "교환 문의 1건이 해결 처리되었습니다.",
-    "tone": "neutral",
-    "created_at": "2026-03-13 15:10",
-    "read": true
-  }
-]

package/server/data/bootstrap/auth_accounts.json

@@ -1,18 +0,0 @@
-[
-  {
-    "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

@@ -1,179 +0,0 @@
-[
-  {
-    "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

@@ -1,5 +0,0 @@
-[
-  { "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

@@ -1,5 +0,0 @@
-[
-  { "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

@@ -1,50 +0,0 @@
-[
-  {
-    "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

@@ -1,80 +0,0 @@
-[
-  {
-    "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

@@ -1,62 +0,0 @@
-[
-  {
-    "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
-  }
-]