agentic-dev 0.1.0 → 0.2.0

package/server/contexts/shipping/infrastructure/repository.py

@@ -0,0 +1,50 @@
+from contexts.shipping.domain import (
+    ShipmentRecord,
+    ShipmentStatusTransition,
+    UpdateShipmentStatusCommand,
+)
+from data.bootstrap_loader import load_bootstrap_json
+
+_shipment_store: list[ShipmentRecord] | None = None
+
+
+def _get_shipment_store() -> list[ShipmentRecord]:
+    global _shipment_store
+    if _shipment_store is None:
+        _shipment_store = [
+            ShipmentRecord(**entry)
+            for entry in load_bootstrap_json("shipping_shipments.json")
+        ]
+    return _shipment_store
+
+
+def list_seed_shipments() -> list[ShipmentRecord]:
+    return [record.model_copy(deep=True) for record in _get_shipment_store()]
+
+
+def transition_seed_shipment_status(
+    shipment_id: str, command: UpdateShipmentStatusCommand
+) -> ShipmentStatusTransition:
+    records = _get_shipment_store()
+    for index, record in enumerate(records):
+        if record.shipment_id != shipment_id:
+            continue
+
+        updated_record = record.model_copy(
+            update={
+                "status": command.status,
+                "last_event": command.last_event,
+                "eta": command.eta or record.eta,
+                "delivered_today": command.status == "Delivered",
+            }
+        )
+        records[index] = updated_record
+        return ShipmentStatusTransition(
+            shipment_id=updated_record.shipment_id,
+            previous_status=record.status,
+            status=updated_record.status,
+            previous_last_event=record.last_event,
+            last_event=updated_record.last_event,
+        )
+
+    raise LookupError(f"Shipment {shipment_id} not found")

package/server/contexts/support/__init__.py

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

package/server/contexts/support/application/__init__.py

@@ -0,0 +1,13 @@
+from .services import (
+    change_faq_visibility,
+    create_support_faq,
+    get_support_faqs,
+    prepare_support_store,
+)
+
+__all__ = [
+    "change_faq_visibility",
+    "create_support_faq",
+    "get_support_faqs",
+    "prepare_support_store",
+]

package/server/contexts/support/application/services.py

@@ -0,0 +1,29 @@
+from contexts.support.domain import (
+    ChangeFaqVisibilityCommand,
+    CreateSupportFaqCommand,
+    SupportFaq,
+    SupportFaqRecord,
+)
+from contexts.support.infrastructure import (
+    create_seed_support_faq,
+    list_seed_support_faqs,
+    update_seed_support_faq_visibility,
+)
+
+
+def get_support_faqs() -> list[SupportFaq]:
+    return list_seed_support_faqs()
+
+
+def create_support_faq(command: CreateSupportFaqCommand) -> SupportFaqRecord:
+    return create_seed_support_faq(command)
+
+
+def change_faq_visibility(
+    faq_id: str, command: ChangeFaqVisibilityCommand
+) -> SupportFaqRecord:
+    return update_seed_support_faq_visibility(faq_id, command)
+
+
+def prepare_support_store() -> None:
+    list_seed_support_faqs()

package/server/contexts/support/contracts/__init__.py

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

package/server/contexts/support/contracts/http/__init__.py

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

package/server/contexts/support/contracts/http/router.py

@@ -0,0 +1,40 @@
+from fastapi import APIRouter, Depends, HTTPException
+
+from contexts.auth.contracts.http.dependencies import require_admin_user
+from contexts.support.application import (
+    change_faq_visibility,
+    create_support_faq,
+    get_support_faqs,
+)
+from contexts.support.domain import (
+    ChangeFaqVisibilityCommand,
+    CreateSupportFaqCommand,
+    SupportFaq,
+    SupportFaqRecord,
+)
+
+router = APIRouter(
+    prefix="/support",
+    tags=["support"],
+    dependencies=[Depends(require_admin_user)],
+)
+
+
+@router.get("/faqs", response_model=list[SupportFaq])
+def support_faqs() -> list[SupportFaq]:
+    return get_support_faqs()
+
+
+@router.post("/faqs", response_model=SupportFaqRecord, status_code=201)
+def create_support_faq_entry(command: CreateSupportFaqCommand) -> SupportFaqRecord:
+    return create_support_faq(command)
+
+
+@router.patch("/faqs/{faq_id}/visibility", response_model=SupportFaqRecord)
+def change_support_faq_visibility(
+    faq_id: str, command: ChangeFaqVisibilityCommand
+) -> SupportFaqRecord:
+    try:
+        return change_faq_visibility(faq_id, command)
+    except LookupError as exc:
+        raise HTTPException(status_code=404, detail=str(exc)) from exc

