jira820 0.1.0__tar.gz

jira820-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+      - name: Test
+        run: pytest -q

jira820-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+# 태그(v*) 푸시 또는 GitHub Release 발행 시 PyPI 로 배포.
+# PyPI Trusted Publishing(OIDC) 사용 — API 토큰 불필요.
+on:
+  push:
+    tags: ["v*"]
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi          # PyPI Trusted Publisher 의 'Environment name' 과 일치해야 함
+    permissions:
+      id-token: write          # OIDC 토큰 발급용 (필수)
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

jira820-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+env/
+
+# Test / tooling
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Mock runtime state (JIRA820_PERSIST)
+*.state.json
+state.json
+
+# Editor / OS
+.idea/
+.vscode/
+.DS_Store

jira820-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# 변경 이력
+
+## 0.1.0
+
+첫 릴리스.
+
+- Jira Data Center 8.20.8 의 상태형 mock: REST v2(읽기+쓰기)와 Agile `/rest/agile/1.0/`.
+- 결정적 시드 데이터셋(사용자, Epic → Story/Task/Bug → Sub-task, 코멘트, 워크로그, 버전, activity ATOM,
+  Confluence 페이지). `JIRA820_*` 환경변수 + YAML 로 설정.
+- 쓰기: 이슈 생성/수정/삭제, 전이(resolution + changelog), 코멘트, 워크로그, 담당자.
+- Agile: 시드된 Scrum 보드 + 스프린트(closed/active/future), Kanban 보드 + 컬럼; 스프린트/백로그 이동,
+  스프린트 생성/시작; 칸반 컬럼 이동 = 전이.
+- 확장 JQL, 파일 영속화(`JIRA820_PERSIST`), 읽기전용 모드(`JIRA820_READONLY`), 영어/한국어 로케일.
+- 외부 데이터 주입 훅(`Store(config, seed=False)`, `config.subtask_type`) — 다른 프로젝트의 world 를 주입해
+  이 패키지의 서버로 서빙 가능.

jira820-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dongyi-kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

