# qiunanrima/picacg_modfiy architecture

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

- Interactive diagram: https://gitdiagram.com/qiunanrima/picacg_modfiy
- Repository: https://github.com/qiunanrima/picacg_modfiy

## Overview

Picacg is an Android comics and community app, being migrated from Fragment/XML screens to Jetpack Compose. The main user journey is to browse recommendations or categories, open a comic, inspect its chapters, then read or download pages. Other documented branches cover accounts, comments, games, chat, profiles, and app operations. The graph groups related screens and ViewModels where implementation excerpts were unavailable; README statements support those product relationships. Coil’s image pipeline is represented from sampled source, while app-to-backend wiring is not shown in the excerpts.

Main entry points: [`app/src/main/java/com/picacomic/fregata/compose/viewmodels`](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels) (Comic ViewModels), [`coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt`](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt) (Image pipeline), [`app/src/main/java/com/picacomic/fregata/activities/SplashActivity.kt`](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/activities/SplashActivity.kt) (App entry), [`app/src/main/java/com/picacomic/fregata/compose/screens`](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens) (Login and register)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_entry["App entry<br/>[SplashActivity.kt]"]
  node_auth["Login and register"]
end

subgraph group_comics["Comic experience"]
  node_home["Home and browse"]
  node_catalog["Comic catalog"]
  node_comicdetail["Comic details"]
  node_reader["Comic reader"]
  node_downloads["Offline downloads"]
  node_comicvm["Comic ViewModels"]
end

subgraph group_community["Community and account"]
  node_accountvm["Account ViewModels"]
  node_social["Community features"]
  node_socialvm["Community ViewModels"]
  node_socket["Socket.IO client<br/>[Manager.java]"]
  node_profile["Profile and settings"]
end

subgraph group_operations["App operations"]
  node_operations["Announcements and apps"]
  node_operationvm["Operations ViewModels"]
end

subgraph group_imaging["Image loading"]
  node_coilrequest["Image requests<br/>[ImageRequest.kt]"]
  node_coilengine["Image pipeline"]
  node_coilcache[("Memory cache")]
  node_coilcompose["Compose image UI"]
end

node_user(("App user"))
node_server{{"Pica services"}}

node_user -->|"opens app"| node_entry
node_entry -.->|"starts browsing"| node_home
node_user -->|"browses"| node_catalog
node_catalog -->|"dispatches events"| node_comicvm
node_comicvm -.->|"requests catalog"| node_server
node_user -->|"opens comic"| node_comicdetail
node_comicdetail -->|"dispatches events"| node_comicvm
node_comicvm -.->|"requests details"| node_server
node_user -->|"reads pages"| node_reader
node_user -->|"downloads chapters"| node_downloads
node_downloads -.->|"fetches pages"| node_server
node_user -->|"signs in"| node_auth
node_auth -->|"dispatches events"| node_accountvm
node_accountvm -.->|"authenticates"| node_server
node_user -->|"joins community"| node_social
node_social -->|"dispatches events"| node_socialvm
node_socialvm -.->|"uses realtime"| node_socket
node_socket -.->|"connects realtime"| node_server
node_user -->|"manages account"| node_profile
node_profile -->|"dispatches events"| node_accountvm
node_user -->|"checks updates"| node_operations
node_operations -->|"dispatches events"| node_operationvm
node_operationvm -.->|"requests updates"| node_server
node_coilcompose -->|"creates requests"| node_coilrequest
node_coilrequest -.->|"executes request"| node_coilengine
node_coilengine -->|"reads and writes"| node_coilcache
node_coilengine -.->|"fetches image"| node_server

click node_entry "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/activities/SplashActivity.kt"
click node_home "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_catalog "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_comicdetail "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/compose/screens/ComicDetailScreen.kt"
click node_reader "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/activities/ComicViewerActivity.kt"
click node_downloads "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/services/DownloadService.java"
click node_comicvm "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels"
click node_auth "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_accountvm "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels"
click node_social "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_socialvm "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels"
click node_socket "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/socket.io-client-java/src/main/java/io/socket/client/Manager.java"
click node_profile "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_operations "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens"
click node_operationvm "https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels"
click node_coilrequest "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/request/ImageRequest.kt"
click node_coilengine "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt"
click node_coilcache "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/memory/MemoryCacheService.kt"
click node_coilcompose "https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-compose-base/src/main/java/coil/compose/AsyncImagePainter.kt"

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_entry,node_auth,node_user toneBlue
class node_home,node_catalog,node_comicdetail,node_reader,node_downloads,node_comicvm toneAmber
class node_accountvm,node_social,node_socialvm,node_socket,node_profile toneMint
class node_operations,node_operationvm toneRose
class node_coilrequest,node_coilengine,node_coilcache,node_coilcompose,node_server toneIndigo
```

## Components

### App navigation

- [App entry](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/activities/SplashActivity.kt): `app/src/main/java/com/picacomic/fregata/activities/SplashActivity.kt`
- [Login and register](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`

