Add comments and type hints to Python code

The python code current has nearly zero comments, which makes it difficult for people to figure out what the code is actually doing. Having comments would make it easier for people who are less familar with python and this specific codebase to contribute. Type hints would also be a useful addition for similar reasons.

Issue không nêu tên tệp, kiểm thử hay điểm vào nào. Hãy bắt đầu bằng cách kiểm kê mã Python và xác định những module nào nằm trong phạm vi, sau đó thêm comment và type hint một cách nhất quán; công việc được xem là hoàn tất khi phạm vi đã thống nhất được ghi lại và mã đã cập nhật vẫn hoạt động.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.