fix: Add type annotations to fix pyright type errors in app/model/

[purplesmoke05]

📌 Description

This pull request introduces several improvements and refactorings across the codebase, focusing on code style, timezone handling, type annotations, and code deduplication. The most significant changes include centralizing timezone conversion utilities, improving type safety and clarity in schema definitions, and cleaning up unused or redundant code.

These changes collectively improve maintainability, consistency, and type safety throughout the project.

✅ Related Issues

• Close [Pyright] Fix type errors in app/model/ #1723

🔄 Changes

Timezone Handling and Utilities:

• Centralized timezone conversion logic (replace_to_local_tz and format_timestamp) in Base class of app/model/db/base.py, replacing similar duplicated methods in multiple models. This reduces code duplication and ensures consistency in timestamp handling. [1] [2] [3] [4] [5] [6] [7]
• Removed unused or redundant timezone imports and logic from several files, relying on the centralized implementation. [1] [2] [3]

Type Annotations and Pydantic Schema Improvements:

• Improved type annotations in various Pydantic models for better type safety, including use of dict[str, Any], list[object], and explicit return types for methods and validators. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10]
• Updated Pydantic model usage to leverage new features, such as ConfigDict and Field(default_factory=...), and refined model inheritance for generics. [1] [2] [3]

General Code Quality and Maintenance:

• Added # pyright: reportUnusedImport=false to several __init__.py files to suppress unused import warnings, improving code linting experience. [1] [2] [3] [4] [5]
• Fixed variable naming and usage in mail sending logic to avoid confusion and potential bugs.

Other Notable Changes:

• Renamed enum values from value to value_ in ListAllLockedSortItem and LockEventSortItem to avoid potential conflicts with reserved keywords. [1] [2]

📌 Checklist

• I have added tests where necessary.
• I have updated the documentation where necessary.

[github-actions]

Coverage Report •

File	Stmts	Miss	Cover	Missing
app/model/blockchain
__init__.py	1	0	100%
token.py	726	25	96%	90, 146, 149, 152, 275–276, 449–450, 472, 522–523, 530–531, 562–563, 701–702, 841–842, 887–888, 969–970, 1084–1085
app/model/db
__init__.py	20	0	100%
base.py	28	4	85%	48, 51, 66–67
idx_lock_unlock.py	49	2	95%	85, 139
idx_token.py	91	2	97%	134, 191
idx_transfer.py	37	0	100%
idx_transfer_approval.py	38	1	97%	74
listing.py	26	2	92%	52, 61
public_info.py	27	0	100%
app/model/mail
__init__.py	1	0	100%
mail.py	80	13	83%	67, 73, 80–81, 94, 114–115, 121, 133–134, 154, 156, 159
app/model/schema
__init__.py	21	0	100%
bc_explorer.py	70	0	100%
dex_order_list.py	42	0	100%
eth.py	51	0	100%
messaging.py	41	0	100%
notification.py	65	0	100%
position.py	126	0	100%
public_info.py	48	0	100%
token.py	210	0	100%
token_bond.py	46	0	100%
token_coupon.py	37	0	100%
token_lock.py	30	0	100%
token_membership.py	37	0	100%
token_share.py	45	0	100%
app/model/schema/base
__init__.py	1	0	100%
base.py	176	4	97%	203, 209–211
TOTAL	46758	1578	96%

Tests	Skipped	Failures	Errors	Time
1538	0 💤	0 ❌	0 🔥	11m 55s ⏱️