assayo/documents/JA.md

English | Español | 中文 | Français | Deutsch | Português | 日本語 | Русский

主な文書はロシア語です。 これは翻訳です。 エラーが含まれている可能性があります。 あなたがネイティブスピーカーであれば、この翻訳を改善するのに役立ちます。 ありがとう！

Assayo

データの可視化とGitレポジトリの分析 (デモ, install).

👨‍💻 従業員は新しい職場を評価することができます

• 働きのペース;
• 過労;
• 職務範囲;
• 新機能とバグの量;
• 同僚の仕事スタイル;

‍👨‍💼 管理者は従業員を評価できます

• 無職人の特定;
• コードの量を推定する;
• 作業速度を確認する;
• 行動の異常を発見する;
• 週次で作業状況を確認する;

👑 アイベンターは製品を評価できます

• 製品の価格;
• 新機能の価格;
• 開発時間;
• 改善時間の予測;
• 予測価格;

Table of contents

• コミット数を素早く確認するにはどうすればよいでしょうか。
• 作者をまとめるにはどうすればいいですか？
• Gitからデータをダウンロードするにはどうすればよろしいでしょうか。
  • Дオンラインで見るため
  • インターネットなしで見るために
• レポートを表示するにはどうすればよいですか？
  • Online
  • Offline
• レポートファイルを再構成する方法は？
• マイクロサービス群のレポートを表示するにはどうすればよいでしょうか。
• 自社のブランドカラーでインターフェースをリニュアルカラーに変えるにはどうすればよろしいでしょうか。
• commit文の署名方法は？
• How to add checking for commit message?
  • Use file commit-msg
  • Use package pre-commit
• データの自動収集方法は？
  • With backend
  • バックエンドなし
• DevOps
  • 公開サーバ
  • プライベートサーバー
  • Dockerイメージの更新
• ️ About application
  • Architecture
  • 半年ごとにリリースを行います。次は何でしょうか。
  • 翻訳を追加または編集するにはどうすればいいでしょうか。
  • 願い、提案、コメント

🚀 コミット数を素早く確認するにはどうすればよいでしょうか。

プロジェクトのルートディレクトリで以下のコマンドを実行します:

git shortlog -s -n -e

‍🎭 作者をまとめるにはどうすればいいですか？

プロジェクトのルートディレクトリ内に.mailmapファイルを作成する必要があります。 ファイルの内容の例:

Alex B <alex@mail.uk>
Alex B <alex@mail.uk> <alex@gov.tk>
Alex B <alex@mail.uk> <bakhirev@ya.kz>
Alex B <alex@mail.uk> <man64@yahoo.com>

このファイルの形式について詳しく読むことができます ここに.

📤 Gitからデータをダウンロードするにはどうすればよろしいでしょうか。

Дオンラインで見るため

プロジェクトのルートディレクトリに次のコマンドを入力します:

git --no-pager log --numstat --oneline --all --reverse --date=iso-strict --pretty=format:"%ad>%cN>%cE>%s" > log.txt

インターネットなしで見るために

git --no-pager log --numstat --oneline --all --reverse --date=iso-strict --pretty=format:"%ad>%cN>%cE>%s" | sed -e 's/\\/\\\\/g' | sed -e 's/`/"/g' | sed -e 's/^/report.push(\`/g' | sed 's/$/\`\);/g' | sed 's/\$/_/g' > log.txt

Gitはファイルを作成します log.txt. このファイルには、レポートを構築するためのデータが含まれています。 インターネットのない形式とインターネットのある形式は、文字列が埋め込まれているという点で異なります。インターネットを持たない形式でファイルを開くと、単に「js」ファイルとして読み込まれます。 /build/index.html

📈 レポートを表示するにはどうすればよいですか？

Online

• に切り替える ウェブサイト
• ボタンを押す “デモ”
• ファイルをドラッグ＆ドロップする log.txt ブラウザウィンドウで

Offline

• このリポジトリをダウンロードする
• ファイルをドラッグ＆ドロップする log.txt フォルダへ /build
• 実行するには /build/index.html
• フォルダをドラッグして下さい /build 自分のリポジトリーにフォルダを置いてください (それがある場所 log.txt). 名前を変更することができます。例えば名前 /build を /report 重要なのは、ファイル log.txt インターネットが利用できない環境で、レポートを表示するために作成されたコマンドである必要があります。

🏭 レポートファイルを再構成する方法は？

• このリポジトリをダウンロードしてください
• 実行するには npm install
• 実行するには npm run build-local
• 最新のビルドは、フォルダに含まれるでしょう /build

🗃️ マイクロサービス群のレポートを表示するにはどうすればよいでしょうか。

• マイクロサービスごとにファイルを作成します。 log.txt (log-1.txt, log-2.txt, log-3.txt など。)
• "インターネット上でレポートを見る方法"を参照してください。最後の手順では、すべてのファイルをブラウザのウィンドウに一度にドラッグ＆ドロップします。
• “インターネットなしでレポートを見る方法” を参照してください。第二段階では、マイクロサービスのすべてのファイルをドラッグしてドロップする必要があります。(log-1.txt, log-2.txt, log-3.txt など。) レポートフォルダへ (/build).