jira820-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: jira820
+Version: 0.1.0
+Summary: Jira Data Center 8.20.8 을 로컬에서 흉내 내는 상태형 읽기+쓰기 mock 서버 (REST v2 + Agile 보드/스프린트/칸반).
+Project-URL: Homepage, https://github.com/dongyi-kim/jira820
+Project-URL: Issues, https://github.com/dongyi-kim/jira820/issues
+Author: dongyi-kim
+License: MIT
+License-File: LICENSE
+Keywords: agile,fake,jira,jira-data-center,kanban,mock,rest-api,sprint,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Testing :: Mocking
+Requires-Python: >=3.9
+Requires-Dist: fastapi>=0.110
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: uvicorn[standard]>=0.29
+Provides-Extra: test
+Requires-Dist: httpx>=0.27; extra == 'test'
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
+# jira820
+
+**Jira Data Center 8.20.8** 을 로컬에서 흉내 내는 **상태형(stateful) 읽기+쓰기 mock 서버**입니다.
+REST v2 는 물론 Agile(`/rest/agile/1.0/`) API 까지 — **실제 Scrum 스프린트와 Kanban 보드**를 포함합니다.
+결정적으로 생성된 그럴듯한 프로젝트 데이터를 서빙하고 **변경(생성/수정/전이/코멘트/워크로그, 스프린트·백로그
+이동)까지 받아들이므로**, Jira 인스턴스·라이선스·DB 없이 **티켓 뷰어 *및* 작성 클라이언트**를 개발·테스트할 수 있습니다.
+
+```bash
+pip install jira820          # (PyPI 등록 후)
+# 또는 저장소에서 직접:
+pip install "jira820 @ git+https://github.com/dongyi-kim/jira820@v0.1.0"
+
+jira820                       # -> http://127.0.0.1:8080
+```
+
+## 왜 만들었나
+
+Jira **Data Center 는 신규 트라이얼 라이선스 발급이 중단**되어, 개발 대상인 실제 8.20.x 서버를 새로 띄우기가
+현실적으로 어렵습니다(구 Docker 이미지는 있으나 새로 발급 못 받는 DC 라이선스 키가 필요). 기존 목(mock) 도구들도
+이 공백을 못 메웁니다:
+
+| 도구 | 상태 유지 | JQL 평가 | Epic→자식/롤업 | 쓰기 | Agile 보드/스프린트 |
+|------|:---:|:---:|:---:|:---:|:---:|
+| Mockoon / WireMock / MockServer / Prism | ❌ 고정응답 | ❌ | ❌ | ❌ | ❌ |
+| `pycontribs/jira` | — (클라이언트) | — | — | — | — |
+| Atlassian `MockitoContainer` | JVM 내부만 | ❌ | ❌ | ❌ | ❌ |
+| **jira820** | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+정적 목 도구는 고정 응답을 재생할 뿐이고, 이 프로젝트는 **살아있는 관계형·가변 데이터 모델**을 유지합니다.
+
+## 실행
+
+```bash
+pip install -e .                 # 체크아웃에서
+jira820                          # 콘솔 스크립트
+python -m jira820                # 모듈 형태
+
+JIRA820_PORT=9000 JIRA820_LOCALE=ko JIRA820_SEED=7 jira820
+JIRA820_CONFIG=examples/config.yaml jira820
+```
+
+## 설정 (`JIRA820_*` 환경변수 > `JIRA820_CONFIG` YAML > 기본값)
+
+| 변수 | 기본값 | 용도 |
+|---|---|---|
+| `JIRA820_HOST` / `JIRA820_PORT` | `127.0.0.1` / `8080` | 바인드 주소 |
+| `JIRA820_LATENCY_MS` | `0` | 요청당 인위적 지연(캐시/성능 테스트) |
+| `JIRA820_SEED` | `0` | (결정적) 데이터셋 변주 |
+| `JIRA820_DATE` | 오늘 | 모든 상대 날짜의 "오늘" 기준 |
+| `JIRA820_PROJECT_KEY` / `JIRA820_PROJECT_NAME` | `DEMO` / `Demo Project` | 프로젝트 식별 |
+| `JIRA820_LOCALE` | `en` | `en` 또는 `ko` |
+| `JIRA820_SP_FIELD` / `JIRA820_EPIC_LINK_FIELD` / `JIRA820_SPRINT_FIELD` | `customfield_10004/10008/10007` | 커스텀필드 id |
+| `JIRA820_SUBTASK_TYPE` | `Sub-task` | `issuetype.subtask` 판정에 쓰는 서브태스크 타입명 |
+| `JIRA820_SERVER_VERSION` | `8.20.8` | `serverInfo` 버전 |
+| `JIRA820_READONLY` | `false` | 쓰기를 `403` 으로 차단 |
+| `JIRA820_PERSIST` | — | 가변 상태를 JSON 파일로 로드/저장(재시작 간 유지) |
+| `JIRA820_CONFIG` | — | 더 풍부한 커스터마이즈 YAML (`examples/config.yaml` 참고) |
+
+우선순위는 **환경변수 → YAML → 기본값**. 데이터셋은 `(seed, date)` 가 같으면 항상 동일합니다.
+
+## 엔드포인트
+
+**읽기** — `serverInfo`, `myself`, `user`, `field`, `status`, `issuetype`, `priority`, `resolution`,
+`project`(+`/{key}`, `/components`, `/versions`, `/statuses`), `search`(JQL + `fields` 투영 + 페이징),
+`issue/{key}`(`?expand=changelog`), `issue/{key}/comment`, `issue/{key}/worklog`, `issue/{key}/transitions`,
+`issue/createmeta`, `issue/{key}/editmeta`, `activity`(ATOM), `content/search`(Confluence CQL).
+
+**쓰기** — `POST issue`, `PUT issue/{key}`, `DELETE issue/{key}`, `POST issue/{key}/transitions`,
+`POST/PUT/DELETE issue/{key}/comment[/{id}]`, `POST issue/{key}/worklog`, `PUT issue/{key}/assignee`.
+
+**Agile** (`/rest/agile/1.0/`) — `board`(scrum+kanban), `board/{id}`(+`/configuration`, `/issue`, `/backlog`,
+`/sprint`, `/epic`), `epic/{key}/issue`, `sprint/{id}`(+`/issue`), `POST sprint`, `PUT sprint/{id}`(시작/완료),
+`POST sprint/{id}/issue`, `POST backlog/issue`.
+
+전이(transition)는 관대한 오픈 워크플로입니다. *done* 카테고리 상태로 들어가면 resolution 과 `resolutiondate` 가
+세팅되고 changelog 가 기록되며, 벗어나면 해제됩니다. **Kanban 컬럼 이동 = 그 컬럼에 매핑된 상태로의 전이**입니다.
+
+## 클라이언트에서 사용
+
+```python
+import requests
+BASE = "http://127.0.0.1:8080"
+# 생성
+key = requests.post(f"{BASE}/rest/api/2/issue",
+    json={"fields": {"project": {"key": "DEMO"}, "issuetype": {"name": "Task"},
+                     "summary": "무언가 배포"}}).json()["key"]
+# 전이
+t = requests.get(f"{BASE}/rest/api/2/issue/{key}/transitions").json()["transitions"][0]["id"]
+requests.post(f"{BASE}/rest/api/2/issue/{key}/transitions", json={"transition": {"id": t}})
+# 활성 스프린트로 이동
+sid = requests.get(f"{BASE}/rest/agile/1.0/board/1/sprint?state=active").json()["values"][0]["id"]
+requests.post(f"{BASE}/rest/agile/1.0/sprint/{sid}/issue", json={"issues": [key]})
+```
+
+전체 셸 예시는 `examples/curl-examples.sh` 를 보세요.
+
+## 내 데이터 주입(임베드)
+
+```python
+from jira820 import make_app, build_store
+from jira820.config import Config
+from jira820.store import Store
+
+app = make_app()                       # 기본 시드 스토어(ASGI 앱)
+# 또는 외부 데이터 주입: 빈 스토어를 만들고 채워서 넘김
+store = Store(Config(project_key="DL"), seed=False)
+store.issues = my_issues; store.users = my_users; store.reindex()
+app = make_app(store=store)            # 이 패키지의 직렬화기/엔드포인트를 그대로 재사용
+```
+
+## 개발
+
+```bash
+pip install -e ".[test]"
+pytest -q
+```
+
+## PyPI 배포 (Trusted Publishing, 토큰 불필요)
+
+`.github/workflows/publish.yml` 가 태그(`v*`) 푸시 시 **PyPI Trusted Publishing(OIDC)** 로 자동 배포합니다.
+최초 1회 PyPI 에서 Trusted Publisher 를 등록하세요: Project `jira820` / Owner `dongyi-kim` / Repository `jira820`
+/ Workflow `publish.yml` / Environment `pypi`.
+
+## 참고 / 한계
+
+- 쓰기 모델은 관대한 단일 테넌트 인메모리 근사입니다 — 클라이언트 구동엔 훌륭하지만 모든 워크플로/권한 규칙을
+  충실히 재현하진 않습니다.
+- JQL 은 흔한 형태(`=,!=,>=,<=,>,<,IN,~`, `AND`/`OR`, `ORDER BY`, project/assignee/status/statusCategory/type/
+  labels/sprint/날짜범위)를 지원하며, 인식하지 못한 절은 오류 대신 무시합니다.
+- Atlassian 과 무관합니다. "Jira" 는 Atlassian 의 상표이며, 이 프로젝트는 로컬 개발·테스트를 위해 공개 REST 형태만
+  흉내 냅니다.
+
+## 라이선스
+
+MIT — [LICENSE](LICENSE) 참고.

