How rockyflux/wanzhi works
Wanzi is a dynamic bookmark-directory web app: visitors browse themed packs, navigate category trees, search and export links; signed-in users can favorite links and track visits; administrators manage packs, categories, sites, imports, users and statistics. The Vue router selects views, while Pinia stores and shared libraries provide authentication and catalog behavior backed by Supabase. The README documents these capabilities and Supabase’s role; several view and store excerpts are partial, so unshown internal calls are not inferred.
Main entry points: catalog.ts Catalog and activity · index.ts Route selection · AdminLayout.vue Admin workspace · auth.ts Authentication state
Components 28
Bookmark browsing
- Home and pack pages
src/views/HomeView.vue - Pack browsing
src/views/PackView.vue - Site details
src/views/SiteDetailView.vue
Accounts and activity
- Favorites
src/views/FavoritesView.vue - Visit history
src/views/VisitsView.vue - Sign in
src/views/LoginView.vue - Registration
src/views/RegisterView.vue - Authentication state
src/stores/auth.ts
Administration
- Admin workspace
src/views/admin/AdminLayout.vue - Pack management
src/views/admin/AdminPacks.vue - Category management
src/views/admin/AdminCategories.vue - Site management
src/views/admin/AdminSites.vue - Bookmark import
src/views/admin/AdminImport.vue - User management
src/views/admin/AdminUsers.vue - Statistics
src/views/admin/AdminStats.vue - Usage reporting
src/views/admin/AdminUsage.vue
Shared application core
- Route selection
src/router/index.ts - Catalog and activity
src/stores/catalog.ts - Category tree utilities
src/lib/tree.ts - Data mapping
src/lib/mappers.ts - Category cache
src/lib/categoryCache.ts - HTML and Markdown export
src/lib/exportPack.ts - Pack icon helpers
src/lib/packIcons.ts - Supabase client
src/lib/supabase.ts
Other components
- Visitor
- Signed-in user
- Administrator
- Supabase services and data
Connections 47
- Visitor → Route selection: opens pages
src/router/index.ts - Signed-in user → Route selection: opens pages
src/router/index.ts - Administrator → Route selection: opens admin
src/router/index.ts - Route selection → Home and pack pages: routes to
src/router/index.ts - Route selection → Site details: routes to
src/router/index.ts - Route selection → Sign in: routes to
src/router/index.ts - Route selection → Registration: routes to
src/router/index.ts - Route selection → Favorites: routes to
src/router/index.ts - Route selection → Visit history: routes to
src/router/index.ts - Route selection → Admin workspace: routes to
src/router/index.ts - Route selection → Authentication state: checks access
src/router/index.ts - Home and pack pages → Pack browsing: renders pack
src/views/HomeView.vue - Home and pack pages → Catalog and activity: loads catalog
src/views/HomeView.vue - Pack browsing → Catalog and activity: loads and updates
src/views/PackView.vue - Pack browsing → Category tree utilities: uses category paths
src/views/PackView.vue - Pack browsing → HTML and Markdown export: exports links
src/views/PackView.vue - Site details → Catalog and activity: records activity
src/views/SiteDetailView.vue - Site details → Authentication state: checks identity
src/views/SiteDetailView.vue - Favorites → Catalog and activity: loads favorites
src/views/FavoritesView.vue - Favorites → HTML and Markdown export: exports links
src/views/FavoritesView.vue - Visit history → Catalog and activity: loads visits
src/views/VisitsView.vue - Visit history → HTML and Markdown export: exports links
src/views/VisitsView.vue - Sign in → Authentication state: authenticates
src/views/LoginView.vue - Registration → Authentication state: registers account
src/views/RegisterView.vue - Admin workspace → Pack management: hosts admin pages
src/router/index.ts - Admin workspace → Category management: hosts admin pages
src/router/index.ts - Admin workspace → Site management: hosts admin pages
src/router/index.ts - Admin workspace → Bookmark import: hosts admin pages
src/router/index.ts - Admin workspace → User management: hosts admin pages
src/router/index.ts - Admin workspace → Statistics: hosts admin pages
src/router/index.ts - Admin workspace → Usage reporting: hosts admin pages
src/router/index.ts - Pack management → Catalog and activity: manages packs
src/views/admin/AdminPacks.vue - Category management → Catalog and activity: manages categories
src/views/admin/AdminCategories.vue - Site management → Catalog and activity: manages sites
src/views/admin/AdminSites.vue - Bookmark import → Catalog and activity: imports catalog data
src/views/admin/AdminImport.vue - User management → Authentication state: manages users
src/views/admin/AdminUsers.vue - Statistics → Catalog and activity: reads statistics
src/views/admin/AdminStats.vue - Usage reporting → Supabase client: queries usage
src/views/admin/AdminUsage.vue - Catalog and activity → Data mapping: maps records
src/stores/catalog.ts - Catalog and activity → Category cache: reads and writes
src/stores/catalog.ts - Catalog and activity → Category tree utilities: uses category lookup
src/stores/catalog.ts - Catalog and activity → Authentication state: checks user state
src/stores/catalog.ts - Catalog and activity → Supabase client: queries and updates
src/stores/catalog.ts - Authentication state → Supabase client: uses client
src/stores/auth.ts - Supabase client → Supabase services and data: connects to
README.md - Visitor → HTML and Markdown export: downloads formats
README.md - Catalog and activity → Pack icon helpers: uses icon helpers
src/stores/catalog.ts