🎨 自社のブランドカラーでインターフェースをリニュアルカラーに変えるにはどうすればよろしいでしょうか。

インターフェースのテーマを独自に作成することができます。下記の項目は変更できます。

• 見出し. それはURLパラメータで指定することができます title. 例えば: ?title=You Company
• CSS スタイル. そのためにはCSSファイルを用意し、そのアドレスをURLパラメーターに指定する必要があります theme. 例えば: ?theme=//company.com/some.css. クラス名をセレクターとして使用することができます。ほとんどの場合、新しいバージョンがリリースされると変更されません
• 言語. URLパラメータに指定することができます lang. 例えば: ?lang=es

📝 commit文の署名方法は？

練習に従ってください Conventional Commits 1.0.0. 例えば:

JIRA-1234 feat(profile): Added avatar for user 

• 発行番号 (JIRA-1234)
• 仕事の種類 (feat, fix, style, refactor, test, doc など。)
• 仕事の分野 (profile - サイトのセクション、ページ、新機能、簡単に)
• ジョブの説明 (Added avatar for user)

👮 How to add checking for commit message?

Use file commit-msg

1. Create file commit-msg in folder .git/hooks/
2. Add this text in file:

#!/usr/bin/env bash
if ! grep -iqE "(JIRA-[0-9]{1,5})(\s)(feat|fix|docs|style|refactor|test|chore)((\([a-z0-9_-]{1,}\)){0,})(:\s)([a-z]{1,})" "$1"; then
   echo "Need commit message like: JIRA-12 fix(profile): some text. Read Semantic Commit Messages" >&2
   exit 1
fi

Use package pre-commit

1. Add in file package.json property commit-msg:

  ...
  "commit-msg": {
    "regex": "(JIRA-[0-9]{1,5})(\\s)(feat|fix|docs|style|refactor|test|chore)((\\([a-z0-9_-]{1,}\\)){0,})(:\\s)([a-z]{1,})",
    "error-message": "Need commit message like: JIRA-12 fix(profile): some text Read Semantic Commit Messages"
  },
  ...

2. Run command npm install pre-commit

📚 データの自動収集方法は？

With backend

• use module Assayo Crawler;

バックエンドなし

• リポジトリのクローンを作成します。;
• フォルダをコピーする build 現在のリポジトリから;
• オープン build/index.html ブラウザでブックマークに追加します。;
• にショートカットを追加する build/assets/ci-cd.sh 自動起動フォルダーに (Windows); コンピューターを再起動するとき、スクリプトはメインブランチに自動的に挿入されたすべてのデータについての統計を更新します。

🛠️ DevOps (CI/CD)

公開サーバ

データをレポートビルド用に公開するファイルをURLで公開することができます。その視覚化は、サイト上で利用可能なツールを使用することで行うことができます。 assayo. データがある場所のアドレスを、URLパラメータに入力してください。 dump:

https://assayo.online/demo/?dump=//you_site.com/some/log.txt

プライベートサーバー

• ダウンロード dockerイメージ;
• ローカルネットワーク内で実行します。;
• レポートの表示には、データが置かれている場所のアドレスがURLパラメータに入っていることを指定したウェブインターフェイスを使用します。 dump:

http://assayo_url/?dump=//you_url/some/log.txt
assayo_url - ポート80でリッスンしているassayoコンテナのURL;
you_url    - gitのログのコンテナーのURLアドレス;

デフォルトではイメージは以下のアドレスで起動します http://127.0.0.1:80/. 問題が解決しない場合は、ポート80が開いているか確認してみてください。

Dockerイメージの更新

• 次のコマンドを実行します npm run build-local
• 次のコマンドを実行します docker build -t assayo .
• 結果を確認する docker run --name assayo -p 80:80 -d assayo;
• 次のコマンドを実行します docker tag assayo bakhirev/assayo:latest;
• コンテナイメージをDocker Hubにアップロードする docker push bakhirev/assayo:latest;

🛠️ ️ About application

📐 Architecture

1. Reports showcase UI displays a list of available reports. Each report consists of a title, description, and a list of repositories.
2. Crawler service collects repository logs for the report.
3. Log visualization UI (you here) displays report. Needs a log file for work.

🈯 半年ごとにリリースを行います。次は何でしょうか。

見て！ 主なドキュメント

🗺️ 翻訳を追加または編集するにはどうすればいいでしょうか。

新しい翻訳を追加するか、現在の翻訳を修正するために、以下のセクションでそれを行うことができます: ts/translations/. 取扱説明書

📧 願い、提案、コメント

• telegramm @bakhirev (優先通信方式)
• alexey-bakhirev@yandex.ru
• ウェブサイト https://assayo.online/