agentic-dev 0.1.0 → 0.2.0

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

@@ -0,0 +1,127 @@
+from contexts.orders.domain import (
+    AdminOrderOverview,
+    AdminQueueItem,
+    CreateOrderCommand,
+    DashboardStat,
+    OrderActivity,
+    OrderDetail,
+    OrderOverview,
+    OrderRecord,
+    OrderStatusTransition,
+    OrderSummary,
+    StageStatus,
+    UpdateOrderStatusCommand,
+)
+from contexts.orders.infrastructure import (
+    create_seed_order,
+    list_seed_orders,
+    update_seed_order_status,
+)
+
+
+def get_order_overview() -> OrderOverview:
+    records = list_seed_orders()
+    at_risk = [record for record in records if record.risk == "risk"]
+    revenue_total = sum(record.amount_krw for record in records)
+    recent_activity = [
+        OrderActivity(
+            order_id=record.id,
+            date=record.created_at,
+            customer=record.customer_name,
+            status=record.status,
+        )
+        for record in records[:3]
+    ]
+    selected = at_risk[0] if at_risk else records[0]
+
+    return OrderOverview(
+        stats=[
+            DashboardStat(
+                label="Active orders", value=str(len(records)), tone="text-[#22314d]"
+            ),
+            DashboardStat(
+                label="At risk",
+                value=str(len(at_risk)),
+                tone="text-[var(--app-danger)]",
+            ),
+            DashboardStat(
+                label="Revenue",
+                value=f"₩{revenue_total // 1_000_000}M",
+                tone="text-[var(--app-accent)]",
+            ),
+        ],
+        recent_activity=recent_activity,
+        selected_order=OrderDetail(
+            product_name=selected.product_name,
+            customer_name=selected.customer_name,
+            status=selected.status,
+            amount=f"₩{selected.amount_krw:,}",
+        ),
+    )
+
+
+def get_order_list() -> list[OrderSummary]:
+    return [
+        OrderSummary(
+            id=record.id,
+            product_name=record.product_name,
+            customer_name=record.customer_name,
+            status=record.status,
+        )
+        for record in list_seed_orders()
+    ]
+
+
+def get_admin_order_overview() -> AdminOrderOverview:
+    records = list_seed_orders()
+    pending = sum(1 for record in records if record.status == "Pending")
+    risky = sum(1 for record in records if record.risk == "risk")
+    new_today = sum(1 for record in records if record.is_new_today)
+    stage_counts: dict[str, int] = {}
+    for record in records:
+        stage_counts[record.stage] = stage_counts.get(record.stage, 0) + 1
+
+    return AdminOrderOverview(
+        cards=[
+            DashboardStat(label="대기 거래", value=str(pending), tone=None),
+            DashboardStat(
+                label="위험 거래", value=str(risky), tone="text-[var(--admin-danger)]"
+            ),
+            DashboardStat(
+                label="오늘 신규",
+                value=str(new_today),
+                tone="text-[var(--admin-accent)]",
+            ),
+        ],
+        stage_statuses=[
+            StageStatus(label=label, value=f"{count}건")
+            for label, count in stage_counts.items()
+        ],
+    )
+
+
+def get_admin_queue() -> list[AdminQueueItem]:
+    return [
+        AdminQueueItem(
+            order_id=record.id,
+            product_name=record.product_name,
+            customer_name=record.customer_name,
+            status=record.fulfillment_status,
+            sla=record.sla,
+        )
+        for record in list_seed_orders()
+    ]
+
+
+def create_order(command: CreateOrderCommand) -> OrderRecord:
+    return create_seed_order(command)
+
+
+def update_order_status(
+    order_id: str, command: UpdateOrderStatusCommand
+) -> OrderStatusTransition:
+    return update_seed_order_status(order_id, command)
+
+
+def prepare_order_store() -> None:
+    list_seed_orders()

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

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

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

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

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

