# danilobez/unibook-publisher architecture

> Architecture diagram of the GitHub repository danilobez/unibook-publisher, 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/danilobez/unibook-publisher
- Repository: https://github.com/danilobez/unibook-publisher

## Overview

UniBook Publisher is a modular publishing-workflow application covering manuscript intake through editorial review, chapter revision and design, with author contracts, royalty calculations, identity and notifications. The main user workflow enters through manuscript and chapter APIs and delegates to production services; publication and finance/communication follow-on capabilities are documented as event-driven. Source excerpts establish selected controller-to-service calls and S3 storage behavior; unsampled subsystem links are included only where the README explicitly documents them.

Main entry points: [`src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java) (Manuscript API), [`src/main/java/com/unibook/publisher/production/service/ManuscriptService.java`](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ManuscriptService.java) (Manuscript workflow), [`src/main/java/com/unibook/publisher/production/service/ChapterService.java`](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ChapterService.java) (Chapters and revisions), [`src/main/java/com/unibook/publisher/finance/service/ContractService.java`](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/finance/service/ContractService.java) (Contract management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_production["Manuscript production"]
  node_api["Manuscript API"]
  node_manuscript_service["Manuscript workflow"]
  node_chapter_api["Chapter API"]
  node_chapter_service["Chapters and revisions"]
  node_diff["Revision diff<br/>[DiffService.java]"]
  node_threads_design["Threads and covers"]
  node_finalization["Publication finalization"]
  node_storage["File storage"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Auth API"]
  node_user_service["User accounts<br/>[UserService.java]"]
  node_user_store[("User records<br/>[User.java]")]
end

subgraph group_finance["Contracts and royalties"]
  node_contract_api["Contract API"]
  node_contract_service["Contract management"]
  node_royalty["Royalty strategies"]
end

subgraph group_communication["Notifications"]
  node_notification_api["Notification API"]
  node_notifications["Notification delivery"]
  node_event_listener["Lifecycle event listener"]
end

subgraph group_shared["Shared domain"]
  node_domain_events["Domain events"]
  node_roles_errors["Roles and errors<br/>[UserRole.java]"]
end

node_author(("Author"))
node_editor(("Editorial staff"))
node_object_store[("S3-compatible store")]

node_author -->|"submits manuscript"| node_api
node_editor -->|"moderates"| node_api
node_api -->|"delegates to"| node_manuscript_service
node_author -->|"uploads revisions"| node_chapter_api
node_chapter_api -->|"delegates to"| node_chapter_service
node_chapter_service -.->|"computes comparison"| node_diff
node_chapter_service -.->|"stores revision content"| node_storage
node_threads_design -.->|"supports publishing"| node_finalization
node_storage -->|"reads and writes"| node_object_store
node_author -.->|"registers or logs in"| node_auth_api
node_auth_api -.->|"delegates to"| node_user_service
node_user_service -.->|"manages accounts"| node_user_store
node_contract_api -->|"delegates to"| node_contract_service
node_contract_service -.->|"simulates payouts"| node_royalty
node_notification_api -->|"delegates to"| node_notifications
node_event_listener -.->|"delivers alerts"| node_notifications
node_domain_events -->|"dispatches lifecycle events"| node_event_listener
node_manuscript_service -.->|"publishes workflow events"| node_domain_events
node_manuscript_service -->|"triggers contract lifecycle"| node_contract_service
node_roles_errors -->|"constrains moderation"| node_api

click node_api "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java"
click node_manuscript_service "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ManuscriptService.java"
click node_chapter_api "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/controller/ChapterController.java"
click node_chapter_service "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ChapterService.java"
click node_diff "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/DiffService.java"
click node_threads_design "https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/production/service"
click node_finalization "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ManuscriptFinalizationService.java"
click node_storage "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/S3FileStorageService.java"
click node_auth_api "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/controller/AuthController.java"
click node_user_service "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/service/UserService.java"
click node_user_store "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/entity/User.java"
click node_contract_api "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/finance/controller/ContractController.java"
click node_contract_service "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/finance/service/ContractService.java"
click node_royalty "https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/finance/royalty"
click node_notification_api "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/controller/NotificationController.java"
click node_notifications "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/service/NotificationService.java"
click node_event_listener "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/listener/NotificationEventListener.java"
click node_domain_events "https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/common/event"
click node_roles_errors "https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/common/enums/UserRole.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_api,node_manuscript_service,node_chapter_api,node_chapter_service,node_diff,node_threads_design,node_finalization,node_storage toneBlue
class node_auth_api,node_user_service,node_user_store,node_object_store toneAmber
class node_contract_api,node_contract_service,node_royalty toneMint
class node_notification_api,node_notifications,node_event_listener toneRose
class node_domain_events,node_roles_errors,node_author,node_editor toneIndigo
```

## Components

### Manuscript production

- [Manuscript API](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java): `src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`
- [Manuscript workflow](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ManuscriptService.java): `src/main/java/com/unibook/publisher/production/service/ManuscriptService.java`
- [Chapter API](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/controller/ChapterController.java): `src/main/java/com/unibook/publisher/production/controller/ChapterController.java`
- [Chapters and revisions](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ChapterService.java): `src/main/java/com/unibook/publisher/production/service/ChapterService.java`
- [Revision diff](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/DiffService.java): `src/main/java/com/unibook/publisher/production/service/DiffService.java`
- [Threads and covers](https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/production/service): `src/main/java/com/unibook/publisher/production/service`
- [Publication finalization](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/ManuscriptFinalizationService.java): `src/main/java/com/unibook/publisher/production/service/ManuscriptFinalizationService.java`
- [File storage](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/production/service/S3FileStorageService.java): `src/main/java/com/unibook/publisher/production/service/S3FileStorageService.java`

### Identity and access

- [Auth API](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/controller/AuthController.java): `src/main/java/com/unibook/publisher/identity/controller/AuthController.java`
- [User accounts](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/service/UserService.java): `src/main/java/com/unibook/publisher/identity/service/UserService.java`
- [User records](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/identity/entity/User.java): `src/main/java/com/unibook/publisher/identity/entity/User.java`

### Contracts and royalties

- [Contract API](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/finance/controller/ContractController.java): `src/main/java/com/unibook/publisher/finance/controller/ContractController.java`
- [Contract management](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/finance/service/ContractService.java): `src/main/java/com/unibook/publisher/finance/service/ContractService.java`
- [Royalty strategies](https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/finance/royalty): `src/main/java/com/unibook/publisher/finance/royalty`

### Notifications

- [Notification API](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/controller/NotificationController.java): `src/main/java/com/unibook/publisher/communication/controller/NotificationController.java`
- [Notification delivery](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/service/NotificationService.java): `src/main/java/com/unibook/publisher/communication/service/NotificationService.java`
- [Lifecycle event listener](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/communication/listener/NotificationEventListener.java): `src/main/java/com/unibook/publisher/communication/listener/NotificationEventListener.java`

### Shared domain

- [Domain events](https://github.com/danilobez/unibook-publisher/tree/main/src/main/java/com/unibook/publisher/common/event): `src/main/java/com/unibook/publisher/common/event`
- [Roles and errors](https://github.com/danilobez/unibook-publisher/blob/main/src/main/java/com/unibook/publisher/common/enums/UserRole.java): `src/main/java/com/unibook/publisher/common/enums/UserRole.java`

### Other components

- **Author**
- **Editorial staff**
- **S3-compatible store**

## Connections

- Author → Manuscript API: submits manuscript (evidence: `src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`)
- Editorial staff → Manuscript API: moderates (evidence: `src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`)
- Manuscript API → Manuscript workflow: delegates to (evidence: `src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`)
- Author → Chapter API: uploads revisions (evidence: `src/main/java/com/unibook/publisher/production/controller/ChapterController.java`)
- Chapter API → Chapters and revisions: delegates to (evidence: `src/main/java/com/unibook/publisher/production/controller/ChapterController.java`)
- Chapters and revisions → Revision diff: computes comparison
- Chapters and revisions → File storage: stores revision content
- Threads and covers → Publication finalization: supports publishing
- File storage → S3-compatible store: reads and writes (evidence: `src/main/java/com/unibook/publisher/production/service/S3FileStorageService.java`)
- Author → Auth API: registers or logs in
- Auth API → User accounts: delegates to (evidence: `src/main/java/com/unibook/publisher/identity/controller/AuthController.java`)
- User accounts → User records: manages accounts
- Contract API → Contract management: delegates to (evidence: `src/main/java/com/unibook/publisher/finance/controller/ContractController.java`)
- Contract management → Royalty strategies: simulates payouts
- Notification API → Notification delivery: delegates to (evidence: `src/main/java/com/unibook/publisher/communication/controller/NotificationController.java`)
- Lifecycle event listener → Notification delivery: delivers alerts
- Domain events → Lifecycle event listener: dispatches lifecycle events (evidence: `README.md`)
- Manuscript workflow → Domain events: publishes workflow events
- Manuscript workflow → Contract management: triggers contract lifecycle (evidence: `README.md`)
- Roles and errors → Manuscript API: constrains moderation (evidence: `src/main/java/com/unibook/publisher/production/controller/ManuscriptController.java`)