jira820-0.1.0/README.md

@@ -0,0 +1,135 @@
+# jira820
+
+**Jira Data Center 8.20.8** 을 로컬에서 흉내 내는 **상태형(stateful) 읽기+쓰기 mock 서버**입니다.
+REST v2 는 물론 Agile(`/rest/agile/1.0/`) API 까지 — **실제 Scrum 스프린트와 Kanban 보드**를 포함합니다.
+결정적으로 생성된 그럴듯한 프로젝트 데이터를 서빙하고 **변경(생성/수정/전이/코멘트/워크로그, 스프린트·백로그
+이동)까지 받아들이므로**, Jira 인스턴스·라이선스·DB 없이 **티켓 뷰어 *및* 작성 클라이언트**를 개발·테스트할 수 있습니다.
+
+```bash
+pip install jira820          # (PyPI 등록 후)
+# 또는 저장소에서 직접:
+pip install "jira820 @ git+https://github.com/dongyi-kim/jira820@v0.1.0"
+
+jira820                       # -> http://127.0.0.1:8080
+```
+
+## 왜 만들었나
+
+Jira **Data Center 는 신규 트라이얼 라이선스 발급이 중단**되어, 개발 대상인 실제 8.20.x 서버를 새로 띄우기가
+현실적으로 어렵습니다(구 Docker 이미지는 있으나 새로 발급 못 받는 DC 라이선스 키가 필요). 기존 목(mock) 도구들도
+이 공백을 못 메웁니다:
+
+| 도구 | 상태 유지 | JQL 평가 | Epic→자식/롤업 | 쓰기 | Agile 보드/스프린트 |
+|------|:---:|:---:|:---:|:---:|:---:|
+| Mockoon / WireMock / MockServer / Prism | ❌ 고정응답 | ❌ | ❌ | ❌ | ❌ |
+| `pycontribs/jira` | — (클라이언트) | — | — | — | — |
+| Atlassian `MockitoContainer` | JVM 내부만 | ❌ | ❌ | ❌ | ❌ |
+| **jira820** | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+정적 목 도구는 고정 응답을 재생할 뿐이고, 이 프로젝트는 **살아있는 관계형·가변 데이터 모델**을 유지합니다.
+
+## 실행
+
+```bash
+pip install -e .                 # 체크아웃에서
+jira820                          # 콘솔 스크립트
+python -m jira820                # 모듈 형태
+
+JIRA820_PORT=9000 JIRA820_LOCALE=ko JIRA820_SEED=7 jira820
+JIRA820_CONFIG=examples/config.yaml jira820
+```
+
+## 설정 (`JIRA820_*` 환경변수 > `JIRA820_CONFIG` YAML > 기본값)
+
+| 변수 | 기본값 | 용도 |
+|---|---|---|
+| `JIRA820_HOST` / `JIRA820_PORT` | `127.0.0.1` / `8080` | 바인드 주소 |
+| `JIRA820_LATENCY_MS` | `0` | 요청당 인위적 지연(캐시/성능 테스트) |
+| `JIRA820_SEED` | `0` | (결정적) 데이터셋 변주 |
+| `JIRA820_DATE` | 오늘 | 모든 상대 날짜의 "오늘" 기준 |
+| `JIRA820_PROJECT_KEY` / `JIRA820_PROJECT_NAME` | `DEMO` / `Demo Project` | 프로젝트 식별 |
+| `JIRA820_LOCALE` | `en` | `en` 또는 `ko` |
+| `JIRA820_SP_FIELD` / `JIRA820_EPIC_LINK_FIELD` / `JIRA820_SPRINT_FIELD` | `customfield_10004/10008/10007` | 커스텀필드 id |
+| `JIRA820_SUBTASK_TYPE` | `Sub-task` | `issuetype.subtask` 판정에 쓰는 서브태스크 타입명 |
+| `JIRA820_SERVER_VERSION` | `8.20.8` | `serverInfo` 버전 |
+| `JIRA820_READONLY` | `false` | 쓰기를 `403` 으로 차단 |
+| `JIRA820_PERSIST` | — | 가변 상태를 JSON 파일로 로드/저장(재시작 간 유지) |
+| `JIRA820_CONFIG` | — | 더 풍부한 커스터마이즈 YAML (`examples/config.yaml` 참고) |
+
+우선순위는 **환경변수 → YAML → 기본값**. 데이터셋은 `(seed, date)` 가 같으면 항상 동일합니다.
+
+## 엔드포인트
+
+**읽기** — `serverInfo`, `myself`, `user`, `field`, `status`, `issuetype`, `priority`, `resolution`,
+`project`(+`/{key}`, `/components`, `/versions`, `/statuses`), `search`(JQL + `fields` 투영 + 페이징),
+`issue/{key}`(`?expand=changelog`), `issue/{key}/comment`, `issue/{key}/worklog`, `issue/{key}/transitions`,
+`issue/createmeta`, `issue/{key}/editmeta`, `activity`(ATOM), `content/search`(Confluence CQL).
+
+**쓰기** — `POST issue`, `PUT issue/{key}`, `DELETE issue/{key}`, `POST issue/{key}/transitions`,
+`POST/PUT/DELETE issue/{key}/comment[/{id}]`, `POST issue/{key}/worklog`, `PUT issue/{key}/assignee`.
+
+**Agile** (`/rest/agile/1.0/`) — `board`(scrum+kanban), `board/{id}`(+`/configuration`, `/issue`, `/backlog`,
+`/sprint`, `/epic`), `epic/{key}/issue`, `sprint/{id}`(+`/issue`), `POST sprint`, `PUT sprint/{id}`(시작/완료),
+`POST sprint/{id}/issue`, `POST backlog/issue`.
+
+전이(transition)는 관대한 오픈 워크플로입니다. *done* 카테고리 상태로 들어가면 resolution 과 `resolutiondate` 가
+세팅되고 changelog 가 기록되며, 벗어나면 해제됩니다. **Kanban 컬럼 이동 = 그 컬럼에 매핑된 상태로의 전이**입니다.
+
+## 클라이언트에서 사용
+
+```python
+import requests
+BASE = "http://127.0.0.1:8080"
+# 생성
+key = requests.post(f"{BASE}/rest/api/2/issue",
+    json={"fields": {"project": {"key": "DEMO"}, "issuetype": {"name": "Task"},
+                     "summary": "무언가 배포"}}).json()["key"]
+# 전이
+t = requests.get(f"{BASE}/rest/api/2/issue/{key}/transitions").json()["transitions"][0]["id"]
+requests.post(f"{BASE}/rest/api/2/issue/{key}/transitions", json={"transition": {"id": t}})
+# 활성 스프린트로 이동
+sid = requests.get(f"{BASE}/rest/agile/1.0/board/1/sprint?state=active").json()["values"][0]["id"]
+requests.post(f"{BASE}/rest/agile/1.0/sprint/{sid}/issue", json={"issues": [key]})
+```
+
+전체 셸 예시는 `examples/curl-examples.sh` 를 보세요.
+
+## 내 데이터 주입(임베드)
+
+```python
+from jira820 import make_app, build_store
+from jira820.config import Config
+from jira820.store import Store
+
+app = make_app()                       # 기본 시드 스토어(ASGI 앱)
+# 또는 외부 데이터 주입: 빈 스토어를 만들고 채워서 넘김
+store = Store(Config(project_key="DL"), seed=False)
+store.issues = my_issues; store.users = my_users; store.reindex()
+app = make_app(store=store)            # 이 패키지의 직렬화기/엔드포인트를 그대로 재사용
+```
+
+## 개발
+
+```bash
+pip install -e ".[test]"
+pytest -q
+```
+
+## PyPI 배포 (Trusted Publishing, 토큰 불필요)
+
+`.github/workflows/publish.yml` 가 태그(`v*`) 푸시 시 **PyPI Trusted Publishing(OIDC)** 로 자동 배포합니다.
+최초 1회 PyPI 에서 Trusted Publisher 를 등록하세요: Project `jira820` / Owner `dongyi-kim` / Repository `jira820`
+/ Workflow `publish.yml` / Environment `pypi`.
+
+## 참고 / 한계
+
+- 쓰기 모델은 관대한 단일 테넌트 인메모리 근사입니다 — 클라이언트 구동엔 훌륭하지만 모든 워크플로/권한 규칙을
+  충실히 재현하진 않습니다.
+- JQL 은 흔한 형태(`=,!=,>=,<=,>,<,IN,~`, `AND`/`OR`, `ORDER BY`, project/assignee/status/statusCategory/type/
+  labels/sprint/날짜범위)를 지원하며, 인식하지 못한 절은 오류 대신 무시합니다.
+- Atlassian 과 무관합니다. "Jira" 는 Atlassian 의 상표이며, 이 프로젝트는 로컬 개발·테스트를 위해 공개 REST 형태만
+  흉내 냅니다.
+
+## 라이선스
+
+MIT — [LICENSE](LICENSE) 참고.

