bugfix

README.md

@@ -0,0 +1,8 @@
+# 合同管理模块
+
+企业合同信息管理系统，支持合同附件管理，并集成AI功能：
+1. 版本差异化对比
+2. 合同合规检查  
+3. 合同关键时点提取
+
+依赖 appbase 和 rbac 模块，AI服务通过URL和API Key配置。

contract_management/ai_config_core.py

@@ -0,0 +1,32 @@
+import os
+import json
+from sqlor.dbp import getDBP
+
+async def save_ai_config(request_data: dict, org_id: str) -> dict:
+    """保存AI配置"""
+    dbp = await getDBP(org_id)
+    
+    # 检查是否已存在配置
+    check_sql = "SELECT id FROM contract_ai_config WHERE org_id = %(org_id)s"
+    check_result = await dbp.doQuery(check_sql, {'org_id': org_id})
+    
+    if check_result:
+        # 更新现有配置
+        sql = """
+        UPDATE contract_ai_config 
+        SET ai_service_url = %(ai_service_url)s, api_key = %(api_key)s, updated_at = NOW()
+        WHERE org_id = %(org_id)s
+        """
+    else:
+        # 插入新配置
+        sql = """
+        INSERT INTO contract_ai_config (id, ai_service_url, api_key, org_id, created_at, updated_at)
+        VALUES (%(id)s, %(ai_service_url)s, %(api_key)s, %(org_id)s, NOW(), NOW())
+        """
+        request_data['id'] = str(uuid.uuid4()).replace('-', '')
+    
+    request_data['org_id'] = org_id
+    await dbp.doTransaction([{'sql': sql, 'params': request_data}])
+    return {'success': True, 'message': 'AI配置保存成功'}
+
+# 在 init.py 中添加这个函数的暴露

contract_management/ai_core.py

@@ -0,0 +1,97 @@
+import json
+import aiohttp
+from typing import Dict, List, Optional, Tuple
+from appPublic.jsonconfig import getConfig
+
+class AIContractService:
+    def __init__(self):
+        self.config = getConfig()
+        
+    async def get_ai_config(self, org_id: str) -> Optional[Dict]:
+        """获取组织的AI配置"""
+        # 这里需要从数据库查询 contract_ai_config 表
+        # 为简化，先假设配置存在
+        dbp = await getDBP(org_id)
+        sql = "SELECT * FROM contract_ai_config WHERE org_id = %(org_id)s"
+        result = await dbp.doQuery(sql, {'org_id': org_id})
+        return result[0] if result else None
+        
+    async def _make_ai_request(self, url: str, api_key: str, payload: Dict) -> Dict:
+        """发送AI请求"""
+        headers = {
+            'Authorization': f'Bearer {api_key}',
+            'Content-Type': 'application/json'
+        }
+        
+        async with aiohttp.ClientSession() as session:
+            async with session.post(url, headers=headers, json=payload) as response:
+                if response.status == 200:
+                    return await response.json()
+                else:
+                    raise Exception(f"AI service error: {response.status} - {await response.text()}")
+                    
+    async def ai_version_compare(self, file1_content: str, file2_content: str, 
+                                org_id: str) -> Dict:
+        """AI版本差异化对比"""
+        ai_config = await self.get_ai_config(org_id)
+        if not ai_config:
+            raise Exception("AI configuration not found for organization")
+            
+        payload = {
+            "task": "version_compare",
+            "file1_content": file1_content,
+            "file2_content": file2_content
+        }
+        
+        return await self._make_ai_request(
+            ai_config['ai_service_url'], 
+            ai_config['api_key'], 
+            payload
+        )
+        
+    async def ai_compliance_check(self, contract_content: str, org_id: str) -> Dict:
+        """AI合同合规检查"""
+        ai_config = await self.get_ai_config(org_id)
+        if not ai_config:
+            raise Exception("AI configuration not found for organization")
+            
+        payload = {
+            "task": "compliance_check", 
+            "contract_content": contract_content
+        }
+        
+        return await self._make_ai_request(
+            ai_config['ai_service_url'],
+            ai_config['api_key'],
+            payload
+        )
+        
+    async def ai_extract_key_dates(self, contract_content: str, org_id: str) -> Dict:
+        """AI合同关键时点提取"""
+        ai_config = await self.get_ai_config(org_id)
+        if not ai_config:
+            raise Exception("AI configuration not found for organization")
+            
+        payload = {
+            "task": "extract_key_dates",
+            "contract_content": contract_content
+        }
+        
+        return await self._make_ai_request(
+            ai_config['ai_service_url'],
+            ai_config['api_key'], 
+            payload
+        )
+
+# 全局实例
+ai_service = AIContractService()
+
+# 导出函数
+async def ai_version_compare(file1_content: str, file2_content: str, org_id: str) -> Dict:
+    return await ai_service.ai_version_compare(file1_content, file2_content, org_id)
+
+async def ai_compliance_check(contract_content: str, org_id: str) -> Dict:
+    return await ai_service.ai_compliance_check(contract_content, org_id)
+
+async def ai_extract_key_dates(contract_content: str, org_id: str) -> Dict:
+    return await ai_service.ai_extract_key_dates(contract_content, org_id)

contract_management/attachment_core.py

