docs: add publish workflow flowchart to README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
LiHaohua
2026-05-12 14:20:57 +08:00
co-authored by Claude Opus 4.6
parent 4c1f3d4170
commit f6827835c0
+52
View File
@@ -161,6 +161,58 @@ cargo run -p czdev --release -- deploy \
./target/release/czdev unpublish my_app --version 1.0.1
```
#### Publish Workflow
```
┌──────────────────────────────────────────────────────────────────────────────┐
│ czdev publish — End-to-End Flow │
└──────────────────────────────────────────────────────────────────────────────┘
┌─────────┐ ┌─────────┐ ┌──────────┐ ┌─────────────┐
│ LOGIN │────────▶│ BUILD │────────▶│ PUBLISH │────────▶│ REVIEW │
└─────────┘ └─────────┘ └──────────┘ └─────────────┘
│ │ │ │
▼ ▼ ▼ ▼
czdev login czdev build czdev publish Admin merges
(GitHub OAuth or CI workflow --deb xxx.deb the PR
Device Flow) ─▶ .deb artifact ┌────────────┐ │
│ │ Preflight: │ ▼
▼ │ • .desktop │ ┌───────────┐
Token saved │ • email ✓ │ │ RELEASE │
~/.config/ │ • version ✓│ └───────────┘
czdev/token │ • size ✓ │ │
└─────┬──────┘ ▼
│ APT repo updated
▼ App live in Store
Fork + Push
─▶ PR created
on packages
─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─
Timeline:
You (Developer) czdev GitHub (Remote)
─────────────── ───── ───────────────
│ │ │
│── czdev login ─────────────▶│── OAuth Device Flow ──────▶│
│ │◀── access token ───────────│
│ │ │
│── czdev publish ───────────▶│ │
│ │── validate .deb ──────────▶│ (check ver)
│ │── fork packages repo ─────▶│
│ │── git push (LFS) ─────────▶│
│ │── POST /pulls ────────────▶│
│◀── PR URL ─────────────────│ │
│ │ │
│ │ Admin reviews & merges
│ │ │
│ │ CI rebuilds APT index
│ │ │
│◀───────────────────── App available in AppStore ─────────│
│ │
```
## Install czdev
**Option A — Build from source (recommended):**