@litfamily/litcodex 1.0.15 → 1.0.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (120) hide show
  1. package/README-Ko-KR.md +10 -10
  2. package/README.md +10 -10
  3. package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
  4. package/dist/install/generated-skill-payload-hashes.js +101 -40
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  10. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  15. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
  16. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
  17. package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
  18. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
  19. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
  20. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
  21. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
  22. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
  23. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
  24. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
  26. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
  27. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
  28. package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
  29. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
  30. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
  31. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
  32. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
  33. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
  34. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
  35. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
  36. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
  37. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
  38. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
  39. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
  40. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  41. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
  46. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
  47. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
  67. package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
  68. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
  69. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
  70. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
  71. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
  72. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
  73. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
  74. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
  75. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
  76. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
  77. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
  78. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
  79. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
  80. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
  81. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
  82. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
  83. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  84. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
  85. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  86. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
  87. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
  88. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
  89. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
  90. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
  91. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  92. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
  93. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
  94. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
  95. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  96. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  97. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  98. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  99. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
  100. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
  101. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
  102. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
  103. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
  104. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
  105. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
  106. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
  107. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
  108. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
  109. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
  110. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
  111. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  112. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
  113. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  114. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
  115. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
  116. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  117. package/package.json +2 -2
  118. package/readme-assets/badge-version.svg +1 -1
  119. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
  120. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Regular.otf +0 -0
