假设有一个电商系统，税务计算规则经常因法规变化而修改。
所有与税务计算相关的类（TaxCalculator、TaxRate、TaxRule 等）
应该放在同一个组件中。这样，当税法变化时，只需要修改和发布
这个税务组件，而不影响其他组件。

违反 CRP：一个 "utils" 组件包含 StringUtils、DateUtils、FileUtils、MathUtils 等。
客户端只需要 StringUtils，但被迫依赖整个 utils 组件，包括它不需要的 DateUtils 等。

符合 CRP：将 utils 拆分为 string-utils、date-utils、file-utils、math-utils 等独立组件。
客户端只依赖它需要的组件。

// 项目结构（违反内聚原则）

my-app/
├── src/
│   ├── common/           # 违反 CRP：杂物抽屉
│   │   ├── StringUtils.java
│   │   ├── DateUtils.java
│   │   ├── FileUtils.java
│   │   ├── MathUtils.java
│   │   └── JsonUtils.java
│   │
│   ├── data/             # 违反 CCP：不同变化原因混在一起
│   │   ├── UserDAO.java       # 用户数据访问（变化原因：用户模型变化）
│   │   ├── OrderDAO.java      # 订单数据访问（变化原因：订单模型变化）
│   │   ├── ProductDAO.java    # 产品数据访问（变化原因：产品模型变化）
│   │   ├── DatabaseConfig.java # 数据库配置（变化原因：基础设施变化）
│   │   └── ConnectionPool.java # 连接池（变化原因：基础设施变化）
│   │
│   └── service/          # 违反 REP：没有明确的发布边界
│       ├── UserService.java
│       ├── OrderService.java
│       └── ProductService.java

// 重构后的项目结构

my-app/
├── components/
│   ├── string-utils/         # 符合 CRP：专注字符串处理
│   │   ├── src/
│   │   │   ├── StringUtils.java
│   │   │   └── StringValidator.java
│   │   ├── pom.xml           # 独立版本：1.0.0
│   │   └── CHANGELOG.md
│   │
│   ├── date-utils/           # 符合 CRP：专注日期处理
│   │   ├── src/
│   │   │   ├── DateUtils.java
│   │   │   └── DateFormatter.java
│   │   ├── pom.xml           # 独立版本：1.0.0
│   │   └── CHANGELOG.md
│   │
│   ├── user-domain/          # 符合 CCP：用户相关变化集中
│   │   ├── src/
│   │   │   ├── User.java
│   │   │   ├── UserRepository.java
│   │   │   ├── UserService.java
│   │   │   └── UserValidator.java
│   │   ├── pom.xml           # 独立版本：2.1.0
│   │   └── CHANGELOG.md
│   │
│   ├── order-domain/         # 符合 CCP：订单相关变化集中
│   │   ├── src/
│   │   │   ├── Order.java
│   │   │   ├── OrderItem.java
│   │   │   ├── OrderRepository.java
│   │   │   ├── OrderService.java
│   │   │   └── OrderCalculator.java
│   │   ├── pom.xml           # 独立版本：1.5.0
│   │   └── CHANGELOG.md
│   │
│   ├── database-infra/       # 符合 CCP：基础设施变化集中
│   │   ├── src/
│   │   │   ├── DatabaseConfig.java
│   │   │   ├── ConnectionPool.java
│   │   │   └── MigrationRunner.java
│   │   ├── pom.xml           # 独立版本：1.0.0
│   │   └── CHANGELOG.md
│   │
│   └── my-app/               # 主应用，依赖上述组件
│       ├── src/
│       │   └── Application.java
│       └── pom.xml
│           # 依赖声明：
│           # - string-utils: ^1.0.0
│           # - user-domain: ^2.0.0
│           # - order-domain: ^1.5.0
│           # - database-infra: ^1.0.0

"""
展示如何在 Python 项目中应用组件内聚原则

Python 中，组件通常对应于 Distribution（pip installable package）
"""

# === 项目结构 ===