@@ -0,0 +1,82 @@
+from fastapi import APIRouter, Depends, HTTPException
+
+from contexts.auth.contracts.http.dependencies import (
+    require_admin_user,
+    require_authenticated_user,
+)
+from contexts.orders.application import (
+    create_order as create_order_service,
+    get_admin_order_overview,
+    get_admin_queue,
+    get_order_list,
+    get_order_overview,
+    update_order_status as update_order_status_service,
+)
+from contexts.orders.domain import (
+    AdminOrderOverview,
+    AdminQueueItem,
+    CreateOrderCommand,
+    OrderOverview,
+    OrderRecord,
+    OrderStatusTransition,
+    OrderSummary,
+    UpdateOrderStatusCommand,
+)
+
+router = APIRouter(prefix="/orders", tags=["orders"])
+
+
+@router.get(
+    "/overview",
+    response_model=OrderOverview,
+    dependencies=[Depends(require_authenticated_user)],
+)
+def order_overview() -> OrderOverview:
+    return get_order_overview()
+
+
+@router.get("", response_model=list[OrderSummary], dependencies=[Depends(require_authenticated_user)])
+def list_orders() -> list[OrderSummary]:
+    return get_order_list()
+
+
+@router.post(
+    "",
+    response_model=OrderRecord,
+    status_code=201,
+    dependencies=[Depends(require_authenticated_user)],
+)
+def create_order(command: CreateOrderCommand) -> OrderRecord:
+    return create_order_service(command)
+
+
+@router.get(
+    "/admin/overview",
+    response_model=AdminOrderOverview,
+    dependencies=[Depends(require_admin_user)],
+)
+def admin_order_overview() -> AdminOrderOverview:
+    return get_admin_order_overview()
+
+
+@router.get(
+    "/admin/queue",
+    response_model=list[AdminQueueItem],
+    dependencies=[Depends(require_admin_user)],
+)
+def admin_queue() -> list[AdminQueueItem]:
+    return get_admin_queue()
+
+
+@router.patch(
+    "/{order_id}/status",
+    response_model=OrderStatusTransition,
+    dependencies=[Depends(require_authenticated_user)],
+)
+def update_order_status(
+    order_id: str, command: UpdateOrderStatusCommand
+) -> OrderStatusTransition:
+    try:
+        return update_order_status_service(order_id, command)
+    except LookupError as exc:
+        raise HTTPException(status_code=404, detail=str(exc)) from exc

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

@@ -0,0 +1,29 @@
+from .models import (
+    AdminOrderOverview,
+    AdminQueueItem,
+    CreateOrderCommand,
+    DashboardStat,
+    OrderActivity,
+    OrderDetail,
+    OrderOverview,
+    OrderRecord,
+    OrderStatusTransition,
+    OrderSummary,
+    StageStatus,
+    UpdateOrderStatusCommand,
+)
+
+__all__ = [
+    "AdminOrderOverview",
+    "AdminQueueItem",
+    "CreateOrderCommand",
+    "DashboardStat",
+    "OrderActivity",
+    "OrderDetail",
+    "OrderOverview",
+    "OrderRecord",
+    "OrderStatusTransition",
+    "OrderSummary",
+    "StageStatus",
+    "UpdateOrderStatusCommand",
+]

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

@@ -0,0 +1,95 @@
+from pydantic import BaseModel
+
+
+class OrderRecord(BaseModel):
+    id: str
+    product_id: str
+    product_name: str
+    customer_name: str
+    seller_name: str
+    status: str
+    fulfillment_status: str
+    created_at: str
+    amount_krw: int
+    risk: str
+    stage: str
+    sla: str
+    is_new_today: bool
+
+
+class DashboardStat(BaseModel):
+    label: str
+    value: str
+    tone: str | None = None
+
+
+class OrderActivity(BaseModel):
+    order_id: str
+    date: str
+    customer: str
+    status: str
+
+
+class OrderDetail(BaseModel):
+    product_name: str
+    customer_name: str
+    status: str
+    amount: str
+
+
+class OrderOverview(BaseModel):
+    stats: list[DashboardStat]
+    recent_activity: list[OrderActivity]
+    selected_order: OrderDetail
+
+
+class OrderSummary(BaseModel):
+    id: str
+    product_name: str
+    customer_name: str
+    status: str
+
+
+class StageStatus(BaseModel):
+    label: str
+    value: str
+
+
+class AdminOrderOverview(BaseModel):
+    cards: list[DashboardStat]
+    stage_statuses: list[StageStatus]
+
+
+class AdminQueueItem(BaseModel):
+    order_id: str
+    product_name: str
+    customer_name: str
+    status: str
+    sla: str
+
+
+class CreateOrderCommand(BaseModel):
+    product_id: str
+    product_name: str
+    customer_name: str
+    seller_name: str
+    amount_krw: int
+    stage: str = "결제 대기"
+    status: str = "Pending"
+    fulfillment_status: str = "Queued"
+    sla: str = "55 min"
+
+
+class UpdateOrderStatusCommand(BaseModel):
+    status: str
+    fulfillment_status: str | None = None
+    stage: str | None = None
+
+
+class OrderStatusTransition(BaseModel):
+    id: str
+    previous_status: str
+    status: str
+    fulfillment_status: str
+    risk: str
+    stage: str

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

@@ -0,0 +1,7 @@
+from .repository import create_seed_order, list_seed_orders, update_seed_order_status
+
+__all__ = [
+    "create_seed_order",
+    "list_seed_orders",
+    "update_seed_order_status",
+]

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

