How minhhjj5678/do-an-quan-ly-ktx works
Quản Lý Ký Túc Xá is a desktop dormitory-management application. The principal workflow is user interaction through Tkinter screens, routed via the UI adapter and business protocols to domain coordination, which validates and changes dormitory records and persists them as JSON. Major capabilities include authentication, catalog management, contract and invoice payments, violations, reporting, settings, and geographic address selection. The README documents the layer boundaries and capabilities; source excerpts confirm startup loading, coordinator behavior, entities, and JSON safety. Many screen-to-operation and coordinator-to-store calls were not sampled, so those links are omitted or marked unverified.
Main entry points: app.py Management screens · thuc_the_goc.py Entity foundations · kiem_cheo_du_lieu.py Cross-entity validation · dieu_phoi.py Business coordinator
Components 23
Desktop interface
- Application startup
main.py - Management screens
giao_dien/app.py - Catalog forms
giao_dien/danh_muc - Login and account UI
giao_dien/xac_thuc - Statistics UI
giao_dien/thong_ke/thong_ke.py - UI adapter
giao_dien/dung_chung/adapter.py
Business services
- Business protocols
giao_thuc/nghiep_vu.py - Account sessions
nghiep_vu/phien_lam_viec.py - Business coordinator
nghiep_vu/dieu_phoi.py - Cross-entity validation
nghiep_vu/kiem_cheo_du_lieu.py
Domain model
- Resident and room entities
thuc_the/ky_tuc_xa.py - Contracts and invoices
thuc_the/tai_chinh.py - Account entities
thuc_the/tai_khoan.py - Violation entities
thuc_the/vi_pham.py - Geographic entities
thuc_the/dia_ly.py - Entity foundations
thuc_the/thuc_the_goc.py
Persistence and utilities
- Safe JSON storage
luu_tru/luu_tru_json.py - Entity stores
luu_tru - Runtime configuration
tien_ich/cau_hinh_dong.py - Input validation
tien_ich/regex.py - Password hashing
tien_ich/bam_mat_khau.py - Data file paths
tien_ich/tap_tin.py
Other components
- Staff or resident
Connections 31
- Staff or resident → Management screens: uses
README.md - Application startup → Management screens: starts
main.py - Application startup → Business coordinator: creates
main.py - Application startup → Account sessions: creates
main.py - Application startup → Entity stores: registers
main.py - Management screens → UI adapter: uses
giao_dien/app.py - Management screens → Catalog forms: opens
giao_dien/app.py - Management screens → Login and account UI: opens
giao_dien/app.py - Management screens → Statistics UI: opens
giao_dien/app.py - UI adapter → Business protocols: adapts
giao_dien/dung_chung/adapter.py - Business protocols → Business coordinator: implemented by
README.md - Business protocols → Account sessions: session contract
README.md - Business coordinator → Cross-entity validation: validates
nghiep_vu/dieu_phoi.py - Business coordinator → Entity stores: reads and writes
README.md - Business coordinator → Runtime configuration: loads settings
nghiep_vu/dieu_phoi.py - Account sessions → Account entities: authenticates
nghiep_vu/phien_lam_viec.py - Account sessions → Password hashing: checks passwords
nghiep_vu/phien_lam_viec.py - Entity stores → Safe JSON storage: specializes
luu_tru/luu_tru_json.py - Safe JSON storage → Data file paths: resolves paths
luu_tru/luu_tru_json.py - Entity stores → Entity foundations: serializes
luu_tru/luu_tru_json.py - Resident and room entities → Entity foundations: inherits
thuc_the/ky_tuc_xa.py - Contracts and invoices → Entity foundations: inherits
thuc_the/tai_chinh.py - Account entities → Entity foundations: inherits
thuc_the/tai_khoan.py - Violation entities → Entity foundations: inherits
thuc_the/vi_pham.py - Cross-entity validation → Resident and room entities: checks relations
nghiep_vu/kiem_cheo_du_lieu.py - Cross-entity validation → Contracts and invoices: checks relations
nghiep_vu/kiem_cheo_du_lieu.py - Cross-entity validation → Account entities: checks relations
nghiep_vu/kiem_cheo_du_lieu.py - Cross-entity validation → Violation entities: checks relations
nghiep_vu/kiem_cheo_du_lieu.py - Entity foundations → Input validation: uses
thuc_the/thuc_the_goc.py - Account entities → Password hashing: verifies
thuc_the/tai_khoan.py - Management screens → Entity stores: loads startup data