"""事業ダッシュボードの見本ジェネレーター（Python標準ライブラリだけ・読み取り専用・チャートはインラインSVG）。
使い方:
python build_dashboard.py sample/ を読んで dashboard_sample.html を作る
python build_dashboard.py 自分のフォルダ 自分のデータのフォルダを読む
python build_dashboard.py --today 2026-10-05 基準日を指定する（省略時は company.md の as_of、なければ今日）
フォルダの形（1ファイル＝1件。先頭の --- で囲んだ項目欄が元データ）:
company.md name / owner / as_of
members/*.md kind(ai|partner|outsource|arbeit|part) / name / role / business / email(人。省略時は example.com) / glyph・color(ai) / contract_hours(arbeit・part)
partner=業務委託（継続）・outsource=外注（単発）・arbeit=アルバイト・part=パート
businesses/*.md name / member(担当partnerのファイル名) / metrics(見る数字を | 区切りで。先頭が折れ線の主役)
reports/*.md business / date / kind ← 報告が届いたら1ファイル足す
metrics/metrics.csv week_end,business,metric,value ← アクセス・申込・クリックなど外部の数字（週ごと・日曜締め）
actionlog.csv date,time,agent,business,what ← AIエージェントの作業記録
deliveries/*.md member / business / title / due / status / pay_due / amount ← 業務委託・外注の納品物（納期・検収・支払で見る）
shifts.csv date,member,hours ← アルバイト・パートのシフトの実績（雇用の人だけ）
tasks/*.md owner / status / due / title / business ← 載せるのは owner が「自分」の行だけ
データの設計 → チャートの形（何を知りたいかで形を決める）:
現在の数字＋前週比＋12週の流れ → ステータスタイル＋スパークライン、主役の数字は折れ線
前週からどの数字がどれだけ動いたか → 左右に伸びる棒（増=青・減=赤・中央は灰）
AIの稼働の波 → 14日の縦棒（今日だけ色、過去は灰）
報告のリズム → 直近8週の点（届いた週は塗り、抜けた週は輪）＋ 7日の目安のメーター
どれも『表で見る』が付く（色や形だけに頼らない）
設計の決まり（S6 第3回ワーク）:
・ファーストビューに、各事業の状態・数字・最終更新を全部出す。並びは『更新が新しい順』だけ
・見るのは『動く数字』だけ。仕様（種類の数・設定済みか）は監視しない
・報告の最終日と経過日数を、事業カードの中に出す。7日を超えたら赤
・台帳に載せるのは、自分にボールがある行だけ。相手の宿題は載せない・順位や点数は作らない
・読めない数字は『未取得』、記録がなければ『記録なし』。推測で埋めない
・止まったデータは、線が途中で終わる（週の軸はそろえる）。直近の週まで線をつなげて隠さない
・メンバーは契約形態ごとに見る数字を変える。業務委託・外注は『納期・検収・支払』（時間は管理しない）、
アルバイト・パートは『シフトの実績と契約の上限』（雇用は労働時間の管理が要る。給与・社会保険は専用のサービスと専門家へ）
・連絡のボタンは、メンバーの状況（検収待ち・納期超過・上限超過・待機など）から案を出す。押すと
人にはメールの作成画面（下書き）、AIにはToDoの指示文のコピー。送信はしない（本文を読んで自分で送る）
・出力は生成物。手で編集せず、元データを直して作り直す
"""
import argparse
import csv
import datetime as dt
import html
import json
import math
import re
from pathlib import Path
REPORT_DAYS = 7
WEEKS = 12
KIND_LABEL = {"ai": "AIエージェント", "partner": "業務委託（継続）", "outsource": "外注（単発）", "arbeit": "アルバイト", "part": "パート"}
HUMAN_KINDS = ("partner", "outsource", "arbeit", "part")
HERE = Path(__file__).resolve().parent
def e(x):
return html.escape(str(x))
def clip(text, n):
text = str(text)
return text if len(text) <= n else text[: n - 1] + "…"
def front(path):
"""先頭の --- で囲んだ『項目: 値』を読む。戻り値は (項目の辞書, 本文)。"""
text = Path(path).read_text(encoding="utf-8-sig")
m = re.match(r"^---\r?\n(.*?)\r?\n---\r?\n?(.*)$", text, re.S)
meta, body = {}, text
if m:
for line in m.group(1).splitlines():
if ":" in line:
k, v = line.split(":", 1)
meta[k.strip()] = v.strip()
body = m.group(2)
meta["_id"] = Path(path).stem
return meta, body
def load(folder):
d = Path(folder)
return [front(p)[0] for p in sorted(d.glob("*.md"))] if d.exists() else []
def day(text):
try:
return dt.date.fromisoformat(str(text)[:10])
except ValueError:
return None
def fmt(v):
return f"{v:,.0f}" if abs(v - round(v)) < 1e-9 else f"{v:,.1f}"
def nice_max(v):
"""軸の上端を、きりのよい数にする（1・2・2.5・5 × 10のべき）。"""
if v <= 0:
return 1
p = 10 ** math.floor(math.log10(v))
for m in (1, 2, 2.5, 5, 10):
if v <= m * p:
return m * p
return 10 * p
def week_axis(today):
"""直近の日曜（週の終わり）から数えて12週の軸。止まったデータは、この軸の途中で線が終わる。"""
last = today - dt.timedelta(days=(today.weekday() + 1) % 7)
return [last - dt.timedelta(days=7 * i) for i in range(WEEKS - 1, -1, -1)]
# ---------------- 顔（人物は似顔、AIは役割ごとの形。色は s1〜s4 の固定順） ----------------
SKIN = ("#f3d3b8", "#e8b996", "#f6dcc6", "#d9a47f")
HAIR = ("#2b2320", "#4a3328", "#1f2430", "#6b4a35")
SHIRT = ("#5b7be0", "#e07b9b", "#4fb98f", "#e0a84f", "#8c6be0", "#4fa9c9")
def person_svg(name):
h = sum(ord(c) * (i + 3) for i, c in enumerate(name))
skin, hair, shirt = SKIN[h % 4], HAIR[(h // 3) % 4], SHIRT[(h // 5) % 6]
long_hair = (h // 11) % 2 == 1
back = f'' if long_hair else ""
return (f'')
def agent_svg(glyph, slot):
if not re.fullmatch("s[1-4]", slot):
slot = "s1"
c = f"var(--{slot})"
shapes = {
"spark": "".join(f'' for i in range(8)),
"hex": f'',
"star": f'',
"ring": f'',
}
return f''
# ---------------- チャート部品（線は2px・端点は8px＋面色の輪・面は10%・格子は髪の毛の細さ） ----------------
def spark(points, axis, w=108, h=30, pad=4, color="var(--s1)"):
"""12週のスパークライン。止まったデータは、軸の途中で線が終わる。"""
xs = {d: pad + i * (w - 2 * pad) / (WEEKS - 1) for i, d in enumerate(axis)}
vals = [(d, points[d]) for d in axis if d in points]
if not vals:
return f''
lo, hi = min(v for _, v in vals), max(v for _, v in vals)
span = (hi - lo) or 1
pts = [(xs[d], h - pad - (v - lo) / span * (h - 2 * pad)) for d, v in vals]
line = " ".join(f"{x:.1f},{y:.1f}" for x, y in pts)
area = f"M{pts[0][0]:.1f},{h - pad} " + " ".join(f"L{x:.1f},{y:.1f}" for x, y in pts) + f" L{pts[-1][0]:.1f},{h - pad} Z"
x, y = pts[-1]
return (f'')
def line_chart(name, points, axis, w=520, h=150):
"""主役の数字の折れ線（ゼロ始まり・格子3本・端点だけ値のラベル・ホバーで十字線と値）。"""
ml, mr, mt, mb = 40, 22, 16, 24
vals = [(d, points[d]) for d in axis if d in points]
if not vals:
return '
データなし（metrics.csv に記録がありません）
'
ymax = nice_max(max(v for _, v in vals))
X = {d: ml + i * (w - ml - mr) / (WEEKS - 1) for i, d in enumerate(axis)}
def Y(v):
return mt + (1 - v / ymax) * (h - mt - mb)
grid = "".join(f''
f'{fmt(t)}' for t in (0, ymax / 2, ymax))
xl = "".join(f'{d:%m/%d}'
for i, d in ((0, axis[0]), (WEEKS // 2, axis[WEEKS // 2]), (WEEKS - 1, axis[-1])))
pts = [(X[d], Y(v)) for d, v in vals]
line = " ".join(f"{x:.1f},{y:.1f}" for x, y in pts)
area = f"M{pts[0][0]:.1f},{Y(0):.1f} " + " ".join(f"L{x:.1f},{y:.1f}" for x, y in pts) + f" L{pts[-1][0]:.1f},{Y(0):.1f} Z"
x, y = pts[-1]
data = json.dumps([[round(X[d], 1), round(Y(v), 1), f"{d:%m/%d}", v] for d, v in vals], ensure_ascii=False)
return (f'')
def top_rounded(x, base, w, h, r=4):
"""基線は四角、データ側（上）は4pxの丸み。"""
r = min(r, w / 2, h)
y = base - h
return f"M{x:.1f},{base:.1f} L{x:.1f},{y + r:.1f} Q{x:.1f},{y:.1f} {x + r:.1f},{y:.1f} L{x + w - r:.1f},{y:.1f} Q{x + w:.1f},{y:.1f} {x + w:.1f},{y + r:.1f} L{x + w:.1f},{base:.1f} Z"
def day_bars(counts, labels, color, bw=10, gap=3, h=38, unit="件"):
"""14日の縦棒。今日だけ色、過去は灰（強調）。0件の日は基線の小さな印だけ。"""
n = len(counts)
W = n * (bw + gap) - gap
top = max(max(counts), 3)
out = []
for i, (c, lab) in enumerate(zip(counts, labels)):
x = i * (bw + gap)
if c:
bh = max(4, c / top * (h - 6))
fill = color if i == n - 1 else "var(--muted)"
out.append(f'{e(lab)}: {c:g}{unit}')
else:
out.append(f'{e(lab)}: 0{unit}')
return f''
def report_dots(report_days, axis):
"""直近8週の、報告が届いた週（塗り）と抜けた週（輪）。"""
weeks = axis[-8:]
cells = []
for wk in weeks:
got = [d for d in report_days if wk - dt.timedelta(days=6) <= d <= wk]
cells.append(f''
f'{wk - dt.timedelta(days=6):%m/%d}〜{wk:%m/%d}の週: {"報告あり" if got else "報告なし"}')
return f''
def meter(age):
"""報告の経過日数。目安の7日に目盛り。状態の色は『状態』だけに使う。"""
if age is None:
return '
'
pct = min(age, 14) / 14 * 100
return f'
'
def cap_meter(used, cap):
"""今週の勤務時間と、契約の上限（アルバイト・パートだけ）。上限を超えたら赤。"""
pct = min(used / (cap * 1.25), 1) * 100 if cap else 0
return f'
'
def contact_menu(opts):
"""カードの中の『連絡する』。状況に当てはまる案だけを並べる。送信はしない。"""
if not opts:
return ""
rows = ""
for o in opts:
main = ('' % e(o["id"])) if o["to"] is None else (
'' % (e(o["id"]), e(o["id"])))
rows += f'
{e(o["kind"])}{e(o["why"])}
{main}
'
return f'{"指示を出す" if opts[0]["to"] is None else "連絡する"}（案{len(opts)}件）{rows}'
# ---------------- 読み込みと組み立て ----------------
def build(root, today=None):
root = Path(root)
company = front(root / "company.md")[0]
today = today or day(company.get("as_of")) or dt.date.today()
axis = week_axis(today)
members = {m["_id"]: m for m in load(root / "members")}
businesses = load(root / "businesses")
reports = load(root / "reports")
tasks = load(root / "tasks")
deliveries = load(root / "deliveries")
shifts = {}
sp = root / "shifts.csv"
if sp.exists():
with open(sp, encoding="utf-8-sig") as fh:
for r in csv.DictReader(fh):
shifts.setdefault(r["member"], {})[day(r["date"])] = float(r["hours"])
metrics = []
mp = root / "metrics/metrics.csv"
if mp.exists():
with open(mp, encoding="utf-8-sig") as fh:
metrics = list(csv.DictReader(fh))
logs = []
lp = root / "actionlog.csv"
if lp.exists():
with open(lp, encoding="utf-8-sig") as fh:
logs = sorted(csv.DictReader(fh), key=lambda r: (r["date"], r["time"]))
def series_of(bid, name):
return {day(r["week_end"]): float(r["value"]) for r in metrics if r["business"] == bid and r["metric"] == name and day(r["week_end"]) and day(r["week_end"]) <= today}
days14 = [today - dt.timedelta(days=i) for i in range(13, -1, -1)]
ck = {}
def opt(mid, key, kind, why, subject, lines, to="", biz=""):
"""連絡案を1件つくる。to=None はAIへの指示（ToDoに入れる文）。"""
oid = f"{mid}:{key}"
ck[oid] = {"to": to, "subject": subject, "body": "\n".join(lines)}
return {"id": oid, "kind": kind, "why": why, "to": to}
labels14 = [f"{d:%m/%d}" for d in days14]
# ---- AIエージェント: 今日動けば稼働中、7日以内なら待機、それ以外は休止。直近4件を省略せず出す
agent_cards = ""
all_counts = [0] * 14
for a in (m for m in members.values() if m.get("kind") == "ai"):
mine = [r for r in logs if r["agent"] == a["name"]]
counts = [sum(1 for r in mine if day(r["date"]) == d) for d in days14]
all_counts = [x + y for x, y in zip(all_counts, counts)]
td, wk = counts[-1], sum(counts[-7:])
last = day(mine[-1]["date"]) if mine else None
state, cls = ("稼働中", "on") if td else (("待機", "idle") if last and (today - last).days < 7 else ("休止", "off"))
works = "".join(f'
'
f'{e(a["name"])}{state}{e(a.get("role", ""))}'
f'今日{td}件 ／ 週{wk}件{day_bars(counts, labels14, f"var(--{slot})")}直近14日の作業件数'
f'
{works}
{contact_menu(a_opts)}
')
# ---- メンバー（人）: 契約形態ごとに、見る数字を変える
biz_short = {b["_id"]: b["name"].split("（")[0] for b in businesses}
last_rep = {}
for r in reports:
d0 = day(r.get("date"))
if d0 and (r.get("business") not in last_rep or d0 > last_rep[r["business"]]):
last_rep[r["business"]] = d0
humans = sorted((m for m in members.values() if m.get("kind") in HUMAN_KINDS), key=lambda m: (HUMAN_KINDS.index(m["kind"]), m["name"]))
member_cards, waiting = "", 0
for m in humans:
kind, mid = m["kind"], m["_id"]
ring, body, note = "on", "", ""
h_opts, to_addr, fam, mname = [], m.get("email") or f"{m['_id']}@example.com", m["name"].split()[0] if " " in m["name"] else m["name"], m["name"]
greet = [f"{mname}さん", "", "お疲れさまです。"]
sign = ["", "よろしくお願いします。", "【自分の名前】"]
if kind in ("partner", "outsource"):
items = ""
for dv_ in sorted((d for d in deliveries if d.get("member") == mid), key=lambda d: d.get("due") or "9999"):
due = day(dv_.get("due"))
status = dv_.get("status", "")
over = bool(due and due < today and status not in ("検収待ち", "検収済み", "支払済み"))
title = dv_.get("title", "")
if status == "検収待ち":
h_opts.append(opt(mid, "thanks" + str(len(h_opts)), "納品のお礼と次の依頼", f"「{clip(title, 18)}」が検収待ち", f"【お礼と次のお願い】{title}", greet + [
f"「{title}」を納品いただき、ありがとうございました。内容を確認しています。",
f"検収の結果は{day(dv_.get('accept_due')):%m/%d}までにお伝えします。" if day(dv_.get("accept_due")) else "検収の結果は、あらためてお伝えします。",
f"お支払いは{day(dv_['pay_due']):%m/%d}の予定です。" if day(dv_.get("pay_due")) else "お支払いの時期は、あらためてお伝えします。",
"", "続けて、次の仕事をお願いできればと考えています。", "・【次にお願いしたい仕事】", "・【納期の希望】", "ご都合や難しい点があれば、遠慮なく教えてください。"] + sign, to_addr))
waiting += 1
ring = "idle" if ring == "on" else ring
flag = f'検収待ち（検収期限 {day(dv_.get("accept_due")):%m/%d}）' if day(dv_.get("accept_due")) else '検収待ち'
elif over:
h_opts.append(opt(mid, "late" + str(len(h_opts)), "納期の確認", f"「{clip(title, 18)}」が納期を{(today - due).days}日超過", f"【ご状況の確認】{title}", greet + [
f"「{title}」の納期（{due:%m/%d}）を過ぎています。状況を教えてください。",
"間に合わない見込みの場合は、いつ頃になりそうか、また、先に進められない点があればお知らせください。", "こちらで調整できることがあれば対応します。"] + sign, to_addr))
ring = "warn"
flag = f'納期を{(today - due).days}日超過'
else:
if due and (due - today).days <= 3:
h_opts.append(opt(mid, "soon" + str(len(h_opts)), "納期前のひとこと", f"「{clip(title, 18)}」の納期まで{(due - today).days}日", f"【進み具合の確認】{title}", greet + [
f"「{title}」の納期（{due:%m/%d}）が近づいています。進み具合はいかがでしょうか。",
"途中のものでも見せていただければ、先に確認できます。困りごとがあれば教えてください。"] + sign, to_addr))
flag = f'納期 {due:%m/%d}（あと{(due - today).days}日）' if due else ""
pay = f"・支払期日 {day(dv_['pay_due']):%m/%d}" if day(dv_.get("pay_due")) else ""
amt = f"・¥{int(dv_['amount']):,}" if dv_.get("amount", "").isdigit() else ""
items += f'
')
# ---- 事業カード
cards, changes, late = [], [], []
for b in businesses:
bid = b["_id"]
member = members.get(b.get("member", ""), {})
rdays = sorted(day(r.get("date")) for r in reports if r.get("business") == bid and day(r.get("date")))
last_report = rdays[-1] if rdays else None
age = (today - last_report).days if last_report else None
names = [x.strip() for x in b.get("metrics", "").split("|") if x.strip()]
latest_metric = None
tiles, table_cols, main_chart = "", {}, ""
for i, name in enumerate(names):
s = series_of(bid, name)
table_cols[name] = s
if not s:
tiles += f'
{e(name)}未取得metrics.csv に記録なし
'
continue
ds = sorted(s)
d1, v1 = ds[-1], s[ds[-1]]
latest_metric = max(latest_metric or d1, d1)
prev = s[ds[-2]] if len(ds) > 1 else None
delta = ""
if prev is not None:
diff = v1 - prev
pct = (diff / prev * 100) if prev else None
arrow = "▲" if diff > 0 else "▼" if diff < 0 else "▶"
cls = "up" if diff > 0 else "down" if diff < 0 else "flat"
delta = f'{arrow} {diff:+g}（前週{fmt(prev)}）'
changes.append((pct if pct is not None else (999 if diff > 0 else 0), f'{b["name"].split("（")[0]} ・ {name}', diff, pct, d1))
note = f"{d1:%m/%d}の週" + ("（以降の数字が届いていません）" if d1 < axis[-1] else "")
if i == 0:
main_chart = f'
'
if last_report is None:
pill, pcls = "報告なし", "off"
elif age > REPORT_DAYS:
pill, pcls = f"報告が{age}日止まっています", "bad"
late.append(b["name"].split("（")[0])
else:
pill, pcls = "週次どおり", "ok"
updated = max([x for x in (last_report, latest_metric) if x], default=None)
ring = {"ok": "on", "bad": "warn"}.get(pcls, "off")
recent = [r for r in logs if r.get("business") == bid]
recent_txt = f'{recent[-1]["date"][5:]} {clip(recent[-1]["what"], 50)}' if recent else "AIの作業記録なし"
rows_tbl = "".join(f'
{d:%m/%d}
' + "".join(f'
{fmt(table_cols[n][d]) if d in table_cols[n] else "—"}
' for n in names) + "
" for d in reversed(axis))
table = f'表で見る（12週）
週の終わり
{"".join(f"
{e(n)}
" for n in names)}
{rows_tbl}
'
upd_cls = "bad" if (updated is None or (today - updated).days > REPORT_DAYS) else "ok"
upd_txt = f"最終更新 {updated:%m/%d}（{(today - updated).days}日前）" if updated else "更新の記録なし"
rep_txt = f"報告 {last_report:%m/%d}（{age}日前・目安{REPORT_DAYS}日）" if last_report else "報告 なし"
mark = "✕ " if pcls == "bad" else "● " if pcls == "ok" else ""
team = "".join(f'{e(m["name"])}{e(KIND_LABEL[m["kind"]])}' for m in humans if m.get("business") == bid)
cards.append((updated or dt.date.min,
f'
'))
cards.sort(key=lambda x: x[0], reverse=True) # 更新が新しい順だけ（固定しない）
# ---- 今週の変化（前週比・左右に伸びる棒。増=青／減=赤／中央は灰）
changes.sort(key=lambda c: c[0], reverse=True)
dv = ""
for key, label, diff, p, d1 in changes:
shown = "新規" if p is None else f"{p:+.0f}%".replace("-", "−")
w = min(abs(p) if p is not None else 100, 100) / 2
side = "pos" if diff > 0 else "neg" if diff < 0 else "zero"
bar = f'' if side != "zero" else ""
stale = f' ※{d1:%m/%d}の週まで' if d1 < axis[-1] else ""
dv += f'
{e(label)}{stale}
{bar}
{e(shown)}
'
# ---- 自分にボールがある行だけ（相手の宿題は載せない）
mine = [t for t in tasks if t.get("owner") == "自分" and t.get("status") in ("todo", "doing")]
mine.sort(key=lambda t: t.get("due") or "9999")
todo = "".join(
f'
"
overdue = sum(1 for t in mine if day(t.get("due")) and day(t.get("due")) < today)
ck_json = json.dumps(ck, ensure_ascii=False).replace("前週と比べられる数字がありません', cards="".join(h for _, h in cards), todo=todo)
PAGE = """
{title} 事業ダッシュボード