package/server/contexts/support/domain/__init__.py

@@ -0,0 +1,13 @@
+from .models import (
+    ChangeFaqVisibilityCommand,
+    CreateSupportFaqCommand,
+    SupportFaq,
+    SupportFaqRecord,
+)
+
+__all__ = [
+    "ChangeFaqVisibilityCommand",
+    "CreateSupportFaqCommand",
+    "SupportFaq",
+    "SupportFaqRecord",
+]

package/server/contexts/support/domain/models.py

@@ -0,0 +1,27 @@
+from pydantic import BaseModel
+
+
+class SupportFaq(BaseModel):
+    id: str
+    question: str
+    visibility: str
+
+
+class SupportFaqRecord(BaseModel):
+    id: str
+    question: str
+    answer: str
+    category: str
+    visibility: str
+    updated_at: str
+
+
+class CreateSupportFaqCommand(BaseModel):
+    question: str
+    answer: str
+    category: str = "General"
+    visibility: str = "노출"
+
+
+class ChangeFaqVisibilityCommand(BaseModel):
+    visibility: str

package/server/contexts/support/infrastructure/__init__.py

@@ -0,0 +1,11 @@
+from .repository import (
+    create_seed_support_faq,
+    list_seed_support_faqs,
+    update_seed_support_faq_visibility,
+)
+
+__all__ = [
+    "create_seed_support_faq",
+    "list_seed_support_faqs",
+    "update_seed_support_faq_visibility",
+]

package/server/contexts/support/infrastructure/repository.py

@@ -0,0 +1,70 @@
+from datetime import date
+
+from contexts.support.domain import (
+    ChangeFaqVisibilityCommand,
+    CreateSupportFaqCommand,
+    SupportFaq,
+    SupportFaqRecord,
+)
+from data.bootstrap_loader import load_bootstrap_json
+
+_support_faq_store: list[SupportFaqRecord] | None = None
+
+
+def _get_support_faq_store() -> list[SupportFaqRecord]:
+    global _support_faq_store
+    if _support_faq_store is None:
+        _support_faq_store = [
+            SupportFaqRecord(**entry)
+            for entry in load_bootstrap_json("support_faqs.json")
+        ]
+    return _support_faq_store
+
+
+def _copy_support_faq(record: SupportFaqRecord) -> SupportFaqRecord:
+    return record.model_copy(deep=True)
+
+
+def _next_faq_number(records: list[SupportFaqRecord]) -> int:
+    return max((int(record.id.split("-")[-1]) for record in records), default=0) + 1
+
+
+def list_seed_support_faqs() -> list[SupportFaq]:
+    return [
+        SupportFaq(id=record.id, question=record.question, visibility=record.visibility)
+        for record in _get_support_faq_store()
+    ]
+
+
+def create_seed_support_faq(command: CreateSupportFaqCommand) -> SupportFaqRecord:
+    records = _get_support_faq_store()
+    record = SupportFaqRecord(
+        id=f"faq-{_next_faq_number(records)}",
+        question=command.question,
+        answer=command.answer,
+        category=command.category,
+        visibility=command.visibility,
+        updated_at=date.today().isoformat(),
+    )
+    records.insert(0, record)
+    return _copy_support_faq(record)
+
+
+def update_seed_support_faq_visibility(
+    faq_id: str, command: ChangeFaqVisibilityCommand
+) -> SupportFaqRecord:
+    records = _get_support_faq_store()
+    for index, record in enumerate(records):
+        if record.id != faq_id:
+            continue
+
+        updated_record = record.model_copy(
+            update={
+                "visibility": command.visibility,
+                "updated_at": date.today().isoformat(),
+            }
+        )
+        records[index] = updated_record
+        return _copy_support_faq(updated_record)
+
+    raise LookupError(f"Support FAQ {faq_id} not found")

package/server/contexts/user/__init__.py

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

package/server/contexts/user/application/__init__.py

@@ -0,0 +1,3 @@
+from .services import get_user_or_404, list_user_summaries, prepare_user_store, update_user_status_or_404
+
+__all__ = ["get_user_or_404", "list_user_summaries", "prepare_user_store", "update_user_status_or_404"]

package/server/contexts/user/application/ports.py

@@ -0,0 +1,11 @@
+from typing import Protocol
+
+from contexts.user.domain import UserRecord, UserSummary
+
+
+class UserRepository(Protocol):
+    def initialize(self) -> None: ...
+    def seed_users(self, users: list[UserRecord]) -> None: ...
+    def get_by_id(self, user_id: str) -> UserRecord | None: ...
+    def list_summaries(self) -> list[UserSummary]: ...
+    def update_status(self, user_id: str, status: str) -> UserRecord | None: ...

