なかよしグループを
つくるコンピュータ

📖 いちばん大事なおはなし

公園で「いま遊びたい人」を集めて、
同じ遊びができそうな友だち同士をチームにする係です。

flowchart LR
  A["🧒 子どもたち
やりたいこと
あいている時間
いまの場所"] --> B["🧠 コンピュータ"]
  B --> C["❌ あそべない人"]
  B --> D["⭐ ふたりの点数"]
  B --> E["🧩 できたチーム"]
      

図 — 入ってきた人を分けて、チームをつくる

データベースやネットは使いません。おもちゃ箱ひとつ（このファイルだけ）で動きます。

🧰 ファイルの中は 8 つの引き出し

flowchart TB
  F["matching_demo.py"]
  F --> A["① CONFIG
ルールの数字"]
  F --> B["② TYPES
ものの形"]
  F --> C["③ SCENARIOS
お話のセット"]
  F --> D["④ 時間の道具"]
  F --> E["⑤ 点数の道具"]
  F --> F5["⑥ 本番の流れ"]
  F --> G["⑦ 結果プリント"]
  F --> H["⑧ main
スタートボタン"]
      

図 — 上から下へ読むと、そのままプログラムの順番

📦 ものの形（クラス / 構造体）

プログラムの「入れもの」です。
ぜんぶ @dataclass(frozen=True)＝いったん作ったら中身を書き換えないカードです。

flowchart TB
  SC["Scenario
お話セット"] --> CA["Candidate
子どもカード"]
  SC --> BE["Beacon
場所カード"]
  SC --> PR["Profile
プロフィール"]
  CA --> TI["TimeInterval
空き時間"]
  RUN["MatchingResult
結果セット"] --> EX["Exclusion
おやすみ理由"]
  RUN --> PS["PairScore
ふたりの点数"]
  RUN --> MG["MatchedGroup
できたチーム"]
  PS --> FS["FactorScores
7つの星"]
  MG --> FS
      

図 — どの入れものが、どの入れものを持つか

flowchart LR
  SC["Scenario お話"] --> RUN["run_matching"]
  RUN --> MR["MatchingResult 結果"]
  MR --> PR["print_report 表示"]
      

図 — お話 → 実行 → 結果袋 → プリント

🌊 全体の流れ（いちばんの川）

入口は run_matching。ここで全部がつながります。

flowchart TD
  MAIN["main
シナリオを選ぶ"] --> RUN["run_matching"]
  RUN --> GATE["filter_eligible
門番チェック"]
  GATE --> OUT1["除外された人"]
  GATE --> OK["残った人"]
  OK --> PAIR["score_pair
ふたりずつ点数"]
  PAIR --> FORM["form_groups
チームづくり"]
  FORM --> REP["print_report
3つのお知らせ"]
  OUT1 --> REP
  PAIR --> REP
      

図 — スタートから結果プリントまで

sequenceDiagram
  participant あなた
  participant main
  participant run_matching
  participant 門番 as filter_eligible
  participant 点数 as score_pair
  participant チーム as form_groups
  participant 印刷 as print_report

  あなた->>main: --scenario A
  main->>run_matching: 子どもたちを渡す
  run_matching->>門番: 入れる？
  門番-->>run_matching: OKの人 / ダメな人
  loop ふたりずつ
    run_matching->>点数: AとBはなかよし？
    点数-->>run_matching: 点数カード
  end
  run_matching->>チーム: グループにして！
  チーム-->>run_matching: できたチーム
  main->>印刷: 結果を見せて
  印刷-->>あなた: ターミナルに表示
      

図 — だれがだれに頼むか

🚦 門番さん filter_eligible

遊べない人は、ここで「おやすみ」になります。点数はまだつけません。

flowchart TD
  C["🧒 子ども"] --> Q1{"まだ有効？"}
  Q1 -->|いいえ| X1["❌ inactive"]
  Q1 -->|はい| Q2{"あいている時間ある？"}
  Q2 -->|いいえ| X2["❌ NO_AVAILABILITY"]
  Q2 -->|はい| Q3{"準備15分あとでも
30分以上ある？"}
  Q3 -->|いいえ| X3["❌ 時間たりない"]
  Q3 -->|はい| Q4{"あそべる場所ある？"}
  Q4 -->|いいえ| X4["❌ 場所なし"]
  Q4 -->|はい| OK["✅ 通過！"]
      

図 — 門番のチェックリスト

なぜ 15 分？ → 「集まる準備の時間」。そのあと最低 30 分あそべないとチームにしません。

⭐ 点数タイム score_pair

ふたりを見て「なかよし度」を 0.00〜1.00 でつけます。
0.60 未満は「まだ友だち未満」で、チームの線になりません。

7つの星の大きさ（重み）

flowchart LR
  A["🧒 A"] --- S["⭐ score_pair"]
  B["🧒 B"] --- S
  S --> F["7つの小さな点"]
  F --> T["合計点"]
  T --> G{"≥ 0.60 ?"}
  G -->|Yes| EDGE["線として残す"]
  G -->|No| DROP["線にしない"]
      

図 — ふたりのカードから一本の線ができるか

🧩 チームづくり form_groups

線でつながった人から、2〜5人のチームを探します。
いちばんよさそうなチームから取って、使った人はもう使いません。

flowchart TD
  P["合格したペアの線"] --> C["2人,3人,4人,5人の候補"]
  C --> S{"グループ点 ≥ 0.70 ?"}
  S -->|No| NG["捨てる"]
  S -->|Yes| R["いい順に並べる"]
  R --> G["貪欲ピック
使った人は再利用しない"]
  G --> T1["チーム1"]
  G --> T2["チーム2"]
  G --> L["あまった人"]
      

図 — パズルのようにチームを取る（シナリオ C がわかりやすい）

flowchart LR
  subgraph Before["まえ"]
    U1["u001"]
    U2["u002"]
    U3["u003"]
    U4["u004"]
    U5["u005"]
    U6["u006"]
  end
  subgraph After["あと（例: C）"]
    G1["チーム1
study 3人"]
    G2["チーム2
lunch 2人"]
    Alone["ひとり
wellness"]
  end
  Before --> After
      

図 — 大勢から複数チーム＋あまり、が出る様子

📇 関数いちらん（なにをする係？）

時間の道具

点数の道具

本番の流れ

お話セット A〜E

▶️ 動かしてみよう

ターミナルで、お話をひとつ選んで実行します。

flowchart LR
  CMD["コマンド"] --> OUT1["[1] Exclusions
おやすみの人"]
  CMD --> OUT2["[2] Pair scores
ふたりの点数"]
  CMD --> OUT3["[3] Groups
できたチーム"]
      

図 — いつも同じ3つのお知らせが出る