このリポジトリには、請求書を簡単に生成するための Web およびクロスプラットフォーム アプリ (Web PWA、Windows、Mac OS X、iOS、Android) が含まれています。このプロジェクトは、顧客データの管理、請求書発行などを行うのに役立ちます。
使用または試用したフレームワーク、プラットフォーム、ライブラリ、プラグイン、コンセプト、アーキテクチャ、テクニックなどは次のとおりです。
このプロジェクトでは、次の依存関係を事前にインストールする必要があります。
必要な依存関係をすべてインストールするには、次を実行するだけです。
npm install
これにより、git commit メッセージ テンプレートもセットアップされます (そして commitizen を使用するように wip パッケージが設定されます)。
このプロジェクトでは、 GitFlowブランチ モデルと SourceTree ブランチのデフォルト名を使用してください。詳細については、こちらを参照してください。
このプロジェクト (Angular) では、従来のコミットAngular コミット メッセージ ガイドラインが使用されます。
これらは、 npm パッケージstandard-versionで変更ログを自動生成するために使用されます。これを行うには、 npm run release
実行するだけです。これにより、次のタスクが実行されます。
npm run commit
使用すると、正しいコミット メッセージの作成に役立つウィザードを取得できます (これはcommitizenで行われます)。
また、コミットメッセージはcommitlintを使用して正しいかどうかチェックされます (どうしてもスキップする必要がある場合は、githook をバイパスできますが、通常は実行しないでください)。
npm run prepare-git-commit-template
を使用して git コミット メッセージ テンプレートを生成できます。これも npm インストール中に行われます。
ヘッダー( type 、 scopeおよびsubjectで構成される) は 72 文字を超えてはなりません。
type(scope?): subject
body?
footer?
次のいずれかである必要があります。
src
やtest
ファイルを変更しないその他の変更スコープは、コミット変更の場所を指定するものであれば何でも構いません。次の規則 (例) を使用しています。
件名には、変更の簡潔な説明が含まれています。
主語と同様に、命令形の現在形を使用します。「変更」でも「変更」でも「変更」ではありません。身体には変化の動機が含まれており、これを以前の行動と対比する必要があります。
フッターには重大な変更に関する情報が含まれている必要があり、このコミットが終了するJIRA の問題を参照する場所でもあります。
重大な変更は、スペースまたは 2 つの改行を含むBREAKING CHANGE:
単語で始める必要があります。残りのコミット メッセージはこれに使用されます。
このリポジトリでは、「クリーンな」ソース コードをチェックするために git フックが使用されます ( huskyでセットアップ)。
Typescript または SCSS ファイルが変更されてプッシュされると、コミット フックがトリガーされ、ステージングされたファイルが prettier でフォーマットされます。 pretty-quickの助けを借りて、フォーマット/変更を実行し、この変更をコミットしてプッシュします。
git commit メッセージが従来の git commit メッセージであるかどうかを確認し、そうでない場合はコミットをキャンセルします。
リリース ブランチの最後のコミットでは、プロジェクト バージョンを設定し、変更ログを生成する必要があります。これはnpm run release
で行う必要があります。このセットはプロジェクトのバージョンであり、変更ログを生成し、この変更をコミットします。詳細については、 「従来の変更ログ / コミット」の章を参照してください。
このプロジェクトでは、 Travis CI はlint-、test-、e2e-tests-、および build-slave としてセットアップされています。すべてがテストされ、正常にビルドされた場合、Travis CI はWebApp をFireBaseにデプロイします。