Step 20: 高级功能 —— 人机协作与运营管理¶

// Step 18: 只有核心服务
auto chat = std::make_shared<ChatService>(io, ai);
auto ai = std::make_shared<AIService>(io, llm, kb);
auto kb = std::make_shared<KnowledgeService>(config);

// 缺少：
// - 人工客服管理
// - 租户管理 API
// - 计费统计

// Step 21: 6 个服务协同工作
// 核心服务（Step 18）
auto kb = std::make_shared<KnowledgeService>(kb_config);
auto ai = std::make_shared<AIService>(io, llm_config, kb);
auto chat = std::make_shared<ChatService>(io, ai);

// 高级服务（Step 20 新增）
auto human = std::make_shared<HumanService>();
auto tenant = std::make_shared<TenantService>();
auto billing = std::make_shared<BillingService>();

// 创建租户
tenant->create_tenant("科技公司", "tech@example.com", TenantPlan::PRO);

// 注册人工客服
human->register_agent(tenant_id, "agent_001", "张客服");
human->set_agent_status("agent_001", HumanAgentStatus::ONLINE);

// 记录用量
billing->record_ai_message(tenant_id, 500, 150);
double cost = billing->calculate_cost(tenant_id);

// include/nuclaw/services/tenant_service.hpp
class TenantService {
public:
    // 租户 CRUD
    std::string create_tenant(const std::string& name,
                               const std::string& email,
                               TenantPlan plan);
    bool delete_tenant(const std::string& tenant_id);

    // 套餐管理（免费/基础/专业/企业）
    bool upgrade_plan(const std::string& tenant_id, TenantPlan new_plan);

    // 配额管理
    TenantQuota get_quota(const std::string& tenant_id);

    // 状态管理（激活/暂停）
    bool suspend_tenant(const std::string& tenant_id, const std::string& reason);
    bool resume_tenant(const std::string& tenant_id);

private:
    std::map<std::string, std::unique_ptr<TenantInfo>> tenants_;
};

// include/nuclaw/services/human_service.hpp
class HumanService {
public:
    // 客服管理
    void register_agent(const std::string& tenant_id,
                        const std::string& agent_id,
                        const std::string& name);
    void set_agent_status(const std::string& agent_id, 
                          HumanAgentStatus status);

    // 转接队列
    std::string request_escalation(const std::string& session_id,
                                    const std::string& tenant_id,
                                    const std::string& reason,
                                    int priority);

    // 会话接管
    bool handover_to_human(const std::string& session_id,
                           const std::string& agent_id);
    bool return_to_ai(const std::string& session_id);

    // 查询状态
    bool is_handled_by_human(const std::string& session_id);
};

// include/nuclaw/services/billing_service.hpp
class BillingService {
public:
    // 用量记录
    void record_ai_message(const std::string& tenant_id,
                           int input_tokens, int output_tokens);
    void record_human_message(const std::string& tenant_id);
    void record_knowledge_document(const std::string& tenant_id,
                                   int doc_size_mb);

    // 费用计算
    double calculate_cost(const std::string& tenant_id);

    // 配额检查
    QuotaCheck check_message_quota(const std::string& tenant_id,
                                    int current, int max);

    // 告警管理
    std::vector<BillingAlert> get_alerts(const std::string& tenant_id);
};

// main.cpp 核心逻辑

// ============================================================
// 初始化 6 个服务
// ============================================================

// 核心服务（Step 18）
auto knowledge_service = std::make_shared<KnowledgeService>(kb_config);
auto ai_service = std::make_shared<AIService>(io, llm_config, knowledge_service);
auto chat_service = std::make_shared<ChatService>(io, ai_service);

// 高级服务（Step 20 新增）
auto human_service = std::make_shared<HumanService>();
auto tenant_service = std::make_shared<TenantService>();
auto billing_service = std::make_shared<BillingService>();

// ============================================================
// 演示 1：租户管理
// ============================================================

// 创建不同套餐的租户
std::string tenant_free = tenant_service->create_tenant(
    "小商店", "shop@example.com", TenantPlan::FREE);

std::string tenant_pro = tenant_service->create_tenant(
    "科技公司", "tech@example.com", TenantPlan::PRO);

// 查看配额
auto quota = tenant_service->get_quota(tenant_pro);
std::cout << "专业版配额: 并发=" << quota.max_concurrent_sessions << "\n";

// ============================================================
// 演示 2：人工客服
// ============================================================

// 注册客服
human_service->register_agent(tenant_pro, "agent_001", "张客服");
human_service->set_agent_status("agent_001", HumanAgentStatus::ONLINE);

// 客户要求转人工
std::string request = human_service->request_escalation(
    "session_001", tenant_pro, "user_001", "投诉问题", 8);

// 客服接管会话
human_service->handover_to_human("session_001", "agent_001");

// 问题解决，交回 AI
human_service->return_to_ai("session_001");

// ============================================================
// 演示 3：计费系统
// ============================================================

// 记录用量
billing_service->record_ai_message(tenant_pro, 500, 150);
billing_service->record_human_message(tenant_pro);
billing_service->record_knowledge_document(tenant_pro, 10);

// 计算费用
double cost = billing_service->calculate_cost(tenant_pro);
std::cout << "本期费用: $" << cost << "\n";

// 配额检查
auto check = billing_service->check_message_quota(
    tenant_pro, 1500, quota.max_messages_per_month);
if (!check.allowed) {
    std::cout << "警告: " << check.reason << "\n";
}