How nornarath001-ui/smartdocs works
SmartDocs combines a public document portal with an authenticated document-management dashboard, plus translation and file-conversion tools. Users browse and filter published documents, inspect summaries, and preview or download files; staff sign in to manage documents and categories, while administrators also manage users and review activity. Translation and conversion are separate workflows. The graph follows documented routes and sampled calls; some page-to-API connections and the translator deployment wiring are not fully evidenced in the excerpts.
Main entry points: api.php API routing · App.jsx Page routing · axios.js API client · ActivityController.php Activity and analytics
Components 24
Web application
- Page routing
frontend/src/App.jsx - Document portal
frontend/src/pages/Portal.jsx - Document management
frontend/src/pages/Documents.jsx - Dashboard and activity
frontend/src/pages/Dashboard.jsx - Translation pages
frontend/src/pages/PublicTranslate.jsx - Conversion page
frontend/src/pages/Convert.jsx - Authentication state
frontend/src/context/AuthContext.jsx - API client
frontend/src/api/axios.js
Backend API
- API routing
backend/routes/api.php - Authentication
backend/app/Http/Controllers/Api/AuthController.php - Document operations
backend/app/Http/Controllers/Api/DocumentController.php - Public catalog and summaries
backend/app/Http/Controllers/Api/PublicDocumentController.php - Activity and analytics
backend/app/Http/Controllers/Api/ActivityController.php - Category management
backend/app/Http/Controllers/Api/CategoryController.php - User management
backend/app/Http/Controllers/Api/UserController.php - Translation endpoints
backend/app/Http/Controllers/Api/PublicTranslateController.php - Conversion endpoints
backend/app/Http/Controllers/Api/ConvertController.php
Processing services
- Translator service
docker/translator/app.py - AI service
ai-service/main.py
Domain data
- Documents
backend/app/Models/Document.php - Users and roles
backend/app/Models/User.php - Categories
backend/app/Models/Category.php - Activities
backend/app/Models/Activity.php
Other components
- Visitor or staff
Connections 33
- Visitor or staff → Page routing: uses
frontend/src/App.jsx - Page routing → Document portal: routes to
frontend/src/App.jsx - Page routing → Document management: routes to
frontend/src/App.jsx - Page routing → Dashboard and activity: routes to
frontend/src/App.jsx - Page routing → Translation pages: routes to
frontend/src/App.jsx - Page routing → Conversion page: routes to
frontend/src/App.jsx - Page routing → Authentication state: checks access
frontend/src/App.jsx - Authentication state → API client: calls
frontend/src/context/AuthContext.jsx - Document portal → API client: requests data
frontend/src/pages/Portal.jsx - Document management → API client: requests data
- Dashboard and activity → API client: requests data
- Translation pages → API client: requests translation
- Conversion page → API client: requests conversion
- API client → API routing: sends requests
- API routing → Authentication: routes to
backend/routes/api.php - API routing → Document operations: routes to
backend/routes/api.php - API routing → Public catalog and summaries: routes to
backend/routes/api.php - API routing → Activity and analytics: routes to
backend/routes/api.php - API routing → Category management: routes to
backend/routes/api.php - API routing → User management: routes to
backend/routes/api.php - API routing → Translation endpoints: routes to
backend/routes/api.php - API routing → Conversion endpoints: routes to
backend/routes/api.php - Document operations → Documents: queries and updates
backend/app/Http/Controllers/Api/DocumentController.php - Public catalog and summaries → Documents: queries published
backend/app/Http/Controllers/Api/PublicDocumentController.php - Public catalog and summaries → Categories: queries filters
backend/app/Http/Controllers/Api/PublicDocumentController.php - Activity and analytics → Activities: queries activity
backend/app/Http/Controllers/Api/ActivityController.php - Activity and analytics → Documents: queries documents
backend/app/Http/Controllers/Api/ActivityController.php - Activity and analytics → Users and roles: queries users
backend/app/Http/Controllers/Api/ActivityController.php - Category management → Categories: manages categories
backend/app/Http/Controllers/Api/CategoryController.php - Category management → Documents: checks usage
backend/app/Http/Controllers/Api/CategoryController.php - User management → Users and roles: manages users
backend/app/Http/Controllers/Api/UserController.php - Authentication → Users and roles: authenticates
backend/app/Http/Controllers/Api/AuthController.php - Translation endpoints → Translator service: posts translation