Handle Decimal conversion for manual holdings quantity and add test coverage

- Update `kis.py` to ensure `ord_psbl_qty` or `hldg_qty` values are converted to integers after passing through float to handle Decimal cases.
- Add new tests for validating proper Decimal-to-int conversion in manual holdings integration scenarios.
- Include mocks and assertions to verify correct quantity type and value during sell automation tasks.

Author: robin-watcha

app/tasks/kis.py

@@ -475,7 +475,8 @@ async def _run() -> dict:
                 current_price = float(stock.get('prpr', 0))
                 # 매도 시 미체결 주문을 제외한 주문 가능 수량(ord_psbl_qty)을 사용
                 # ord_psbl_qty가 없으면 hldg_qty를 fallback으로 사용
-                qty = int(stock.get('ord_psbl_qty', stock.get('hldg_qty', 0)))
+                # 수동 잔고의 경우 Decimal이 str로 변환되어 소수점이 있을 수 있으므로 float을 거쳐 int로 변환
+                qty = int(float(stock.get('ord_psbl_qty', stock.get('hldg_qty', 0))))
                 is_manual = stock.get('_is_manual', False)
 
                 # 수동 잔고 종목인 경우 현재가를 API로 조회

tests/test_kis_manual_holdings_integration.py

@@ -283,3 +283,83 @@ async def fake_sell(kis, symbol, current_price, avg_price, qty):
 
         # 현재가 조회 API가 호출되어야 함
         assert "005930" in price_fetch_calls, "수동 잔고 종목의 현재가를 조회해야 함"
+
+    def test_manual_holdings_decimal_conversion(self, monkeypatch):
+        """Decimal 타입의 수량/가격이 올바르게 변환되는지 확인"""
+        from app.tasks import kis as kis_tasks
+        from decimal import Decimal
+
+        class DummyAnalyzer:
+            async def analyze_stock_json(self, name):
+                return {"decision": "hold", "confidence": 65}, "gemini-2.5-pro"
+
+            async def close(self):
+                return None
+
+        class DummyKIS:
+            async def fetch_my_stocks(self):
+                return []  # KIS에는 보유 종목 없음
+
+            async def inquire_korea_orders(self, *args, **kwargs):
+                return []
+
+            async def cancel_korea_order(self, *args, **kwargs):
+                return {"odno": "0000001"}
+
+            async def fetch_fundamental_info(self, code):
+                return {"종목명": "삼성전자", "현재가": 72000}
+
+        # Mock manual holding with Decimal values that have many decimal places
+        manual_holding = MagicMock()
+        manual_holding.ticker = "005930"
+        manual_holding.display_name = "삼성전자"
+        manual_holding.quantity = Decimal("2.00000000")  # 소수점 많은 Decimal
+        manual_holding.avg_price = Decimal("70000.00000000")  # 소수점 많은 Decimal
+
+        class MockManualService:
+            def __init__(self, db):
+                pass
+
+            async def get_holdings_by_user(self, user_id, market_type):
+                return [manual_holding]
+
+        sell_calls = []
+
+        async def fake_buy(kis, symbol, current_price, avg_price):
+            return {"success": False, "message": "조건 미충족", "orders_placed": 0}
+
+        async def fake_sell(kis, symbol, current_price, avg_price, qty):
+            # qty가 올바르게 정수로 전달되는지 확인
+            sell_calls.append({"symbol": symbol, "qty": qty, "qty_type": type(qty).__name__})
+            return {"success": False, "message": "조건 미충족", "orders_placed": 0}
+
+        # Mock DB session
+        mock_db_session = MagicMock()
+        mock_db_session.__aenter__ = AsyncMock(return_value=MagicMock())
+        mock_db_session.__aexit__ = AsyncMock(return_value=None)
+
+        with patch('app.core.db.AsyncSessionLocal', return_value=mock_db_session), \
+             patch('app.services.manual_holdings_service.ManualHoldingsService', MockManualService):
+
+            monkeypatch.setattr(kis_tasks, "KISClient", DummyKIS)
+            monkeypatch.setattr(kis_tasks, "KISAnalyzer", DummyAnalyzer)
+            monkeypatch.setattr(kis_tasks, "process_kis_domestic_buy_orders_with_analysis", fake_buy)
+            monkeypatch.setattr(kis_tasks, "process_kis_domestic_sell_orders_with_analysis", fake_sell)
+            monkeypatch.setattr(
+                kis_tasks.run_per_domestic_stock_automation,
+                "update_state",
+                lambda *_, **__: None,
+                raising=False,
+            )
+
+            result = kis_tasks.run_per_domestic_stock_automation.apply().result
+
+        # 태스크가 성공적으로 완료되어야 함
+        assert result["status"] == "completed"
+
+        # 매도 함수가 호출되어야 함
+        assert len(sell_calls) == 1, "매도 함수가 호출되어야 함"
+
+        # qty가 정수 타입이어야 함
+        assert sell_calls[0]["qty_type"] == "int", f"수량은 int 타입이어야 하는데 {sell_calls[0]['qty_type']} 타입임"
+        assert sell_calls[0]["qty"] == 2, f"수량은 2여야 하는데 {sell_calls[0]['qty']}임"