Communitygithub.com

ディセーニョ・システマス

CRM、ERP、社内ダッシュボード、B2Bポータルなどの管理システム向けの視覚的・UX言語です。デスクトップとモバイルの両方を対象とし、これらのインターフェースを設計またはレビューする際に使用します。

ディセーニョ・システマス とは?

このスキルは、管理システム向けの統一された視覚言語とUXパターンを提供します。中核となる考え方は、「ベースはニュートラル、データに命を吹き込む」というもので、構造(背景、メニュー、枠線)は落ち着いたニュートラルカラーに保ち、データ(グラフ、進捗、人物、プロジェクト)に色、形、動きを与えます。CRM、ERP、社内ダッシュボード、B2Bポータルのデスクトップおよびモバイルインターフェースを含むすべての管理システムに適用可能です。このスキルは、トークン、タイポグラフィ、角丸、状態、コンポーネントをシステム間で共有することで、同じ企業の複数のシステムが同一ファミリーに属する感覚を生み出します。各システムのアクセントカラーとニュートラルカラーの色相だけが異なり、ブランドや使用目的に応じて調整されます(例:ブランド色の色相、暖色/寒色、ダークモードなど)。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brandon4320/skill-diseno-sistemas/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

システム設計: 全員のための単一言語

ベースはニュートラル、データに命を吹き込む。構造(背景、メニュー、枠線)は落ち着いてニュートラルに保ち、その上でデータに色、形、動きを与えます。グラフ、進捗、人物、プロジェクトにはそれぞれの色があります。グラフがなく、エンティティごとに色がなく、主役がいない画面は、死んでいるように感じられます。「命」のセクションを読み、ダッシュボードをデザインする前に06、07、08、14を開いてください。同じ企業の複数のシステムは、トークン、タイポグラフィ、角丸、状態、コンポーネントを共有するため、同じファミリーに属しているように感じられます。システムごとに異なるのは、アクセントカラーとニュートラルカラーの色相です。

ニュートラルは灰色を意味しません。 ベースは、ブランドや各システムの使用目的に応じて色相を持たせることができます。

  • ブランド色相: アクセントカラーのごく薄い色相を含む背景(例:非常に薄い紫や青みがかった色)。
  • 色味のある背景: 色味のある背景と、暗く落ち着いたブランドカラー(例:ネイビーブルー)のメニュー。フラットな白ではありません。
  • 暖色または寒色: 業種による。
  • ダーク: 監視用。

ルールは彩度とコントラストであり、色ではありません。ニュートラルカラーは彩度が非常に低く(OKLCH C ≤ 0.02、キャンバスは最大〜0.03まで)、システム全体で同じ色相である必要があります。状態とアクセントカラーだけが、本当に色のあるものとして読まれるようにしなければなりません。このドキュメントの灰色の16進数値は出発点であり、必須ではありません。各システムは、独自の色相でニュートラルカラーのランプを構築します(tokens.css参照)。

  • すぐに貼り付け可能なトークン: tokens.css。名前はスペイン語(fondo、superficie、tinta、texto-2、acento、verde-fondo…)。

  • 例はejemplos/内:

    • tablero-crm.html: CRMの全画面。
    • componentes.html: すべてのパーツのギャラリー(ライト、ダーク、モバイルを含む)。
    • recetas-tailwind.md: React + Tailwind v4でコピーするためのパーツ。

    開いて上書きしてください。

  • 参考スクリーンショット: referencias/01…14-*.jpg。類似のものをデザインする前に、該当するものを開いてください。

  • トピックごとの完全な分析(値と例を含む): analisis/01-estructura.md … analisis/15-homogeneidad.md。担当するトピックのものを読んでください。

このフォルダにmarcas.local.mdが存在する場合は、最初にそれを読んでください。スキルを使用する各ブランドのアクセントカラー、色相、独自のルールが記載されています。そこに書かれていることが、このドキュメントのサンプル値よりも優先されます。