@@ -0,0 +1,104 @@
+from datetime import date
+
+from contexts.orders.domain import (
+    CreateOrderCommand,
+    OrderRecord,
+    OrderStatusTransition,
+    UpdateOrderStatusCommand,
+)
+from data.bootstrap_loader import load_bootstrap_json
+
+_order_store: list[OrderRecord] | None = None
+
+
+def _get_order_store() -> list[OrderRecord]:
+    global _order_store
+    if _order_store is None:
+        _order_store = [
+            OrderRecord(**entry) for entry in load_bootstrap_json("orders.json")
+        ]
+    return _order_store
+
+
+def _copy_orders(records: list[OrderRecord]) -> list[OrderRecord]:
+    return [record.model_copy(deep=True) for record in records]
+
+
+def _next_order_number(records: list[OrderRecord]) -> int:
+    return max((int(record.id.split("-")[-1]) for record in records), default=24050) + 1
+
+
+def _derive_fulfillment_status(status: str, current_status: str | None = None) -> str:
+    fulfillment_status_map = {
+        "Pending": "Queued",
+        "Paid": "Picking",
+        "At risk": "Exception",
+        "Completed": "Delivered",
+        "Cancelled": "Cancelled",
+    }
+    return fulfillment_status_map.get(status, current_status or "Queued")
+
+
+def _derive_risk(status: str, current_risk: str | None = None) -> str:
+    if status == "At risk":
+        return "risk"
+    if status in {"Approved", "Completed"}:
+        return "ok"
+    return current_risk or "ok"
+
+
+def list_seed_orders() -> list[OrderRecord]:
+    return _copy_orders(_get_order_store())
+
+
+def create_seed_order(command: CreateOrderCommand) -> OrderRecord:
+    records = _get_order_store()
+    next_order_number = _next_order_number(records)
+    today = date.today().strftime("%Y.%m.%d")
+    record = OrderRecord(
+        id=f"ORD-{next_order_number:05d}",
+        product_id=command.product_id,
+        product_name=command.product_name,
+        customer_name=command.customer_name,
+        seller_name=command.seller_name,
+        status=command.status,
+        fulfillment_status=command.fulfillment_status,
+        created_at=today,
+        amount_krw=command.amount_krw,
+        risk=_derive_risk(command.status),
+        stage=command.stage,
+        sla=command.sla,
+        is_new_today=True,
+    )
+    records.insert(0, record)
+    return record.model_copy(deep=True)
+
+
+def update_seed_order_status(
+    order_id: str, command: UpdateOrderStatusCommand
+) -> OrderStatusTransition:
+    records = _get_order_store()
+    for index, record in enumerate(records):
+        if record.id != order_id:
+            continue
+
+        updated_record = record.model_copy(
+            update={
+                "status": command.status,
+                "fulfillment_status": command.fulfillment_status
+                or _derive_fulfillment_status(command.status, record.fulfillment_status),
+                "risk": _derive_risk(command.status, record.risk),
+                "stage": command.stage or record.stage,
+            }
+        )
+        records[index] = updated_record
+        return OrderStatusTransition(
+            id=updated_record.id,
+            previous_status=record.status,
+            status=updated_record.status,
+            fulfillment_status=updated_record.fulfillment_status,
+            risk=updated_record.risk,
+            stage=updated_record.stage,
+        )
+
+    raise LookupError(f"Order {order_id} not found")

package/server/contexts/shipping/__init__.py

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

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

@@ -0,0 +1,13 @@
+from .services import (
+    get_shipment_list,
+    get_shipping_overview,
+    prepare_shipping_store,
+    transition_shipment_status,
+)
+
+__all__ = [
+    "get_shipment_list",
+    "get_shipping_overview",
+    "prepare_shipping_store",
+    "transition_shipment_status",
+]

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