jira820-0.1.0/examples/config.yaml

@@ -0,0 +1,55 @@
+# Example jira820 config.  Point at it with JIRA820_CONFIG=examples/config.yaml
+# Any JIRA820_* environment variable overrides the matching key here.
+
+# --- server ---
+host: 127.0.0.1
+port: 8080
+latency_ms: 0          # inject artificial latency per request (cache/perf testing)
+
+# --- dataset identity & determinism ---
+seed: "0"              # change to get a different (but still deterministic) dataset
+date: 2026-01-15       # "today" anchor for all relative dates (reproducible)
+project_key: DEMO
+project_name: Demo Project
+server_version: 8.20.8
+locale: en             # en | ko
+
+# --- custom field ids (match what your client expects) ---
+sp_field: customfield_10004
+epic_link_field: customfield_10008
+sprint_field: customfield_10007
+subtask_type: Sub-task   # issue-type name treated as a sub-task (issuetype.subtask=true)
+
+# --- behaviour ---
+readonly: false        # set true to reject all writes with 403
+# persist: state.json  # uncomment to load/save mutable state to a file across restarts
+
+# --- dataset shape ---
+modules: [Web, API, Mobile, Payments, Platform, Infra]
+components_extra: [Support]
+users_per_module: 3
+
+# volume knobs
+epics_per_module: 3
+children_per_epic: [4, 9]
+standalone_per_module: 10
+history_per_module: 12
+sprints_per_scrum_board: 5   # a few closed + one active + a couple future
+
+# workflow (statusName, category[todo|inprogress|done], numeric id)
+statuses:
+  - [Open, todo, "1"]
+  - [In Progress, inprogress, "3"]
+  - [In Review, inprogress, "10001"]
+  - [Done, done, "10002"]
+  - [Reopened, todo, "4"]
+
+# issue types (name, numeric id).  A type literally named "Sub-task" is treated as a subtask.
+issue_types:
+  - [Bug, "1"]
+  - [Epic, "2"]
+  - [Improvement, "3"]
+  - [New Feature, "4"]
+  - [Story, "5"]
+  - [Task, "6"]
+  - [Sub-task, "7"]

