Activiti

활동

홈페이지: http://activiti.org

Activiti는 비즈니스맨, 개발자 및 시스템 관리자를 대상으로 하는 경량 워크플로 및 비즈니스 프로세스 관리(BPM) 플랫폼입니다. 그 핵심은 Java용 초고속의 견고한 BPMN 2 프로세스 엔진입니다. 오픈 소스이며 Apache 라이센스에 따라 배포됩니다. Activiti는 서버, 클러스터 또는 클라우드의 모든 Java 애플리케이션에서 실행됩니다. 이는 Spring과 완벽하게 통합되며 매우 가볍고 간단한 개념을 기반으로 합니다.

* *참고: 프로젝트의 다음 주요 버전을 설계하고 코딩하는 데 사용했던 개발 브랜치의 모든 콘텐츠를 마스터 브랜치로 이동했습니다. 버전 6.x에 기여하려면 6.x 브랜치를 살펴보세요.**

리포지토리 구조에 대해 더 자세히 알고 싶다면 GitBook을 읽어보세요.

IntelliJ 구성

• 최신 Java 버전에서만 사용할 수 있는 기능을 (실수로) 사용할 때 언어 레벨 21을 강제로 빠른 속도로 실행합니다.

  • 메뉴 파일 열기, 메뉴 항목 프로젝트 구조
  • 목록 항목 Modules 를 클릭하고, 각 모듈에 대해 Sources 탭을 클릭하고, 콤보박스 언어 수준이 자동으로 21 ...

• 다음 실행/디버그에서 일부 리소스의 변경 사항이 무시되는 것을 피하세요(그리고 mvn을 사용해야 합니다).

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 클릭 Compiler , textfield 리소스 패턴 : !?*.java 로 변경(다른 콘텐츠 제거)

• 빌드 시 StackOverflowError 방지

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 컴파일러 , 트리 항목 Java 컴파일러 , 텍스트 필드 추가 명령줄 매개변수를 클릭합니다.
  • -J-Xss1024k 추가