@@ -0,0 +1,111 @@
+import os
+import uuid
+from datetime import datetime
+from typing import List, Dict, Optional
+from appPublic.jsonconfig import getConfig
+from appPublic.worker import Worker
+from sqlor.dbp import getDBP
+
+class ContractAttachmentManager:
+    def __init__(self):
+        self.config = getConfig()
+        self.worker = Worker()
+        self.upload_dir = self.config.get('contract_upload_dir', '/var/uploads/contracts')
+        
+    async def get_db_connection(self, org_id: str):
+        """获取数据库连接"""
+        dbp = await getDBP(org_id)
+        return dbp
+        
+    async def ensure_upload_dir(self, org_id: str):
+        """确保存储目录存在"""
+        org_dir = os.path.join(self.upload_dir, org_id)
+        os.makedirs(org_dir, exist_ok=True)
+        return org_dir
+        
+    async def upload_contract_attachment(self, contract_id: str, file_data: bytes, 
+                                       file_name: str, file_type: str, 
+                                       user_id: str, org_id: str, 
+                                       description: Optional[str] = None) -> str:
+        """上传合同附件"""
+        attachment_id = str(uuid.uuid4()).replace('-', '')
+        dbp = await self.get_db_connection(org_id)
+        org_dir = await self.ensure_upload_dir(org_id)
+        
+        # 生成文件路径
+        file_ext = os.path.splitext(file_name)[1] if '.' in file_name else ''
+        safe_filename = f"{attachment_id}{file_ext}"
+        file_path = os.path.join(org_dir, safe_filename)
+        
+        # 保存文件
+        with open(file_path, 'wb') as f:
+            f.write(file_data)
+            
+        # 获取文件大小
+        file_size = len(file_data)
+        
+        # 检查是否已有同名文件的版本
+        check_sql = """
+        SELECT MAX(version) as max_version FROM contract_attachment 
+        WHERE contract_id = %(contract_id)s AND file_name = %(file_name)s AND org_id = %(org_id)s
+        """
+        check_result = await dbp.doQuery(check_sql, {
+            'contract_id': contract_id,
+            'file_name': file_name,
+            'org_id': org_id
+        })
+        current_version = check_result[0]['max_version'] if check_result and check_result[0]['max_version'] else 0
+        new_version = current_version + 1
+        
+        # 插入附件记录
+        sql = """
+        INSERT INTO contract_attachment (
+            id, contract_id, file_name, file_path, file_size, file_type,
+            version, description, uploaded_by, org_id, created_at
+        ) VALUES (
+            %(id)s, %(contract_id)s, %(file_name)s, %(file_path)s, %(file_size)s, %(file_type)s,
+            %(version)s, %(description)s, %(uploaded_by)s, %(org_id)s, NOW()
+        )
+        """
+        
+        params = {
+            'id': attachment_id,
+            'contract_id': contract_id,
+            'file_name': file_name,
+            'file_path': file_path,
+            'file_size': file_size,
+            'file_type': file_type,
+            'version': new_version,
+            'description': description,
+            'uploaded_by': user_id,
+            'org_id': org_id
+        }
+        
+        await dbp.doTransaction([{'sql': sql, 'params': params}])
+        return attachment_id
+        
+    async def get_contract_attachments(self, contract_id: str, org_id: str) -> List[Dict]:
+        """获取合同的所有附件"""
+        dbp = await self.get_db_connection(org_id)
+        sql = """
+        SELECT * FROM contract_attachment 
+        WHERE contract_id = %(contract_id)s AND org_id = %(org_id)s
+        ORDER BY version DESC, created_at DESC
+        """
+        result = await dbp.doQuery(sql, {'contract_id': contract_id, 'org_id': org_id})
+        return result
+
+# 全局实例
+attachment_manager = ContractAttachmentManager()
+
+# 导出函数
+async def upload_contract_attachment(contract_id: str, file_data: bytes, 
+                                   file_name: str, file_type: str, 
+                                   user_id: str, org_id: str, 
+                                   description: Optional[str] = None) -> str:
+    return await attachment_manager.upload_contract_attachment(
+        contract_id, file_data, file_name, file_type, user_id, org_id, description
+    )
+
+async def get_contract_attachments(contract_id: str, org_id: str) -> List[Dict]:
+    return await attachment_manager.get_contract_attachments(contract_id, org_id)

contract_management/contract_core.py