jira820-0.1.0/examples/curl-examples.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Example requests against a running jira820 (default http://127.0.0.1:8080).
+set -euo pipefail
+BASE=${BASE:-http://127.0.0.1:8080}
+PK=${PK:-DEMO}
+
+echo "# server info"
+curl -s "$BASE/rest/api/2/serverInfo" | python -m json.tool
+
+echo "# search (JQL) with field projection + paging"
+curl -s "$BASE/rest/api/2/search?jql=project=$PK%20ORDER%20BY%20updated%20DESC&maxResults=3&fields=summary,status,assignee" | python -m json.tool
+
+echo "# one issue with changelog"
+curl -s "$BASE/rest/api/2/issue/$PK-1?expand=changelog" | python -m json.tool
+
+echo "# agile: boards (scrum + kanban)"
+curl -s "$BASE/rest/agile/1.0/board" | python -m json.tool
+
+echo "# agile: kanban board columns"
+curl -s "$BASE/rest/agile/1.0/board/2/configuration" | python -m json.tool
+
+echo "# --- WRITE: create an issue ---"
+KEY=$(curl -s -X POST "$BASE/rest/api/2/issue" -H 'Content-Type: application/json' \
+  -d "{\"fields\":{\"project\":{\"key\":\"$PK\"},\"issuetype\":{\"name\":\"Task\"},\"summary\":\"created via curl\"}}" \
+  | python -c "import sys,json;print(json.load(sys.stdin)['key'])")
+echo "created $KEY"
+
+echo "# available transitions, then move to first one"
+TID=$(curl -s "$BASE/rest/api/2/issue/$KEY/transitions" | python -c "import sys,json;print(json.load(sys.stdin)['transitions'][0]['id'])")
+curl -s -X POST "$BASE/rest/api/2/issue/$KEY/transitions" -H 'Content-Type: application/json' -d "{\"transition\":{\"id\":\"$TID\"}}"
+echo "transitioned $KEY via $TID"
+
+echo "# add a comment + worklog"
+curl -s -X POST "$BASE/rest/api/2/issue/$KEY/comment" -H 'Content-Type: application/json' -d '{"body":"nice"}' >/dev/null
+curl -s -X POST "$BASE/rest/api/2/issue/$KEY/worklog" -H 'Content-Type: application/json' -d '{"timeSpentSeconds":3600}' >/dev/null
+
+echo "# move it into the active sprint (board 1)"
+SID=$(curl -s "$BASE/rest/agile/1.0/board/1/sprint?state=active" | python -c "import sys,json;print(json.load(sys.stdin)['values'][0]['id'])")
+curl -s -X POST "$BASE/rest/agile/1.0/sprint/$SID/issue" -H 'Content-Type: application/json' -d "{\"issues\":[\"$KEY\"]}"
+echo "moved $KEY into sprint $SID"

jira820-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "jira820"
+version = "0.1.0"
+description = "Jira Data Center 8.20.8 을 로컬에서 흉내 내는 상태형 읽기+쓰기 mock 서버 (REST v2 + Agile 보드/스프린트/칸반)."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "dongyi-kim" }]
+keywords = ["jira", "mock", "fake", "testing", "jira-data-center", "rest-api", "agile", "sprint", "kanban"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Testing :: Mocking",
+]
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.29",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7", "httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://github.com/dongyi-kim/jira820"
+Issues = "https://github.com/dongyi-kim/jira820/issues"
+
+[project.scripts]
+jira820 = "jira820.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/jira820"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

