Professional Python Project Foundations

Initialize an installable Python project with a src layout, an isolated environment, and pyproject.toml.

Separate runtime and development dependencies and produce a reproducible dependency lock file.

Apply precise type annotations to functions, collections, and optional values in incident-domain code.

Use Enum types to represent constrained incident attributes such as severity and status.

Use dataclasses to model internal domain values independently of API and database models.

Organize Python packages and imports to avoid circular dependencies and executable import side effects.