Astryx 학습 경험과 공용 디자인 시스템 구축

Author: eddmpython

.github/workflows/ci.yml

@@ -45,9 +45,39 @@ jobs:
       - name: Run docs gate
         run: uv run python -X utf8 tests/run.py gate docs
 
+      - name: Run architecture boundary gate
+        run: uv run python -X utf8 tests/run.py gate architecture-boundary
+
+      - name: Observe plan quality bootstrap
+        if: matrix.python-version == '3.12'
+        continue-on-error: true
+        run: uv run python -X utf8 tests/run.py gate plan-quality
+
       - name: Run backend gate
         run: uv run python -X utf8 tests/run.py gate backend
 
+      - name: Run learning evidence contract
+        if: matrix.python-version == '3.12'
+        run: uv run python -X utf8 tests/run.py gate learning-evidence-contract
+
+      - name: Verify removed learning concepts
+        if: matrix.python-version == '3.12'
+        run: uv run python -X utf8 tests/run.py gate removed-learning-concepts
+
+      - name: Run learning efficacy report contract
+        if: matrix.python-version == '3.12'
+        run: uv run python -X utf8 tests/run.py gate learning-efficacy-report
+
+      - name: Run curriculum quality matrix
+        if: matrix.python-version == '3.12'
+        timeout-minutes: 20
+        run: uv run python -X utf8 tests/run.py gate curriculum-quality-matrix
+
+      - name: Verify repository simplification
+        if: matrix.python-version == '3.12'
+        timeout-minutes: 10
+        run: uv run python -X utf8 tests/run.py gate repository-simplification
+
       - name: Run widget-bridge gate
         run: uv run python -X utf8 tests/run.py gate widget-bridge
 
@@ -95,11 +125,77 @@ jobs:
 
       - name: Install
         working-directory: landing
-        run: npm install
+        run: npm ci
 
       - name: Build
         run: python -X utf8 tests/run.py gate landing-build
 
+  experience:
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install Python dependencies
+        run: uv sync --extra dev --python 3.12
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: |
+            editor/package-lock.json
+            landing/package-lock.json
+
+      - name: Install editor
+        working-directory: editor
+        run: npm ci
+
+      - name: Install landing
+        working-directory: landing
+        run: npm ci
+
+      - name: Install Chromium
+        timeout-minutes: 15
+        run: uv run --with playwright python -m playwright install --with-deps chromium
+
+      - name: Verify visual assets
+        timeout-minutes: 15
+        run: uv run python -X utf8 tests/run.py gate visual-assets
+
+      - name: Verify Astryx design system
+        timeout-minutes: 15
+        run: uv run python -X utf8 tests/run.py gate design-system-contract
+
+      - name: Verify direct learning method
+        timeout-minutes: 15
+        run: uv run python -X utf8 tests/run.py gate learning-method
+
+      - name: Verify Web learning
+        timeout-minutes: 25
+        run: uv run python -X utf8 tests/run.py gate web-learning
+
+      - name: Verify public landing
+        timeout-minutes: 25
+        run: uv run python -X utf8 tests/run.py gate landing-public
+
+      - name: Verify Local Studio
+        timeout-minutes: 30
+        run: uv run python -X utf8 tests/run.py gate local-studio-browser
+
+      - name: Verify full product experience
+        timeout-minutes: 30
+        run: uv run python -X utf8 tests/run.py gate product-experience-browser
+
   launcher:
     # 다운로드 엔진(타임아웃/재시도/resume mock 테스트)과 provision 경로를 실제 배포 타깃인
     # Windows를 포함한 3개 OS에서 검증한다. "내 로컬은 되는데 다른 환경은 터진다"를 CI에서 막는다.

.github/workflows/pages.yml

@@ -35,9 +35,16 @@ jobs:
 
       - name: Install Editor
         working-directory: editor
-        run: npm install
+        run: npm ci
 
-      - name: Build Editor Web Variant
+      - name: Build Primary Web Run
+        working-directory: editor
+        env:
+          CODARO_WEB_BASE: codaro/run
+          CODARO_WEB_OUT: ../landing/static/run
+        run: npm run build
+
+      - name: Build App Compatibility Tree
         working-directory: editor
         env:
           CODARO_WEB_BASE: codaro/app
@@ -46,7 +53,7 @@ jobs:
 
       - name: Install
         working-directory: landing
-        run: npm install
+        run: npm ci
 
       - name: Build
         working-directory: landing

.github/workflows/product-release.yml

@@ -101,6 +101,10 @@ jobs:
               raise SystemExit("codaro/webBuild/_app/ assets missing from wheel")
           if "codaro/curricula/python/__init__.py" not in names:
               raise SystemExit("codaro/curricula/python/__init__.py missing from wheel")
