P6AI

AI 기반 Primavera P6 Professional(독립형 SQLite) 일정 DB 구축 도구입니다.

👥 프로그램에 익숙하지 않은 토목 업계 분들은 여기를 참고하세요: 토목 업계 분들을 위한 안내

P6AI는 구조화된 시공 일정 JSON을 입력받아 완전성 / 비즈니스 / 네트워크(DAG) 검증을 먼저 수행한 뒤, 단일 트랜잭션으로 P6 Professional 독립형의 PPMDBSQLite.db에 직접 반영하며, 자동 백업, 자동 롤백, 기본 키 시퀀스 자동 정렬을 수행합니다. 작성 후 P6를 열고 F9를 누르면 일정 계산이 완료됩니다.

⚠️ 비공식 도구이며 Oracle과 무관한 프로젝트입니다. P6 Professional 독립형(SQLite PMDB)만을 대상으로 합니다.

Features

• 일정 검증: 필드 완전성, WBS 참조, 공기 유효성, 논리 관계 유형, 순환 의존성 감지

• 구조 자체 점검: 쓰기 전에 데이터베이스 테이블/필드가 현재 P6 버전과 호환되는지 확인하여 EPPM DB 오작동 방지

• 안전한 반영: 자동 백업 + 단일 트랜잭션 + 실패 시 전체 롤백 + NEXTKEY 기본 키 시퀀스 정렬

• 버전 대응: P6 Professional 23.12 독립형 실제 테이블 구조를 기준으로 작성(22자리 GUID, EPS 연결 포함)

• 제3자 런타임 의존성 없음(Python 표준 라이브러리만 사용)

Related MCP server: FronyBoard

Quick Start

# 1. 结构自检：确认目标库与本工具兼容
python -m p6ai check --db "C:\Users\<you>\Documents\PPMDBSQLite.db"

# 2. 校验计划 JSON（不写库）
python -m p6ai validate --plan plan.json

# 3. 写入 P6 数据库（自动备份）
python -m p6ai create --plan plan.json --db "C:\Users\<you>\Documents\PPMDBSQLite.db"

# 4. 打开 P6 Professional，打开新项目，按 F9 进度计算

Plan JSON Format

{
  "project_code": "PRJ-2026-001",
  "project_name": "某变电站土建及机电安装工程",
  "start_date": "2026-09-01 08:00:00",
  "calendar_name": "Corporate - Standard Full Time",
  "wbs_tree": [
    { "wbs_code": "WBS.1", "wbs_name": "土建工程", "parent": null },
    { "wbs_code": "WBS.1.1", "wbs_name": "桩基与地基处理", "parent": "WBS.1" }
  ],
  "tasks": [
    { "task_code": "A1010", "task_name": "场地平整及放线", "wbs_code": "WBS.1.1", "duration_days": 5 },
    { "task_code": "A1020", "task_name": "静压管桩施工及检测", "wbs_code": "WBS.1.1", "duration_days": 12.5 }
  ],
  "relationships": [
    { "pred_code": "A1010", "succ_code": "A1020", "type": "PR_FS", "lag_days": 0 }
  ]
}

• 논리 관계 유형: PR_FS / PR_SS / PR_FF / PR_SF

• duration_days는 소수 가능, 반드시 0보다 커야 함

• 전체 네트워크는 반드시 유방향 비순환 그래프(DAG)여야 하며, 순환은 금지

Safety Notes

• 작성 중에는 P6 Professional을 완전히 종료해야 합니다(데이터베이스가 점유된 경우 반영을 거부하고 안내 표시).

• 매번 쓰기 전에 PPMDBSQLite.db.bak_时间戳 백업이 자동 생성됩니다

• 역검증된 테이블 구조를 기반으로 작성되므로, 다른 P6 버전에서는 먼저 check를 실행하세요

MCP 인터페이스(AI 도구)

p6ai는 의존성 없는 MCP 서버를 내장하고 있으며(stdio 전송, Python 표준 라이브러리만 사용), MCP를 지원하는 AI 클라이언트(Claude Desktop, Codex, Cursor 등)에서 직접 호출할 수 있습니다:

서버 시작:

python -m p6ai serve
# 安装后也可直接：p6ai serve

Claude Desktop 설정 예시(claude_desktop_config.json): 기본적이다

{
  "mcpServers": {
    "p6ai": {
      "command": "python",
      "args": ["-m", "p6ai", "serve"],
      "cwd": "C:\\path\\to\\p6ai"
    }
  }
}

Codex CLI 설정 예시(~/.codex/config.toml):

[mcp_servers.p6ai]
command = "python"
args = ["-m", "p6ai", "serve"]
cwd = "C:\\path\\to\\p6ai"

python이 시스템 PATH에 없는 경우 command를 파이썬 인터프리터의 전체 경로로 바꾸세요. AI 클라이언트는 자연어로 이 도구들을 직접 사용할 수 있습니다. 예: "이 계획을 검증해 줘", "이 공사 계획을 P6에 구축해 줘".

지원 환경

• Primavera P6 Professional 23.12(독립형 SQLite, PPMDB,2312.*)

• Python 3.9+

Roadmap

• MCP 서버: AI 클라이언트(Claude / Codex / Cursor)에 검증, DB 구축, 목록, 자체 검사 도구 접근

• XER 내보내기 업데이트, DCMA 품질 검사 통합

• 버전용 스키마 어댑터 계층

License

MIT

Disclaimer

이 도구는 커뮤니티 프로젝트로, Oracle Corporation 및 해당 제품과 어떤 연계도 및 승인도 없습니다. 직접 데이터베이스에 접근하는 방식은 P6 데이터에 위험이 있으므로, 반드시 직접 백업을 하고 테스트 환경에서 검증한 후 사용하시기 바랍니다.