# thepowermisha/document architecture

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

- Interactive diagram: https://gitdiagram.com/thepowermisha/document
- Repository: https://github.com/thepowermisha/document

## Overview

This repository implements an author-aware document processing system, plus a scheduled status worker and a document generator. The main workflow is to create a draft, submit it, then approve it; approval also writes to a register, and successful transitions record history. The API exposes document search, retrieval, batch operations, and author endpoints. The README documents the worker’s timed status changes and the generator’s API-driven document creation. Edges reflect shown calls or documented behavior; unsampled internals are represented only where the README supports them.

Main entry points: [`document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java`](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java) (Document service), [`document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java`](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java) (Transition service), [`document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java`](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java) (Document API), [`document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java`](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java) (Author service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_document_api["Document API"]
  node_author_api["Author API"]
  node_author_service["Author service<br/>[AuthorService.java]"]
  node_token_utils["Token utilities"]
end

subgraph group_workflow["Document workflow"]
  node_document_service["Document service"]
  node_batch_service["Batch service"]
  node_transactional_service["Transition service"]
end

subgraph group_persistence["Persistence"]
  node_document_data["Document data<br/>[Document.java]"]
  node_author_data["Author data<br/>[Author.java]"]
  node_history_data["History records"]
  node_register_data["Register entries"]
  node_document_repo["Document repository"]
  node_author_repo["Author repository"]
  node_history_repo["History repository"]
  node_register_repo["Register repository"]
end

subgraph group_automation["Automation"]
  node_worker["Scheduler worker"]
  node_scheduler_service["Status scheduler"]
  node_generator["Document generator"]
end

node_user(("API user"))
node_database[("Relational database")]

node_user -->|"requests"| node_document_api
node_user -->|"requests"| node_author_api
node_author_api -->|"delegates"| node_author_service
node_author_service -->|"looks up"| node_author_repo
node_author_service -->|"encodes token"| node_token_utils
node_document_api -->|"delegates"| node_document_service
node_document_api -->|"delegates batches"| node_batch_service
node_document_service -->|"queries and saves"| node_document_repo
node_document_service -->|"validates author"| node_author_repo
node_document_service -->|"transitions"| node_transactional_service
node_batch_service -->|"delegates"| node_document_service
node_transactional_service -->|"reads and updates"| node_document_repo
node_transactional_service -->|"records changes"| node_history_repo
node_transactional_service -->|"registers approval"| node_register_repo
node_document_repo -.->|"persists documents"| node_database
node_author_repo -.->|"persists authors"| node_database
node_history_repo -.->|"persists history"| node_database
node_register_repo -.->|"persists register"| node_database
node_worker -->|"schedules"| node_scheduler_service
node_scheduler_service -->|"searches and transitions"| node_document_service
node_generator -->|"sends create requests"| node_document_api

click node_document_api "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java"
click node_author_api "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/controller/AuthorController.java"
click node_author_service "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java"
click node_token_utils "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/security/UuidTokenUtils.java"
click node_document_service "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java"
click node_batch_service "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentBatchService.java"
click node_transactional_service "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java"
click node_document_data "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/Document.java"
click node_author_data "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/Author.java"
click node_history_data "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/DocumentHistory.java"
click node_register_data "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/DocumentRegister.java"
click node_document_repo "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRepository.java"
click node_author_repo "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/AuthorRepository.java"
click node_history_repo "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentHistoryRepository.java"
click node_register_repo "https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRegisterRepository.java"
click node_worker "https://github.com/thepowermisha/document/blob/master/background-worker/src/main/java/com/thepowermisha/scheduler/scheduler/SchedulerWorker.java"
click node_scheduler_service "https://github.com/thepowermisha/document/blob/master/background-worker/src/main/java/com/thepowermisha/scheduler/service/DocumentSchedulerService.java"
click node_generator "https://github.com/thepowermisha/document/blob/master/document-generator/src/main/java/com/thepowermisha/generator/service/GeneratorService.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_document_api,node_author_api,node_author_service,node_token_utils,node_user toneBlue
class node_document_service,node_batch_service,node_transactional_service,node_database toneAmber
class node_document_data,node_author_data,node_history_data,node_register_data,node_document_repo,node_author_repo,node_history_repo,node_register_repo toneMint
class node_worker,node_scheduler_service,node_generator toneRose
```

## Components

### API and identity

- [Document API](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java): `document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java`
- [Author API](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/controller/AuthorController.java): `document-processing/src/main/java/com/thepowermisha/document/controller/AuthorController.java`
- [Author service](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java): `document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java`
- [Token utilities](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/security/UuidTokenUtils.java): `document-processing/src/main/java/com/thepowermisha/document/security/UuidTokenUtils.java`

### Document workflow

- [Document service](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java): `document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java`
- [Batch service](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentBatchService.java): `document-processing/src/main/java/com/thepowermisha/document/service/DocumentBatchService.java`
- [Transition service](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java): `document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java`

### Persistence

- [Document data](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/Document.java): `document-processing/src/main/java/com/thepowermisha/document/entity/Document.java`
- [Author data](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/Author.java): `document-processing/src/main/java/com/thepowermisha/document/entity/Author.java`
- [History records](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/DocumentHistory.java): `document-processing/src/main/java/com/thepowermisha/document/entity/DocumentHistory.java`
- [Register entries](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/entity/DocumentRegister.java): `document-processing/src/main/java/com/thepowermisha/document/entity/DocumentRegister.java`
- [Document repository](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRepository.java): `document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRepository.java`
- [Author repository](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/AuthorRepository.java): `document-processing/src/main/java/com/thepowermisha/document/repository/AuthorRepository.java`
- [History repository](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentHistoryRepository.java): `document-processing/src/main/java/com/thepowermisha/document/repository/DocumentHistoryRepository.java`
- [Register repository](https://github.com/thepowermisha/document/blob/master/document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRegisterRepository.java): `document-processing/src/main/java/com/thepowermisha/document/repository/DocumentRegisterRepository.java`

### Automation

- [Scheduler worker](https://github.com/thepowermisha/document/blob/master/background-worker/src/main/java/com/thepowermisha/scheduler/scheduler/SchedulerWorker.java): `background-worker/src/main/java/com/thepowermisha/scheduler/scheduler/SchedulerWorker.java`
- [Status scheduler](https://github.com/thepowermisha/document/blob/master/background-worker/src/main/java/com/thepowermisha/scheduler/service/DocumentSchedulerService.java): `background-worker/src/main/java/com/thepowermisha/scheduler/service/DocumentSchedulerService.java`
- [Document generator](https://github.com/thepowermisha/document/blob/master/document-generator/src/main/java/com/thepowermisha/generator/service/GeneratorService.java): `document-generator/src/main/java/com/thepowermisha/generator/service/GeneratorService.java`

### Other components

- **API user**
- **Relational database**

## Connections

- API user → Document API: requests (evidence: `document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java`)
- API user → Author API: requests
- Author API → Author service: delegates (evidence: `document-processing/src/main/java/com/thepowermisha/document/controller/AuthorController.java`)
- Author service → Author repository: looks up (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java`)
- Author service → Token utilities: encodes token (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/AuthorService.java`)
- Document API → Document service: delegates (evidence: `document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java`)
- Document API → Batch service: delegates batches (evidence: `document-processing/src/main/java/com/thepowermisha/document/controller/DocumentController.java`)
- Document service → Document repository: queries and saves (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java`)
- Document service → Author repository: validates author (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java`)
- Document service → Transition service: transitions (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentService.java`)
- Batch service → Document service: delegates (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentBatchService.java`)
- Transition service → Document repository: reads and updates (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java`)
- Transition service → History repository: records changes (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java`)
- Transition service → Register repository: registers approval (evidence: `document-processing/src/main/java/com/thepowermisha/document/service/DocumentTransactionalService.java`)
- Document repository → Relational database: persists documents
- Author repository → Relational database: persists authors
- History repository → Relational database: persists history
- Register repository → Relational database: persists register
- Scheduler worker → Status scheduler: schedules (evidence: `background-worker/src/main/java/com/thepowermisha/scheduler/scheduler/SchedulerWorker.java`)
- Status scheduler → Document service: searches and transitions (evidence: `background-worker/src/main/java/com/thepowermisha/scheduler/service/DocumentSchedulerService.java`)
- Document generator → Document API: sends create requests (evidence: `document-generator/src/main/java/com/thepowermisha/generator/service/GeneratorService.java`)