@@ -0,0 +1,183 @@
1
+ ---
2
+ tonality: studio
3
+ title: 지역 농가 브랜드 세 곳의 패키지 디자인 포트폴리오
4
+ date: 2026-10-05
5
+ department: 예시 패키지디자인 스튜디오
6
+ presenter: 예시 디렉터
7
+ notice: 예시 데이터 — 실제 수치로 바꿔 주세요
8
+ ---
9
+
10
+ ---
11
+ layout: cover-split-image
12
+
13
+ # 지역 농가 브랜드 세 곳의 패키지 디자인 포트폴리오
14
+ ---
15
+
16
+ ---
17
+ layout: text-two-column
18
+
19
+ ## 의뢰 배경과 작업 범위
20
+
21
+ - **의뢰 배경**
22
+ (1) 사과·참기름·잡곡을 파는 농가 세 곳, 연 매출 합계 14억 원
23
+ (2) 온라인 판매가 늘었지만 상자와 병이 도매용 그대로라 선물로 고르기 어려웠다
24
+ (3) 택배 파손 반품이 주문의 4.1%로, 포장 구조도 함께 고쳐야 했다
25
+ (4) 농가마다 인쇄소가 달라 같은 지역 상품으로 묶여 보이지 않았다
26
+ - **작업 범위**
27
+ (1) 브랜드 이름 글자와 색 체계, 상자·병·봉투 패키지 11종
28
+ (2) 택배용 완충 구조 설계와 파손 시험
29
+ (3) 상세 페이지 사진 촬영 3회, 농가별 하루씩
30
+ (4) 지역 특산물 매장용 진열대 안내판 3종
31
+ - **조건과 결과**
32
+ (1) 예산 세 곳 합계 6,300만 원, 지역 상생 사업 지원금이 절반
33
+ (2) 기존 포장 단가보다 개당 10% 넘게 오르지 않을 것
34
+ (3) 실제 단가는 평균 6% 올랐고, 반품률은 1.2%로 내려갔다
35
+ (4) 작업 기간 일곱 달, 첫 명절 판매 전에 초도 생산을 마쳤다
36
+ - **소재와 생산**
37
+ (1) 재생 펄프 90% 판지와 콩기름 잉크 2도 인쇄로 통일했다
38
+ (2) 세 농가 물량을 한 인쇄소에 모아 초도 6만 개를 한 번에 찍었다
39
+ (3) 재고는 농가별 창고 대신 지역 농협 물류창고 한 곳에 둔다
40
+ (4) 추가 생산은 농가별로 최소 5천 개부터 주문할 수 있다
41
+ - 주: 농가별 판매 기록과 택배 반품 기록, 2025년 9월-2026년 8월 기준 (예시)
42
+ ---
43
+
44
+ ---
45
+ layout: image-full
46
+
47
+ ## 사과 농가 선물 상자, 겉면과 손잡이 구조
48
+
49
+ ![도 1. 접착제 없이 접어 만드는 5kg 사과 상자, 손잡이 일체형 | 출처: 예시 이미지](assets/example-a.png)
50
+ ---
51
+
52
+ ---
53
+ layout: photo-grid
54
+
55
+ ## 세 농가 패키지의 공통 체계
56
+
57
+ ![도 2. 사과 상자 5kg·10kg | 출처: 예시 이미지](assets/example-a.png)
58
+
59
+ ![도 3. 참기름 병과 2병 세트 상자 | 출처: 예시 이미지](assets/example-b.png)
60
+
61
+ ![도 4. 잡곡 지퍼 봉투 1kg | 출처: 예시 이미지](assets/example-c.png)
62
+
63
+ - 세 농가가 같은 글자 체계와 띠 배치를 쓰고 색만 바꿔, 함께 진열해도 한 지역 상품으로 읽힌다
64
+ ---
65
+
66
+ ---
67
+ layout: section-rail
68
+
69
+ # 출시 1년 판매 성과
70
+ ---
71
+
72
+ ---
73
+ layout: kpi-row
74
+
75
+ ## 패키지 교체 후 1년 판매 지표
76
+
77
+ | 온라인 주문 | 선물 주문 비중 | 파손 반품률 | 재구매율 | 평균 주문 금액 |
78
+ |---|---|---|---|---|
79
+ | 월 1,840건 | 38% | 1.2% | 41% | 4만 6천 원 |
80
+ | 교체 전 월 1,120건 | 교체 전 17% | 교체 전 4.1% | 교체 전 29% | 교체 전 3만 9천 원 |
81
+
82
+ > 교체 전 1년과 교체 후 1년의 월평균 비교 (예시)
83
+
84
+ - 온라인 주문은 64% 늘었고, 선물 주문이 늘어난 몫의 절반을 차지했다
85
+ - 파손 반품이 4.1%에서 1.2%로 줄어 반품 비용이 연 1,900만 원 줄었다
86
+ - 명절 두 번의 선물 주문이 연 주문의 27%를 차지했다
87
+ - 주: 선물 주문은 받는 사람 주소가 주문자와 다른 주문. 자료는 세 농가 온라인 판매 기록과 택배사 반품 기록, 2025년 9월-2026년 8월 (예시)
88
+ ---
89
+
90
+ ---
91
+ layout: chart-insight
92
+
93
+ ## 농가별 월평균 온라인 주문, 교체 전후
94
+
95
+ ::: chart type=bar unit="건"
96
+ | 농가 | 교체 전 (건) | 교체 후 (건) |
97
+ |---|---|---|
98
+ | 사과 농가 | 520 | 860 |
99
+ | 참기름 농가 | 360 | 610 |
100
+ | 잡곡 농가 | 240 | 370 |
101
+ > 농가별 월평균 온라인 주문, 교체 전 1년과 교체 후 1년 (예시 데이터)
102
+ :::
103
+
104
+ - 세 농가 모두 주문이 50% 넘게 늘었다
105
+ - 참기름은 2병 세트가 새로 생기며 증가율이 69%로 가장 높았다
106
+ - 잡곡은 봉투 교체만으로 54% 늘었지만 선물 비중은 12%에 머물렀다
107
+ - 주: 같은 기간 세 농가의 광고비는 월 80만 원 안팎으로 거의 같았다
108
+ ---
109
+
110
+ ---
111
+ layout: comparison
112
+
113
+ ## 기존 도매 포장과 새 패키지 비교
114
+
115
+ :::: columns 1fr 1fr
116
+ ::: col
117
+ - **기존 도매 포장**
118
+ (1) 구성: 농가마다 다른 인쇄소 상자, 이름과 연락처만 인쇄
119
+ (2) 보호: 칸막이 없이 신문지 완충, 반품률 4.1%
120
+ (3) 단가: 사과 5kg 상자 1,450원, 참기름 병 820원
121
+ (4) 판매 채널: 도매 시장과 단골 직거래 위주
122
+ :::
123
+ ::: col
124
+ - **새 패키지**
125
+ (1) 구성: 세 농가 공통 체계, 이름 글자와 산지 지도를 함께 인쇄
126
+ (2) 보호: 접이식 칸막이와 병 고정 홈, 반품률 1.2%
127
+ (3) 단가: 사과 5kg 상자 1,560원, 참기름 병 860원, 평균 6% 상승
128
+ (4) 판매 채널: 온라인 선물 주문과 지역 특산물 매장으로 넓어졌다
129
+ :::
130
+ ::::
131
+
132
+ - 주: 인쇄소 견적서와 농가별 판매 채널 기록(2025-2026년) 기준 (예시)
133
+ ---
134
+
135
+ ---
136
+ layout: image-split
137
+
138
+ ## 재생 판지 선택과 낙하 시험
139
+
140
+ ![도 5. 재생 판지 상자 낙하 시험, 높이 80cm | 출처: 예시 이미지](assets/example-b.png)
141
+
142
+ 출처: 예시 포장 시험소 낙하 시험 성적서, 2025년 7월 (예시)
143
+
144
+ - **소재** 재생 펄프 90% 판지, 인쇄는 콩기름 잉크 2도
145
+ - **시험** 80cm 높이에서 모서리·면 낙하 10회, 사과 손상 0개
146
+ - **비교** 기존 상자는 같은 시험에서 사과 20개 중 3개 손상
147
+ - **무게** 상자 무게 410g으로 기존보다 60g 가볍다
148
+ - **비용** 판지 단가는 7% 비싸지만 신문지 완충재 비용이 없어진다
149
+ ---
150
+
151
+ ---
152
+ layout: timeline
153
+
154
+ ## 작업 단계와 기간, 2025년 3-9월
155
+
156
+ | 시점 | 작업 | 산출물 | 비용 |
157
+ |---|---|---|---|
158
+ | 2025년 3월 | 농가 방문과 판매 기록 분석 | 의뢰 정의서 | 400만 원 |
159
+ | 2025년 4-5월 | 이름 글자, 색 체계, 시안 3안 | 브랜드 체계서 | 1,800만 원 |
160
+ | 2025년 6-7월 | 상자·병·봉투 구조 설계와 낙하 시험 | 구조 도면 11종 | 2,100만 원 |
161
+ | 2025년 8월 | 인쇄 감리와 첫 생산 | 초도 생산 6만 개 | 1,200만 원 |
162
+ | 2025년 9월 | 상세 페이지 사진 촬영 3회 | 사진 240컷 | 800만 원 |
163
+
164
+ 출처: 예시 패키지디자인 스튜디오 작업 기록과 정산서, 2025년 (예시)
165
+
166
+ > 표 1. 작업 단계, 산출물과 비용 (예시)
167
+
168
+ - 일곱 달 동안 세 농가 작업을 함께 진행해 시안과 시험 비용을 나눠 냈다
169
+ - 총비용 6,300만 원 가운데 절반은 지역 상생 사업 지원금으로 충당했다
170
+ ---
171
+
172
+ ---
173
+ layout: closing-summary-list
174
+
175
+ ## 다른 지역 농가 묶음 작업 제안
176
+
177
+ - 같은 지역 농가 여러 곳이 하나의 패키지 체계를 함께 쓰면 비용은 나누고 진열 효과는 커진다
178
+ - 이번 작업은 주문 64% 증가, 파손 반품 4.1% → 1.2%, 포장 단가 6% 상승으로 끝났다
179
+ - 진행 방식: 농가 방문 한 달, 체계와 구조 설계 넉 달, 생산과 촬영 두 달
180
+ - 비용 기준: 농가 세 곳 묶음 6,300만 원 안팎, 농가 수가 늘수록 한 곳당 비용이 준다
181
+ - 다음 단계: 11월 중 희망 지역 농가 대상 설명회, 신청은 예시 디렉터에게 이메일로 받는다
182
+ - 연락처: 예시 패키지디자인 스튜디오, studio@example.kr
183
+ ---
@@ -0,0 +1,176 @@
1
+ ---
2
+ tonality: chalk
3
+ title: Reading a centrifugal pump curve
4
+ date: 2026-10-05
5
+ department: Example Plant Engineering Academy
6
+ presenter: Example Instructor
7
+ notice: Example data — replace with real figures
8
+ ---
9
+
10
+ ---
11
+ layout: cover-numeral
12
+
13
+ # Reading a centrifugal pump curve, plant engineering module
14
+ ---
15
+
16
+ ---
17
+ layout: agenda
18
+
19
+ ## Session goals and order
20
+
21
+ - **The curve and the system** what the head-flow curve says and where the system curve crosses it
22
+ - **Choosing a pump** four steps from duty point to a shortlisted model
23
+ - **Speed and the affinity laws** how a drive changes flow, head and power
24
+ - **Mistakes and exercise** the three most common errors and this week's task
25
+ ---
26
+
27
+ ---
28
+ layout: section-numeral
29
+
30
+ # The curve and the system
31
+ ---
32
+
33
+ ---
34
+ layout: method
35
+
36
+ ## Duty point and system curve
37
+
38
+ H_sys = H_static + k · Q²
39
+
40
+ - **H_sys** head the system needs at flow Q, in metres of liquid
41
+ - **H_static** height difference between suction and delivery levels, 12 m in the example
42
+ - **k** friction coefficient of the pipework, from pipe length, diameter and fittings
43
+ - **Q** flow rate in m³/h; friction head grows with its square
44
+ - **Pump curve** head the pump delivers at each flow, published by the maker at one speed
45
+ - **Duty point** where the pump curve crosses the system curve; the pump runs there whether you like it or not
46
+ - **BEP** best efficiency point, the flow at which the pump wastes least energy
47
+ - **Preferred range** 70-120% of BEP flow; outside it, wear and vibration rise
48
+ - **NPSHr** suction head the pump needs to avoid cavitation, also read from the maker's sheet
49
+ - **NPSHa** suction head the installation provides; keep it at least 1 m above NPSHr
50
+ - **Shut-off head** head at zero flow, the left end of the pump curve
51
+ - Source: Example Plant Engineering Academy course notes, module 2, 2026
52
+ ---
53
+
54
+ ---
55
+ layout: image-split
56
+
57
+ ## Worked example: cooling-water duty at 180 m³/h
58
+
59
+ ![Figure 1. Pump and system curves for the cooling-water loop | Source: example image](assets/example-b.png)
60
+
61
+ - **Need** 180 m³/h against 12 m static head and 1,400 m of 200 mm pipe
62
+ - **System curve** H = 12 + 0.00062 · Q², so 32 m at 180 m³/h
63
+ - **Candidate** model B curve crosses at 184 m³/h and 32.5 m
64
+ - **Efficiency** 81% at the duty point, BEP 83% at 200 m³/h
65
+ - **Position** duty flow is 92% of BEP flow, inside the preferred range
66
+ - **Suction** NPSHa 6.8 m against NPSHr 3.9 m, margin 2.9 m
67
+ - Source: Example cooling-water loop design data and maker curve sheet (example data)
68
+ ---
69
+
70
+ ---
71
+ layout: section-numeral
72
+
73
+ # Choosing a pump
74
+ ---
75
+
76
+ ---
77
+ layout: step-diagram
78
+
79
+ ## Four steps from duty point to shortlist
80
+
81
+ - **1. Fix the duty** Write the flow you need and the head the system needs at that flow
82
+ (1) Example: 180 m³/h at 32 m, from the system curve
83
+ (2) Check: add 5-10% head margin only once, not at every step
84
+ - **2. Screen the curves** Keep models whose curves cross the system curve within 5% of the duty flow
85
+ (1) Example: models A, B and C pass; D crosses at 230 m³/h
86
+ (2) Check: read each curve at the speed you will actually run
87
+ - **3. Check efficiency and range** Keep duty flow between 70% and 120% of each model's BEP flow
88
+ (1) Example: B sits at 92% of BEP, C at 64% and drops out
89
+ (2) Check: compare power at the duty point, not the peak efficiency figure
90
+ - **4. Check suction** Confirm NPSHa exceeds NPSHr by at least 1 m at the duty flow
91
+ (1) Example: B has a 2.9 m margin, A only 0.6 m
92
+ (2) Check: use the lowest tank level and the hottest water temperature
93
+ - Source: Example Plant Engineering Academy selection checklist, version 3
94
+ ---
95
+
96
+ ---
97
+ layout: table-insight
98
+
99
+ ## Candidate pumps at the 180 m³/h duty
100
+
101
+ | Model | Flow at crossing (m³/h) | Head (m) | Efficiency (%) | Share of BEP flow (%) | NPSH margin (m) |
102
+ |---|---|---|---|---|---|
103
+ | A | 178 | 31.8 | 79 | 104 | 0.6 |
104
+ | B | 184 | 32.5 | 81 | 92 | 2.9 |
105
+ | C | 188 | 32.9 | 72 | 64 | 3.4 |
106
+ | D | 230 | 37.0 | 76 | 115 | 2.1 |
107
+ | E | 171 | 31.4 | 77 | 88 | 2.5 |
108
+
109
+ > Table 1. Five candidate pumps read at the duty point (example data)
110
+
111
+ - Model B is the only one that passes all four steps
112
+ - Model A has the best range position but too little suction margin
113
+ - Model D overshoots the duty by 28% and would need throttling all its life
114
+ - Source: Example maker curve sheets, 1,480 rpm, read for this exercise (example data)
115
+ - Note: share of BEP flow is the crossing flow over the model's best efficiency flow
116
+ ---
117
+
118
+ ---
119
+ layout: comparison
120
+
121
+ ## Throttling valve and speed drive at 140 m³/h
122
+
123
+ :::: columns 1fr 1fr
124
+ ::: col
125
+ - **Throttling valve**
126
+ (1) How: close a valve to steepen the system curve until it crosses at 140 m³/h
127
+ (2) Head: the pump climbs its curve to 36 m, 9 m more than the system needs
128
+ (3) Power: 19.5 kW at the shaft, most of the extra head burnt in the valve
129
+ (4) Cost: no new equipment, higher energy bill every hour it runs
130
+ :::
131
+ ::: col
132
+ - **Speed drive**
133
+ (1) How: slow the pump to 1,150 rpm so its curve meets the system curve at 140 m³/h
134
+ (2) Head: 24 m, exactly what the system needs at that flow
135
+ (3) Power: 12.4 kW at the shaft, from the affinity laws (P ∝ n³)
136
+ (4) Cost: a drive at about €6,000, paid back in 14 months at 6,000 hours a year
137
+ :::
138
+ ::::
139
+
140
+ - Source: Example cooling-water loop calculation, electricity at €0.14 per kWh (example data)
141
+ ---
142
+
143
+ ---
144
+ layout: sidebar-note
145
+
146
+ ## Three common curve-reading mistakes
147
+
148
+ - **Stacking safety margins**
149
+ (1) Margins added at flow, head and motor size multiply into an oversized pump
150
+ (2) The pump then runs far left of BEP and wears its bearings early
151
+ - **Reading the curve at the wrong speed**
152
+ (1) Maker sheets are drawn at one speed; a 4-pole motor on 60 Hz runs about 20% faster than on 50 Hz
153
+ (2) Head rises with speed squared, so the duty point moves a long way
154
+ - **Ignoring the lowest tank level**
155
+ (1) NPSHa checked at the normal level can pass while the low level fails
156
+ (2) Cavitation then starts on the first dry week of the year
157
+
158
+ ::: main-box
159
+ Read every value at the duty point and the actual speed: flow, head, efficiency, power and NPSH margin. A pump chosen by its peak efficiency figure alone is usually chosen wrong
160
+
161
+ Example: pump B at 180 m³/h and 1,780 rpm gives 32 m, 78% efficiency, 20 kW and a 2.9 m NPSH margin; the same pump read at 1,480 rpm would look 30% short of head
162
+ :::
163
+ ---
164
+
165
+ ---
166
+ layout: closing-summary-list
167
+
168
+ ## Summary and this week's exercise
169
+
170
+ - The pump always runs where its curve crosses the system curve; selection is choosing where that is
171
+ - Shortlist in four steps: fix the duty, screen curves, check BEP range, check suction margin
172
+ - At part flow, a speed drive saves energy that a throttling valve burns as extra head
173
+ - Exercise: select a pump for 95 m³/h against the attached hot-water loop, using the five supplied curves
174
+ - Submit one page with your system curve, shortlist table and chosen model by Thursday 12:00
175
+ - Next session: parallel pumps and what happens to the duty point when the second pump starts
176
+ ---
@@ -0,0 +1,157 @@
1
+ ---
2
+ tonality: gazette
3
+ title: 예시구 공공 와이파이 확충 사업 9월 진행 보고
4
+ date: 2026-10-05
5
+ department: 예시구 스마트도시과
6
+ presenter: 예시 사업 담당
7
+ notice: 예시 데이터 — 실제 수치로 바꿔 주세요
8
+ ---
9
+
10
+ ---
11
+ layout: cover-index
12
+
13
+ # 예시구 공공 와이파이 확충 사업 9월 진행 보고
14
+ ---
15
+
16
+ ---
17
+ layout: agenda
18
+
19
+ ## 9월 진행 보고 목차
20
+
21
+ - **진행 요약** 설치 실적, 예산 집행, 이번 달 주요 변경
22
+ - **세부 실적** 권역별 설치 현황과 이용 지표
23
+ - **일정과 위험** 남은 일정, 지연 원인, 대응 방안
24
+ - **협조 요청** 10월 중 결정이 필요한 두 가지
25
+ ---
26
+
27
+ ---
28
+ layout: summary-box-list
29
+
30
+ ## 9월 진행 요약과 이번 달 쟁점
31
+
32
+ ::: key-message
33
+ 설치는 계획의 96%로 거의 맞췄으나, 전통시장 2곳의 전기 공사 지연으로 연말 완료가 2주 늦어질 수 있다
34
+ :::
35
+
36
+ - **설치 실적**
37
+ (1) 누적 설치 AP 412대, 계획 430대 대비 96%
38
+ (2) 9월 한 달 설치 58대, 버스 정류장 31곳과 공원 9곳
39
+ (3) 접속 장애 신고 처리 평균 1.8일, 목표 2일 이내
40
+ - **예산 집행**
41
+ (1) 사업비 18억 원 가운데 11억 4천만 원 집행, 63%
42
+ (2) 계획 집행률 65%와 차이는 시장 공사비 미집행분
43
+ - **이번 달 쟁점**
44
+ (1) 시장 2곳 분전반 용량 부족, 한전 증설 신청 후 회신 대기
45
+ (2) 정류장 AP 13대 전원 불안정, 태양광 보조 전원으로 교체 중
46
+ - **협조 요청**
47
+ (1) 시장 임시 전원 설치 예비비 600만 원, 10월 넷째 주 결정
48
+ (2) 상인회 야간 공사 협의 참석과 준공 2주 연장 시 계약 변경 검토
49
+ - 주: 스마트도시과 설치 대장과 예산 집행 내역, 2026년 9월 30일 기준 (예시)
50
+ ---
51
+
52
+ ---
53
+ layout: ledger-table
54
+
55
+ ## 권역별 설치 현황과 이용 지표, 9월 말
56
+
57
+ | 권역 | 계획 AP | 설치 AP | 진척률 | 하루 접속자 | 장애 신고 (9월) |
58
+ |---|---|---|---|---|---|
59
+ | 동부 | 120 | 118 | 98% | 6,200명 | 4건 |
60
+ | 서부 | 110 | 109 | 99% | 5,400명 | 3건 |
61
+ | 남부 | 100 | 96 | 96% | 4,100명 | 7건 |
62
+ | 북부 | 100 | 89 | 89% | 3,300명 | 2건 |
63
+ | 합계 | 430 | 412 | 96% | 1만 9천 명 | 16건 |
64
+
65
+ 출처: 스마트도시과 설치 대장과 접속 관리 시스템, 2026년 9월 (예시)
66
+
67
+ > 표 1. 권역별 설치와 이용 현황, 2026년 9월 30일 기준 (예시 데이터)
68
+
69
+ - 북부 권역 진척률이 89%로 가장 낮고, 미설치 11대 중 8대가 전통시장 두 곳에 있다
70
+ - 남부 권역은 장애 신고 7건 가운데 5건이 정류장 전원 문제였다
71
+ - 하루 접속자는 8월보다 12% 늘어 1만 9천 명이다
72
+ - 주: 하루 접속자는 9월 평일 평균, 같은 기기의 재접속은 한 명으로 셈
73
+ ---
74
+
75
+ ---
76
+ layout: timeline
77
+
78
+ ## 남은 일정과 담당, 10-12월
79
+
80
+ | 시점 | 할 일 | 담당과 산출물 |
81
+ |---|---|---|
82
+ | 10월 셋째 주 | 정류장 AP 13대 태양광 보조 전원 교체 완료 | 시공사, 교체 확인서 |
83
+ | 10월 넷째 주 | 한전 분전반 증설 회신과 시장 상인회 협의 | 스마트도시과, 협의 결과 |
84
+ | 11월 셋째 주 | 전통시장 2곳 전기 공사와 AP 8대 설치 | 시공사, 준공 사진 |
85
+ | 12월 첫째 주 | 북부 권역 잔여 AP 3대 설치 | 시공사, 설치 대장 |
86
+ | 12월 셋째 주 | 전 구간 속도 측정과 준공 검사 | 스마트도시과, 준공 검사서 |
87
+
88
+ 출처: 스마트도시과 사업 일정표, 2026년 9월 개정 (예시)
89
+
90
+ > 표 2. 남은 일정, 12월 셋째 주 준공 목표 (예시)
91
+
92
+ - 한전 회신이 10월을 넘기면 시장 공사가 12월로 밀려 준공이 2주 늦어진다
93
+ - 정류장 전원 교체는 시공사 부담으로 진행해 추가 비용이 없다
94
+ ---
95
+
96
+ ---
97
+ layout: comparison
98
+ title: side-rail
99
+
100
+ ## 계획 대비 실적, 9월 말 기준
101
+
102
+ :::: columns 1fr 1fr
103
+ ::: col
104
+ - **계획**
105
+ (1) 설치: 누적 430대, 9월 설치 60대
106
+ (2) 집행: 사업비 18억 원 중 11억 7천만 원, 65%
107
+ (3) 품질: 장애 처리 평균 2일 이내, 속도 100Mbps 이상
108
+ (4) 이용: 하루 접속자 1만 8천 명
109
+ :::
110
+ ::: col
111
+ - **실적**
112
+ (1) 설치: 누적 412대(96%), 9월 설치 58대
113
+ (2) 집행: 11억 4천만 원(63%), 시장 공사비 3천만 원 미집행
114
+ (3) 품질: 장애 처리 평균 1.8일, 평균 속도 142Mbps
115
+ (4) 이용: 하루 접속자 1만 9천 명, 계획보다 6% 많다
116
+ :::
117
+ ::::
118
+
119
+ - 주: 사업 계획서(2026년 3월)와 9월 말 설치 대장·집행 내역 비교 (예시)
120
+ ---
121
+
122
+ ---
123
+ layout: text-column
124
+
125
+ ## 지연 위험 요인과 대응 방안
126
+
127
+ - **전통시장 분전반 용량 부족**
128
+ (1) 시장 2곳 모두 기존 분전반이 상인 점포 전기로 이미 한도에 가깝다
129
+ (2) 대응: 한전 증설 신청(9월 18일), 회신 지연 시 임시 전원 설치 검토
130
+ (3) 영향: 회신이 10월을 넘기면 준공 2주 지연, 추가 비용 약 600만 원
131
+ - **정류장 AP 전원 불안정**
132
+ (1) 가로등 전원을 함께 쓰는 정류장 13곳에서 낮 시간 전원이 끊긴다
133
+ (2) 대응: 태양광 보조 전원으로 교체, 10월 셋째 주 완료
134
+ (3) 영향: 교체 전까지 해당 정류장 접속 불안정, 비용은 시공사 부담
135
+ - **상인회 공사 시간 협의**
136
+ (1) 시장 영업시간을 피해야 해 공사는 오후 8시 이후만 가능하다
137
+ (2) 대응: 상인회와 10월 넷째 주 협의, 야간 공사 사흘로 계획
138
+ - **준공 연장에 따른 계약 변경**
139
+ (1) 준공이 2주 늦어지면 시공 계약 기간을 바꿔야 한다
140
+ (2) 대응: 계약팀이 11월 첫째 주까지 변경안 검토
141
+ - 주: 스마트도시과 위험 관리 대장, 2026년 9월 30일 기준 (예시)
142
+ ---
143
+
144
+ ---
145
+ layout: closing-decision-box
146
+
147
+ ## 10월 협조 요청 사항
148
+
149
+ - 요청: 임시 전원 설치 예비비 사용 승인과 상인회 협의 지원을 부탁드립니다
150
+ - 결정 뒤 스마트도시과가 11월 첫째 주 주간 회의에서 시장 공사 계획을 보고한다
151
+
152
+ | 결정 사항 | 금액 | 담당 | 기한 |
153
+ |---|---|---|---|
154
+ | 시장 임시 전원 설치 예비비 사용 | 600만 원 | 기획예산과 | 10월 넷째 주 |
155
+ | 상인회 야간 공사 협의 참석 | 없음 | 지역경제과 | 10월 넷째 주 |
156
+ | 준공 2주 연장 시 계약 변경 | 없음 | 계약팀 | 11월 첫째 주 |
157
+ ---
@@ -77,7 +77,7 @@ When ambiguity ≤ 0.20 (or early exit / hard cap), write `.pptx-pipeline/spec-{
77
77
  - Generated: {timestamp}
78
78
 
79
79
  ## Deck Configuration
80
- - Template: {chosen} (bare `lit` default AZURE-PRO; options AZURE-A2Z, BOILERPLATE-PRETENDARD, BOILERPLATE-A2Z, or a learned template)
80
+ - Tonality: {chosen} with alternatives {A}, {B} (from the direction card; a legacy template such as AZURE-PRO, AZURE-A2Z, BOILERPLATE-PRETENDARD, BOILERPLATE-A2Z or a learned template only when the user names it)
81
81
  - Font: {Pretendard | 에이투지체 | learned}
82
82
  - Slide count: {n}
83
83
  - Language: {match the user; e.g. Korean with English technical terms}