jira820-0.1.0/src/jira820/__init__.py

@@ -0,0 +1,14 @@
+"""jira-dc-8.20-mock: a stateful, read+write mock of Jira Data Center 8.20.8.
+
+Public API:
+    make_app(store=None, config=None) -> FastAPI     # build the ASGI app
+    build_store(config=None) -> Store                # build/seed a data store
+    load_config() -> Config                          # read JIRA820_* env + YAML
+"""
+
+from .config import Config, load_config
+from .server import build_store, make_app
+from .store import JiraError, Store
+
+__version__ = "0.1.0"
+__all__ = ["make_app", "build_store", "load_config", "Config", "Store", "JiraError", "__version__"]

jira820-0.1.0/src/jira820/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

jira820-0.1.0/src/jira820/agile.py

@@ -0,0 +1,77 @@
+"""Agile board read-model: which issues belong to a board, its backlog, sprints, epics, columns.
+
+Boards filter on the project. Scrum backlog = board issues not in an active/future sprint.
+Kanban board issues = all non-subtask issues; columns map to statuses (see workflow.kanban_columns).
+"""
+
+from __future__ import annotations
+
+
+def _board_issue_keys(store, board_id: int) -> list:
+    board = store.boards.get(board_id)
+    if not board:
+        return []
+    pk = board["projectKey"]
+    keys = [k for k, it in store.issues.items()
+            if it["project"] == pk and it["type"] not in ("Epic", "Sub-task")]
+    keys.sort()
+    return keys
+
+
+def board_issue_keys(store, board_id: int) -> list:
+    return _board_issue_keys(store, board_id)
+
+
+def backlog_keys(store, board_id: int) -> list:
+    """Issues not currently in an active/future sprint (and not done)."""
+    active_future = {s["id"] for s in store.sprints.values()
+                     if s["boardId"] == board_id and s["state"] in ("active", "future")}
+    out = []
+    for k in _board_issue_keys(store, board_id):
+        it = store.issues[k]
+        in_open_sprint = any(sid in active_future for sid in it.get("sprints", []))
+        if not in_open_sprint and it["statusCategory"] != "done":
+            out.append(k)
+    return out
+
+
+def board_sprint_ids(store, board_id: int) -> list:
+    ids = [sid for sid, s in store.sprints.items() if s["boardId"] == board_id]
+    ids.sort()
+    return ids
+
+
+def board_epic_keys(store, board_id: int) -> list:
+    board = store.boards.get(board_id)
+    if not board:
+        return []
+    pk = board["projectKey"]
+    return sorted(k for k, it in store.issues.items() if it["project"] == pk and it["type"] == "Epic")
+
+
+def sprint_issue_keys(store, sid: int) -> list:
+    return sorted(k for k, it in store.issues.items() if sid in it.get("sprints", []))
+
+
+def board_json(store, board_id: int, base_url: str) -> dict:
+    b = store.boards[board_id]
+    return {"id": b["id"], "self": f"{base_url}/rest/agile/1.0/board/{b['id']}",
+            "name": b["name"], "type": b["type"],
+            "location": {"projectKey": b["projectKey"], "projectName": store.config.project_name,
+                         "projectTypeKey": "software"}}
+
+
+def board_configuration(store, board_id: int, base_url: str) -> dict:
+    b = store.boards[board_id]
+    ser = store.serializer
+    columns = store.workflow.kanban_columns(ser)
+    return {
+        "id": b["id"], "name": b["name"], "type": b["type"],
+        "self": f"{base_url}/rest/agile/1.0/board/{b['id']}/configuration",
+        "location": {"type": "project", "key": b["projectKey"]},
+        "filter": {"id": str(b["filterId"]), "self": f"{base_url}/rest/api/2/filter/{b['filterId']}"},
+        "columnConfig": {"constraintType": "issueCount", "columns": columns},
+        "estimation": {"type": "field",
+                       "field": {"fieldId": store.config.sp_field, "displayName": "Story Points"}},
+        "ranking": {"rankCustomFieldId": 10005},
+    }