117 lines
3.8 KiB
Markdown
117 lines
3.8 KiB
Markdown
---
|
|
name: rpa-validation
|
|
description: "RPA 입력 항목 Validation 학습 스킬. ITSM 프로젝트 소스코드(models.py, routers/)에서 Pydantic 스키마를 파싱하여 모든 입력 항목의 validation 규칙(타입·필수·제약·enum)을 학습하고 DB에 저장한다. 다음 상황에서 반드시 사용: (1) 'validation 학습', 'API 스키마 학습', '입력 규칙 학습'; (2) 'Pydantic 모델 파싱', '소스 분석'; (3) RPA 봇 실행 전 입력 검증 규칙 갱신; (4) 새 라우터/모델 추가 후 재학습; (5) 다시 실행, 업데이트, 보완."
|
|
---
|
|
|
|
# RPA Validation 학습 스킬
|
|
|
|
ITSM 프로젝트 소스코드를 직접 분석하여 모든 입력 항목의 validation 규칙을 학습한다.
|
|
|
|
---
|
|
|
|
## 학습 전략: 소스 기반 정적 분석
|
|
|
|
OpenAPI JSON 대신 **소스코드를 직접 파싱**한다.
|
|
이유: OpenAPI JSON은 일부 validator가 누락되고, 소스 파싱이 더 정확하다.
|
|
|
|
### 학습 대상 파일
|
|
|
|
```
|
|
itsm/models.py ← Pydantic BaseModel (SRCreate, SRStatusUpdate, 등)
|
|
itsm/routers/*.py ← 각 라우터에서 사용하는 스키마 매핑
|
|
```
|
|
|
|
### 파싱 방법
|
|
|
|
`POST /api/rpa/validations/learn` 호출 시 서버가:
|
|
1. `itsm/models.py` AST 파싱
|
|
2. `class XXXCreate(BaseModel)` / `class XXXUpdate(BaseModel)` 클래스 탐색
|
|
3. 각 클래스의 필드 분석:
|
|
|
|
```python
|
|
# 분석 대상 패턴
|
|
class SRCreate(BaseModel):
|
|
sr_type: SRType # Enum → allowed_values 추출
|
|
title: str # required str
|
|
description: Optional[str] = None # optional
|
|
priority: Priority = Priority.MEDIUM # enum + default
|
|
server_id: Optional[int] = None # optional int
|
|
inst_id: int # required int
|
|
assigned_to: Optional[str] = None
|
|
```
|
|
|
|
### 추출되는 규칙 구조
|
|
|
|
```json
|
|
{
|
|
"endpoint": "POST /api/tasks",
|
|
"schema_class": "SRCreate",
|
|
"field_name": "sr_type",
|
|
"field_type": "enum",
|
|
"is_required": true,
|
|
"allowed_values": ["DEPLOY", "RESTART", "LOG", "INQUIRY", "OTHER"],
|
|
"default": null,
|
|
"constraints": {}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 학습 API
|
|
|
|
```
|
|
POST /api/rpa/validations/learn
|
|
Body: { "source_path": "auto", "overwrite": true }
|
|
|
|
응답:
|
|
{
|
|
"learned": 127,
|
|
"schemas": ["SRCreate", "SRStatusUpdate", "InstitutionCreate", ...],
|
|
"endpoints_mapped": 43,
|
|
"errors": []
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 검증 적용
|
|
|
|
RPA 봇이 `POST /api/rpa/execute` 호출 시:
|
|
|
|
```python
|
|
# 내부 검증 흐름
|
|
rules = db.query(RPAValidationRule).filter_by(endpoint="POST /api/tasks")
|
|
for rule in rules:
|
|
field_val = payload.get(rule.field_name)
|
|
if rule.is_required and field_val is None:
|
|
raise RPAValidationError(f"{rule.field_name}: 필수 항목")
|
|
if rule.field_type == "enum" and field_val not in rule.allowed_values:
|
|
raise RPAValidationError(
|
|
f"{rule.field_name}: 허용값 {rule.allowed_values} 중 하나"
|
|
)
|
|
if rule.constraints.get("max_length") and len(str(field_val)) > rule.constraints["max_length"]:
|
|
raise RPAValidationError(f"{rule.field_name}: 최대 {rule.constraints['max_length']}자")
|
|
```
|
|
|
|
---
|
|
|
|
## 주요 학습 대상 스키마
|
|
|
|
| 스키마 | 엔드포인트 | 핵심 필드 |
|
|
|--------|----------|---------|
|
|
| SRCreate | POST /api/tasks | sr_type(enum), title(required), inst_id(required) |
|
|
| SRStatusUpdate | PATCH /api/tasks/{id}/status | status(enum), comment |
|
|
| InstitutionCreate | POST /api/institutions | inst_code, inst_name |
|
|
| ServerCreate | POST /api/servers | server_name, inst_id, server_role |
|
|
| ApprovalCreate | POST /api/approvals | sr_id, result(enum) |
|
|
| IncidentCreate | POST /api/incidents | title, severity(enum), server_id |
|
|
|
|
---
|
|
|
|
## 재학습 트리거 조건
|
|
|
|
- 신규 라우터 추가 후
|
|
- models.py 스키마 변경 후
|
|
- RPA 봇 validation 오류 급증 시
|
|
- 주 1회 자동 재학습 (스케줄러)
|