How jayq23/librarymanagement works
Viva La Vida is a desktop library-management application. A librarian signs in, then uses the dashboard to manage the catalog, members, borrowing and returns, reservations, fines, and reports; a chatbot offers a parallel natural-language interface to selected library operations. Business managers execute the domain rules and query the database service. The graph includes major README-style product areas indicated by the source tree and module references; relationships for unsampled views are based on the SOURCE INDEX, not inspected implementations.
Main entry points: dashboard.py Dashboard · tools.py Library action tools · borrow_return_view.py Borrow and return · book_manager.py Book catalog
Components 28
Desktop interface
- Application entry
main.py - Sign-in
gui/login_window.py - Dashboard
gui/dashboard.py - Catalog view
gui/book_catalog_view.py - Borrow and return
gui/borrow_return_view.py - Category view
gui/category_view.py - Member view
gui/member_view.py - Reservation view
gui/reservation_view.py - Reports view
gui/reports_view.py - Chat window
gui/chatbot_window.py
Library operations
- Authentication
managers/auth_manager.py - Book catalog
managers/book_manager.py - Categories
managers/category_manager.py - Membership
managers/member_manager.py - Circulation and reservations
managers/transaction_manager.py - Fines
managers/fine_manager.py - Reporting
managers/report_manager.py
AI assistant
- Chatbot interface
ai_agent/chatbot.py - AI agent
ai_agent/agent.py - Library action tools
ai_agent/tools.py - Receipt queue
ai_agent/receipts.py - Application config
config.py
Data and presentation
- Database service
database/db_manager.py - PostgreSQL database
- Invoice model
models/invoice.py - Receipt modal
utils/receipt_modal.py - Receipt helpers
utils/receipt_helpers.py
Other components
- Librarian
Connections 48
- Librarian → Application entry: starts
main.py - Application entry → Sign-in: opens
main.py - Sign-in → Authentication: authenticates
gui/login_window.py - Sign-in → Dashboard: opens
gui/login_window.py - Dashboard → Catalog view: shows
gui/dashboard.py - Dashboard → Borrow and return: shows
gui/dashboard.py - Dashboard → Category view: shows
gui/dashboard.py - Dashboard → Member view: shows
gui/dashboard.py - Dashboard → Reservation view: shows
gui/dashboard.py - Dashboard → Reports view: shows
gui/dashboard.py - Dashboard → Chat window: opens
gui/dashboard.py - Dashboard → Reporting: loads metrics
gui/dashboard.py - Catalog view → Book catalog: manages
gui/book_catalog_view.py - Catalog view → Categories: uses
gui/book_catalog_view.py - Borrow and return → Book catalog: uses
gui/borrow_return_view.py - Borrow and return → Membership: uses
gui/borrow_return_view.py - Borrow and return → Circulation and reservations: processes loans
gui/borrow_return_view.py - Borrow and return → Invoice model: uses
gui/borrow_return_view.py - Borrow and return → Receipt modal: opens
gui/borrow_return_view.py - Category view → Categories: manages
gui/category_view.py - Member view → Membership: manages
gui/member_view.py - Reservation view → Book catalog: uses
gui/reservation_view.py - Reservation view → Membership: uses
gui/reservation_view.py - Reservation view → Circulation and reservations: manages reservations
gui/reservation_view.py - Reservation view → Receipt helpers: uses
gui/reservation_view.py - Reports view → Reporting: requests reports
gui/reports_view.py - Reports view → Fines: reads fines
gui/reports_view.py - Chat window → Chatbot interface: sends messages
gui/chatbot_window.py - Chatbot interface → AI agent: delegates
ai_agent/chatbot.py - Chatbot interface → Receipt queue: uses
ai_agent/chatbot.py - AI agent → Library action tools: dispatches tools
ai_agent/agent.py - AI agent → Application config: reads settings
ai_agent/agent.py - Library action tools → Book catalog: queries catalog
ai_agent/tools.py - Library action tools → Categories: queries categories
ai_agent/tools.py - Library action tools → Membership: queries members
ai_agent/tools.py - Library action tools → Reporting: requests reports
ai_agent/tools.py - Library action tools → Circulation and reservations: processes circulation
ai_agent/tools.py - Library action tools → Receipt queue: queues receipts
ai_agent/tools.py - Receipt helpers → Book catalog: uses
utils/receipt_helpers.py - Receipt helpers → Invoice model: formats
utils/receipt_helpers.py - Receipt helpers → Receipt modal: opens
utils/receipt_helpers.py - Receipt modal → Invoice model: displays
utils/receipt_modal.py - Receipt modal → Fines: uses
utils/receipt_modal.py - Authentication → Database service: queries users
managers/auth_manager.py - Book catalog → Database service: queries catalog
managers/book_manager.py - Categories → Database service: queries categories
managers/category_manager.py - Membership → Database service: queries members
managers/member_manager.py - Circulation and reservations → Database service: reads and writes
managers/transaction_manager.py