Rename core/scorer.py to core/scoring.py

core/{scorer.py → scoring.py}

@@ -1,6 +1,5 @@
 from __future__ import annotations
-from typing import Dict, Any, List
-import math
+from typing import Dict, Any
 
 def _nz(x):
     try:
@@ -11,6 +10,10 @@ def _nz(x):
 def clamp(x, lo=0, hi=100): return max(lo, min(hi, x))
 
 def score_company(fin: Dict[str, Any]) -> Dict[str, Any]:
+    """
+    すべて『円』換算済みの fin を前提
+    数量スケールの違いで比率が歪まないよう、原則として比率/マージン/回転率ベースで採点
+    """
     bs = fin.get("balance_sheet", {}) or {}
     pl = fin.get("income_statement", {}) or {}
 
@@ -22,26 +25,26 @@ def score_company(fin: Dict[str, Any]) -> Dict[str, Any]:
     opinc    = _nz(pl.get("operating_income"))
     netinc   = _nz(pl.get("net_income"))
 
-    # 指標
-    equity_ratio    = equity / assets if assets > 0 else 0.0             # 自己資本比率
-    current_ratio   = curA / curL if curL > 0 else (2.0 if curA > 0 else 0.0)  # 流動比率
+    # 比率
+    equity_ratio    = equity / assets if assets > 0 else 0.0
+    current_ratio   = curA / curL if curL > 0 else (2.0 if curA > 0 else 0.0)
     op_margin       = opinc / sales if sales > 0 else 0.0
     net_margin      = netinc / sales if sales > 0 else 0.0
     roa             = netinc / assets if assets > 0 else 0.0
 
-    # スコア化（100点満点換算）
-    s_equity   = clamp(equity_ratio * 200)            # 50%で100点
-    s_liquid   = clamp((current_ratio / 2.0) * 100)   # 200%で100点
-    s_opm      = clamp(op_margin * 400)               # 25%で100点
-    s_npm      = clamp(net_margin * 400)              # 25%で100点
-    s_roa      = clamp(roa * 1000)                    # 10%で100点
+    # スコア（100点換算）
+    s_equity   = clamp(equity_ratio * 200)            # 50%で100
+    s_liquid   = clamp((current_ratio / 2.0) * 100)   # 200%で100
+    s_opm      = clamp(op_margin * 400)               # 25%で100
+    s_npm      = clamp(net_margin * 400)              # 25%で100
+    s_roa      = clamp(roa * 1000)                    # 10%で100
 
     details = [
-        {"metric": "自己資本比率", "value": round(equity_ratio*100, 2), "score": round(s_equity,1)},
-        {"metric": "流動比率",   "value": round(current_ratio*100, 1), "score": round(s_liquid,1)},
-        {"metric": "営業利益率", "value": round(op_margin*100, 2),     "score": round(s_opm,1)},
-        {"metric": "純利益率",   "value": round(net_margin*100, 2),     "score": round(s_npm,1)},
-        {"metric": "ROA",       "value": round(roa*100, 2),            "score": round(s_roa,1)},
+        {"metric": "自己資本比率", "value": round(equity_ratio*100, 2), "score": round(s_equity,1), "unit":"%"},
+        {"metric": "流動比率",   "value": round(current_ratio*100, 1), "score": round(s_liquid,1), "unit":"%"},
+        {"metric": "営業利益率", "value": round(op_margin*100, 2),     "score": round(s_opm,1),    "unit":"%"},
+        {"metric": "純利益率",   "value": round(net_margin*100, 2),     "score": round(s_npm,1),    "unit":"%"},
+        {"metric": "ROA",       "value": round(roa*100, 2),            "score": round(s_roa,1),    "unit":"%"},
     ]
 
     total = round(sum(d["score"] for d in details) / len(details), 1)
@@ -49,5 +52,4 @@ def score_company(fin: Dict[str, Any]) -> Dict[str, Any]:
              "A" if total >= 70 else
              "B" if total >= 55 else
              "C" if total >= 40 else "D")
-
-    return {"total_score": total, "grade": grade, "details": details}
+    return {"total_score": total, "grade": grade, "details": details, "assumption":"金額は円換算済み"}