コンテンツにスキップ

Greco 設計ドキュメント

産業廃棄物の マニフェスト管理 を行う B2B SaaS「Greco」の設計判断・機能仕様・ 操作手順・運用手順を集約した、開発者・運用者向けのサイトです。

  • はじめに — システム全体像

    5 分で輪郭をつかむ全体像と、シーケンス / 状態遷移 / ER / C4 の各図。

    全体像を読む

  • 機能仕様

    認可 / 配車・二次搬出 / マニフェスト・JWNET / 計量 / 運行日報 / 月次請求 / 車両コスト・P&L / マスタ管理。

    機能仕様へ

  • 操作手順書

    事務・ドライバー向けの画面操作マニュアル (01〜12)。 社内オンボーディングはここから。

    操作手順書へ

  • 運用・技術

    認証・テナント運用 / デプロイ / マイグレーション安全運用 / リリース・secrets などの Runbook。

    運用・技術へ

  • ADR — 設計判断の記録

    確定済みの設計判断を MADR 形式で 1 件 1 ファイル。 すべて実コードで裏取りしています。

    ADR 索引へ

  • リポジトリ

    実装の一次情報。機械が守る不変条件と verify ゲートの正典は AGENTS.md。

    kyoei-paper/waste-link

読み方 (推奨順)

  1. システム全体像 — 5 分でプロダクトと構成の輪郭をつかむ
  2. 機能仕様 — 担当する機能の仕様・不変条件を確認する
  3. ADR 索引 — 「なぜこの設計なのか」を確認する
  4. 操作手順書 — 実際の画面操作を確認する

情報の優先順位

記述が矛盾した場合は、次の順で一次情報を確認してください。

  1. 実コード (migration / アプリ実装) — 常に正
  2. AGENTS.md — 機械が守る不変条件・verify ゲートの正典
  3. 本サイト (ADR / 機能仕様 / 手順書) — 人間向けの説明

ロードマップ・人間タスクは docs/pm が正典（2026-09-15 に Notion から移行）

プロダクト管理（🗺 ロードマップ・📌 外部手続き・人間タスク）は本サイトに置く。 機能企画 (RICE)・週次レポート・意思決定ログは接続テスト後の移行まで引き続き Notion が正典で、本サイトには置かない。

このサイトについて