Feature/delta team/epic r04 (#7)

## Summary

epic r04 - begin refactor

## Change Type

- [x] Cowork feature
- [ ] Bug fix
- [ ] Core AI contribution
- [ ] Test / hardening
- [ ] Performance
- [ ] Documentation

## Related Work

Cowork Task:

Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets

Core AI Issue:

Core Task:

Related PR:

## Scope

What is intentionally included?

What is intentionally NOT included?

## Validation

- [ ] Unit tests
- [ ] Integration tests
- [ ] Manual verification
- [ ] Regression check

Commands / evidence:

## Security Impact

Permission / credential / network / customer data impact:

## Compatibility

- [ ] No breaking change
- [ ] Breaking change documented

## Reviewer Notes

Anything Cowork reviewers should pay attention to.

---------

Co-authored-by: Anh Tran Nguyen Minh <anhtnm1@fpt.com>
Co-authored-by: Huong Le Thi Thien <huongltt35@fpt.com>
Co-authored-by: Nam Pham Dinh Thanh <nampdt@fpt.com>
Co-authored-by: Vu Dam Tuan <vudt15@fpt.com>
Co-authored-by: Hiep Ha Van <hiephv3@fpt.com>
Co-authored-by: Lam Hoang Van <lamhv7@fpt.com>
Reviewed-on: #7
Co-authored-by: Duy Le Huu <duylh19@fpt.com>

core/pptx_edit.py

@@ -37,6 +37,7 @@ _KEEP_PREFIX = "("   # image values like "(keep …)" mean "don't change"
 
 
 def is_available() -> bool:
+    """Máy đã cài ``python-pptx`` chưa — không có thì mọi tính năng PowerPoint tắt."""
     try:
         import pptx  # noqa: F401
         return True
@@ -45,10 +46,12 @@ def is_available() -> bool:
 
 
 def _in(emu) -> float:
+    """Đổi đơn vị EMU của Office sang inch, làm tròn 2 chữ số."""
     return round((emu or 0) / _EMU_PER_IN, 2)
 
 
 def _kind(shape) -> str:
+    """Loại hình khối trong slide: ảnh, bảng, biểu đồ hay hộp văn bản."""
     from pptx.enum.shapes import MSO_SHAPE_TYPE
     try:
         if shape.shape_type == MSO_SHAPE_TYPE.PICTURE:
@@ -182,6 +185,11 @@ def _apply_font(shape, spec: str) -> bool:
 
 
 def _parse(text: str) -> Dict[Tuple[int, int], dict]:
+    """Đọc dạng văn bản đánh dấu của slide trở lại thành cấu trúc.
+
+    Đây là khuôn trung gian giữa PowerPoint và ô soạn thảo: người dùng (và AI)
+    sửa văn bản, hàm này dựng lại thành thao tác trên deck.
+    """
     blocks: Dict[Tuple[int, int], dict] = {}
     cur: Tuple[int, int] | None = None
     fields: dict = {}
@@ -189,6 +197,7 @@ def _parse(text: str) -> Dict[Tuple[int, int], dict]:
     textbuf: List[str] = []
 
     def _flush():
+        """Chốt khối đang đọc dở và đưa vào kết quả."""
         if cur is not None:
             if in_text:
                 fields["text"] = "\n".join(textbuf).strip("\n")
@@ -221,6 +230,7 @@ def _parse(text: str) -> Dict[Tuple[int, int], dict]:
 
 
 def _pair(val: str):
+    """Đọc chuỗi 'a, b' thành cặp số (dùng cho toạ độ và kích thước)."""
     try:
         a, b = (x.strip() for x in val.split(",", 1))
         return float(a), float(b)