How hks2002/docs-web works
Docs Web is a browser frontend for a document-library system. The main user flow is login, then browse document listings and access logs, navigate paths, and upload documents; administrators also manage cleanup and user permissions. The graph includes the documented UI, state, localization, API and WebSocket capabilities visible in the tree and excerpts. Several feature implementations are not sampled, so their internal interactions are omitted rather than inferred.
Main entry points: SessionStore.js Session state · LoginPage.vue Login · PageHeader.vue Navigation header · index.js Route guard
Components 21
App navigation
- Routes
src/router/routes.js - Route guard
src/router/index.js - Login
src/pages/LoginPage.vue - Main layout
src/layouts/MainLayout.vue - Navigation header
src/layouts/PageHeader.vue
Document library
- Library page
src/pages/IndexPage.vue - Document tables
src/components/DocsTable0.vue - Access log
src/components/AccessLog.vue - File upload
src/components/FileUpload.vue - Path and file helpers
src/utils/file.js
Administration
- Document cleanup
src/components/CleanNonExists.vue - User permissions
src/components/UserFuncMatrix.vue - Admin drawer
src/layouts/RightDrawer.vue
Client services
- Session state
src/stores/SessionStore.js - Locale state
src/stores/LocaleStore.js - Localization
src/composables/useI18n.js - HTTP client setup
src/boot/axios.js - WebSocket manager
src/ws/ws.js
Other components
- User
- Docs API
- Docs WebSocket service
Connections 29
- User → Route guard: opens routes
- Routes → Route guard: configures
src/router/index.js - Route guard → Session state: checks session
src/router/index.js - User → Login: submits credentials
src/pages/LoginPage.vue - Login → Docs API: posts login
src/pages/LoginPage.vue - Login → Session state: sets user state
src/pages/LoginPage.vue - Login → Route guard: navigates after login
src/pages/LoginPage.vue - Routes → Main layout: routes to
src/router/routes.js - Main layout → Navigation header: renders
src/layouts/MainLayout.vue - Routes → Library page: routes to
src/router/routes.js - Library page → Document tables: renders
src/pages/IndexPage.vue - Library page → Access log: renders
src/pages/IndexPage.vue - Navigation header → File upload: renders
src/layouts/PageHeader.vue - Document tables → Session state: reads state
src/components/DocsTable0.vue - Document tables → Path and file helpers: uses
src/components/DocsTable0.vue - Access log → Path and file helpers: uses
src/components/AccessLog.vue - Access log → Docs API: requests log data
- File upload → Session state: reads state
src/components/FileUpload.vue - File upload → Docs API: uploads documents
- Navigation header → Admin drawer: opens admin drawer
- Admin drawer → Document cleanup: renders
src/layouts/RightDrawer.vue - Admin drawer → User permissions: renders
src/layouts/RightDrawer.vue - User permissions → Docs API: loads and updates
src/components/UserFuncMatrix.vue - User permissions → Session state: uses
- Document cleanup → Docs WebSocket service: requests cleanup
- WebSocket manager → Docs WebSocket service: connects and exchanges events
src/ws/ws.js - WebSocket manager → Localization: translates notifications
src/ws/ws.js - Navigation header → Locale state: uses locale controls
- Locale state → Localization: selects language