新しい画面のためのクイックレシピ:

  1. 画面の種類(ダッシュボード、リスト、詳細、カレンダー、フォーム、モバイル)を選び、ejemplos/内の該当する参考資料と例を開きます。
  2. システムのアクセントカラーとニュートラルカラーの色相を定義します(tokens.css)。
  3. フレームを構築します。キャンバス上にサイドバー、パンくずリスト付きのパネル。
  4. ヘッダーを書きます。大きくて軽いディスプレイタイトル、実際の数字を使ったサブタイトル、塗りつぶしボタン1つのみ。
  5. 3〜6個のKPIの行。1つは主役、残りはトレイ+内側のカードスタイルで、それぞれに図を添えます。
  6. ボディ。進行中のものにはエンティティカード、残りにはテーブルまたはリスト、そしてコンテキスト用のサイドパネル。
  7. 命を吹き込みます。エンティティごとの色、アバター、状態のあるグラフ、読み込み時のアニメーション。
  8. 空の状態、読み込み状態、エラー状態をデザインします(セクション6b)。
  9. 390pxとダークモードでテストします。
  10. セクション8のリストを確認し、参考資料と比較します。

基本原則: ゼロフリクション、画面ごとに1つの主要アクション、プレースホルダーテキストなし、リストに移動するすべてのボタンは該当する行にフォーカスを当てます。

