用途
该技能面向建筑项目中的许可证(Permit)管理,旨在自动化跟踪许可证申请状态、管理文档要求、监控截止日期,并与地方主管部门系统集成。
主要能力
- 许可证申请跟踪
- 文档管理
- 截止日期监控
- 状态通知
- 合规检查
- 续期自动化
数据模型
技能定义了完整的数据模型,包括:
- PermitType(许可证类型):building、electrical、plumbing、mechanical、fire、demolition、excavation、occupancy、environmental、special_use。
- PermitStatus(许可证状态):draft、submitted、under_review、revision_required、approved、issued、active、expired、closed。
- Permit:包含 permit_id、permit_type、jurisdiction、status、application_date、issued_date、expiry_date、description、required_documents、submitted_documents。
- Jurisdiction(管辖区):包含 jurisdiction_id、name、region、country、permit_portal_url、contact_email、contact_phone、typical_review_days。
- RequiredDocument(所需文档):包含 document_id、document_type、description、is_mandatory、format_requirements、template_url。
- SubmittedDocument(已提交文档):包含 document_id、document_type、filename、file_path、submitted_date、version、status、reviewer_comments。
- Inspection(检查):包含 inspection_id、inspection_type、scheduled_date、completed_date、inspector、result、notes、required_corrections。
- Fee(费用):包含 fee_id、fee_type、amount、due_date、paid_date、receipt_number。
- PermitApplication(许可证申请):整合标识、项目引用、申请人、状态、工作范围、文档、检查、费用、时间线等字段,并提供 get_document_status() 与 get_fee_status() 方法。
使用方式
快速检查许可证状态
使用 check_permit_status(permit) 函数可检查许可证状态与即将到来的截止日期,返回 is_valid 与 alerts。alerts 类型包括 expired、expiring_soon、missing_documents。
许可证跟踪引擎
PermitTracker 类提供以下方法:
- add_jurisdiction(jurisdiction):注册管辖区。
- create_application(permit_type, jurisdiction_id, project_name, project_address):创建新申请,并自动加载该许可证类型所需的文档。
- submit_application(application_id):提交申请,检查文档完整性,更新状态为 submitted,记录历史,并根据管辖区 typical_review_days 计算预计决定日期(默认30天)。
- update_status(application_id, new_status, notes, reviewer):更新状态;当状态为 approved 时记录 approval_date;当状态为 issued 时生成 permit_number 并设置 expiry_date(默认365天)。
- add_document(application_id, document_type, filename, file_path):添加文档,自动处理版本号。
- schedule_inspection(application_id, inspection_type, requested_date):安排检查。
- record_inspection_result(application_id, inspection_id, result, notes, corrections):记录检查结果。
截止日期监控
DeadlineMonitor 类基于 PermitTracker 工作,默认阈值:
- expiry:[90, 60, 30, 14, 7] 天
- fee_due:[30, 14, 7, 1] 天
- inspection:[7, 3, 1] 天
check_all_deadlines() 方法遍历所有申请,在到期日等于阈值时生成 expiry_warning 提醒(剩余天数≤14为 high 优先级,否则 medium),并在已过期时生成 expired 提醒。
适用场景
- 建筑项目管理中集中管理多个许可证。
- 跟踪审批进度、文档提交与费用支付状态。
- 监控许可证到期、费用到期与检查安排,提前预警。
- 记录检查结果与所需整改项。
限制
资料中未提供关于收费、价格、平台支持范围、实际集成效果或具体使用步骤的更多信息。文档中提及“would be loaded from database”等注释,表明部分数据在实际使用中需从数据库加载,但资料未提供数据库结构或加载实现。