@@ -0,0 +1,92 @@
+from contexts.shipping.domain import (
+    ShippingCarrierLoad,
+    ShippingOverview,
+    ShippingStat,
+    ShipmentStatusTransition,
+    ShipmentSummary,
+    UpdateShipmentStatusCommand,
+)
+from contexts.shipping.infrastructure import (
+    list_seed_shipments,
+    transition_seed_shipment_status,
+)
+
+
+def get_shipping_overview() -> ShippingOverview:
+    records = list_seed_shipments()
+    in_transit_count = sum(
+        1
+        for record in records
+        if record.status in {"In transit", "Out for delivery", "Delayed"}
+    )
+    delayed_count = sum(1 for record in records if record.status == "Delayed")
+    delivered_today_count = sum(1 for record in records if record.delivered_today)
+
+    carrier_names = sorted({record.carrier for record in records})
+    carriers = []
+    for carrier in carrier_names:
+        carrier_records = [record for record in records if record.carrier == carrier]
+        delayed_for_carrier = sum(
+            1 for record in carrier_records if record.status == "Delayed"
+        )
+        carriers.append(
+            ShippingCarrierLoad(
+                label=carrier,
+                value=f"{len(carrier_records)}건 · 지연 {delayed_for_carrier}건",
+            )
+        )
+
+    highlighted = next(
+        (record for record in records if record.status == "Delayed"),
+        records[0],
+    )
+
+    return ShippingOverview(
+        stats=[
+            ShippingStat(
+                label="배송 중",
+                value=str(in_transit_count),
+                tone="text-[var(--in-accent)]",
+            ),
+            ShippingStat(
+                label="지연",
+                value=str(delayed_count),
+                tone="text-[#c4663a]",
+            ),
+            ShippingStat(
+                label="오늘 완료",
+                value=str(delivered_today_count),
+                tone="text-[#245f92]",
+            ),
+        ],
+        carriers=carriers,
+        highlighted_route=(
+            f"{highlighted.route_name} · {highlighted.last_event}"
+        ),
+    )
+
+
+def get_shipment_list() -> list[ShipmentSummary]:
+    return [
+        ShipmentSummary(
+            shipment_id=record.shipment_id,
+            order_id=record.order_id,
+            carrier=record.carrier,
+            destination=record.destination,
+            tracking_number=record.tracking_number,
+            status=record.status,
+            eta=record.eta,
+            last_event=record.last_event,
+        )
+        for record in list_seed_shipments()
+    ]
+
+
+def transition_shipment_status(
+    shipment_id: str, command: UpdateShipmentStatusCommand
+) -> ShipmentStatusTransition:
+    return transition_seed_shipment_status(shipment_id, command)
+
+
+def prepare_shipping_store() -> None:
+    list_seed_shipments()

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

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

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

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

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

@@ -0,0 +1,40 @@
+from fastapi import APIRouter, Depends, HTTPException
+
+from contexts.auth.contracts.http.dependencies import require_authenticated_user
+from contexts.shipping.application import (
+    get_shipment_list,
+    get_shipping_overview,
+    transition_shipment_status,
+)
+from contexts.shipping.domain import (
+    ShippingOverview,
+    ShipmentStatusTransition,
+    ShipmentSummary,
+    UpdateShipmentStatusCommand,
+)
+
+router = APIRouter(
+    prefix="/shipping",
+    tags=["shipping"],
+    dependencies=[Depends(require_authenticated_user)],
+)
+
+
+@router.get("/overview", response_model=ShippingOverview)
+def shipping_overview() -> ShippingOverview:
+    return get_shipping_overview()
+
+
+@router.get("/shipments", response_model=list[ShipmentSummary])
+def list_shipments() -> list[ShipmentSummary]:
+    return get_shipment_list()
+
+
+@router.patch("/shipments/{shipment_id}/status", response_model=ShipmentStatusTransition)
+def patch_shipment_status(
+    shipment_id: str, command: UpdateShipmentStatusCommand
+) -> ShipmentStatusTransition:
+    try:
+        return transition_shipment_status(shipment_id, command)
+    except LookupError as exc:
+        raise HTTPException(status_code=404, detail=str(exc)) from exc

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

@@ -0,0 +1,19 @@
+from .models import (
+    ShippingCarrierLoad,
+    ShippingOverview,
+    ShippingStat,
+    ShipmentRecord,
+    ShipmentStatusTransition,
+    ShipmentSummary,
+    UpdateShipmentStatusCommand,
+)
+
+__all__ = [
+    "ShippingCarrierLoad",
+    "ShippingOverview",
+    "ShippingStat",
+    "ShipmentRecord",
+    "ShipmentStatusTransition",
+    "ShipmentSummary",
+    "UpdateShipmentStatusCommand",
+]

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

@@ -0,0 +1,48 @@
+from pydantic import BaseModel
+
+
+class ShippingStat(BaseModel):
+    label: str
+    value: str
+    tone: str | None = None
+
+
+class ShippingCarrierLoad(BaseModel):
+    label: str
+    value: str
+
+
+class ShippingOverview(BaseModel):
+    stats: list[ShippingStat]
+    carriers: list[ShippingCarrierLoad]
+    highlighted_route: str
+
+
+class ShipmentSummary(BaseModel):
+    shipment_id: str
+    order_id: str
+    carrier: str
+    destination: str
+    tracking_number: str
+    status: str
+    eta: str
+    last_event: str
+
+
+class ShipmentRecord(ShipmentSummary):
+    route_name: str
+    delivered_today: bool
+
+
+class UpdateShipmentStatusCommand(BaseModel):
+    status: str
+    last_event: str
+    eta: str | None = None
+
+
+class ShipmentStatusTransition(BaseModel):
+    shipment_id: str
+    previous_status: str
+    status: str
+    previous_last_event: str
+    last_event: str

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

@@ -0,0 +1,9 @@
+from .repository import (
+    list_seed_shipments,
+    transition_seed_shipment_status,
+)
+
+__all__ = [
+    "list_seed_shipments",
+    "transition_seed_shipment_status",
+]