@@ -0,0 +1,163 @@
+import os
+import json
+import uuid
+from datetime import datetime
+from typing import List, Dict, Optional, Tuple
+from appPublic.jsonconfig import getConfig
+from appPublic.worker import Worker
+from sqlor.dbp import getDBP
+
+class ContractManager:
+    def __init__(self):
+        self.config = getConfig()
+        self.worker = Worker()
+        
+    async def get_db_connection(self, org_id: str):
+        """获取数据库连接"""
+        dbp = await getDBP(org_id)
+        return dbp
+        
+    async def create_contract(self, contract_data: Dict, user_id: str, org_id: str) -> str:
+        """创建合同"""
+        contract_id = str(uuid.uuid4()).replace('-', '')
+        dbp = await self.get_db_connection(org_id)
+        
+        # 插入合同数据
+        sql = """
+        INSERT INTO contract (
+            id, contract_number, title, party_a, party_b, contract_type,
+            status, amount, start_date, end_date, sign_date, description,
+            owner_id, org_id, created_at, updated_at
+        ) VALUES (
+            %(id)s, %(contract_number)s, %(title)s, %(party_a)s, %(party_b)s, %(contract_type)s,
+            %(status)s, %(amount)s, %(start_date)s, %(end_date)s, %(sign_date)s, %(description)s,
+            %(owner_id)s, %(org_id)s, NOW(), NOW()
+        )
+        """
+        
+        params = {
+            'id': contract_id,
+            'contract_number': contract_data['contract_number'],
+            'title': contract_data['title'],
+            'party_a': contract_data['party_a'],
+            'party_b': contract_data['party_b'],
+            'contract_type': contract_data['contract_type'],
+            'status': contract_data.get('status', 'draft'),
+            'amount': contract_data.get('amount'),
+            'start_date': contract_data['start_date'],
+            'end_date': contract_data['end_date'],
+            'sign_date': contract_data.get('sign_date'),
+            'description': contract_data.get('description'),
+            'owner_id': user_id,
+            'org_id': org_id
+        }
+        
+        await dbp.doTransaction([{'sql': sql, 'params': params}])
+        return contract_id
+        
+    async def update_contract(self, contract_id: str, contract_data: Dict, org_id: str) -> bool:
+        """更新合同"""
+        dbp = await self.get_db_connection(org_id)
+        
+        # 构建更新SQL
+        update_fields = []
+        params = {'id': contract_id, 'org_id': org_id}
+        
+        for field, value in contract_data.items():
+            if field in ['contract_number', 'title', 'party_a', 'party_b', 'contract_type', 
+                        'status', 'amount', 'start_date', 'end_date', 'sign_date', 'description']:
+                update_fields.append(f"{field} = %({field})s")
+                params[field] = value
+                
+        update_fields.append("updated_at = NOW()")
+        sql = f"UPDATE contract SET {', '.join(update_fields)} WHERE id = %(id)s AND org_id = %(org_id)s"
+        
+        result = await dbp.doTransaction([{'sql': sql, 'params': params}])
+        return result.rowcount > 0
+        
+    async def delete_contract(self, contract_id: str, org_id: str) -> bool:
+        """删除合同（软删除）"""
+        dbp = await self.get_db_connection(org_id)
+        sql = "UPDATE contract SET status = 'deleted', updated_at = NOW() WHERE id = %(id)s AND org_id = %(org_id)s"
+        result = await dbp.doTransaction([{'sql': sql, 'params': {'id': contract_id, 'org_id': org_id}}])
+        return result.rowcount > 0
+        
+    async def get_contract_by_id(self, contract_id: str, org_id: str) -> Optional[Dict]:
+        """根据ID获取合同"""
+        dbp = await self.get_db_connection(org_id)
+        sql = "SELECT * FROM contract WHERE id = %(id)s AND org_id = %(org_id)s AND status != 'deleted'"
+        result = await dbp.doQuery(sql, {'id': contract_id, 'org_id': org_id})
+        return result[0] if result else None
+        
+    async def list_contracts(self, org_id: str, filters: Optional[Dict] = None, 
+                           page: int = 1, page_size: int = 20) -> Tuple[List[Dict], int]:
+        """列出合同"""
+        dbp = await self.get_db_connection(org_id)
+        
+        # 构建查询条件
+        where_clauses = ["org_id = %(org_id)s", "status != 'deleted'"]
+        params = {'org_id': org_id}
+        
+        if filters:
+            if filters.get('contract_number'):
+                where_clauses.append("contract_number LIKE %(contract_number)s")
+                params['contract_number'] = f"%{filters['contract_number']}%"
+            if filters.get('title'):
+                where_clauses.append("title LIKE %(title)s")
+                params['title'] = f"%{filters['title']}%"
+            if filters.get('party_b'):
+                where_clauses.append("party_b LIKE %(party_b)s")
+                params['party_b'] = f"%{filters['party_b']}%"
+            if filters.get('status'):
+                where_clauses.append("status = %(status)s")
+                params['status'] = filters['status']
+            if filters.get('contract_type'):
+                where_clauses.append("contract_type = %(contract_type)s")
+                params['contract_type'] = filters['contract_type']
+            if filters.get('start_date_from'):
+                where_clauses.append("start_date >= %(start_date_from)s")
+                params['start_date_from'] = filters['start_date_from']
+            if filters.get('end_date_to'):
+                where_clauses.append("end_date <= %(end_date_to)s")
+                params['end_date_to'] = filters['end_date_to']
+                
+        where_sql = " AND ".join(where_clauses)
+        
+        # 获取总数
+        count_sql = f"SELECT COUNT(*) as total FROM contract WHERE {where_sql}"
+        count_result = await dbp.doQuery(count_sql, params)
+        total = count_result[0]['total'] if count_result else 0
+        
+        # 获取分页数据
+        offset = (page - 1) * page_size
+        data_sql = f"""
+        SELECT * FROM contract 
+        WHERE {where_sql}
+        ORDER BY created_at DESC
+        LIMIT %(limit)s OFFSET %(offset)s
+        """
+        params['limit'] = page_size
+        params['offset'] = offset
+        
+        data_result = await dbp.doQuery(data_sql, params)
+        return data_result, total
+
+# 全局实例
+contract_manager = ContractManager()
+
+# 导出函数
+async def create_contract(contract_data: Dict, user_id: str, org_id: str) -> str:
+    return await contract_manager.create_contract(contract_data, user_id, org_id)
+
+async def update_contract(contract_id: str, contract_data: Dict, org_id: str) -> bool:
+    return await contract_manager.update_contract(contract_id, contract_data, org_id)
+
+async def delete_contract(contract_id: str, org_id: str) -> bool:
+    return await contract_manager.delete_contract(contract_id, org_id)
+
+async def get_contract_by_id(contract_id: str, org_id: str) -> Optional[Dict]:
+    return await contract_manager.get_contract_by_id(contract_id, org_id)
+
+async def list_contracts(org_id: str, filters: Optional[Dict] = None, 
+                        page: int = 1, page_size: int = 20) -> Tuple[List[Dict], int]:
+    return await contract_manager.list_contracts(org_id, filters, page, page_size)

contract_management/init.py