1. アプリのフレーム(参考資料 02, 03, 07, 13)

  • キャンバスは bg-fondo(#F4F4F5)。サイドバーはキャンバスの上に直接配置され、240〜256px。
  • コンテンツは bg-panel または bg-superficie、rounded-[var(--radius-marco)] のパネル内に配置され、端とサイドバーから8px離れ、1pxの境界線があります。
  • サイドバー:
    • 上部にロゴまたは会社セレクター。オプションで⌘K検索。
    • 11pxのtexto-3、大文字、tracking-widerのラベル付きグループ。
    • 32〜36pxのアイテム。16pxのグレーのアイコンと、右側にグレーのカウント。
    • アクティブなアイテムは bg-superficie(または bg-tinta text-white)のピル型。ブランドカラーは使用しません。
    • 下部にユーザー(アバター、名前、ロール)。
  • パネルの上部バー: 56px、border-b付き。左側にパンくずリスト(「セクション / ページ」、親はグレー)。右側に⌘K検索、通知、アバター。
  • ページヘッダー:
    • 20〜24px、ウェイト500〜600、tracking-tightのタイトル。
    • その下に、実際の状態の数字を含むグレーのサブタイトル:「12件請求予定・3件期限切れ」。汎用的な説明は決して使用しません。
    • アクションは右側、同じ行に配置。
  • 固定の垂直順序: ヘッダー → フィルターとビュー(セグメント化) → KPI行 → ボディ。
  • コンテキスト付きボディ: grid-cols-[1fr_360px]。左側にリストまたはカレンダー、右側に詳細パネル(01, 02, 07)。
  • 詳細画面: 3カラム [1fr_1.6fr_1fr]。データ、カウント付きタブのアクティビティ、関連会社(03)。

1b. 命(整然としたスプレッドシートにならないための要素)

06(Gr8r)、07(Loops)、08(Finora)、14(Solexa)を参照。すべてのダッシュボードには、以下のリソースのうち少なくとも5つが必要です。

  1. エンティティごとの色。 各プロジェクト、クライアント、人物、サービスには、データパレットから割り当てられた固定の色があります。以下の場所に表示されます。

    • アイコンまたはアバター。
    • 進捗バー。
    • スパークライン。
    • テーブルの左端の線。 これが最も命を吹き込みます(06: 各プロジェクトと各人物に色があります)。
  2. すべての数字に図を添える。 グラデーションエリア付きスパークライン、ティックバー(07: パーセンテージまで色付きの細い線)、セグメント化バー(06: 10個中1個のブロック)、または進行リング(09, 13, 14)。数字だけでは死んでいます。

  3. 画面ごとに1つの主役。 アクセントカラーのグラデーションで彩られたカード、大きな白い数字、白い線グラフとマークされたポイント(08「Total Expenses」、09「halfway there」)。

  4. エンティティカード(テーブルだけではありません)。「進行中」のもの(プロジェクト、サービス、大きな機会)には、06のようなグリッドカードを使用します。

    • 優先度ピルとラベル。
    • 2行の説明付きの大きなタイトル。
    • 「6件中3件完了・12月15日期限」などのセグメント化バー。
    • アクティビティのスパークライン。
    • チェックマークと「+ 追加」付きの「次のステップ」。
  5. 顔のある人々。 写真またはイラストのアバター。ない場合は、色付きの頭文字。参加者の重なり合ったアバタースタック。チームは負荷バー付きのカードで表示(06「Team」)。

  6. 状態のあるグラフ。 アクティブなバーまたはポイントは塗りつぶし、残りはハッチングまたは薄く表示。ダークなツールチップに「値 | シェア | vs. 他」を表示(08)。現在の月は「MTD」としてハッチング(07)。

  7. 雰囲気のある背景。 パネルの上部にシステムの色相の非常に微妙なグラデーション(08)、またはヘッダーストリップ(14)やプロモーション/プランカード(06と14、線画イラスト)の写真やイラスト。

  8. 目的のある動き。 読み込み時、数字は値までカウントアップ(〜600ms)、バーは0から成長、線は描画されます。ホバー時、カードは1〜2px浮き上がり、境界線が強調されます。成功はその場でトーストで表示。すべて ease-out で、prefers-reduced-motionを尊重します。

  9. 内側にカードがあるトレイ(「プレミアム」に見えるもの)。 KPIはフラットなボックスではありません。bg-suave、角丸16、パディング4のトレイで構成されます。

    • 上部: トレイの上にアイコンと⋯付きのラベル(07)。
    • 内部: 角丸12の白いカード、数字とその図。
    • 下部: トレイの上に、アイコン、コンテキスト、デルタ値付きのフッター(06)。 アイコンも同様のパターン: 36〜40pxの白い四角形、境界線と最小限の影、トレイの上に配置(08)。
  10. 余白。 余裕のあるパディング(大きなカードで20〜24)、16〜20のギャップ。28〜40pxの数字。プレミアムは呼吸します。窮屈に見える場合は、小さくする前に要素を削除します。

制限: 色はデータ、エンティティ、および1つの主役にのみ存在します。フレーム(メニュー、背景、境界線、テキスト)はニュートラルのままです。

2. タイポグラフィ(分析 02)

  • 2つの声、1つではありません:
    • ディスプレイ: タイトル、挨拶、数字用。Outfit、General Sans、Satoshi、Plus Jakartaなどの特徴のある幾何学またはグロテスク書体(08はこのタイプを使用)。
    • テキスト: インターフェース用。Plus Jakarta Sans、Manrope、Inter。
    • モノ: 個性のあるもの(JetBrains Mono、Geist Mono)をコード用に(PR-0241、FAC-01101)。技術系や監視系のダッシュボードでは、数字にも使用します(14)。
    • GeistやInterだけだと「ベーシック」に見えます。
  • 大きくて軽いタイトル: ページの挨拶やタイトルは、36〜44px、ウェイト400、tracking-tightで設定(06「Good evening, Alex」、08)。大きなものに太字は必要ありません。
  • スケール: 11 / 12 / 13 / 14 / 16 / 20 / 24 / 32 / 40。1枚のカードで3サイズ以上を混在させません。
  • ウェイト: テキストと大きなタイトルは400、カードタイトルとアクションは500、数字は500〜600。700は使用しません。
  • データ = 上部に12〜13pxのグレーのラベル、下部に14pxのtintaの値。 詳細画面内で同じ行に「ラベル: 値」と表示することは決してありません。
  • 数字は tabular-nums を使用し、金額は右揃えにします。通貨記号、セント、単位は texto-3 で1サイズ小さく表示: $ 24.957,81。
  • メタデータは12pxグレーの1行に、「 · 」で連結: 「債権回収 · FAC-01101 · 2分前」。
  • 大文字はメニューのグループラベルのみに使用します。テーブルヘッダー、ボタン、タブは文頭のみ小文字にします。

3. 色(分析 03)

  • 3つのレイヤーがあります(fondo → panel → superficie)。奥行きは、色相 + 1pxの境界線 + 最小限の影から生まれます(セクション4参照)。

  • 各システムに合わせたニュートラルカラー:

    • 単一のランプ: 各システムはニュートラルカラーの色相(ブランドまたは使用目的から)を選択し、ランプ全体(背景、パネル、境界線、3つのテキストレベル)で使用します。
    • 低クロマ: 色相は「雰囲気」として認識され、「色」として認識されてはいけません。背景がステータスピルと競合する場合は、彩度が高すぎます。
    • 混合なし: 同じシステム内で寒色系と暖色系のランプを組み合わせることは決してしません。
    • グレーを超えることも可能: 色味のある背景やブランドカラーのダークメニューも有効です。条件は、コンテンツが明るく読みやすいサーフェス上にあり、ステートだけが唯一の強い色味であることです。
  • テキストは tinta / texto-2 / texto-3。これらは同じ色相を持つニュートラルカラーです。#000 を #FFF の上に使用することは禁止されています。

  • システムごとに1つのアクセントカラー。メインボタン、トグル、フォーカス、未読ドット、モバイルのアクティブタブにのみ使用します。タイトル、カードの背景、メニューには決して使用しません。

  • システムごとのアクセントカラー: 各システムまたは企業は、1つのアクセントカラー(ブランドカラー)を持ちます。ブランドが定義されていない場合はグラファイト #18181B。スキルの残りの部分はすべてのシステムで同じです。

  • ステート = ピル: 背景10% + 彩度の高いテキスト + 6pxのドット。彩度の高い背景に白いテキストを乗せることは決してなく、色だけにすることも決してありません。常に単語と共に使用します。

    • 緑: 完了、回収済み、オンライン。
    • 琥珀: 保留中、部分的、期限間近。
    • 赤: 期限切れ、失敗、オフライン。
    • 青: 進行中、情報。
    • グレー: 下書き、キャンセル、返金済み。
  • 通常の状態は色付けしません。 赤はアクションが必要なものだけに使用します。画面上に3つ以上の赤がある場合は、1つの警告にまとめます。

  • データパレット(dato-1…6、最大6つ)は、グラフ、進捗バー、タイプアイコンのみに使用します。テーブルでは3pxの線として繰り返し使用しますが、行全体を塗りつぶすことはありません。

  • 予測値、部分値、未選択のものはハッチングまたは30%の不透明度で表示し、実績値は塗りつぶします。例: 現在の月「MTD」(07, 08)。

  • 画面ごとに最大1つのヒーローカードを色で塗りつぶします(08, 09)。

  • 終了する前に、色を数えます: グレー + 1アクセントカラー + 最大4ステートカラー + 最大6データカラー。

4. サーフェス、角丸、スペース(分析 04)

階層化された角丸。 内側の各レベルは、それを含む要素よりも少しだけ丸みが少なくなります(内側の角丸 ≈ 外側の角丸 − パディング)。他の値は作成しません。

要素角丸
アプリのフレーム(システム全体を1つのボックスに)26
メインパネル20
カード / トレイ / シート20
トレイ内のカード16
ボタン / フィールド / 検索 / 四角いアイコン11〜12
小さなボタン / ピル / ラベル7〜9、またはフィルターや「+12%」の場合は丸型

モバイルでは、カードの角丸は20〜24にします。

スペース。 スケール 4 / 8 / 12 / 16 / 20 / 24 / 32 / 40。10、14、18は使用しません。

  • パディング: カードは16〜20(高密度の場合やモバイルの場合は12)、パネルは26〜28。
  • グリッドギャップ: 14。
  • 大きなブロック間: 28。
  • セクション間: 32〜40の余白とタイトル。太い線や色付きの背景は決して使用しません。

境界線と影。

  • 境界線は常に1pxのborde。2pxや色付きの境界線は、フォーカスを除き使用しません。
  • 3レベルの影。常にソフトで、テキストの色相(純粋な黒ではありません)。
    • 最小限(0 1px 2px /.05): 境界線付きのボタン、トレイ内のカード、アクティブなメニューアイテム、四角いアイコンに使用。これにより「プレミアム」な浮き上がり効果が生まれます。
    • ホバー時(0 14px 30px -18px /.3、2pxの浮き上がりと共に): クリッカブルなカードに使用。
    • フローティング(0 24px 48px -16px /.22): メニュー、シート、モーダル、トーストに使用。黒のメインボタンには、独自の影と上部の輝き(inset 0 1px 0 /.12)があります。
    • 静的なコンテンツカードは境界線のみで、大きな影は付けません。

分割。 カードを分割するには、全幅のストリップ(border-t または suave 背景)を使用するか、トレイ+白いカードのパターン(「命」のポイント9参照)を使用します。3レベルの境界線ボックスを積み重ねることはしません。行内のメトリクスは divide-x で区切ります。

5. パーツ

KPIカード(06, 07, 13, 14 · 分析 06)

  • ラベル + 数字 + コンテキスト行が常に必要です。数字だけを「何の」や「何に対する」なしで表示することはしません。
  • 数字は tinta(24〜28px、600、tabular-nums)で表示します。色はデルタ値、ピル、またはバーにのみ使用します。
  • デルタ値は期間を示します(「+12% vs. 前月」、「今週+3」)。矢印(↗/↘)を伴い、色はビジネスにとって良いか悪いかで決まり、符号ではありません。滞納が減れば緑色です。
  • 期限切れがある場合、フッターには警告アイコンと、赤いテキストで件数(「2件期限切れ · 注意が必要」)を表示します。
  • 目標に対する進捗は、リングまたはバーで表示します。

エンティティカード(06, 13 · 分析 07)

  • エンティティカードには、タイトル、エンティティの色(左端の線またはアイコン)、優先度ピル、セグメント化進捗バー(「3/6完了」)、アクティビティスパークライン、アクション(チェックマーク付き「次のステップ」)が含まれます。
  • テーブルは補足的なものにします。エンティティカードがプライマリビューです。

テーブル(参考資料 01, 02)

  • テーブルはフラットで、bg-panel 上に配置します。1pxの行 separator を使用します。
  • ヘッダーは12pxグレー、小文字、tracking-wider。
  • 最初の列はエンティティ(名前 + 色付きの左端の線)。
  • 数値列は右揃え、通貨記号は小さいグレー。
  • アクションは行の最後、ホバー時に表示されます。

フォーム(参考資料 04, 05)

  • ラベルは12pxグレーでフィールドの上に配置。
  • フィールドは高さ40px、bg-superficie、角丸11、1pxのborde。
  • エラーは赤い境界線 + 10pxのエラーテキスト。
  • 1つのプライマリボタン、1つのセカンダリボタン。

モバイル(参考資料 10, 11, 12)

  • 画面幅390px。サイドバーは下部タブバーに置き換わります。
  • タブはアイコン + ラベル、アクティブタブはアクセントカラー。
  • カードはフル幅、パディング12〜16。
  • テーブルはカードのリストに置き換わります。

6. 状態

6b. 空の状態、読み込み状態、エラー状態

  • 空の状態: イラスト、タイトル、アクション。「まだありません」ではなく、何があるべきかを説明します。
  • 読み込み状態: スケルトンスクリーン(パルスするグレーのブロック)。正確なレイアウトを反映します。
  • エラー状態: エラーメッセージ + 再試行ボタン。フレンドリーで、具体的に何が問題かを説明します。

7. アクセシビリティ

  • すべてのテキストはWCAG AAに準拠します(コントラスト比4.5:1以上)。
  • 色だけで情報を伝えることはしません。常にテキストまたはアイコンと組み合わせます。
  • すべてのインタラクティブ要素はキーボードで操作可能です。
  • prefers-reduced-motion を尊重します。

8. デザインレビューチェックリスト

以下の各項目を確認します。

  1. フレームはニュートラルですか?アクセントカラーはデータ/エンティティ/主役だけに使用されていますか?
  2. 色相はシステム全体で一貫していますか?
  3. 彩度の高い背景に白いテキストはありますか?(禁止)
  4. 各エンティティに固有の色がありますか?
  5. 1つの主役はいますか?
  6. すべての数字に図が添えられていますか?
  7. トレイ内カードパターンは正しく使用されていますか(該当する場合)?
  8. タイポグラフィスケールとウェイトは守られていますか?
  9. 角丸は階層化されていますか?
  10. 影は適切なレベルですか?
  11. 空の状態、読み込み状態、エラー状態はデザインされていますか?
  12. 390pxでテストしましたか?
  13. ダークモードでテストしましたか?
  14. 色の数は制限内ですか?(グレー + 1アクセントカラー + 最大4ステートカラー + 最大6データカラー)
  15. prefers-reduced-motion は尊重されていますか?

9. トークン(tokens.css)

:root {
  --fondo: #F4F4F5;
  --panel: #FFFFFF;
  --superficie: #FAFAFA;
  --suave: #F0F0F1;
  --borde: #E4E4E7;
  --tinta: #18181B;
  --texto-2: #52525B;
  --texto-3: #A1A1AA;
  --acento: #18181B;
  --verde-fondo: #F0FDF4;
  --verde-texto: #166534;
  --ambar-fondo: #FEF9C3;
  --ambar-texto: #A16207;
  --rojo-fondo: #FEF2F2;
  --rojo-texto: #991B1B;
  --azul-fondo: #EFF6FF;
  --azul-texto: #1D4ED8;
  --dato-1: #3B82F6;
  --dato-2: #10B981;
  --dato-3: #F59E0B;
  --dato-4: #EF4444;
  --dato-5: #8B5CF6;
  --dato-6: #EC4899;
  --radius-marco: 26px;
  --radius-panel: 20px;
  --radius-tarjeta: 20px;
  --radius-interior: 16px;
  --radius-boton: 11px;
  --radius-pildora: 7px;
}

10. リソース

  • tokens.css: 上記のトークン。すぐに使用可能。
  • ejemplos/tablero-crm.html: CRMダッシュボードの完全なHTML例。
  • ejemplos/componentes.html: すべてのコンポーネントのギャラリー。
  • ejemplos/recetas-tailwind.md: React + Tailwind v4のレシピ。
  • referencias/: 各パターンの参考スクリーンショット。
  • analisis/: 各トピックの詳細な分析。

11. クイックスタート

  1. tokens.css をプロジェクトにコピーします。
  2. アクセントカラーとニュートラルカラーの色相を調整します。
  3. フレーム(サイドバー + パネル)を構築します。
  4. ページヘッダー(タイトル + サブタイトル + アクション)を追加します。
  5. KPI行を追加します(1つの主役 + トレイ内カード)。
  6. エンティティカードまたはテーブルでボディを構築します。
  7. 命を吹き込みます(色、アバター、グラフ、アニメーション)。
  8. 状態を追加します(空、読み込み、エラー)。
  9. モバイルとダークモードでテストします。
  10. チェックリストを確認します。

関連スキル