2026-03-17 14:36:31 +08:00
|
|
|
"""
|
|
|
|
|
Chunks API Router
|
|
|
|
|
"""
|
2026-03-17 17:29:58 +08:00
|
|
|
import asyncio
|
2026-03-17 14:36:31 +08:00
|
|
|
from typing import List, Optional
|
|
|
|
|
from uuid import UUID
|
2026-03-17 17:29:58 +08:00
|
|
|
from pydantic import BaseModel, Field
|
2026-03-17 14:36:31 +08:00
|
|
|
from fastapi import APIRouter, Depends, HTTPException, Query
|
|
|
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
|
|
|
|
from sqlalchemy import select
|
2026-03-17 17:29:58 +08:00
|
|
|
|
|
|
|
|
from app.api.response import ApiResponse, PaginatedResponse
|
2026-03-17 14:36:31 +08:00
|
|
|
from app.core.database import get_db
|
2026-03-17 17:29:58 +08:00
|
|
|
from app.core.exceptions import NotFoundException
|
|
|
|
|
from app.core.crud import CRUDBase
|
2026-03-17 14:36:31 +08:00
|
|
|
from app.models.models import Chunk, File
|
2026-03-17 17:29:58 +08:00
|
|
|
from app.schemas.chunk import ChunkResponse
|
|
|
|
|
from app.schemas.chunk import ChunkCreateSchema
|
2026-03-17 14:36:31 +08:00
|
|
|
from app.services.text_splitter.splitter import get_splitter
|
|
|
|
|
from app.services.file_processor.pdf_processor import process_pdf
|
|
|
|
|
from app.services.file_processor.docx_processor import process_docx
|
|
|
|
|
from app.services.file_processor.excel_processor import process_csv, process_excel
|
|
|
|
|
|
|
|
|
|
router = APIRouter()
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
# Initialize CRUD
|
|
|
|
|
chunk_crud = CRUDBase(Chunk)
|
|
|
|
|
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
class SplitRequest(BaseModel):
|
|
|
|
|
"""Request model for splitting text"""
|
2026-03-17 17:29:58 +08:00
|
|
|
file_id: UUID
|
2026-03-17 14:36:31 +08:00
|
|
|
method: str = "recursive"
|
2026-03-17 17:29:58 +08:00
|
|
|
chunk_size: int = Field(500, ge=50, le=5000)
|
|
|
|
|
overlap: int = Field(50, ge=0, le=500)
|
2026-03-17 14:36:31 +08:00
|
|
|
separator: Optional[str] = None
|
|
|
|
|
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
async def process_file_by_type(file: File) -> str:
|
2026-03-17 14:36:31 +08:00
|
|
|
"""Process file based on its type"""
|
|
|
|
|
if not file.file_path:
|
2026-03-17 17:29:58 +08:00
|
|
|
raise NotFoundException("File", file.id)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
processors = {
|
|
|
|
|
"pdf": process_pdf,
|
|
|
|
|
"docx": process_docx,
|
|
|
|
|
"xlsx": process_excel,
|
|
|
|
|
"csv": process_csv,
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
processor = processors.get(file.file_type)
|
|
|
|
|
if not processor:
|
|
|
|
|
# Return raw text for txt, md files
|
2026-03-17 17:29:58 +08:00
|
|
|
loop = asyncio.get_event_loop()
|
|
|
|
|
content = await loop.run_in_executor(
|
|
|
|
|
None,
|
|
|
|
|
lambda: open(file.file_path, 'r', encoding='utf-8').read()
|
|
|
|
|
)
|
|
|
|
|
return content
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
return await processor(file.file_path)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
@router.post("/split", response_model=ApiResponse)
|
2026-03-17 14:36:31 +08:00
|
|
|
async def split_text(
|
|
|
|
|
project_id: UUID,
|
|
|
|
|
request: SplitRequest,
|
|
|
|
|
db: AsyncSession = Depends(get_db)
|
|
|
|
|
):
|
|
|
|
|
"""Split text into chunks"""
|
|
|
|
|
# Get file
|
2026-03-17 17:29:58 +08:00
|
|
|
result = await db.execute(
|
|
|
|
|
select(File).where(File.id == request.file_id, File.project_id == project_id)
|
|
|
|
|
)
|
|
|
|
|
file = result.scalar_one_or_none()
|
|
|
|
|
if not file:
|
|
|
|
|
raise NotFoundException("File", request.file_id)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
# Process file
|
|
|
|
|
text = await process_file_by_type(file)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
# Update file status
|
|
|
|
|
file.status = "processing"
|
|
|
|
|
await db.commit()
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
# Split text
|
|
|
|
|
kwargs = {"chunk_size": request.chunk_size, "overlap": request.overlap}
|
|
|
|
|
if request.method == "custom" and request.separator:
|
|
|
|
|
kwargs["separator"] = request.separator
|
|
|
|
|
|
|
|
|
|
splitter = get_splitter(request.method, **kwargs)
|
|
|
|
|
split_results = splitter.split(text)
|
|
|
|
|
|
|
|
|
|
# Save chunks
|
|
|
|
|
chunks = []
|
|
|
|
|
for chunk_data in split_results:
|
|
|
|
|
db_chunk = Chunk(
|
|
|
|
|
project_id=project_id,
|
|
|
|
|
file_id=file.id,
|
|
|
|
|
name=chunk_data.get("name", f"Chunk {chunk_data['index'] + 1}"),
|
|
|
|
|
content=chunk_data["content"],
|
|
|
|
|
word_count=chunk_data.get("word_count", len(chunk_data["content"].split()))
|
|
|
|
|
)
|
|
|
|
|
db.add(db_chunk)
|
|
|
|
|
chunks.append(db_chunk)
|
|
|
|
|
|
|
|
|
|
await db.commit()
|
|
|
|
|
|
|
|
|
|
# Update file status
|
|
|
|
|
file.status = "completed"
|
|
|
|
|
await db.commit()
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
return ApiResponse.ok(
|
|
|
|
|
data={"chunks": len(chunks)},
|
|
|
|
|
message=f"Successfully split into {len(chunks)} chunks"
|
|
|
|
|
)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
@router.get("", response_model=ApiResponse)
|
2026-03-17 14:36:31 +08:00
|
|
|
async def list_chunks(
|
|
|
|
|
project_id: UUID,
|
|
|
|
|
file_id: Optional[UUID] = Query(None),
|
2026-03-17 17:29:58 +08:00
|
|
|
page: int = Query(1, ge=1),
|
|
|
|
|
page_size: int = Query(20, ge=1, le=100),
|
2026-03-17 14:36:31 +08:00
|
|
|
db: AsyncSession = Depends(get_db)
|
|
|
|
|
):
|
|
|
|
|
"""List chunks for a project"""
|
2026-03-17 17:29:58 +08:00
|
|
|
filters = {"project_id": project_id}
|
2026-03-17 14:36:31 +08:00
|
|
|
if file_id:
|
2026-03-17 17:29:58 +08:00
|
|
|
filters["file_id"] = file_id
|
|
|
|
|
|
|
|
|
|
skip = (page - 1) * page_size
|
|
|
|
|
chunks, total = await chunk_crud.get_multi(
|
|
|
|
|
db,
|
|
|
|
|
skip=skip,
|
|
|
|
|
limit=page_size,
|
|
|
|
|
filters=filters,
|
|
|
|
|
order_by="created_at",
|
|
|
|
|
descending=True
|
|
|
|
|
)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
chunk_responses = [ChunkResponse.model_validate(c) for c in chunks]
|
|
|
|
|
return PaginatedResponse.ok(
|
|
|
|
|
items=chunk_responses,
|
|
|
|
|
page=page,
|
|
|
|
|
page_size=page_size,
|
|
|
|
|
total=total
|
|
|
|
|
)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
@router.get("/{chunk_id}", response_model=ApiResponse)
|
|
|
|
|
async def get_chunk(
|
|
|
|
|
project_id: UUID,
|
|
|
|
|
chunk_id: UUID,
|
|
|
|
|
db: AsyncSession = Depends(get_db)
|
|
|
|
|
):
|
2026-03-17 14:36:31 +08:00
|
|
|
"""Get chunk by ID"""
|
2026-03-17 17:29:58 +08:00
|
|
|
chunk = await chunk_crud.get(db, chunk_id)
|
|
|
|
|
if not chunk or chunk.project_id != project_id:
|
|
|
|
|
raise NotFoundException("Chunk", chunk_id)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
return ApiResponse.ok(data=ChunkResponse.model_validate(chunk))
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
|
|
|
|
|
@router.put("/{chunk_id}", response_model=ApiResponse)
|
2026-03-17 14:36:31 +08:00
|
|
|
async def update_chunk(
|
|
|
|
|
project_id: UUID,
|
|
|
|
|
chunk_id: UUID,
|
2026-03-17 17:29:58 +08:00
|
|
|
chunk: ChunkCreateSchema,
|
2026-03-17 14:36:31 +08:00
|
|
|
db: AsyncSession = Depends(get_db)
|
|
|
|
|
):
|
|
|
|
|
"""Update chunk"""
|
2026-03-17 17:29:58 +08:00
|
|
|
db_chunk = await chunk_crud.get(db, chunk_id)
|
|
|
|
|
if not db_chunk or db_chunk.project_id != project_id:
|
|
|
|
|
raise NotFoundException("Chunk", chunk_id)
|
|
|
|
|
|
|
|
|
|
updated_chunk = await chunk_crud.update(db, db_chunk, chunk)
|
|
|
|
|
return ApiResponse.ok(
|
|
|
|
|
data=ChunkResponse.model_validate(updated_chunk),
|
|
|
|
|
message="Chunk updated successfully"
|
2026-03-17 14:36:31 +08:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
@router.delete("/{chunk_id}", response_model=ApiResponse)
|
|
|
|
|
async def delete_chunk(
|
|
|
|
|
project_id: UUID,
|
|
|
|
|
chunk_id: UUID,
|
|
|
|
|
db: AsyncSession = Depends(get_db)
|
|
|
|
|
):
|
2026-03-17 14:36:31 +08:00
|
|
|
"""Delete chunk"""
|
2026-03-17 17:29:58 +08:00
|
|
|
chunk = await chunk_crud.get(db, chunk_id)
|
|
|
|
|
if not chunk or chunk.project_id != project_id:
|
|
|
|
|
raise NotFoundException("Chunk", chunk_id)
|
2026-03-17 14:36:31 +08:00
|
|
|
|
2026-03-17 17:29:58 +08:00
|
|
|
await chunk_crud.delete(db, chunk_id)
|
|
|
|
|
return ApiResponse.ok(message="Chunk deleted successfully")
|