@@ -0,0 +1,34 @@
+from ahserver.serverenv import ServerEnv
+from appPublic.worker import awaitify
+from .contract_core import (
+    create_contract,
+    update_contract, 
+    delete_contract,
+    get_contract_by_id,
+    list_contracts
+)
+from .attachment_core import (
+    upload_contract_attachment,
+    get_contract_attachments
+)
+from .ai_core import (
+    ai_version_compare,
+    ai_compliance_check,
+    ai_extract_key_dates
+)
+from .ai_config_core import save_ai_config
+
+def load_contract_management():
+    env = ServerEnv()
+    # 所有函数都是协程，不需要 awaitify 包装
+    env.create_contract = create_contract
+    env.update_contract = update_contract
+    env.delete_contract = delete_contract
+    env.get_contract_by_id = get_contract_by_id
+    env.list_contracts = list_contracts
+    env.upload_contract_attachment = upload_contract_attachment
+    env.get_contract_attachments = get_contract_attachments
+    env.ai_version_compare = ai_version_compare
+    env.ai_compliance_check = ai_compliance_check
+    env.ai_extract_key_dates = ai_extract_key_dates
+    env.save_ai_config = save_ai_config

json/contract.json

@@ -0,0 +1,42 @@
+{
+  "tblname": "contract",
+  "title": "合同管理",
+  "params": {
+    "sortby": "created_at",
+    "sortorder": "desc",
+    "browserfields": {
+      "exclouded": ["id", "org_id", "ai_compliance_result", "ai_key_dates", "updated_at"],
+      "cwidth": {
+        "contract_number": 150,
+        "title": 200,
+        "party_b": 150,
+        "amount": 120,
+        "start_date": 120,
+        "end_date": 120,
+        "status": 100
+      }
+    },
+    "editexclouded": ["id", "org_id", "created_at", "updated_at", "ai_compliance_result", "ai_key_dates"],
+    "subtables": [
+      {
+        "field": "id",
+        "title": "合同附件",
+        "subtable": "contract_attachment"
+      }
+    ],
+    "alters": {
+      "contract_type": {
+        "codetable": "appcodes",
+        "codevalue": "CONTRACT_TYPE"
+      },
+      "status": {
+        "options": [
+          {"value": "draft", "text": "草稿"},
+          {"value": "active", "text": "生效"}, 
+          {"value": "expired", "text": "过期"},
+          {"value": "terminated", "text": "终止"}
+        ]
+      }
+    }
+  }
+}

json/contract_ai_config.json

@@ -0,0 +1,18 @@
+{
+  "tblname": "contract_ai_config",
+  "title": "AI配置管理",
+  "params": {
+    "sortby": "created_at",
+    "sortorder": "desc",
+    "browserfields": {
+      "exclouded": ["id", "api_key"],
+      "cwidth": {
+        "ai_service_url": 300,
+        "created_at": 150,
+        "updated_at": 150
+      }
+    },
+    "editexclouded": ["id", "created_at", "updated_at"],
+    "confidential_fields": ["api_key"]
+  }
+}

json/contract_attachment.json

@@ -0,0 +1,26 @@
+{
+  "tblname": "contract_attachment",
+  "title": "合同附件",
+  "params": {
+    "sortby": "created_at",
+    "sortorder": "desc",
+    "browserfields": {
+      "exclouded": ["id", "contract_id", "file_path", "org_id"],
+      "cwidth": {
+        "file_name": 200,
+        "file_size": 100,
+        "file_type": 150,
+        "version": 80,
+        "uploaded_by": 150,
+        "created_at": 150
+      }
+    },
+    "editexclouded": ["id", "contract_id", "file_path", "file_size", "org_id", "created_at"],
+    "alters": {
+      "uploaded_by": {
+        "codetable": "users",
+        "displayfield": "username"
+      }
+    }
+  }
+}

models/contract.json

