feat(backend): 数字员工平台 B1+B2 批次实现

B1: 项目脚手架 + 数据模型 + 租户管理
- Task 1.1: FastAPI 项目脚手架、SQLite + async SQLAlchemy
- Task 1.2: 7 个数据模型 (Tenant, TenantConfig, DigitalEmployee, Conversation, Message, KnowledgeBase, Document)
- Task 1.3: 租户 CRUD API + LLM 配置(含 API Key AES 加密)

B2: 数字员工配置 + LLM Provider 抽象层
- Task 2.1: 数字员工 CRUD API(关联知识库)
- Task 2.2: BaseLLMProvider 抽象接口 + OpenAI/Qwen Provider
- Task 2.3: Provider 动态实例化 + test-provider 端点

验证: 26 个测试全部通过

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
rootandClaude Opus 4.7 committed 2026-05-06 11:29:48 +08:00
1 parent 44c37420af
commit c62156af53
37 files changed
+4419 -1

No files matched your search

View File
Whitespace-only changes.
+33
View File
@@ -0,0 +1,33 @@
import base64
import os
from cryptography.fernet import Fernet
from cryptography.hazmat.primitives import hashes
from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC
from app.config import settings
def _get_encryption_key() -> bytes:
kdf = PBKDF2HMAC(
algorithm=hashes.SHA256(),
length=32,
salt=settings.encryption_salt.encode(),
iterations=480000,
)
return base64.urlsafe_b64encode(kdf.derive(settings.secret_key.encode()))
def encrypt_api_key(plaintext: str) -> str:
if not plaintext:
return ""
fernet = Fernet(_get_encryption_key())
encrypted = fernet.encrypt(plaintext.encode())
return base64.urlsafe_b64encode(encrypted).decode()
def decrypt_api_key(ciphertext: str) -> str:
if not ciphertext:
return ""
fernet = Fernet(_get_encryption_key())
encrypted = base64.urlsafe_b64decode(ciphertext.encode())
return fernet.decrypt(encrypted).decode()
+104
View File
@@ -0,0 +1,104 @@
import json
from fastapi import HTTPException
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from app.models import DigitalEmployee, EmployeeStatus
async def create_employee(
session: AsyncSession,
tenant_id: str,
name: str,
role: str,
system_prompt: str,
greeting: str | None = None,
avatar_url: str | None = None,
temperature: float = 0.7,
max_context_messages: int = 20,
knowledge_base_ids: list[str] | None = None,
) -> DigitalEmployee:
employee = DigitalEmployee(
tenant_id=tenant_id,
name=name,
role=role,
system_prompt=system_prompt,
greeting=greeting,
avatar_url=avatar_url,
temperature=temperature,
max_context_messages=max_context_messages,
knowledge_base_ids=json.dumps(knowledge_base_ids or []),
)
session.add(employee)
await session.commit()
await session.refresh(employee)
return employee
async def get_employee(session: AsyncSession, employee_id: str) -> DigitalEmployee:
result = await session.execute(
select(DigitalEmployee).where(
DigitalEmployee.id == employee_id,
DigitalEmployee.status != EmployeeStatus.inactive,
)
)
employee = result.scalar_one_or_none()
if not employee:
raise HTTPException(status_code=404, detail="Employee not found")
return employee
async def list_employees(session: AsyncSession, tenant_id: str) -> list[DigitalEmployee]:
result = await session.execute(
select(DigitalEmployee).where(
DigitalEmployee.tenant_id == tenant_id,
DigitalEmployee.status != EmployeeStatus.inactive,
)
)
return list(result.scalars().all())
async def update_employee(
session: AsyncSession,
employee_id: str,
name: str | None = None,
role: str | None = None,
system_prompt: str | None = None,
greeting: str | None = None,
avatar_url: str | None = None,
temperature: float | None = None,
max_context_messages: int | None = None,
knowledge_base_ids: list[str] | None = None,
status: str | None = None,
) -> DigitalEmployee:
employee = await get_employee(session, employee_id)
if name is not None:
employee.name = name
if role is not None:
employee.role = role
if system_prompt is not None:
employee.system_prompt = system_prompt
if greeting is not None:
employee.greeting = greeting
if avatar_url is not None:
employee.avatar_url = avatar_url
if temperature is not None:
employee.temperature = temperature
if max_context_messages is not None:
employee.max_context_messages = max_context_messages
if knowledge_base_ids is not None:
employee.knowledge_base_ids = json.dumps(knowledge_base_ids)
if status is not None:
employee.status = EmployeeStatus(status)
await session.commit()
await session.refresh(employee)
return employee
async def delete_employee(session: AsyncSession, employee_id: str) -> None:
employee = await get_employee(session, employee_id)
employee.status = EmployeeStatus.inactive
await session.commit()
+125
View File
@@ -0,0 +1,125 @@
from fastapi import HTTPException
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from app.models import Tenant, TenantConfig, TenantStatus
from app.providers import get_provider
from app.providers.base import BaseLLMProvider
from app.services.crypto import decrypt_api_key, encrypt_api_key
async def get_provider_for_tenant(
session: AsyncSession, tenant_id: str
) -> BaseLLMProvider:
"""根据租户配置动态实例化 Provider"""
await get_tenant(session, tenant_id)
result = await session.execute(
select(TenantConfig).where(TenantConfig.tenant_id == tenant_id)
)
config = result.scalar_one_or_none()
if not config:
raise HTTPException(status_code=404, detail="Tenant config not found")
api_key = decrypt_api_key(config.llm_api_key)
return get_provider(
provider_type=config.llm_provider,
api_key=api_key,
model=config.llm_model,
base_url=config.llm_base_url,
)
async def create_tenant(session: AsyncSession, name: str, slug: str) -> Tenant:
existing = await session.execute(select(Tenant).where(Tenant.slug == slug))
if existing.scalar_one_or_none():
raise HTTPException(status_code=400, detail="Slug already exists")
tenant = Tenant(name=name, slug=slug)
session.add(tenant)
await session.commit()
await session.refresh(tenant)
return tenant
async def get_tenant(session: AsyncSession, tenant_id: str) -> Tenant:
result = await session.execute(
select(Tenant).where(Tenant.id == tenant_id, Tenant.status != TenantStatus.deleted)
)
tenant = result.scalar_one_or_none()
if not tenant:
raise HTTPException(status_code=404, detail="Tenant not found")
return tenant
async def list_tenants(session: AsyncSession) -> list[Tenant]:
result = await session.execute(
select(Tenant).where(Tenant.status != TenantStatus.deleted)
)
return list(result.scalars().all())
async def update_tenant(
session: AsyncSession, tenant_id: str, name: str | None, slug: str | None
) -> Tenant:
tenant = await get_tenant(session, tenant_id)
if slug and slug != tenant.slug:
existing = await session.execute(select(Tenant).where(Tenant.slug == slug))
if existing.scalar_one_or_none():
raise HTTPException(status_code=400, detail="Slug already exists")
tenant.slug = slug
if name:
tenant.name = name
await session.commit()
await session.refresh(tenant)
return tenant
async def delete_tenant(session: AsyncSession, tenant_id: str) -> None:
tenant = await get_tenant(session, tenant_id)
tenant.status = TenantStatus.deleted
await session.commit()
async def update_tenant_config(
session: AsyncSession,
tenant_id: str,
llm_provider: str,
llm_api_key: str,
llm_model: str,
llm_base_url: str | None = None,
max_tokens_per_month: int = 1000000,
) -> TenantConfig:
await get_tenant(session, tenant_id)
result = await session.execute(
select(TenantConfig).where(TenantConfig.tenant_id == tenant_id)
)
config = result.scalar_one_or_none()
encrypted_key = encrypt_api_key(llm_api_key)
if config:
config.llm_provider = llm_provider
config.llm_api_key = encrypted_key
config.llm_model = llm_model
config.llm_base_url = llm_base_url
config.max_tokens_per_month = max_tokens_per_month
else:
config = TenantConfig(
tenant_id=tenant_id,
llm_provider=llm_provider,
llm_api_key=encrypted_key,
llm_model=llm_model,
llm_base_url=llm_base_url,
max_tokens_per_month=max_tokens_per_month,
)
session.add(config)
await session.commit()
await session.refresh(config)
return config