agentic-dev 0.2.10 → 0.2.12

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -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"
-  }
-]