package/server/contexts/user/application/services.py

@@ -0,0 +1,44 @@
+from fastapi import HTTPException, status
+
+from contexts.user.domain import UpdateUserStatusCommand, UserDetail, UserRecord, UserSummary
+from contexts.user.infrastructure import get_user_repository
+from data.bootstrap_loader import load_bootstrap_json
+
+
+def list_user_summaries() -> list[UserSummary]:
+    repository = get_user_repository()
+    return repository.list_summaries()
+
+
+def get_user_or_404(user_id: str) -> UserDetail:
+    repository = get_user_repository()
+    user = repository.get_by_id(user_id)
+    if user is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="User not found")
+    return UserDetail(**user.model_dump())
+
+
+def update_user_status_or_404(user_id: str, command: UpdateUserStatusCommand) -> UserDetail:
+    repository = get_user_repository()
+    user = repository.update_status(user_id, command.status)
+    if user is None:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail="User not found")
+    return UserDetail(**user.model_dump())
+
+
+def prepare_user_store() -> None:
+    repository = get_user_repository()
+    repository.initialize()
+    records = [
+        UserRecord(
+            id=entry["id"],
+            name=entry["name"],
+            email=entry["email"],
+            role=entry["role"],
+            status=entry["status"],
+            timezone=entry["timezone"],
+            last_login_at=entry["last_login_at"],
+        )
+        for entry in load_bootstrap_json("users.json")
+    ]
+    repository.seed_users(records)

package/server/contexts/user/contracts/__init__.py

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

package/server/contexts/user/contracts/http/__init__.py

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

package/server/contexts/user/contracts/http/router.py

@@ -0,0 +1,26 @@
+from fastapi import APIRouter, Depends
+
+from contexts.auth.contracts.http.dependencies import require_admin_user
+from contexts.user.application import get_user_or_404, list_user_summaries, update_user_status_or_404
+from contexts.user.domain import UpdateUserStatusCommand, UserDetail, UserSummary
+
+router = APIRouter(
+    prefix="/users",
+    tags=["users"],
+    dependencies=[Depends(require_admin_user)],
+)
+
+
+@router.get("", response_model=list[UserSummary])
+def list_users() -> list[UserSummary]:
+    return list_user_summaries()
+
+
+@router.get("/{user_id}", response_model=UserDetail)
+def get_user(user_id: str) -> UserDetail:
+    return get_user_or_404(user_id)
+
+
+@router.patch("/{user_id}/status", response_model=UserDetail)
+def update_user_status(user_id: str, command: UpdateUserStatusCommand) -> UserDetail:
+    return update_user_status_or_404(user_id, command)

package/server/contexts/user/domain/__init__.py

@@ -0,0 +1,3 @@
+from .models import UpdateUserStatusCommand, UserDetail, UserRecord, UserSummary
+
+__all__ = ["UserSummary", "UserDetail", "UserRecord", "UpdateUserStatusCommand"]

package/server/contexts/user/domain/models.py

@@ -0,0 +1,22 @@
+from pydantic import BaseModel, EmailStr
+
+
+class UserSummary(BaseModel):
+    id: str
+    name: str
+    email: EmailStr
+    role: str
+    status: str
+
+
+class UserDetail(UserSummary):
+    timezone: str
+    last_login_at: str
+
+
+class UserRecord(UserDetail):
+    pass
+
+
+class UpdateUserStatusCommand(BaseModel):
+    status: str

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

@@ -0,0 +1,3 @@
+from .factory import get_user_repository
+
+__all__ = ["get_user_repository"]

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

@@ -0,0 +1,27 @@
+from contexts.user.domain import UserRecord, UserSummary
+
+
+class MemoryUserRepository:
+    def __init__(self) -> None:
+        self._users: dict[str, UserRecord] = {}
+
+    def initialize(self) -> None:
+        return None
+
+    def seed_users(self, users: list[UserRecord]) -> None:
+        for user in users:
+            self._users[user.id] = user
+
+    def get_by_id(self, user_id: str) -> UserRecord | None:
+        return self._users.get(user_id)
+
+    def list_summaries(self) -> list[UserSummary]:
+        return [UserSummary(**user.model_dump(exclude={"timezone", "last_login_at"})) for user in self._users.values()]
+
+    def update_status(self, user_id: str, status: str) -> UserRecord | None:
+        user = self._users.get(user_id)
+        if user is None:
+            return None
+        updated_user = user.model_copy(update={"status": status})
+        self._users[user_id] = updated_user
+        return updated_user

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

@@ -0,0 +1,41 @@
+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

@@ -0,0 +1,94 @@
+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

@@ -0,0 +1,28 @@
+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

@@ -0,0 +1,24 @@
+`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`: platform/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

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