How lamduychuclinh19/do_an_dich_thuat works
This repository implements a multilingual audio-guide system: an admin web app manages points of interest (POIs) and translations, while a FastAPI backend exposes admin and public APIs and serves audio. The main workflow is admin authentication, POI and narration management, audio generation and persistence, then public guide retrieval. Admin staff management is also present in the service layer. Edges reflect the shown route registrations, service calls, and documented imports; frontend-to-backend request details and unsampled implementations are not inferred.
Main entry points: main.py FastAPI application · translation_service.py Translation service · App.jsx Web app routes · guide_service.py Guide service
Components 25
Admin web
- Web app routes
admin-web/src/App.jsx - Login page
admin-web/src/pages/LoginPage.jsx - Dashboard
admin-web/src/pages/DashboardPage.jsx - POI management
admin-web/src/pages/PoiPage.jsx - Translation management
admin-web/src/pages/TranslationPage.jsx - API client
admin-web/src/services/api.js
API and access
- FastAPI application
app/main.py - Authentication routes
app/routers/auth_router.py - Authentication service
app/services/auth_service.py - Admin authorization
app/dependencies/auth_dependency.py - POI routes
app/routers/admin_poi_router.py - Public POI routes
app/routers/public_poi_router.py - Translation routes
app/routers/admin_translation_router.py - Public translation routes
app/routers/public_translation_router.py - Guide routes
app/routers/guide_router.py
Guide domain
- POI service
app/services/poi_service.py - Translation service
app/services/translation_service.py - Guide service
app/services/guide_service.py - Staff management
app/services/admin_management_service.py
Persistence and audio
- POI repository
app/repositaries/poi_repository.py - Translation repository
app/repositaries/translation_repository.py - Admin repository
app/repositaries/admin_repository.py - SQL Server database
app/database.py - Audio service
app/services/audio_service.py
Other components
- Administrator
Connections 36
- Administrator → Web app routes: uses
- Web app routes → Login page: routes to
admin-web/src/App.jsx - Web app routes → Dashboard: routes to
admin-web/src/App.jsx - Web app routes → POI management: routes to
admin-web/src/App.jsx - Web app routes → Translation management: routes to
admin-web/src/App.jsx - FastAPI application → Authentication routes: registers
app/main.py - FastAPI application → POI routes: registers
app/main.py - FastAPI application → Public POI routes: registers
app/main.py - FastAPI application → Translation routes: registers
app/main.py - FastAPI application → Public translation routes: registers
app/main.py - FastAPI application → Guide routes: registers
app/main.py - Authentication routes → Authentication service: calls
app/routers/auth_router.py - POI routes → Admin authorization: requires
app/routers/admin_poi_router.py - Translation routes → Admin authorization: requires
app/routers/admin_translation_router.py - Translation routes → Translation service: calls
app/routers/admin_translation_router.py - Public translation routes → Translation service: calls
app/routers/public_translation_router.py - Public POI routes → POI service: calls
app/routers/public_poi_router.py - Guide routes → Guide service: calls
app/routers/guide_router.py - Admin authorization → Authentication service: verifies token
app/dependencies/auth_dependency.py - Authentication service → Admin repository: reads and updates
app/services/auth_service.py - POI service → POI repository: queries
app/services/poi_service.py - Translation service → POI repository: checks POIs
app/services/translation_service.py - Translation service → Translation repository: reads and writes
app/services/translation_service.py - Translation service → Audio service: generates audio
app/services/translation_service.py - Guide service → POI service: uses
app/services/guide_service.py - Guide service → Translation service: uses
app/services/guide_service.py - Guide service → Translation repository: queries guides
app/services/guide_service.py - Staff management → Admin repository: uses
app/services/admin_management_service.py - POI repository → SQL Server database: queries
app/repositaries/poi_repository.py - Translation repository → SQL Server database: queries
app/repositaries/translation_repository.py - Admin repository → SQL Server database: queries
app/repositaries/admin_repository.py - FastAPI application → Audio service: mounts audio
app/main.py - Login page → API client: uses
admin-web/src/pages/LoginPage.jsx - Dashboard → API client: uses
admin-web/src/pages/DashboardPage.jsx - POI management → API client: uses
admin-web/src/pages/PoiPage.jsx - Translation management → API client: uses
admin-web/src/pages/TranslationPage.jsx