@@ -0,0 +1,174 @@
+{
+    "summary": [
+        {
+            "name": "contract",
+            "title": "合同表",
+            "primary": "id"
+        }
+    ],
+    "fields": [
+        {
+            "name": "id",
+            "title": "合同ID",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "合同ID，主键"
+        },
+        {
+            "name": "contract_number",
+            "title": "合同编号", 
+            "type": "str",
+            "length": 50,
+            "nullable": "no",
+            "comments": "合同编号，唯一标识"
+        },
+        {
+            "name": "title",
+            "title": "合同标题",
+            "type": "str",
+            "length": 200,
+            "nullable": "no",
+            "comments": "合同标题"
+        },
+        {
+            "name": "party_a",
+            "title": "甲方",
+            "type": "str",
+            "length": 100,
+            "nullable": "no",
+            "comments": "甲方（我方）"
+        },
+        {
+            "name": "party_b",
+            "title": "乙方",
+            "type": "str",
+            "length": 100,
+            "nullable": "no",
+            "comments": "乙方（对方）"
+        },
+        {
+            "name": "contract_type",
+            "title": "合同类型",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "合同类型，引用appcodes表的id"
+        },
+        {
+            "name": "status",
+            "title": "合同状态",
+            "type": "str",
+            "length": 20,
+            "nullable": "no",
+            "default": "draft",
+            "comments": "合同状态：draft-草稿, active-生效, expired-过期, terminated-终止"
+        },
+        {
+            "name": "amount",
+            "title": "合同金额",
+            "type": "decimal",
+            "length": 15,
+            "dec": 2,
+            "nullable": "yes",
+            "comments": "合同金额"
+        },
+        {
+            "name": "start_date",
+            "title": "开始日期",
+            "type": "date",
+            "nullable": "no",
+            "comments": "合同开始日期"
+        },
+        {
+            "name": "end_date",
+            "title": "结束日期",
+            "type": "date",
+            "nullable": "no",
+            "comments": "合同结束日期"
+        },
+        {
+            "name": "sign_date",
+            "title": "签署日期",
+            "type": "date",
+            "nullable": "yes",
+            "comments": "签署日期"
+        },
+        {
+            "name": "owner_id",
+            "title": "负责人",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "合同负责人，引用users表的id"
+        },
+        {
+            "name": "org_id",
+            "title": "所属组织",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "所属组织，引用organization表的id"
+        },
+        {
+            "name": "ai_compliance_result",
+            "title": "合规检查结果",
+            "type": "text",
+            "nullable": "yes",
+            "comments": "AI合规检查结果"
+        },
+        {
+            "name": "ai_key_dates",
+            "title": "关键时点",
+            "type": "text",
+            "nullable": "yes",
+            "comments": "AI提取的关键时点JSON数据"
+        },
+        {
+            "name": "created_at",
+            "title": "创建时间",
+            "type": "timestamp",
+            "nullable": "no",
+            "comments": "创建时间"
+        },
+        {
+            "name": "updated_at",
+            "title": "更新时间",
+            "type": "timestamp",
+            "nullable": "no",
+            "comments": "更新时间"
+        }
+    ],
+    "indexes": [
+        {
+            "name": "idx_contract_number",
+            "idxtype": "unique",
+            "idxfields": ["contract_number"]
+        },
+        {
+            "name": "idx_contract_org",
+            "idxtype": "index",
+            "idxfields": ["org_id"]
+        },
+        {
+            "name": "idx_contract_status",
+            "idxtype": "index", 
+            "idxfields": ["status"]
+        }
+    ],
+    "codes": [
+        {
+            "field": "contract_type",
+            "table": "appcodes",
+            "valuefield": "id",
+            "textfield": "name",
+            "cond": "id='CONTRACT_TYPE'"
+        },
+        {
+            "field": "owner_id",
+            "table": "users",
+            "valuefield": "id",
+            "textfield": "username"
+        }
+    ]
+}

models/contract_ai_config.json

@@ -0,0 +1,64 @@
+{
+    "summary": [
+        {
+            "name": "contract_ai_config",
+            "title": "AI配置表",
+            "primary": "id"
+        }
+    ],
+    "fields": [
+        {
+            "name": "id",
+            "title": "配置ID",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "AI配置ID"
+        },
+        {
+            "name": "ai_service_url",
+            "title": "AI服务URL",
+            "type": "str",
+            "length": 500,
+            "nullable": "no",
+            "comments": "AI服务URL地址"
+        },
+        {
+            "name": "api_key",
+            "title": "API密钥",
+            "type": "str",
+            "length": 255,
+            "nullable": "no",
+            "comments": "API密钥"
+        },
+        {
+            "name": "org_id",
+            "title": "所属组织",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "所属组织"
+        },
+        {
+            "name": "created_at",
+            "title": "创建时间",
+            "type": "timestamp",
+            "nullable": "no",
+            "comments": "创建时间"
+        },
+        {
+            "name": "updated_at",
+            "title": "更新时间",
+            "type": "timestamp",
+            "nullable": "no",
+            "comments": "更新时间"
+        }
+    ],
+    "indexes": [
+        {
+            "name": "idx_ai_config_org",
+            "idxtype": "unique",
+            "idxfields": ["org_id"]
+        }
+    ]
+}

models/contract_attachment.json

@@ -0,0 +1,122 @@
+{
+    "summary": [
+        {
+            "name": "contract_attachment",
+            "title": "合同附件表",
+            "primary": "id"
+        }
+    ],
+    "fields": [
+        {
+            "name": "id",
+            "title": "附件ID",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "附件ID，主键"
+        },
+        {
+            "name": "contract_id",
+            "title": "合同ID",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "关联的合同ID，引用contract表的id"
+        },
+        {
+            "name": "file_name",
+            "title": "文件名",
+            "type": "str",
+            "length": 255,
+            "nullable": "no",
+            "comments": "文件名"
+        },
+        {
+            "name": "file_path",
+            "title": "文件路径",
+            "type": "str",
+            "length": 500,
+            "nullable": "no",
+            "comments": "文件存储路径"
+        },
+        {
+            "name": "file_size",
+            "title": "文件大小",
+            "type": "long",
+            "nullable": "no",
+            "comments": "文件大小（字节）"
+        },
+        {
+            "name": "file_type",
+            "title": "文件类型",
+            "type": "str",
+            "length": 50,
+            "nullable": "no",
+            "comments": "文件类型（MIME类型）"
+        },
+        {
+            "name": "version",
+            "title": "版本号",
+            "type": "long",
+            "nullable": "no",
+            "default": "1",
+            "comments": "文件版本号"
+        },
+        {
+            "name": "description",
+            "title": "附件描述",
+            "type": "str",
+            "length": 200,
+            "nullable": "yes",
+            "comments": "附件描述"
+        },
+        {
+            "name": "uploaded_by",
+            "title": "上传人",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "上传人，引用users表的id"
+        },
+        {
+            "name": "org_id",
+            "title": "所属组织",
+            "type": "str",
+            "length": 32,
+            "nullable": "no",
+            "comments": "所属组织"
+        },
+        {
+            "name": "created_at",
+            "title": "上传时间",
+            "type": "timestamp",
+            "nullable": "no",
+            "comments": "上传时间"
+        }
+    ],
+    "indexes": [
+        {
+            "name": "idx_attachment_contract",
+            "idxtype": "index",
+            "idxfields": ["contract_id"]
+        },
+        {
+            "name": "idx_attachment_org",
+            "idxtype": "index",
+            "idxfields": ["org_id"]
+        },
+        {
+            "name": "idx_attachment_version",
+            "idxtype": "index",
+            "idxfields": ["file_name", "version"]
+        }
+    ],
+    "codes": [
+        {
+            "field": "uploaded_by",
+            "table": "users",
+            "valuefield": "id",
+            "textfield": "username"
+        }
+    ]
+}

pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "contract_management"
+version = "1.0.0"
+description = "Enterprise contract management module with AI integration"
+authors = [{name = "Hermes Agent", email = "hermes@example.com"}]
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+]
+dependencies = [
+    "appbase",
+    "rbac", 
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "black", "flake8"]

skill/SKILL.md

@@ -0,0 +1,133 @@
+---
+name: contract-management-module
+version: 1.0.0
+description: Enterprise contract management module with AI-powered version comparison, compliance checking, and key date extraction, integrated with appbase and rbac modules.
+author: Hermes Agent
+license: MIT
+---
+
+# Contract Management Module
+
+## Overview
+This module provides comprehensive enterprise contract management capabilities with advanced AI integration. It manages contract information, attachments, and leverages AI services for intelligent contract analysis including version comparison, compliance checking, and key date extraction.
+
+The module integrates seamlessly with the existing `appbase` (for code management) and `rbac` (for user/role-based access control) foundation modules, following the standard module development specification.
+
+## Directory Structure
+```
+contract_management/
+├── contract_management/        # Python package
+│   ├── __init__.py            # Python package marker
+│   ├── init.py                # Module initialization (load_contract_management)
+│   ├── contract_core.py       # Core contract management logic
+│   ├── attachment_core.py     # Contract attachment management
+│   ├── ai_core.py             # AI service integration
+│   └── ai_config_core.py      # AI configuration management
+├── wwwroot/                   # Frontend resources
+│   ├── contract_list.ui       # Contract list view
+│   ├── contract_edit.ui       # Contract creation/edit view
+│   ├── contract_detail.ui     # Contract detail view
+│   └── ai_config.ui           # AI service configuration
+├── models/                    # Database table definitions
+│   ├── contract.json          # Contract main table
+│   ├── contract_attachment.json # Contract attachments table
+│   └── contract_ai_config.json # AI configuration table
+├── json/                      # CRUD operation definitions
+│   ├── contract.json          # Contract CRUD
+│   ├── contract_attachment.json # Attachment CRUD
+│   └── contract_ai_config.json # AI config CRUD
+├── init/                      # Initialization data (optional)
+├── skill/                     # Skill documentation
+│   └── SKILL.md               # This skill document
+├── pyproject.toml             # Python packaging
+└── README.md                  # Module documentation
+```
+
+## Core Features
+
+### 1. Contract Information Management
+- Complete contract lifecycle management (create, read, update, delete)
+- Contract metadata including parties, amounts, dates, types, and status
+- Integration with appbase codes for contract type classification
+- RBAC-based access control for multi-tenant security
+
+### 2. Contract Attachment Management  
+- Version-controlled file attachments with automatic versioning
+- Secure file storage with organization isolation
+- File metadata tracking (size, type, upload time, uploader)
+- Attachment browsing and management through CRUD interface
+
+### 3. AI-Powered Contract Analysis
+- **Version Comparison**: Compare different contract versions to identify changes
+- **Compliance Checking**: Analyze contracts for regulatory and policy compliance
+- **Key Date Extraction**: Automatically extract important dates (deadlines, renewals, etc.)
+- Configurable AI service endpoints with API key authentication
+
+## Integration Points
+
+### AppBase Integration
+- Uses `appcodes` table for contract type categorization
+- Leverages appbase's hierarchical code management system
+- Reuses existing encoding patterns for consistency
+
+### RBAC Integration  
+- Implements organization-based data isolation
+- Uses RBAC user/role permissions for access control
+- Integrates with existing authentication flows
+- Supports multi-tenant deployment scenarios
+
+### AI Service Integration
+- Configurable AI service URL per organization
+- Secure API key management with confidential field handling
+- Asynchronous AI processing with error handling
+- Standardized request/response patterns for AI tasks
+
+## Usage Patterns
+
+### Basic Contract Management
+1. Navigate to `contract_list.ui` to view all contracts
+2. Click "新建合同" to create a new contract via `contract_edit.ui`
+3. Select a contract to view details in `contract_detail.ui`
+4. Manage attachments through the subtable interface
+
+### AI Configuration
+1. Access AI configuration through admin interface
+2. Set AI service URL and API key in `ai_config.ui`
+3. Save configuration for organization-wide AI service access
+
+### AI Analysis Execution
+1. Upload contract documents as attachments
+2. Use AI buttons in contract edit/detail views to trigger analysis
+3. View AI results in the dedicated AI analysis section
+4. Results are automatically saved to contract record for future reference
+
+## Security Considerations
+- All data is organization-isolated through `org_id` field
+- API keys are stored as confidential fields with proper masking
+- File uploads are stored in organization-specific directories
+- RBAC permissions control all data access and operations
+- Input validation and sanitization throughout the module
+
+## Performance Optimization
+- Efficient database queries with proper indexing
+- Asynchronous AI processing to avoid blocking UI
+- Pagination for large contract lists
+- Lazy loading of attachment data
+- Caching of AI configuration per organization
+
+## Customization Points
+- Contract type codes can be extended via appbase
+- AI service endpoints can be customized per organization
+- UI templates can be modified for specific business needs
+- Additional AI analysis tasks can be added to ai_core.py
+
+## Verification Checklist
+- [ ] Module loads correctly via `load_contract_management()` function
+- [ ] All CRUD operations function as defined in json/ directory
+- [ ] Frontend renders correctly with bricks-framework components
+- [ ] AI configuration saves and retrieves properly
+- [ ] File attachments upload and version correctly
+- [ ] RBAC permissions enforce proper data access
+- [ ] Appbase codes integrate correctly for contract types
+- [ ] AI service calls handle errors gracefully
+- [ ] Package builds successfully with pyproject.toml