### Comic experience

- [Home and browse](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`
- [Comic catalog](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`
- [Comic details](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/compose/screens/ComicDetailScreen.kt): `app/src/main/java/com/picacomic/fregata/compose/screens/ComicDetailScreen.kt`
- [Comic reader](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/activities/ComicViewerActivity.kt): `app/src/main/java/com/picacomic/fregata/activities/ComicViewerActivity.kt`
- [Offline downloads](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/app/src/main/java/com/picacomic/fregata/services/DownloadService.java): `app/src/main/java/com/picacomic/fregata/services/DownloadService.java`
- [Comic ViewModels](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels): `app/src/main/java/com/picacomic/fregata/compose/viewmodels`

### Community and account

- [Account ViewModels](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels): `app/src/main/java/com/picacomic/fregata/compose/viewmodels`
- [Community features](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`
- [Community ViewModels](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels): `app/src/main/java/com/picacomic/fregata/compose/viewmodels`
- [Socket.IO client](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/socket.io-client-java/src/main/java/io/socket/client/Manager.java): `socket.io-client-java/src/main/java/io/socket/client/Manager.java`
- [Profile and settings](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`

### App operations

- [Announcements and apps](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/screens): `app/src/main/java/com/picacomic/fregata/compose/screens`
- [Operations ViewModels](https://github.com/qiunanrima/picacg_modfiy/tree/MD3/app/src/main/java/com/picacomic/fregata/compose/viewmodels): `app/src/main/java/com/picacomic/fregata/compose/viewmodels`

### Image loading

- [Image requests](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/request/ImageRequest.kt): `coil/coil-base/src/main/java/coil/request/ImageRequest.kt`
- [Image pipeline](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt): `coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt`
- [Memory cache](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-base/src/main/java/coil/memory/MemoryCacheService.kt): `coil/coil-base/src/main/java/coil/memory/MemoryCacheService.kt`
- [Compose image UI](https://github.com/qiunanrima/picacg_modfiy/blob/MD3/coil/coil-compose-base/src/main/java/coil/compose/AsyncImagePainter.kt): `coil/coil-compose-base/src/main/java/coil/compose/AsyncImagePainter.kt`

### Other components

- **App user**
- **Pica services**

## Connections

- App user → App entry: opens app
- App entry → Home and browse: starts browsing
- App user → Comic catalog: browses
- Comic catalog → Comic ViewModels: dispatches events
- Comic ViewModels → Pica services: requests catalog
- App user → Comic details: opens comic
- Comic details → Comic ViewModels: dispatches events
- Comic ViewModels → Pica services: requests details
- App user → Comic reader: reads pages
- App user → Offline downloads: downloads chapters
- Offline downloads → Pica services: fetches pages
- App user → Login and register: signs in
- Login and register → Account ViewModels: dispatches events
- Account ViewModels → Pica services: authenticates
- App user → Community features: joins community
- Community features → Community ViewModels: dispatches events
- Community ViewModels → Socket.IO client: uses realtime
- Socket.IO client → Pica services: connects realtime
- App user → Profile and settings: manages account
- Profile and settings → Account ViewModels: dispatches events
- App user → Announcements and apps: checks updates
- Announcements and apps → Operations ViewModels: dispatches events
- Operations ViewModels → Pica services: requests updates
- Compose image UI → Image requests: creates requests (evidence: `coil/coil-compose-base/src/main/java/coil/compose/AsyncImagePainter.kt`)
- Image requests → Image pipeline: executes request (evidence: `coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt`)
- Image pipeline → Memory cache: reads and writes (evidence: `coil/coil-base/src/main/java/coil/intercept/EngineInterceptor.kt`)
- Image pipeline → Pica services: fetches image
