# bigbrownking/ai_investigator architecture

> Architecture diagram of the GitHub repository bigbrownking/ai_investigator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bigbrownking/ai_investigator
- Repository: https://github.com/bigbrownking/ai_investigator

## Overview

This is a Spring-based digital case-management backend. Users authenticate and work with cases, files, interrogations, plans, and related legal records; asynchronous processing and notifications support some of those workflows. The tree shows broad administrative, face-authentication, inspection, reporting, and support capabilities as well. Source excerpts are limited, and the README is empty, so relationships not directly evidenced in the excerpts or source index are omitted rather than inferred.

Main entry points: [`src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java) (Interrogation authorization), [`src/main/java/org/di/digital/service/auth/AuthService.java`](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/auth/AuthService.java) (Authentication), [`src/main/java/org/di/digital/service/cases/CaseService.java`](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/cases/CaseService.java) (Case management), [`src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java`](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java) (Interrogations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_user["User<br/>[User.java]"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_face["Face authentication"]
  node_access["Case access"]
  node_interrogation_auth["Interrogation authorization"]
end

subgraph group_cases["Casework"]
  node_case["Case management<br/>[CaseService.java]"]
  node_case_record["Case record<br/>[Case.java]"]
  node_case_repository["Case repository"]
  node_file_storage["File storage<br/>[MinioService.java]"]
  node_interrogation["Interrogations"]
  node_interrogation_record["Interrogation record"]
  node_interrogation_repository["Interrogation repository"]
  node_plans["Plans and approvals<br/>[PlanService.java]"]
  node_legal_docs["Legal documents"]
  node_inspection["Inspections<br/>[OsmotrService.java]"]
  node_reports["Reports<br/>[ReportService.java]"]
end

subgraph group_processing["Processing and events"]
  node_task_queue["Task queue"]
  node_transcription["Transcription updates"]
  node_notifications["Notifications"]
end

subgraph group_operations["Administration"]
  node_admin["Administration<br/>[AdminService.java]"]
  node_support["Feedback and support"]
end

node_actor(("User"))

node_actor -.->|"authenticates"| node_auth
node_auth -->|"uses account"| node_user
node_actor -.->|"manages cases"| node_case
node_case -->|"uses record"| node_case_record
node_actor -.->|"conducts interview"| node_interrogation
node_interrogation -->|"uses record"| node_interrogation_record
node_interrogation_auth -->|"loads interview"| node_interrogation_repository
node_interrogation_auth -->|"loads user"| node_user
node_interrogation_auth -->|"checks access"| node_access
node_interrogation_auth -->|"returns interview"| node_interrogation_record
node_task_queue -->|"references repository"| node_case_repository
node_transcription -->|"updates interview"| node_interrogation_repository
node_actor -.->|"administers"| node_admin
node_actor -.->|"uses face login"| node_face
node_actor -.->|"submits feedback"| node_support

click node_user "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/user/User.java"
click node_auth "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/auth/AuthService.java"
click node_face "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/face/FaceManagementService.java"
click node_access "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/cases/CaseAccessService.java"
click node_case "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/cases/CaseService.java"
click node_case_record "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/cases/Case.java"
click node_case_repository "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/repository/cases/CaseRepository.java"
click node_file_storage "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/core/MinioService.java"
click node_interrogation "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java"
click node_interrogation_auth "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java"
click node_interrogation_record "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/interrogation/CaseInterrogation.java"
click node_interrogation_repository "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/repository/interrogation/CaseInterrogationRepository.java"
click node_plans "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/plan/PlanService.java"
click node_legal_docs "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/indictment/IndictmentService.java"
click node_inspection "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/osmotr/OsmotrService.java"
click node_reports "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/report/ReportService.java"
click node_task_queue "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/queue/TaskQueueService.java"
click node_transcription "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/consumer/transcription/TranscriptionUpdateService.java"
click node_notifications "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/core/NotificationService.java"
click node_admin "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/admin/AdminService.java"
click node_support "https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/FeedbackService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_user,node_auth,node_face,node_access,node_interrogation_auth,node_actor toneBlue
class node_case,node_case_record,node_case_repository,node_file_storage,node_interrogation,node_interrogation_record,node_interrogation_repository,node_plans,node_legal_docs,node_inspection,node_reports toneAmber
class node_task_queue,node_transcription,node_notifications toneMint
class node_admin,node_support toneRose
```

## Components

### Identity and access

- [User](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/user/User.java): `src/main/java/org/di/digital/model/user/User.java`
- [Authentication](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/auth/AuthService.java): `src/main/java/org/di/digital/service/auth/AuthService.java`
- [Face authentication](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/face/FaceManagementService.java): `src/main/java/org/di/digital/service/face/FaceManagementService.java`
- [Case access](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/cases/CaseAccessService.java): `src/main/java/org/di/digital/service/cases/CaseAccessService.java`
- [Interrogation authorization](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java): `src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`

### Casework

- [Case management](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/cases/CaseService.java): `src/main/java/org/di/digital/service/cases/CaseService.java`
- [Case record](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/cases/Case.java): `src/main/java/org/di/digital/model/cases/Case.java`
- [Case repository](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/repository/cases/CaseRepository.java): `src/main/java/org/di/digital/repository/cases/CaseRepository.java`
- [File storage](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/core/MinioService.java): `src/main/java/org/di/digital/service/core/MinioService.java`
- [Interrogations](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java): `src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java`
- [Interrogation record](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/model/interrogation/CaseInterrogation.java): `src/main/java/org/di/digital/model/interrogation/CaseInterrogation.java`
- [Interrogation repository](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/repository/interrogation/CaseInterrogationRepository.java): `src/main/java/org/di/digital/repository/interrogation/CaseInterrogationRepository.java`
- [Plans and approvals](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/plan/PlanService.java): `src/main/java/org/di/digital/service/plan/PlanService.java`
- [Legal documents](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/indictment/IndictmentService.java): `src/main/java/org/di/digital/service/indictment/IndictmentService.java`
- [Inspections](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/osmotr/OsmotrService.java): `src/main/java/org/di/digital/service/osmotr/OsmotrService.java`
- [Reports](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/report/ReportService.java): `src/main/java/org/di/digital/service/report/ReportService.java`

### Processing and events

- [Task queue](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/queue/TaskQueueService.java): `src/main/java/org/di/digital/service/impl/queue/TaskQueueService.java`
- [Transcription updates](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/consumer/transcription/TranscriptionUpdateService.java): `src/main/java/org/di/digital/consumer/transcription/TranscriptionUpdateService.java`
- [Notifications](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/impl/core/NotificationService.java): `src/main/java/org/di/digital/service/impl/core/NotificationService.java`

### Administration

- [Administration](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/admin/AdminService.java): `src/main/java/org/di/digital/service/admin/AdminService.java`
- [Feedback and support](https://github.com/bigbrownking/ai_investigator/blob/main/src/main/java/org/di/digital/service/FeedbackService.java): `src/main/java/org/di/digital/service/FeedbackService.java`

### Other components

- **User**

## Connections

- User → Authentication: authenticates
- Authentication → User: uses account (evidence: `src/main/java/org/di/digital/service/auth/AuthService.java`)
- User → Case management: manages cases
- Case management → Case record: uses record (evidence: `src/main/java/org/di/digital/service/cases/CaseService.java`)
- User → Interrogations: conducts interview
- Interrogations → Interrogation record: uses record (evidence: `src/main/java/org/di/digital/service/interrogation/CaseInterrogationService.java`)
- Interrogation authorization → Interrogation repository: loads interview (evidence: `src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`)
- Interrogation authorization → User: loads user (evidence: `src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`)
- Interrogation authorization → Case access: checks access (evidence: `src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`)
- Interrogation authorization → Interrogation record: returns interview (evidence: `src/main/java/org/di/digital/service/impl/interrogation/InterrogationAuthService.java`)
- Task queue → Case repository: references repository (evidence: `src/main/java/org/di/digital/service/impl/queue/TaskQueueService.java`)
- Transcription updates → Interrogation repository: updates interview (evidence: `src/main/java/org/di/digital/consumer/transcription/TranscriptionUpdateService.java`)
- User → Administration: administers
- User → Face authentication: uses face login
- User → Feedback and support: submits feedback