"""
ecommerce/
├── pyproject.toml          # 主项目配置
├── packages/
│   ├── ecommerce-string-utils/
│   │   ├── pyproject.toml  # name = "ecommerce-string-utils", version = "1.0.0"
│   │   └── src/
│   │       └── ecommerce_string_utils/
│   │           ├── __init__.py
│   │           ├── strings.py
│   │           └── validators.py
│   │
│   ├── ecommerce-date-utils/
│   │   ├── pyproject.toml  # name = "ecommerce-date-utils", version = "1.0.0"
│   │   └── src/
│   │       └── ecommerce_date_utils/
│   │           ├── __init__.py
│   │           ├── dates.py
│   │           └── formatters.py
│   │
│   ├── user-domain/
│   │   ├── pyproject.toml  # name = "user-domain", version = "2.1.0"
│   │   └── src/
│   │       └── user_domain/
│   │           ├── __init__.py
│   │           ├── models.py
│   │           ├── repository.py
│   │           ├── service.py
│   │           └── validators.py
│   │
│   └── order-domain/
│       ├── pyproject.toml  # name = "order-domain", version = "1.5.0"
│       └── src/
│           └── order_domain/
│               ├── __init__.py
│               ├── models.py
│               ├── items.py
│               ├── repository.py
│               ├── service.py
│               └── calculator.py
"""

# === string-utils 组件 ===

# packages/ecommerce-string-utils/src/ecommerce_string_utils/strings.py
def capitalize_words(text: str) -> str:
    """将每个单词首字母大写"""
    return ' '.join(word.capitalize() for word in text.split())


def truncate(text: str, max_length: int, suffix: str = '...') -> str:
    """截断文本到指定长度"""
    if len(text) <= max_length:
        return text
    return text[:max_length - len(suffix)] + suffix


# packages/ecommerce-string-utils/src/ecommerce_string_utils/validators.py
def is_valid_email(email: str) -> bool:
    """简单的邮箱验证"""
    return '@' in email and '.' in email.split('@')[1]


def is_valid_phone(phone: str) -> bool:
    """简单的手机号验证"""
    digits = ''.join(c for c in phone if c.isdigit())
    return len(digits) >= 10


# === user-domain 组件 ===

# packages/user-domain/src/user_domain/models.py
from dataclasses import dataclass
from datetime import datetime


@dataclass
class User:
    id: int
    username: str
    email: str
    created_at: datetime
    
    def validate(self) -> list[str]:
        """验证用户数据"""
        errors = []
        if not self.username or len(self.username) < 3:
            errors.append("Username must be at least 3 characters")
        if not self.email or '@' not in self.email:
            errors.append("Invalid email")
        return errors


# packages/user-domain/src/user_domain/repository.py
from typing import Optional
from .models import User


class UserRepository:
    """用户数据仓库接口"""
    
    def find_by_id(self, user_id: int) -> Optional[User]:
        raise NotImplementedError
    
    def find_by_username(self, username: str) -> Optional[User]:
        raise NotImplementedError
    
    def save(self, user: User) -> User:
        raise NotImplementedError


# packages/user-domain/src/user_domain/service.py
from .models import User
from .repository import UserRepository


class UserService:
    def __init__(self, repository: UserRepository):
        self.repository = repository
    
    def register_user(self, username: str, email: str) -> User:
        # 业务逻辑
        user = User(
            id=0,  # 将由 repository 分配
            username=username,
            email=email,
            created_at=datetime.now()
        )
        
        errors = user.validate()
        if errors:
            raise ValueError(f"Invalid user data: {errors}")
        
        return self.repository.save(user)


# === 主应用使用组件 ===

# src/application.py
from user_domain.service import UserService
from user_domain.repository import UserRepository
from order_domain.service import OrderService


class Application:
    def __init__(
        self,
        user_repo: UserRepository,
        # ... 其他依赖
    ):
        self.user_service = UserService(user_repo)
        # self.order_service = OrderService(...)
    
    def register_and_order(self, username: str, email: str):
        user = self.user_service.register_user(username, email)
        # 创建订单等后续逻辑
        pass