• 권장 코드 스타일: editorconfig와 함께 Google Java 스타일 가이드를 사용하세요.

  • [https://google.github.io/styleguide/intellij-java-google-style.xml]에서 IntelliJ 코드 스타일 xml을 다운로드하세요.
  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 Code Style을 클릭하고 톱니바퀴를 클릭한 후 Import Scheme을 선택한 다음 IntelliJ 코드 스타일 xml을 선택합니다.
  • xml을 다운로드한 위치를 찾아 엽니다. GoogleStyle이 활성 구성표인지 확인하세요.
    • 참고: IntelliJ IDEA는 코드 형식을 자동으로 지정하지 않습니다. 코딩이 완료되면 자동 서식 지정을 실행하려면 Ctrl+Alt+L 키보드 조합을 눌러야 합니다.
  • 들여쓰기, 파일 인코딩, 줄 끝을 정의하는 .editorconfig 가 있습니다.
  • 비활성화하는 경우 파일 인코딩과 공백 수를 수동으로 올바르게 설정해야 합니다.
  • Eclipse 코드 스타일 xml: [https://google.github.io/styleguide/eclipse-java-google-style.xml]
  • Eclipse에는 EditorConfig 파일을 지원하려면 editorconfig-eclipse 플러그인이 필요합니다.

• 올바른 파일 인코딩(속성 파일을 제외한 UTF-8) 및 줄 끝 문자(unix)를 수동으로 설정합니다.

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 코드 스타일 , 트리 항목 일반을 클릭합니다.
    • 콤보박스 줄 구분 기호(새 파일용) : Unix
  • 트리 항목 파일 인코딩을 클릭하세요.
    • 콤보박스 전역 인코딩 : UTF-8
    • 속성 파일의 콤보박스 기본 인코딩 : ISO-8859-1
      • 참고: 일반 i18n 속성 파일은 Java ResourceBundle 계약에 지정된 대로 ISO-8859-1 에 있어야 합니다.

• 탭을 누를 때 올바른 공백 수를 수동으로 설정하십시오.

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 코드 스타일 , 트리 항목 일반을 클릭합니다.
  • 탭 Java를 클릭하세요.
    • 체크박스 탭 문자 사용 : off
    • 텍스트 필드 탭 크기 : 4
    • 텍스트 필드 들여쓰기 : 4
    • 텍스트 필드 연속 들여쓰기 : 8
  • 열린 탭 XML
    • 체크박스 탭 문자 사용 : off
    • 텍스트 필드 탭 크기 : 2
    • 텍스트 필드 들여쓰기 : 2
    • 텍스트 필드 연속 들여쓰기 : 4

• 올바른 파일 헤더를 설정하십시오(@author 또는 의미 없는 javadoc을 포함하지 마십시오).

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 파일 템플릿 , 탭 포함 , 목록 항목 File Header 클릭합니다.
  • @author Your Name 행을 제거합니다.
    • 소스 파일에는 @author 줄이 허용되지 않습니다. 아래 FAQ를 참조하세요.
  • 자동으로 템플릿화된 데이터는 의미가 없으므로 전체 javadoc을 제거하십시오.

• 올바른 라이선스 헤더를 설정하세요.

  • File 메뉴 항목, Settings 메뉴 항목 또는 IntelliJ IDEA 메뉴 항목, Preferences... 메뉴 항목(Mac인 경우)을 엽니다.
  • 트리 항목 저작권 , 트리 항목 저작권 프로필을 클릭하세요.
    • 저작권 프로필을 가져오려면 가져오기 버튼을 클릭하세요.
    • 파일 선택: Alfresco_Software.xml
  • 트리 항목 클릭 저작권
    • 콤보박스 기본 프로젝트 저작권 : Alfresco Software

FAQ

• 소스 코드에서 @author 줄을 허용하지 않는 이유는 무엇입니까?

  • Java 파일의 작성자 태그는 유지 관리의 악몽이기 때문입니다.

    • 많은 부분이 잘못되었거나 불완전하거나 부정확합니다.
    • 대부분의 경우 원본 작성자만 포함되어 있습니다. 많은 파일이 다른 작성자에 의해 완전히 리팩터링/확장되었습니다.
    • Git은 정확합니다. 이는 올바른 작성자를 찾는 정식 소스입니다.

  • 작성자 태그는 코드 소유권을 촉진하기 때문에 장기적으로 보면 좋지 않습니다.

    • 사람들이 다른 사람이 소유한 것으로 인식되는 작품을 작업하는 경우 다음과 같은 경향이 있습니다.
      • 깨진 모든 것을 고치는 대신, 고치도록 할당된 것만 고치세요.
      • 해당 코드가 제대로 작동하지 않으면 책임을 버립니다.
      • 주인의 발을 밟는 것을 두려워합니다.

  • 저자에 대한 크레딧은 다음과 같습니다.

    • 통계도 포함된 Open Hub를 통해
    • GitHub 웹 인터페이스에서.

개발 명령

라이선스 헤더 추가

필요한 라이센스로 파일 형식을 지정하려면:

mvn license:format

체크스타일

코드 스타일이 모든 규칙을 준수하는지 확인하려면 다음을 수행하세요.

mvn checkstyle:check -DskipCheckstyle=false

대지

Maven 사이트를 생성하려면:

mvn clean site site:stage

사이트는 target/staging/index.html 에 생성됩니다.

CI/CD

GH Action에서 실행 중입니다.

CI에 의해 유효성을 검사할 종속봇 PR의 ​​경우 PR에 "CI"라는 레이블을 추가해야 합니다.

다음 비밀을 설정해야 합니다.

이름	설명
BOT_GITHUB_TOKEN	GH에서 다른 빌드를 출시하기 위한 토큰
BOT_GITHUB_USERNAME	전파 PR을 발행하기 위한 사용자 이름
NEXUS_USERNAME	내부 Maven 저장소 사용자 이름
NEXUS_PASSWORD	내부 Maven 저장소 비밀번호
SLACK_NOTIFICATION_BOT_TOKEN	실패 시 Slack을 알리는 토큰