feat: support aliases for git log usernames

Author: John van Leeuwen

README.md

@@ -39,6 +39,21 @@ npm i @softarc/detective -D
 npx detective
 ```
 
+## Defining aliases
+
+In case users have used multiple names, as appearing in the `git log`, use the `aliases` option in the file `.detective/config.json` created the first time detective runs:
+
+```json
+{
+  [...]
+  "aliases": {
+    "jdoe": "John Doe", 
+    "janedoe": "Jane Doe"
+  }
+  [...]
+}
+```
+
 ## Defining Teams
 
 For the Team Alignment Analysis, you need to map team names to the names of your team members as found in `git log`. This is done in the file `.detective/config.json` created the first time detective runs:

apps/backend/src/infrastructure/config.ts

@@ -13,6 +13,7 @@ const initConfig: Config = {
     files: [],
     logs: [],
   },
+  aliases: {},
   teams: {
     'example-team-a': ['John Doe', 'Jane Doe'],
     'example-team-b': ['Max Muster', 'Susi Sorglos'],

apps/backend/src/model/config.ts

@@ -8,13 +8,15 @@ export type Config = {
   groups: string[];
   filter: Filter;
   teams: Record<string, string[]>;
+  aliases: Record<string, string>;
   entries: [];
 };
 
 export const emptyConfig: Config = {
   scopes: [],
   groups: [],
   teams: {},
+  aliases: {},
   entries: [],
   filter: {
     logs: [],

apps/backend/src/services/team-alignment.ts

@@ -50,6 +50,8 @@ export async function calcTeamAlignment(
       }
     }
 
+    userName = config.aliases?.[userName] || userName;
+
     users.add(userName);
 
     const key = calcKey(byUser, userName, userToTeam);