+          if "codaro/generatedContracts/artifactOwnership.py" not in names:
+              raise SystemExit("generated product contract type missing from wheel")
+          if "codaro/generatedContracts/artifactOwnership.schema.json" not in names:
+              raise SystemExit("generated product contract schema missing from wheel")
           lessonCount = sum(
               1 for name in names
               if name.startswith("codaro/curricula/python/") and name.endswith(".yaml")

.github/workflows/publish.yaml

@@ -105,6 +105,8 @@ jobs:
           required_wheel_entries = {
               "codaro/webBuild/index.html",
               "codaro/curricula/python/__init__.py",
+              "codaro/generatedContracts/artifactOwnership.py",
+              "codaro/generatedContracts/artifactOwnership.schema.json",
           }
           missing = sorted(required_wheel_entries - wheel_names)
           if missing:
@@ -120,6 +122,8 @@ jobs:
               raise SystemExit("sdist missing src/codaro/webBuild/index.html")
           if not any(name.endswith("/src/codaro/curricula/python/__init__.py") for name in sdist_names):
               raise SystemExit("sdist missing built-in curriculum package")
+          if not any(name.endswith("/src/codaro/generatedContracts/artifactOwnership.schema.json") for name in sdist_names):
+              raise SystemExit("sdist missing generated product contract schema")
           PY
 
       - name: Verify wheel install
@@ -166,6 +170,7 @@ jobs:
           assert callable(codaro.main)
           assert (files("codaro") / "webBuild" / "index.html").is_file()
           assert (files("codaro") / "curricula" / "python" / "__init__.py").is_file()
+          assert (files("codaro") / "generatedContracts" / "artifactOwnership.schema.json").is_file()
           assert any((files("codaro") / "curricula" / "python").glob("*.yaml"))
           print(f"codaro {version} uv add resources ok")
           PY

.github/workflows/publish.yml

@@ -105,6 +105,8 @@ jobs:
           required_wheel_entries = {
               "codaro/webBuild/index.html",
               "codaro/curricula/python/__init__.py",
+              "codaro/generatedContracts/artifactOwnership.py",
+              "codaro/generatedContracts/artifactOwnership.schema.json",
           }
           missing = sorted(required_wheel_entries - wheel_names)
           if missing:
@@ -120,6 +122,8 @@ jobs:
               raise SystemExit("sdist missing src/codaro/webBuild/index.html")
           if not any(name.endswith("/src/codaro/curricula/python/__init__.py") for name in sdist_names):
               raise SystemExit("sdist missing built-in curriculum package")
+          if not any(name.endswith("/src/codaro/generatedContracts/artifactOwnership.schema.json") for name in sdist_names):
+              raise SystemExit("sdist missing generated product contract schema")
           PY
 
       - name: Verify wheel install
@@ -166,6 +170,7 @@ jobs:
           assert callable(codaro.main)
           assert (files("codaro") / "webBuild" / "index.html").is_file()
           assert (files("codaro") / "curricula" / "python" / "__init__.py").is_file()
+          assert (files("codaro") / "generatedContracts" / "artifactOwnership.schema.json").is_file()
           assert any((files("codaro") / "curricula" / "python").glob("*.yaml"))
           print(f"codaro {version} uv add resources ok")
           PY

.github/workflows/release-quality.yml

@@ -0,0 +1,94 @@
+name: Release Quality
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  product-release:
+    runs-on: ubuntu-latest
+    timeout-minutes: 120
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Linux launcher dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install Python dependencies
+        run: uv sync --extra dev --python 3.12
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: "npm"
+          cache-dependency-path: |
+            editor/package-lock.json
+            landing/package-lock.json
+
+      - name: Install editor
+        working-directory: editor
+        run: npm ci
+
+      - name: Install landing
+        working-directory: landing
+        run: npm ci
+
+      - name: Install Chromium
+        timeout-minutes: 15
+        run: uv run --with playwright python -m playwright install --with-deps chromium
+
+      - name: Run product release sequence
+        timeout-minutes: 90
+        run: uv run python -X utf8 tests/run.py product-release
+
+      - name: Upload release quality evidence
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: product-release-evidence
+          path: output/test-runner/
+
+  confirmatory-efficacy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install Python dependencies
+        run: uv sync --extra dev --python 3.12
+
+      - name: Verify featured-path E3 evidence
+        run: uv run python -X utf8 tests/run.py gate path-efficacy-confirmatory
+
+      - name: Upload confirmatory evidence report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: path-efficacy-confirmatory
+          path: output/test-runner/path-efficacy-confirmatory/

.gitignore

@@ -17,6 +17,7 @@ CLAUDE.md
 AGENTS.md
 .agents/
 .claude/
+.vscode/
 # Data (available via gh release)
 data/
 
@@ -55,6 +56,16 @@ landing/static/blog/assets/
 landing/static/docs/blog/assets/
 landing/static/app/
 
+# Landing modules generated by npm lifecycle hooks
+/landing/src/lib/generated/curriculum.js
+/landing/src/lib/generated/curriculumLessons/
+/landing/src/lib/generated/docsNav.js
+/landing/src/lib/generated/docsPages/
+/landing/src/lib/generated/posts.js
+/landing/src/lib/generated/searchIndex.js
+/landing/src/lib/generated/visualAssetManifest.js
+/editor/src/lib/generated/visualAssetManifest.ts
+
 # MkDocs build
 site/