wwwroot/ai_config.ui

@@ -0,0 +1,30 @@
+{
+  "widgettype": "VBox",
+  "options": {
+    "width": "100%",
+    "height": "100%"
+  },
+  "subwidgets": [
+    {
+      "widgettype": "Form",
+      "options": {
+        "title": "AI服务配置",
+        "tblname": "contract_ai_config",
+        "submit_url": "/api/contract/ai_config/save",
+        "width": "100%",
+        "style": {
+          "maxWidth": "800px",
+          "margin": "0 auto"
+        }
+      },
+      "binds": [
+        {
+          "wid": "self",
+          "event": "submited",
+          "actiontype": "script",
+          "script": "await bricks.show_resp_message_or_error(event.params); if (event.params.success) { bricks.app.goto_url('{{entire_url(\"contract_list.ui\")}}'); }"
+        }
+      ]
+    }
+  ]
+}

wwwroot/contract_detail.ui

@@ -0,0 +1,212 @@
+{
+  "widgettype": "VBox",
+  "options": {
+    "width": "100%",
+    "height": "100%"
+  },
+  "subwidgets": [
+    {
+      "widgettype": "HBox",
+      "options": {
+        "width": "100%",
+        "height": "50px"
+      },
+      "subwidgets": [
+        {
+          "widgettype": "Button",
+          "options": {
+            "text": "返回列表",
+            "styleType": "default",
+            "style": {
+              "marginLeft": "20px",
+              "marginTop": "8px"
+            }
+          },
+          "binds": [
+            {
+              "wid": "self",
+              "event": "click",
+              "actiontype": "urlwidget",
+              "target": "body/app",
+              "options": {
+                "url": "{{entire_url('contract_list.ui')}}"
+              }
+            }
+          ]
+        },
+        {
+          "widgettype": "Filler"
+        },
+        {
+          "widgettype": "Button",
+          "options": {
+            "text": "编辑合同",
+            "styleType": "primary",
+            "style": {
+              "marginRight": "20px",
+              "marginTop": "8px"
+            }
+          },
+          "binds": [
+            {
+              "wid": "self",
+              "event": "click",
+              "actiontype": "urlwidget",
+              "target": "body/app",
+              "options": {
+                "url": "{{entire_url('contract_edit.ui')}}",
+                "params": {
+                  "id": "{{params_kw.get('contract_id')}}"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "widgettype": "Filler",
+      "options": {
+        "height": "10px"
+      }
+    },
+    {
+      "widgettype": "Form",
+      "options": {
+        "tblname": "contract",
+        "record_id": "{{params_kw.get('contract_id')}}",
+        "readonly": true,
+        "width": "100%",
+        "style": {
+          "maxWidth": "1200px",
+          "margin": "0 auto"
+        }
+      }
+    },
+    {
+      "widgettype": "Filler",
+      "options": {
+        "height": "20px"
+      }
+    },
+    {
+      "widgettype": "HBox",
+      "options": {
+        "width": "100%",
+        "style": {
+          "maxWidth": "1200px", 
+          "margin": "0 auto"
+        }
+      },
+      "subwidgets": [
+        {
+          "widgettype": "VBox",
+          "options": {
+            "width": "50%"
+          },
+          "subwidgets": [
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "合同附件",
+                "style": {
+                  "fontSize": "18px",
+                  "fontWeight": "600",
+                  "marginBottom": "10px"
+                }
+              }
+            },
+            {
+              "widgettype": "DataGrid",
+              "options": {
+                "tblname": "contract_attachment",
+                "width": "100%",
+                "parent_field": "contract_id",
+                "parent_value": "{{params_kw.get('contract_id')}}"
+              }
+            }
+          ]
+        },
+        {
+          "widgettype": "Filler",
+          "options": {
+            "width": "20px"
+          }
+        },
+        {
+          "widgettype": "VBox",
+          "options": {
+            "width": "50%"
+          },
+          "subwidgets": [
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "AI分析结果",
+                "style": {
+                  "fontSize": "18px",
+                  "fontWeight": "600", 
+                  "marginBottom": "10px"
+                }
+              }
+            },
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "合规检查结果:",
+                "style": {
+                  "fontWeight": "600",
+                  "marginBottom": "5px"
+                }
+              }
+            },
+            {
+              "widgettype": "Text",
+              "options": {
+                "fieldname": "ai_compliance_result",
+                "record_id": "{{params_kw.get('contract_id')}}",
+                "tblname": "contract",
+                "style": {
+                  "whiteSpace": "pre-wrap",
+                  "backgroundColor": "#f8f9fa",
+                  "padding": "10px",
+                  "borderRadius": "4px"
+                }
+              }
+            },
+            {
+              "widgettype": "Filler",
+              "options": {
+                "height": "10px"
+              }
+            },
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "关键时点:",
+                "style": {
+                  "fontWeight": "600",
+                  "marginBottom": "5px"
+                }
+              }
+            },
+            {
+              "widgettype": "Text",
+              "options": {
+                "fieldname": "ai_key_dates", 
+                "record_id": "{{params_kw.get('contract_id')}}",
+                "tblname": "contract",
+                "style": {
+                  "whiteSpace": "pre-wrap",
+                  "backgroundColor": "#f8f9fa",
+                  "padding": "10px",
+                  "borderRadius": "4px"
+                }
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

wwwroot/contract_edit.ui

@@ -0,0 +1,152 @@
+{
+  "widgettype": "VBox",
+  "options": {
+    "width": "100%",
+    "height": "100%"
+  },
+  "subwidgets": [
+    {
+      "widgettype": "Form",
+      "options": {
+        "title": "合同信息",
+        "tblname": "contract",
+        "submit_url": "/api/contract/save",
+        "width": "100%",
+        "style": {
+          "maxWidth": "1200px",
+          "margin": "0 auto"
+        }
+      },
+      "binds": [
+        {
+          "wid": "self",
+          "event": "submited",
+          "actiontype": "script",
+          "script": "await bricks.show_resp_message_or_error(event.params); if (event.params.success) { bricks.app.goto_url('{{entire_url(\"contract_list.ui\")}}'); }"
+        }
+      ]
+    },
+    {
+      "widgettype": "Filler",
+      "options": {
+        "height": "20px"
+      }
+    },
+    {
+      "widgettype": "HBox",
+      "options": {
+        "width": "100%",
+        "style": {
+          "maxWidth": "1200px",
+          "margin": "0 auto"
+        }
+      },
+      "subwidgets": [
+        {
+          "widgettype": "VBox",
+          "options": {
+            "width": "50%"
+          },
+          "subwidgets": [
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "合同附件",
+                "style": {
+                  "fontSize": "18px",
+                  "fontWeight": "600",
+                  "marginBottom": "10px"
+                }
+              }
+            },
+            {
+              "widgettype": "DataGrid",
+              "options": {
+                "tblname": "contract_attachment",
+                "width": "100%",
+                "parent_field": "contract_id",
+                "parent_value": "{{params_kw.get('id') or 'new'}}"
+              }
+            }
+          ]
+        },
+        {
+          "widgettype": "Filler",
+          "options": {
+            "width": "20px"
+          }
+        },
+        {
+          "widgettype": "VBox", 
+          "options": {
+            "width": "50%"
+          },
+          "subwidgets": [
+            {
+              "widgettype": "Text",
+              "options": {
+                "text": "AI分析结果",
+                "style": {
+                  "fontSize": "18px", 
+                  "fontWeight": "600",
+                  "marginBottom": "10px"
+                }
+              }
+            },
+            {
+              "widgettype": "Button",
+              "options": {
+                "text": "执行合规检查",
+                "styleType": "primary",
+                "style": {
+                  "marginBottom": "10px"
+                }
+              },
+              "binds": [
+                {
+                  "wid": "self",
+                  "event": "click", 
+                  "actiontype": "script",
+                  "script": "console.log('AI合规检查功能待实现')"
+                }
+              ]
+            },
+            {
+              "widgettype": "Button",
+              "options": {
+                "text": "提取关键时点", 
+                "styleType": "primary",
+                "style": {
+                  "marginBottom": "10px"
+                }
+              },
+              "binds": [
+                {
+                  "wid": "self",
+                  "event": "click",
+                  "actiontype": "script", 
+                  "script": "console.log('AI关键时点提取功能待实现')"
+                }
+              ]
+            },
+            {
+              "widgettype": "Button",
+              "options": {
+                "text": "版本对比",
+                "styleType": "primary"
+              },
+              "binds": [
+                {
+                  "wid": "self",
+                  "event": "click",
+                  "actiontype": "script",
+                  "script": "console.log('AI版本对比功能待实现')"
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

wwwroot/contract_list.ui

@@ -0,0 +1,84 @@
+{
+  "widgettype": "VBox",
+  "options": {
+    "width": "100%",
+    "height": "100%"
+  },
+  "subwidgets": [
+    {
+      "widgettype": "HBox", 
+      "options": {
+        "width": "100%",
+        "height": "50px"
+      },
+      "subwidgets": [
+        {
+          "widgettype": "Text",
+          "options": {
+            "text": "合同管理",
+            "style": {
+              "fontSize": "24px",
+              "fontWeight": "600",
+              "marginLeft": "20px",
+              "marginTop": "10px"
+            }
+          }
+        },
+        {
+          "widgettype": "Filler"
+        },
+        {
+          "widgettype": "Button",
+          "options": {
+            "text": "新建合同",
+            "styleType": "primary",
+            "style": {
+              "marginRight": "20px",
+              "marginTop": "8px"
+            }
+          },
+          "binds": [
+            {
+              "wid": "self",
+              "event": "click",
+              "actiontype": "urlwidget",
+              "target": "main_content",
+              "options": {
+                "url": "{{entire_url('contract_edit.ui')}}"
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "widgettype": "Filler",
+      "options": {
+        "height": "10px"
+      }
+    },
+    {
+      "id": "main_content",
+      "widgettype": "DataGrid",
+      "options": {
+        "tblname": "contract",
+        "width": "100%",
+        "height": "calc(100% - 70px)"
+      },
+      "binds": [
+        {
+          "wid": "self",
+          "event": "rowSelected",
+          "actiontype": "urlwidget", 
+          "target": "main_content",
+          "options": {
+            "url": "{{entire_url('contract_detail.ui')}}",
+            "params": {
+              "contract_id": "{{params.row.id}}"
+            }
+          }
+        }
+      ]
+    }
+  ]
+}