149 Commits

Author SHA1 Message Date
king 89ad338024 fix(project): review fixes — access leaks, open paths, save safety, concurrency
- Subproject tasks via parent /tasks are re-filtered by current access (FULL/READ kept)
- PUT /api/projects/order: every id must be manageable; bad/duplicate ids -> 400, all-or-nothing
- Inbox, web alert popup, PC notifier open tasks via /project/t/{id}; embed=1 survives redirect;
  old /p/{home}?task= redirects READ users to the linked project
- Project page / snapshot / workload include the opened archived or sub project only
- Alerts: DB-side filters + oldest-first paging (no 50-row cut); badges counted without caps;
  my tasks keep every open task (completed capped)
- Meeting results: next-week meeting open, or own meeting open when no next meeting;
  header edits + result checks under row locks (FOR UPDATE / FOR SHARE)
- Inbox panel waits for the task window save (same retry/discard flow) before switching/closing;
  read failures stay unread
- Attachment upload removes only its own file on DB failure
- New project modal: create once, retry only failed member assignments
- update_task / update_project: locked-row validation in one transaction; completion hints from real transition
- Creator added as explicit member when another owner is chosen
- _once lock lifetime managed by refcount (no leak on failure)
- Section default assignee must still be a registered project user; follower add uses can_assign
- Docs (PROJECT_MODULE 6-15, help), tests (DB-less, real PostgreSQL, jsdom, Chrome)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 11:08:56 +09:00
king c07a3466a0 Merge branch 'feat/project-role-tiers' 2026-10-12 01:10:33 +09:00
king 5d054e59b6 feat(project): 4-tier roles (super/admin/pro/user), meeting header 구분
- app.store: role "pro" (ROLES, ROLE_LABELS); admin page grade select
  Admin / Pro user / User, super admin fixed to one account.
- project.access: role_of, is_pro, is_project_admin.
- router: _require_admin -> _require_pro (goals, meetings complete/delete,
  members, reorder, trash restore, assignable users); new project and
  project edit/owner change need Pro user+; task delete open to any member;
  project/section delete = Admin+ or creator; comment edit/delete of others
  and workload summary = Pro user+. Templates get pj_pro / pj_admin.
- Weekly meeting table first header "구역" -> "구분".
- Docs (CLAUDE.md, PROJECT_MODULE 6-14, overview, help page) and tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 01:10:25 +09:00
king 061f18d081 Merge branch 'feat/workload-nested-subtasks' 2026-10-08 16:57:40 +09:00
king ee9c04147a feat(project): workload chart counts nested subtasks
subtasks-summary now returns every level under the scope's main tasks
(recursive CTE, depth <= 20) with root_task_id and parent_title; the
dashboard groups by root_task_id. Also fix drawer header '세부 작업 작업'.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 16:57:36 +09:00
king 6a1c437635 Merge branch 'feat/inbox-click-terms-boardcopy' 2026-10-08 16:03:03 +09:00
king 8045d06362 feat(project): click-to-open inbox, 세부 작업 terms, board link copy
- Inbox lists only unread notifications / unchecked mentions; no
  [확인] button: clicking a row marks it (and same-task rows) seen and
  opens the task side panel; picking another row switches the panel and
  removes the previously seen rows; closing removes them too
- Project module wording: 하위 작업 -> 세부 작업, 작업 추가 -> 메인 작업 추가;
  dashboard workload bars "메인 작업" / "세부 작업"
- Meeting: link icon next to 회의록 보드 copies the board URL
- Bump project asset versions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 16:02:58 +09:00
king 85e91ca882 Merge branch 'feat/project-ui-batch-1008' 2026-10-08 13:22:40 +09:00
king 11e9803965 feat(project): asana icons, 12-col colors, bold sections, all-view menu, desc text color/size
- Project edit modal: color palette 12 columns; icon tabs [기본 아이콘] /
  [아사나 아이콘] (33 filled icons, value "asana:<name>", 6KB subset font
  material-symbols-asana.woff2)
- Section names bold (board column, list group, rename input)
- Inbox: clicking the left inbox area closes the task side panel
- Replace top-right scope toggle with admin-only sidebar "전체 보기"
  (?scope=all, switches in place on project pages)
- Description editor: text color and size; server keeps only validated
  color / font-size on plain spans (desc_inline_style)
- Fix goals_meeting_ui [2e] for manual monthly target; bump asset versions

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 13:22:35 +09:00
king 90fb06c48c Merge branch 'feat/login-orbit-sparkle' 2026-10-08 12:32:50 +09:00
king ac3b90f2be feat(login): orbit names sparkle like King
Same glow keyframes as King (text-shadow only, depth opacity stays in
script), random start offset per name.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 12:32:46 +09:00
king a664c4a9fc Merge branch 'feat/login-orbit-size' 2026-10-08 12:30:10 +09:00
king 64aabdfbda feat(login): orbit names up to 80% of King size
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 12:30:05 +09:00
king 98fda9923e Merge branch 'feat/login-orbit-names' 2026-10-08 11:47:25 +09:00
king 53c7c85caf feat(login): 100px logo, user ids orbit around King
Login brand panel logo is 100px wide (height by ratio). Registered user
ids (email local part, no full email/real name) float around the King
label on random tilted, wobbling elliptical paths; respects
prefers-reduced-motion.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 11:47:21 +09:00
king c380b5e411 Merge branch 'feat/notifier-silence-web' 2026-10-08 11:35:19 +09:00
king 84113d1fd7 feat(project): silence web alert popup while PC notifier is running
If the user has a non-revoked notifier token seen in the last 3 minutes,
/api/notifications/alerts returns only the baseline with desktop=true;
the web marks it seen so alerts resume on the web after the app stops.
A failing check keeps the web popup.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 11:35:14 +09:00
king 4715de9b5b Merge branch 'feat/notifier-in-inbox' 2026-10-08 11:13:31 +09:00
king d7d4f61bfb feat(project): move PC notifier entry into inbox header
Sidebar 'PC 알림' item removed; inbox header gets a [PC 알림] button,
and the notifier page keeps the inbox highlighted with a breadcrumb.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 11:13:27 +09:00
king 69e594ac54 Merge branch 'feat/home-remove-tiles' 2026-10-08 10:40:51 +09:00
king f69219919d feat(home): remove default shortcut/notice tiles from ERP home
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 10:40:46 +09:00
king 972c94d86c docs(notifier): correct exe size in README
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 10:22:15 +09:00
king f4606bddc6 Merge branch 'feat/pc-notifier' 2026-10-08 10:22:02 +09:00
king 06af036f86 feat(project): PC tray notifier for mentions and assignments
Windows tray app (desktop/notifier, C# .NET Framework 4.8 WinForms,
single exe, no installer/admin) that shows the same big alert popup as
the web even when the browser is in the background: layered topmost
window that does not steal focus, blinking border, open/close actions,
sound, autostart toggle, DPAPI-encrypted token.

Server side (project_db migration 023):
- notifier_links / notifier_tokens (SHA-256 hashes only)
- device link flow: link/start -> browser approve at /project/notifier
  -> link/poll issues token once
- Bearer API for alerts/read/logout reusing _alerts_payload; token
  re-checks current user record and project permission each call
- /project/notifier page (approve, connected PCs, revoke, download)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 10:21:58 +09:00
king 8f46d6c13a Merge branch 'feat/week-target-month-manual' 2026-10-08 09:20:17 +09:00
king 701f43a1f8 feat(project): manual monthly sales target with weekly diff
Week target popup now has its own "month total" input at the top; the
monthly target is saved as entered instead of being the sum of weeks.
Bottom shows week sum and diff (month target - week sum), colored
for remaining / over / even. Requests without `month` (stale cached JS)
still fall back to the week sum.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 09:20:07 +09:00
king 9eea1a073a Merge branch 'feat/stage-color-alerts-meeting-lock' 2026-10-07 17:37:28 +09:00
king 5278d568de feat(project): weekly meetings editable by anyone, admin completes to lock
Meeting write APIs now accept any project user; deleting a meeting and the
new POST /api/goals/meetings/{week}/complete (complete/reopen) stay admin
only. A completed meeting (migration 022: completed_at, completed_by)
rejects edits with 409; last-week result fields follow the next meeting's
lock instead. The page shows a complete button / locked badge.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 17:37:23 +09:00
king 21fc78adb9 feat(project): blinking popup for new mentions and task assignments
Project pages poll GET /api/notifications/alerts every 20s (and when the
tab becomes visible). New unread mention/assigned notifications show in a
large blinking popup at the bottom center until closed; closing in one tab
closes it in the others. A new browser starts from the latest id.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 17:30:15 +09:00
king 4bdab1de3d feat(project): uniform #f3f3f3 section headers, remove section color picker
Stored stage colors are ignored; timeline rows use the project color.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 17:27:59 +09:00
king f90884e028 Merge branch 'feat/quick-task-delete' 2026-10-07 16:57:02 +09:00
king 6959941128 feat(project): delete registered tasks from the meeting task table
Registered rows get a delete button that, after confirmation, deletes the
task from its project (trash). Unapplied rows get an x to drop the row.
Registered rows now stay in the browser list so they can be deleted later.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 16:56:57 +09:00
king 18dd9531ad Merge branch 'fix/member-modal-height' 2026-10-07 16:53:22 +09:00
king 28d56fc3c5 fix(project): member dialog grows to fit everyone instead of scrolling
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 16:53:18 +09:00
king b8d944b3ef Merge branch 'feat/meeting-units-members' 2026-10-07 16:50:46 +09:00
king a0722f26ca feat(project): meeting numbers in sales unit, member add/remove, quick-task polish
- Header numbers use the goal table sales unit (e.g. 백만원); exact won
  amounts in tooltips.
- Notes title: 결정사항 : 진행상황 수시 공유 및 완료 되어야 함.
- Member dialog shows current members checked: check to add, uncheck to
  remove (owner locked); member APIs also require project access.
- Quick task table: centered bold headers, assignee shown as avatar + name.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 16:50:42 +09:00
king 261267a523 Merge branch 'feat/meeting-top-areas' 2026-10-07 16:24:27 +09:00
king da27c9990a feat(project): meeting header with plan, notes and quick task table
Three header areas that stay visible while the table scrolls:
month plan with the four numbers in one compact line, decisions/notes,
and a task table (title, assignee, project, section) whose cells open
pick lists; Apply creates the task in that project.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 16:24:23 +09:00
king 50153139fc Merge branch 'feat/member-no-role' 2026-10-07 15:49:59 +09:00
king c4fb7761ad feat(project): drop member role from assignment
The role select (member/manager) had no effect on permissions; every
assigned member can view and edit the project. Remove it from the
assign dialog and avatar tooltip; new assignments are always member.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 15:49:54 +09:00
king fb7b25ba2c Merge branch 'fix/asset-monitor-same-model' 2026-10-07 15:14:27 +09:00
king e9be17faab fix(asset): allow registering a monitor of an already-registered model
Registration was blocked whenever same-model candidates existed, so a
second monitor of the same model (e.g. dual monitors) could not be added.
Now only an existing asset with the same serial blocks a new one; the
UI tells serial and model candidates apart and hides 'register' only
for serial matches.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 15:14:22 +09:00
king 133df472d1 Merge branch 'fix/dash-workload-bar-ratio' 2026-10-07 14:43:27 +09:00
king 569b33ece4 fix(project): workload bars fill by completion rate, not task count
Bar height was scaled to the largest count, so 9/13 looked nearly empty
and 1/1 short. Each bar is now the whole set; green fill = done ratio,
with count and percent above.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 14:43:21 +09:00
king 452e8a9093 Merge branch 'feat/dash-workload-bars' 2026-10-07 14:24:07 +09:00
king 1cfcec2bef feat(project): workload as vertical bars with task list drawer
Per assignee, main and subtask bars (height = count, green = done).
Clicking a bar slides in a right-side panel listing those tasks;
clicking an item opens the task editor. Closing the editor refreshes
the counts. Subtask summary API now returns id, title, due date.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 14:24:02 +09:00
king 2d638804d1 Merge branch 'feat/project-members-only' 2026-10-07 14:16:41 +09:00
king b6dc82c0b3 feat(project): projects visible to members only, admins included
Admins no longer see projects they are not owner/member of: sidebar list,
project list API, project pages, search, inbox, notifications, reminders
and trash all follow access.visible_project_ids. Only the super admin
still sees every project. Member assignment stays admin-only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 14:16:36 +09:00
king 2a01d97dd0 Merge branch 'feat/dash-assignee-workload' 2026-10-07 14:09:11 +09:00
king fc3a2d0b9b feat(project): dashboard workload by assignee with subtasks and completion
Replace the scheduled-tasks bar chart with a table of all tasks assigned
per person in scope (no due date needed, filters ignored): main tasks,
subtasks (new GET /api/projects/{id}/subtasks-summary), done counts and
completion rate, plus a total row. Admin only, as before.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 14:09:06 +09:00
king c766af691a Merge branch 'feat/goals-no-cell-move' 2026-10-07 14:03:34 +09:00
king b7c24c07e7 feat(project): remove drag-to-move for annual goal cells
Goal text cells no longer get move borders or drag handling; clicking a
cell still highlights it. The weekly meeting table keeps its move.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 14:02:51 +09:00
king fbb6c648a5 Merge branch 'feat/board-btn-color' 2026-10-07 13:58:18 +09:00
king 8b664fc216 style(project): pastel PowerPoint colors for meeting board button
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 13:58:14 +09:00
king 5f10f9ce45 Merge branch 'fix/board-refresh-error-code' 2026-10-07 12:59:38 +09:00
king 46dc038e26 fix(project): show OAuth error code when meeting board token refresh fails
RefreshError showed only a generic message; include Google's error code
and explain client ID/secret mismatch (unauthorized_client).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 12:59:33 +09:00
king c0b742af8a Merge branch 'fix/authorize-port-18765' 2026-10-07 12:50:19 +09:00
king 80c9904771 fix(scripts): move OAuth callback port to 18765
8765-8767 are taken by local preview servers on the dev PC.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 12:50:14 +09:00
king 8885bbce6b Merge branch 'fix/authorize-fixed-port' 2026-10-07 12:42:30 +09:00
king e9618d93d6 fix(scripts): use fixed OAuth callback port 8765 for token issue
A web-application OAuth client needs the exact redirect URI registered;
a random port made that impossible (redirect_uri_mismatch).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 12:42:26 +09:00
king cbf59d9bf0 Merge branch 'feat/meeting-board-slides' 2026-10-07 12:04:14 +09:00
king c9d5e6e017 feat(project): meeting board button opens a blank Google Slides deck
A "회의록 보드" button next to attendees opens the week's Google Slides
deck in its own window. The deck is found (Drive appProperties) or
created in the shared drive MEETING_BOARD_FOLDER_ID as one BLANK slide,
named like "10월 2주차 (10/5~10/11)". Needs a token with Drive and
Slides scopes; the authorize script now requests them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 12:04:09 +09:00
king 15e84ba5bc Merge branch 'feat/meeting-autofit-on-load' 2026-10-07 11:43:57 +09:00
king 3045944200 feat(project): auto-fit all meeting columns on load
The weekly meeting table always starts with "fit all columns" instead of
the widths saved in the browser; it refits once fonts load unless the
user already resized a column.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 11:43:53 +09:00
king e1f50e0ca5 Merge branch 'feat/meeting-amount-text' 2026-10-07 11:40:36 +09:00
king 9528f735b8 feat(project): allow text in meeting target/result cells; fix result note save
- Target and result cells accept text such as "20개". Values that parse
  as amounts still go to the integer columns; anything else goes to the
  new target_text/result_text columns (migration 021).
- Fix: PUT /api/goals/meeting-items/{id} dropped result_note, so the
  last-week result text was never saved.
- Update meeting nav test to the month-bounded week numbering.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 11:40:30 +09:00
king 7417e661e0 Merge branch 'feat/week-target-labels' 2026-10-07 11:30:54 +09:00
king 38d0a87d6b feat(project): show weekday and day count in weekly target popup
Each week reads like "11/1(일)~11/8(일) 8일".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 11:30:49 +09:00
king cd3577b299 feat(project): month-bounded meeting weeks, weekly sales targets, sticky header
- Weeks stay inside the month: week 1 starts on the 1st (through the next
  Sunday if the 1st is a weekend); a trailing Mon/Tue joins the last week.
  "Last week" is the previous period.
- Prev-week review columns: 전주 업무 | 결과(text, new result_note) |
  전주 목표 | 결과(amount).
- Header now shows month target, cumulative weekly target, month-to-date
  sales and gap (amount + %), with decisions/notes beside it; the area
  stays fixed while scrolling.
- Goals board: the monthly sales target is entered per week; the sum
  becomes the month target.
- Migration 020: result_note, goal_week_targets, drop Monday-only check,
  move absorbed Monday meetings to the new week start.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-07 11:24:41 +09:00
king 9194487217 Merge branch 'feat/meeting-columns' 2026-10-06 17:27:08 +09:00
king e958743e65 feat(project): rename meeting columns and drop rate/evaluation
Headers: 주요 업무 / 결과 / 전주 목표 / 정량 목표. The achievement-rate
and evaluation columns are removed from the weekly meeting table.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 17:27:04 +09:00
king 85cf0a28b1 Merge branch 'feat/meeting-no-week-sales' 2026-10-06 16:01:52 +09:00
king 39dcda66b4 feat(project): remove per-row this-week sales in weekly meetings
Drop the "이번주 실적" line under each row's target and the now-unused
shop link menu. Performance sales stay only in the header cards.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 16:01:47 +09:00
king f09b8fa2f9 Merge branch 'feat/meeting-no-auto-result' 2026-10-06 15:52:15 +09:00
king df36a5a917 feat(project): drop auto last-week results in weekly meetings
Last-week result is always entered by hand; remove shop sales auto-fill
and the 자동입력 / 실적 미사용 badges next to item names. This-week sales
under the target stay.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-06 15:52:05 +09:00
king d18e801e08 feat(asset): animate asset detail drawer 2026-10-06 02:39:03 +09:00
king b576dd1a38 feat(asset): add photos, monitor links and deletion
Apply asset_db_002_photos_monitors.sql before rebuilding web.

Restrict soft deletion to the super admin; retain reports and audit.
2026-10-06 02:29:19 +09:00
king bd0c47e6fc feat(asset): add inventory and HWiNFO reports
Requires asset_db initialized with scripts/sql/asset_db_init.sql and ASSET_DB_URL configured before enabling storage.
2026-10-06 02:09:10 +09:00
king 75c0370e54 fix(project): shift goal years left by 35px 2026-10-04 14:54:48 +09:00
king a2a39671b9 feat(project): collapse meeting months by year 2026-10-04 14:40:58 +09:00
king 2a1a3e7bd9 fix(project): keep sidebar on week navigation 2026-10-04 14:14:25 +09:00
king 5bf8c9c160 feat(project): add monthly meeting menu tree 2026-10-04 13:45:22 +09:00
king 86622cc4dd fix(project): retain monthly plan text styles 2026-10-04 13:30:36 +09:00
king ed7da57066 feat(project): compact links and add file icons 2026-10-04 13:17:22 +09:00
king e2fc14a584 fix(project): center weekly meeting labels 2026-10-03 18:45:27 +09:00
king d89875db7e fix(project): restore smooth quarter toggles
Hide monthly content until column widths settle to prevent numeric shifts during expansion.
2026-10-03 18:09:10 +09:00
king 321bf11f65 fix(project): stop quarter reveal numeric drift 2026-10-03 17:53:16 +09:00
king 3e4c6dfad3 fix(project): center annual goal labels 2026-10-03 17:18:32 +09:00
king d3c1ca12e9 fix(project): grow cells and repair Enter 2026-10-03 17:04:02 +09:00
king 090e508bf3 feat(project): add meeting cell editing
Apply project_db migration 019 to enable vertical cell merges. Other cell editing remains available before migration.
2026-10-03 15:11:41 +09:00
king 193da56edf fix(project): fit meeting rows and inline badges 2026-10-03 14:26:36 +09:00
king cd0a509215 feat(project): add help search and detailed guides 2026-10-03 09:41:09 +09:00
king 7647e4b20f feat(project): add cell moves and width menus 2026-10-03 08:55:15 +09:00
king 2c8542339d fix(project): fit goal rows to text height 2026-10-03 07:59:22 +09:00
king b32f2ac3a3 feat(project): auto-fit goal column widths 2026-10-03 06:55:00 +09:00
king e726f986db perf(project): smooth sidebar resizing
Batch drag updates per frame and defer full layout recalculation until release. Cover resize edge cases and retain goals review records.
2026-10-03 06:45:56 +09:00
king 36a6866b96 style(project): compact toolbar and reset icon 2026-10-03 06:29:50 +09:00
king db39d3b383 fix(project): anchor toolbar above selected cell 2026-10-03 06:23:03 +09:00
king dc2008c5b3 feat(project): add Excel font controls and reflow 2026-10-03 05:47:57 +09:00
king 494d84f7c2 feat(project): add group collapse and UI polish 2026-10-03 05:26:41 +09:00
king 44f6ca4ef7 style(project): reduce board column and card corner radius 2026-10-02 18:02:40 +09:00
king 7f9c7a24d3 style(project): change board column background to ececec 2026-10-02 17:58:19 +09:00
king 22af196d56 feat(project): add Asana-style board completion checks 2026-10-02 17:55:31 +09:00
king 20232baf06 feat(project): add font options and selected goal text formatting
Restore the board header add button to the task side panel while keeping footer quick entry. Add safe, persisted goal text formatting and self-hosted Project font preferences with shared help updates and regression coverage.
2026-10-02 17:28:54 +09:00
king 035cb83d6f feat(project): add inline board tasks and reorder subtasks 2026-10-02 16:38:01 +09:00
king 114af59b26 fix(project): show completed subtasks with filled green checks 2026-10-02 16:13:52 +09:00
king 6a38fdb06a feat(project): match Asana typography sizes and weights 2026-10-02 16:03:52 +09:00
king d387048ebf feat(project): apply Asana system fonts to Project screens
Override the font token only on Project pages, preserve icon and monospace fonts, and update CSS/JS cache versions. Match the image viewer font stack as well.
2026-10-02 15:15:46 +09:00
king 71516713c5 Merge branch 'feat/cupang-box-weight' — 쿠팡 밀크런 상자별 무게 합계 2026-10-02 14:24:08 +09:00
king d21670f6af feat(cupang): 출고 상세 상자 목록에 상자별 무게 합계
- 상자마다 무게 칸 = 상자에 든 제품 수량 × 포장무게(설정(제품명)의 지금 값) 합계, 상자번호처럼 상자 단위 한 칸
- 무게가 없는 제품이 섞이면 아는 무게만 더하고 "일부 미입력"(말풍선에 빠진 코드), 모두 없으면 —
- 상자 목록 엑셀에도 무게(g) 열(혼합 상자는 세로 병합)
- 포장무게 칸(마이그레이션 007)이 없으면 무게 칸·열 없이 예전 그대로
- tests/test_cupang_weight.py: 상자 무게 계산 + 엑셀 무게 열

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 14:23:56 +09:00
king 2434bce35e Merge branch 'feat/cupang-product-weight' — 쿠팡 밀크런 제품 포장무게(g) 2026-10-02 13:43:30 +09:00
king f02742497a feat(cupang): 제품 설정에 포장무게(g) — 수기 추가·수정 입력, 목록 표시·정렬
- cupang_products.weight_g (마이그레이션 007, NULL = 미입력, 0~1,000,000 CHECK)
- 초기 무게 39건 시드(cupang_products_weight_seed.sql) — 무게가 비어 있는 행만 채움, 실행 전 값 백업
- 수기 추가에 포장무게(g) 칸(1,070·1070g 허용, 비우면 기존 무게 유지), 수정 팝업에서 수정·지우기
- 등록 목록에 포장무게 열(1,070g, 숫자 정렬, 무게 없는 줄은 맨 뒤)
- 007 미적용이면 무게 칸·열을 숨기고 저장 SQL 에서도 뺌(기존 동작 그대로)
- tests/test_cupang_weight.py: 입력 읽기 + 무게 칸 유무별 등록·수정 SQL

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 13:43:17 +09:00
king 968892d811 feat(project): 회의록 이번주↔지난주 순서 바꾸기(사람별 기억), 목표 줄·영역 바로 추가, 보드 카드 100px·표지 이미지
- 주간 회의록: 표 왼쪽 위 [순서 바꾸기] — 이번주(2칸)·지난주 리뷰(5칸) 묶음 순서 교체, 로그인 이메일별로 브라우저에 기억
- 연간 목표: 업무 영역 추가·줄 추가(1열·2열 메뉴)는 이름을 묻지 않고 바로 만들고 새 이름 칸을 바로 입력 상태로
- 보드 카드: 높이 100px 고정(제목 2줄까지), 담당자·날짜 글자·아이콘 10% 크게,
  설명의 첫 이미지를 카드 위 표지로(아사나식)
- project.css/js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 11:38:27 +09:00
king a3a9444c3b feat(project): 설명란 이미지 더블클릭 = 별도 창 보기, 댓글 Shift+Enter 줄바꿈, 메뉴 이름 Project
- 설명란 이미지 더블클릭 → 별도 브라우저 창(원본 크기, 휠 확대·축소, 끌어서 이동, −/+ · 1:1 · 맞춤 막대, 키 + − 0 1 Esc)
- 댓글 입력칸·댓글 대화창·답글 입력칸을 여러 줄 입력칸으로 — Enter 등록, Shift+Enter 줄바꿈, 줄 수만큼 늘어남
- ERP 메뉴·홈 카드 이름 "프로젝트 관리" → "Project"
- project.css/js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-02 10:50:30 +09:00
king e1006c63de fix(project): 목표·주간 회의록 저장 손실·지난주 연결·실적 미확인 수정 (점검 9건)
- 칸별 자동 저장 createFieldSaver: 같은 칸 요청 직렬화, 보낸 값만 saved,
  늦은 응답이 새 초안을 덮지 않음, 실패 시 초안·dirty 유지(빨간 테두리),
  localStorage 초안 백업·되살리기, 페이지 떠남 keepalive + 이탈 경고
- 목표 표: 저장 실패면 영역·줄·병합 작업과 표 교체 중단, 받는 사이 입력 보호
- 회의록: 금주 목표 저장 뒤 새로고침 대신 숫자 칸만 다시(차례 번호로 옛 응답 버림),
  이번주 실적 %는 서버 확정 목표로 즉시 재계산
- 지난주 = 정확히 7일 전 주의 같은 연결키 줄(line_key, 마이그레이션 018),
  역순 생성·이름 변경·삭제 후 재생성에도 연결, 이름 추정 연결 없음
- 실적 조회 장애를 0원 대신 미확인으로(목록·매출·부분 실패 구분)
- 구역·항목 ⋮ 메뉴 버튼(키보드·터치), 메뉴 키보드 탐색·포커스 복귀
- 매출 갱신 실패·일부 실패 안내 + 재시도, 서버 기록 갱신 시각, 권한 없으면 호출 안 함
- 테스트: Python 통합(역순 생성·실적 장애), 018 백필, jsdom UI 106건

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 21:14:10 +09:00
king 21981eb946 style(project): 연간 목표 분기 구분 — 분기별 색 띠·열 음영, 접기 아이콘은 엑셀식 −/+
- 분기마다 차분한 색(파랑·청록·보라·남색): 머리 위 색 띠(월 3px · 분기 6px), 분기 열 전체 옅은 음영,
  분기 칸 오른쪽 2px 경계, 분기 머리 글자·아이콘은 분기 색
- 접기 아이콘: 네모 안 −(펼침) / +(접힘), 90° 돌며 세로 막대가 자라고 줄어드는 애니메이션
- project.css 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 17:39:32 +09:00
king ac4f2653af feat(project): 빈 카드 하위 작업 추가 버튼, 분기 머리 칸 전체 클릭 접기 + 회전 아이콘, 달력 회의록 점 안쪽으로
- 보드: 하위 작업이 없는 카드에도 하위 작업 토글(카드 hover 때 보임) — 누르면 펼쳐지며 바로 이름 입력 줄
- 연간 목표: 분기 머리 칸 아무 곳이나 눌러 접기/펴기(너비 조절 직후 클릭은 무시),
  꺽쇠 대신 SVG →|← / ←|→ 아이콘, 화살표가 반 바퀴 돌며 바뀜, 접힌 분기 머리는 강조색
- 회의록 작은 달력: 회의록 있음 점을 달력 테두리 안으로
- project.css/js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 17:18:47 +09:00
king 51727e419a feat(project): 연간 목표 상·하반기 → 1~4분기, 주간 회의록 머리·표 다듬기
연간 목표 표
- 3·6·9·12월 오른쪽에 1~4분기 칸(글 칸 13=1분기·15=2분기·14=3분기·16=4분기 — 예전 반기 칸 번호를 이어 써서
  글 옮기기 없음, 예전 상반기 글은 1분기·하반기 글은 3분기에 보임)
- 분기 합계·달성률·로아스 가중 평균, 분기 접기(pj_goal_fold_q), 열 너비 키 q1~q4
- 가로 병합은 같은 분기 월 칸 안에서만(서버·화면·DB CHECK), 분기를 넘는 예전 병합은 잘라서 그림
- 마이그레이션 017: goal_cells 월 칸 0~16, 분기를 넘는 병합은 분기 끝까지로 줄임(글 유지),
  회의록 줄 이름 "메타(숫자)" → "메타". 미적용이면 2·4분기 칸 읽기 전용 + 503

주간 회의록
- 달력 폭 줄이고(174px) 글자·칸 5% 키움, 주차 탭은 달력 바로 왼쪽
- 지난주 리뷰 머리에 지난주 기간, "목표 금액" → "정량 목표", "목표 표에서 보기" 삭제
- 첫 회의록 기본 줄 "메타(숫자)" → "메타"

도움말·문서·테스트 갱신, project.css/js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 16:30:24 +09:00
king b791f7be68 style(project): 주간 회의록 머리 정리 — 주차 탭은 제목 줄 끝 작은 탭, 이 달 계획은 그 아래(달력 앞까지), 달력 90% 축소
- 주차 탭: 한 줄짜리(1주차 10/5~11, 같은 달이면 끝 월 생략, 전체 기간은 말풍선), 회의록 있음 점은 왼쪽 위
- 이 달 계획 카드를 머리 왼쪽(주차 탭 자리)으로 옮겨 너비를 달력 앞까지
- 작은 달력 212px → 191px(글자·칸 높이도 같이)
- project.css 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:32:25 +09:00
king 334b83c973 feat(project): 주간 회의록 위에 이 달 계획 카드, 숫자 영역은 한 줄 막대로 축소
- 연간 목표 표의 그 달 열 글을 업무 영역별 카드로 표시(router._month_plan) — 빈 칸 제외,
  가로 병합 칸 글은 범위(9~10월) 표시, 묶인 줄은 묶음 항목 이름, 목표 표 미적용이면 숨김
- 머리 숫자 9칸을 한 줄 막대(.pj-meet-kpibar)로 — 값 15px, 설명 문구는 말풍선
- project.css 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:21:17 +09:00
king 6ea4a2e0f9 feat(project): 목표 표 가로 스크롤 3열(연간)까지 고정, 연간·반기 달성률 = 기간 목표 합계 대비 실적
- 연간 열 sticky(left = 1열 + 2열 너비), 경계 그림자 — 머리·지표(틀 고정 줄)·업무 영역 칸 모두
- 매출 달성률 연간·상·하반기 = 입력된 실적 합계 ÷ 그 기간 목표 합계 전체(예: 2,910 ÷ 3,313 = 87.8%),
  예전 '실적이 있는 달의 목표만' 기준에서 변경, 말풍선 "연간 목표 합계 대비 실적"
- 캐시 버전 20261001v, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:10:22 +09:00
king ec5d7e2efe style(project): 프로젝트 관리 모든 화면 위쪽 여백 줄임(상단 바~제목 36px → 6px)
- .erp-page:has(> .pj-wrap / .pjh) 위 여백 24px → 6px, .pj-wrap·제목 줄(.pj-section-head·회의록 머리) 위 여백 0
- 다른 모듈의 .erp-page 여백은 그대로, 캐시 버전 20261001u, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:01:42 +09:00
king 737191c170 feat(project): 주간 회의록 참석자를 전체 멤버에서 고르기
- 자유 입력 칸 대신 멤버 칩(사진·이름·×) + [참석자] 고르기 창(찾기·전원 선택·모두 해제·체크), 바뀔 때마다 저장
- 후보 = project 권한 보유 등록 사용자(_meet_members), 저장은 이메일 쉼표 목록(예전 글자는 칩으로 유지, _parse_attendees)
- 참석자 길이 제한 500 → 3000자, 캐시 버전 20261001t, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:59:52 +09:00
king f199eda322 style(project): 목표·회의록 제목 2배(32px) 굵게, 회의록 → 연간 목표 큰 깃발 버튼
- h2.pj-goal-title 32px·800 — 연간 목표·주간 회의록 제목
- 회의록의 ← 화살표 대신 [깃발 {연도}년 목표] 강조 버튼(.pj-meet-goalbtn), 인쇄에선 숨김
- 캐시 버전 20261001s, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:55:56 +09:00
king 9161e0901f fix(project): 주간 회의록 1주차 = 그 달 첫 월요일이 있는 주(월간 목표·누적은 1일~말일)
- store.month_weeks: 주는 월요일이 속한 달의 것 — 예) 2026년 10월 = 10/5·12·19·26, 9/28~10/4 는 9월 마지막 주
- 다른 달의 주(?week=)를 열면 그 달 회의록으로 303
- 작은 달력은 그 달 날짜가 든 주 전부(store.calendar_weeks) — 앞 달 주는 흐리게, 누르면 그 달 회의록
- 월 누적·주당 필요 매출은 그대로 1일~말일 기준(1주차면 첫 월요일 전날까지 누적), 캐시 버전 20261001r, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:54:30 +09:00
king 5460c7f676 feat(project): 목표 표 1·2열 마우스 오버 도구 막대 제거 → 우클릭 메뉴로
- 1열(구역) 우클릭: 색 바꾸기(색 창은 우클릭 자리)·위로·아래로·줄 추가(구역 맨 아래)·영역 삭제 — goalAct 로 정리
- 2열(항목) 우클릭: 기존 줄 추가·삭제·항목 칸 나누기 + 위로·아래로(묶이지 않은 칸)
- 도구 막대 템플릿·JS(placeTools)·CSS 제거, 영역 색은 tbody[data-color], 캐시 버전 20261001q, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:49:43 +09:00
king 2a9f6f5628 fix(project): 목표 표 도구 막대가 오른쪽에 고정돼 누를 수 없던 버그 — 커서 오른쪽 위로
- 커서 오른쪽(같은 높이)에 두니 옆 칸으로 가로질러 갈 때 막대에 걸려 옆 칸 막대가 안 뜨고,
  칸 오른쪽 끝에서 들어오면 막대가 칸 밖에 떠서 가는 중에 사라졌다
- 이제 커서 오른쪽 위: 가로 이동은 막대 밑으로 지나가고, 막대는 오른쪽 위로 가서 누름
- 커서가 멀어질 때(왼쪽·아래)만 따라오고 막대 쪽으로 갈 땐 그대로, 시작점은 이름 칸 안, 작은 호버 다리
- 캐시 버전 20261001p, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:17:03 +09:00
king 58dbb7ef3e fix(project): 목표 표 영역·줄 도구 막대를 마우스 커서 오른쪽에
- 이름 칸 아래 가운데(왼쪽 고정 열이라 잘림) 대신 커서 오른쪽에 — 들어온 자리 기준 가로 고정, 세로는 커서를 따라감
  (가로까지 따라가면 막대를 누르러 갈 때 도망감), 커서가 막대 위면 그대로, 화면 배율 보정
- 캐시 버전 20261001n, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:10:01 +09:00
king 75b82024de fix(project): 입력 중 테두리를 칸 전체로, 고른 칸 Del 로 내용 지우기(Ctrl+Z 되돌리기)
- 목표 표·회의록: 입력 중 보라 테두리·밝은 배경을 입력칸(글 높이) 대신 칸 전체(td:focus-within)에
- 끌기·Shift+클릭으로 고른 칸에서 Del → 글 지우고 칸마다 저장, Ctrl+Z 로 바로 직전 지우기 되돌림
  (입력 중일 때의 Del·Ctrl+Z 는 평소 글자 편집), 우클릭 메뉴 "내용 지우기 (Del)"
- 캐시 버전 20261001m, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 14:03:57 +09:00
king 4af1ad8848 fix(project): 목표 표·회의록 — 칸 아무 곳이나 눌러 입력(엑셀처럼), 우클릭 메뉴 아이콘
- 칸이 세로로 길면 위쪽(글 높이)만 눌러야 입력되던 것: 글/금액 칸 아무 곳이나 누르면 그 칸 입력, 커서는 글 끝,
  칸 전체 글 입력 마우스 모양, Shift+클릭·끌기 선택은 그대로
- 우클릭 메뉴 왼쪽 아이콘(menuIcon): 줄 추가 위/아래·줄 삭제·셀 병합·병합 해제·항목 칸 나누기, 회의록 위로/아래로·쇼핑몰 연결
- goals.html 항목 칸 rowspan 계산이 값 없을 때도 안전하게, 캐시 버전 20261001l, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 13:52:30 +09:00
king 164153dc9c feat(project): 목표 표 3열에서 줄 추가 = 같은 항목 칸(2열) 안에 — 항목 칸 묶음
- goal_rows.label_cont(마이그레이션 016): 바로 위 줄 항목 칸에 묶임, 이름은 묶음 첫 줄, 2열 rowspan(_goal_label_spans)
- 3열 우클릭 위/아래에 줄 추가 → same_label: 같은 항목 칸 안(이름 묻지 않음), 첫 줄 위면 새 줄이 첫 줄로 이름 넘겨받음
- 2열 메뉴·+ 줄 추가는 묶음 밖(묶음 맨 위/맨 아래 기준), 묶인 2열 우클릭 → 항목 칸 나누기(split-label)
- 묶음 첫 줄 삭제 → 다음 줄이 첫 줄·이름 넘겨받음, 묶인 줄 이동 400, 새 연도 복사에 묶음 유지
- 캐시 버전 20261001k, DB 회귀 test_goal_label_groups, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 13:37:40 +09:00
king ac0672bc11 fix(project): 목표 표 병합·줄 추가/삭제 때 새로고침 대신 제자리 다시 그리기 + 애니메이션, 3열 줄 메뉴
- 병합 때 표가 줄었다 늘어나고 줄 추가/삭제 때 깜박이던 것: 새로고침(열 너비가 늦게 적용) 대신 페이지를 다시 받아
  업무 영역 tbody 만 교체(refreshTable) — 열 너비·반기 접기 다시 적용, 새 글 칸 연결
- 애니메이션: 지운 줄 흐려지며 사라짐, 남은 줄 미끄러져 이동(FLIP), 새 줄 위에서 등장 + 강조, 병합/해제 칸 테두리 강조
- 3열(연간 칸) 우클릭에도 위/아래에 줄 추가·줄 삭제(병합 메뉴가 있으면 그 아래에)
- 영역 추가·삭제·이동, 줄 이동도 같은 방식, 캐시 버전 20261001j, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 13:30:37 +09:00
king 24dd3acd09 fix(project): 목표 표 월 머리 — 주간 회의록 링크를 글자 대신 칸 전체로
- a.pj-goal-mlink 를 칸 전체(absolute inset 0)로, 마우스를 올리면 칸 전체 강조
- 오른쪽 끝 너비 조절 손잡이는 링크 위에 남아 그대로 끌 수 있음, 이번 달 밑줄 유지
- 캐시 버전 20261001i, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 13:06:03 +09:00
king 4efe7cef58 fix(project): 회의록 머리 배치 — 인쇄·삭제는 제목 옆, 달력은 오른쪽 위 90% 크기, 매출 갱신 상태 줄 제거
- 인쇄·회의록 삭제 버튼을 제목 줄(‹이전 달·다음 달› 뒤)로
- 작은 달력을 오른쪽 위(예전 버튼 자리)로 올리고 90% 크기(212px)
- 매출 자료 갱신 상태 줄·[매출 갱신] 버튼 제거 — 주차를 열면 표시 없이 다시 받아 숫자만 갱신(10분에 한 번)
- 캐시 버전 20261001h, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 12:13:57 +09:00
king 2dab20f718 feat(project): 주간 회의록 작은 달력 — 보고 있는 주 영역 표시, 주 줄을 누르면 그 주 회의록
- 주차 탭 오른쪽에 그 달 월요일 시작 달력(주 = 월~일 한 줄)
- 보고 있는 주 영역 표시, 오늘 동그라미, 토 파랑·일/공휴일 빨강, 다른 달 날짜 흐리게, 회의록 있는 주 점
- 줄(주)을 누르면 그 주 회의록(?week=), 인쇄에선 숨김, 좁은 화면은 아래로
- 캐시 버전 20261001g, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 12:07:21 +09:00
king be298777af feat(project): 회의록 주차를 열면 매출 자료를 쇼핑몰에서 한 번 더 받아 숫자 갱신
- 실적 모듈 매출 업데이트(POST /performance/api/sync, background)를 지난주 월요일 ~ 이번 주 오늘 기간으로 실행,
  진행 상황(쇼핑몰 n/m·받은 자료)을 상태 줄에 표시
- 끝나면 화면을 서버에서 다시 받아 숫자 칸만 교체(머리 카드·자동 결과·달성률·이번주 실적), 입력 중인 칸은 그대로
- 같은 주는 10분에 한 번만 자동(새로고침마다 쇼핑몰 API 를 부르지 않게), [매출 갱신] 버튼은 언제나,
  다른 업데이트가 돌면 그 작업을 기다림, 실적 권한 없음·실패 쇼핑몰 안내
- project.css/js 캐시 버전 20261001f, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 12:04:14 +09:00
king 45a671940b feat(project): 연간 목표 로아스 연간·상반기·하반기 목표/실적 계산
- 기간 로아스 = 기간 매출 ÷ 기간 광고비 — 월 광고비를 매출 ÷ 로아스로 환산해 합친 매출 가중 평균
  (목표는 매출 목표, 실적은 매출 실적으로), 매출이 없는 달이 섞이면 단순 평균. 말풍선에 방식·개월 수
- 화면 계산(저장 안 함), 숫자 칸을 고치면 바로 다시 계산. 캐시 버전 20261001e, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 11:58:03 +09:00
king 601971d43d fix(project): 회의록 쇼핑몰 연결 결과 — 진행 전 주·실적 미사용 쇼핑몰을 0 대신 구분, 이번주 실적 표시
- 지난 회의록 주가 아직 시작 전이면 자동 0 대신 "진행 전"
- 실적 모듈에서 사용 중이 아닌 쇼핑몰(사용 OFF·없는 코드)에 연결된 줄은 "실적 미사용" 표시 + 결과 직접 입력
- 자동 결과 말풍선에 쇼핑몰·기간, 0 이면 매출 업데이트 안내
- 쇼핑몰 연결 줄의 목표 금액 아래에 이번주 실적(월요일~오늘, 목표 대비 %)
- project.css/js 캐시 버전 20261001d, 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 11:54:06 +09:00
king c9bce7c976 feat(project): 연간 목표 엑셀식 칸 병합(끌어 고르기·우클릭 병합/해제) + 월별 주간 회의록
엑셀식 칸 병합 (예전 Shift+클릭·병합 버튼·오른쪽/왼쪽 칸 병합 메뉴 대체)
- 글 칸을 마우스로 끌어(또는 Shift+클릭) 사각형 선택 → 우클릭 "셀 병합 (N줄 × M칸)" / "병합 해제"
- 같은 업무 영역 안 세로(row_span) + 같은 반기 월 칸 가로, 연간·상·하반기 칸은 세로로만
- 걸친 병합은 엑셀처럼 범위를 넓혀 흡수, 글은 왼쪽 위부터 이어 왼쪽 위 칸에, 해제하면 왼쪽 위 칸에 남음
- POST /api/goals/areas/{id}/merge {row_from,row_to,col_from,col_to} (db.merge_goal_rect), router._goal_area_layout(colspan·rowspan)
- 가려진 칸 저장 거절(세로 포함), 병합 안쪽 줄 끼우기 +1 / 가려진 줄 지우기 -1, 세로 병합에 걸린 줄 이동 거절

주간 회의록 (/project/goals/{연도}/meetings/{월}, 목표 표 월 머리 클릭)
- 주(월~일) 탭, 주마다 회의록: 이번주 할 일·목표 금액 | 지난주 할 일·목표·결과·달성률·평가
- 앞선 회의록 줄 이어받기(carry_from), 처음이면 목표 표 업무 영역 + 기본 양식 줄(유통 줄 쇼핑몰 연결 추측)
- 머리: 월 목표·지난주까지 누적·주당 필요 매출(페이싱)·전주 목표/결과/달성률·금주 목표/현재 실적
- 쇼핑몰 연결 줄의 결과·누적·주간 매출은 실적 모듈 performance_store 읽기 전용(없으면 직접 입력)
- 금액 입력 120만·1.5억·3천만·1억2천만, 참석자·결정 사항 메모, 줄 메뉴(추가·순서·쇼핑몰 연결·삭제), 인쇄

마이그레이션 015(project_db): goal_cell_merges.row_span + CHECK 교체, goal_meetings, goal_meeting_items
캐시 버전 20261001c, 테스트(DB 회귀 test_goal_rect_merges·test_goal_meetings)·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 11:46:25 +09:00
king 614747ffca fix(performance): 주문 내역 창 가로 스크롤 없애기 — 넓은 창(최대 1640px) + 상품명만 줄바꿈
- openModal opts.wide → .perf-modal-card.is-wide(min(1640px, 100%)), 금액 클릭 주문 내역 창에 사용
- 상품명 열(.perf-ev-name)만 줄바꿈(최소 220px), 나머지 열은 한 줄 그대로
- css·js 캐시 버전 올림

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:39:24 +09:00
king 931cc0d1d9 fix(performance): 토스쇼핑 환불 건별 표에 주문일을 메모가 아닌 별도 열로
- 원본 데이터 확인 → 환불 출처별 비교 건별 표: 환불일 · 주문일 · 주문번호 · 주문상품 · 금액 · 메모
  (예: 9/5 주문을 9/6 취소 → 환불일 9/6, 주문일 9/5), 메모에는 취소/반품·클레임 상태만
- 저장되는 환불 사건의 order_date(대시보드 금액 클릭 상세의 주문일 열)를 테스트로 확인
- performance.js 캐시 버전 20261001f

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:36:51 +09:00
king b6b4f8c360 feat(performance): 수수료 설정 일반 사용자에게 열기 · 매출 업데이트 쇼핑몰별 [중지](다음 쇼핑몰로 계속)
- 설정 화면을 실적 권한자 누구나 — 일반 사용자는 탭 "수수료 설정", 쇼핑몰 표에 쇼핑몰·수수료율·마지막 동기화만
  (사용·집계 토글·API 설정·연결 상태·아래 카드는 관리자만), 수수료율 API(조회·변경·이력 삭제)만 모듈 권한으로
- 쇼핑몰별 [중지]: POST /api/sync/jobs/{id}/shops/{code}/stop — 그 쇼핑몰만 다음 API 호출 직전에 멈추고 저장 안 함,
  업데이트는 다음 쇼핑몰로 계속. 차례 전 중지는 차례에 건너뜀, 저장 중·끝난 쇼핑몰은 409, 실행 기록 "쇼핑몰 중지"
- 진행 창 쇼핑몰 이름 옆 [중지] 버튼, 결과 요약에 "중지됨" 구분, css·js 캐시 버전 올림
- 테스트(test_sync_job_stop_shop)·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:30:46 +09:00
king ff81d80cf9 fix(performance): 토스쇼핑 환불 = 클레임 환불 완료 + 클레임 없는 결제취소(환불일) — 9/6 실데이터 11,900 일치
- 9/6: 9/5 주문(276435356)을 9/6 취소 11,900 — 클레임 refundedDt·canceledAt 둘 다 일치, 정산 REFUND 에는 없음
- merge_refunds: 클레임(CANCEL·RETURN, isRefunded, refundedDt) + 클레임 없는 CANCELED_PAYMENT(canceledAt),
  주문상품마다 한 번(toss:R{orderProductId}), 금액 = 주문상품 price(없으면 클레임 order.price), 교환·미환불 제외
- 수집 때 기간 앞 90일 주문도 불러 다른 날 주문의 환불을 잡는다, collect 직접 구현(정산 건별은 수집에 안 씀)
- 원본 데이터 확인: 환불 출처별 비교 첫 열 = 적용 규칙, 날짜별 표의 환불 = 저장되는 값
- performance.js 캐시 버전 20261001d, 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:21:36 +09:00
king 01000757f3 feat(performance): 토스쇼핑 원본 데이터 확인에 환불 후보 3가지(정산 REFUND·주문 취소 시각·클레임 환불 완료)
- 9/6 실데이터: 매출 29,600 일치, 환불 11,900 은 정산 건별 REFUND 에 없음(다른 날 주문을 9/6 에 환불)
- 후보 ① 정산 REFUND(현재 규칙) ② orders/v2 canceledAt(기간 90일 전 주문까지) ③ claims refundedDt(isRefunded)
  — 날짜별 합계를 나란히 + 건별(주문번호·금액·메모), 화면 숫자와 같은 후보로 규칙을 정한다
- 클레임 목록 개인정보(연락처·수거 주소·요청 사유·사진) 값·합계 숨김, 송장번호 합계도 숨김
- performance.js 캐시 버전 20261001c, 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:16:29 +09:00
king d75dec2a50 feat(performance): 토스쇼핑 매출 = 순 거래액(매출 − 환불) — 정산 건별 REFUND 를 환불일에 차감
- 사용자 지정: 토스쇼핑 파트너스 "순 거래액" 기준(9/6 화면 매출 29,600 − 환불 11,900 = 17,700)
- 환불: GET /settlement-steps dateCondition=TRANSACTION_DATE 의 stepType=REFUND 상품 줄 → CANCEL 사건,
  날짜 = transactionTs 한국 날짜, 금액 = -|orderProductPrice|, 배송비 줄 제외, 31일 구간 + nextToken
  (클레임 목록은 날짜로 거를 수 없고 결제완료 단계 고객 취소가 안 잡혀 정산 쪽을 사용)
- 원본 데이터 확인: 날짜별 매출(주문일)·환불(환불일)·순 거래액 + 정산 stepType 별 항목 합계
- 원본 확인 표의 매출 열 이름도 day_cols 로 바꿀 수 있게(performance.js), 캐시 버전 20261001b
- 테스트·문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 10:12:07 +09:00
king a45f78217c feat(performance): 토스쇼핑 매출 수집 — OAuth 토큰·주문 내역 조회(31일·커서)·원본 데이터 확인
- 인증: Access Key·Secret Key → POST oauth2.cert.toss.im/token(client_credentials, scope toss-shopping-fep:write),
  토큰(약 1년) 암호화 저장·재사용, 401 이면 한 번 새로 발급. 키 발급 때 등록한 IP 에서만 호출됨
- 입력칸 라벨을 Access Key / Secret Key 로(키 이름 api_key·api_secret 그대로 — 저장값 유지), 판매자 ID 칸 제거
- 수집: GET /api/v3/shopping-fep/orders/v2 31일 구간 + nextCursor, HTTP 200 + resultType FAIL 도 오류 처리
- 잠정 매출 규칙: 주문 단위(toss:{orderId}), 주문일(한국 날짜), price 합(할인 전·배송비 제외), 결제 전만 제외
- 설정 화면 "쇼핑몰 원본 데이터 확인"에 토스쇼핑 — 상태별 항목 합계·날짜별 현재 규칙 매출(개인정보 숨김)
- 테스트 3개 추가(토큰·연결·오류, 수집 규칙·구간·커서, 원본 확인 개인정보), 문서 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 09:36:42 +09:00
king d3761183c3 feat(project): 연간 목표 모든 열 너비 조절·지표 줄 틀 고정·항목 줄 위/아래 추가·삭제
- 연간·1~12월·상/하반기 열도 머리 칸 오른쪽 끝을 끌어 너비 조절(더블클릭 = 기본), localStorage pj_goal_col_w
  에 기본값과 다른 칸만 저장. 반기 접기 애니메이션의 안쪽 고정 폭은 --fold-w(병합 칸 = 걸친 월 너비 합)
- 세로 스크롤 틀 고정: 머리 줄 + 매출·로아스 지표 줄까지 sticky(줄마다 --kpi-top, stickKpi)
- 항목 칸 도구 막대에 + (아래에 줄 추가) 항상 표시, 우클릭 메뉴로 위/아래 줄 추가·줄 삭제
- POST /api/goals/areas/{id}/rows 에 ref_row_id·place(above|below) — 기준 줄 위/아래에 넣고 순서 다시 매김
- project.css/js 캐시 버전 20261001b, 문서·회귀 테스트 갱신

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 09:11:55 +09:00
king 5d07770ce2 feat(project): 연간 목표 상·하반기 칸·반기 접기·이름 바로 수정·월 칸 병합·로아스 %
- 6월·12월 오른쪽에 상반기·하반기 칸 추가. 매출 목표·실적은 반기 합계,
  달성률은 연간과 같은 규칙, 업무 영역 글 칸은 month 13·14 로 저장
- 반기 칸 머리 버튼으로 1~6월 / 7~12월 칸을 접었다 펴기(너비 애니메이션,
  localStorage pj_goal_fold). 표를 width:1px + table-layout:fixed 로 바꿔
  펼칠 때도 애니메이션이 적용되게 함
- 업무 영역·줄 이름을 눌러 그 자리에서 수정(✎ 버튼 제거)
- 월 칸 가로 병합(goal_cell_merges, 반기 안에서만): Shift+클릭 선택 후
  병합 버튼, 우클릭 메뉴로 좌/우 병합·해제. 병합 시 글은 월 순서대로 첫 칸에 모음
- 로아스 목표·실적 칸 % 표기
- 마이그레이션 014 (goal_cells month CHECK 0~14, goal_cell_merges)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 08:24:13 +09:00
king 91bdc12e78 chore(cafe24): 정리 전 완료된 작업 보존
Cafe24 수정, 테스트 및 DB 마이그레이션 파일을 함께 기록한다.
2026-10-01 02:29:19 +09:00
184 changed files with 31375 additions and 2365 deletions
+10
View File
@@ -43,6 +43,12 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
# GOOGLE_SHEETS_CREDENTIALS=/opt/www/main/secrets/google-sheets-sa.json
# 또는 파일 대신 JSON 본문을 통째로 (한 줄):
# GOOGLE_SHEETS_CREDENTIALS_JSON={"type":"service_account", ...}
#
# 주간 회의록 "회의록 보드"(주차마다 빈 Google 슬라이드) — 위 Google 인증을 같이 쓴다.
# OAuth 토큰은 Drive·Slides 권한까지 필요: scripts/google_sheets_authorize.py 로 다시 발급(시트 권한도 함께 들어감)
# Cloud Console 에서 Google Drive API·Google Slides API 사용 설정. 서비스 계정이면 공유 드라이브 콘텐츠 관리자로 추가.
# GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN=replace-me # 비우면 GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN 사용
# MEETING_BOARD_FOLDER_ID=0AGF3CIEboPQiUk9PVA # 보드를 만들 공유 드라이브(폴더) ID — 비우면 이 기본값
# ─── 휴가 관리 모듈 (vacation_db) ───
# 설정해야 모듈이 동작한다(미설정 시 "설정 필요" 안내, JSON 폴백 없음).
@@ -163,3 +169,7 @@ CUSTOMER_ORDER_LIST_URL=/orderlist/
# APP_ENCRYPTION_KEY_V1=
# [매출 업데이트] 가 가져오는 기간(오늘 포함 최근 N일, 기본 7, 최대 90)
# PERFORMANCE_SYNC_DAYS=7
# 자산관리 — 별도 asset_db. 사용자가 서버에서 asset_db_init.sql로 직접 초기화.
# 미설정 시 등록/배정은 비활성, HWiNFO XML 분석 미리보기는 사용 가능.
# ASSET_DB_URL=postgresql://asset_app:replace-me@postgres-db:5432/asset_db
+3
View File
@@ -16,3 +16,6 @@ PUBLIC_BASE_URL=http://localhost:8080
CS_ORDER_URL=https://cs.example.com
CUSTOMER_ORDER_LIST_URL=https://orders.example.com
# 자산관리 개발용 DB (사용자가 직접 생성). 운영 DB 접속정보를 사용하지 마세요.
# ASSET_DB_URL=postgresql://asset_app:replace-me@host.docker.internal:5432/asset_db
+3
View File
@@ -24,3 +24,6 @@ __pycache__/
# dispatch 라벨 PDF 샘플(실제 고객 PII — 커밋 금지)
docs/samples/
tests/js/.out/
# HWiNFO 실물 보고서: 시리얼/MAC/사용자 정보가 포함되어 소스에 보관하지 않음
KING-DESKTOP.XML
+7 -2
View File
@@ -36,10 +36,15 @@ Codex는 이 저장소에서 작업을 시작하기 전에 **반드시 아래
- 말레이시아 창고 재고관리 (`app/modules/malaysia/`, `malaysia_stock_db`) — 낱개(MT/MX/MZ) 입출고·조정, 세트(MY) BOM, 일일 재고조사(세트→낱개 자동 분해), 현재고 현황. 뚜껑(MD-)은 재고 집계 제외 — 단, 창고 랙에는 위치 확인용으로 배치 가능(`store.LID_ITEMS`). 상품은 `itemcode_db` 읽기 전용. 권한키 `malaysia`
- 말레이시아 배송 (`app/modules/dispatch/`, `dispatch_db`) — TikTok·Shopee 출고관리. 플랫폼별 데이터 엑셀 업로드(TikTok=03_TikTok_Order_Export.xlsx, Shopee=Packing List.Doorstep Delivery.xlsx) → 1박스=1카드 출고 작업 리스트·SKU 피킹 요약·Kagayaku 전달표 자동 생성. 1박스 묶음 기준 Package ID > Tracking ID > Order ID, 같은 박스 같은 SKU 합산. 작업 상태 토글(`dispatch_logs` 기록). 받는 사람 이름/전화/주소는 박스 단위로 저장(작업 카드 표시 + 출고 엑셀 생성용 — 개인정보). 배치 다운로드 zip 에 업로드 원본 + 취합 출고 엑셀(`YYYY.MM.DD(Ddd)_tictoc|shopee.xlsx`) 포함. 엑셀은 openpyxl 파싱/생성. 권한키 `dispatch`. 상세는 `docs/DISPATCH_MODULE.md`
- 카페24 상품관리 (`app/modules/cafe24/`, `cafe24_db`) — 카페24 관리자에 들어가지 않고 상품 상세페이지(description HTML) 조회·편집·즉시적용·예약적용·자동복원·버전 롤백·일괄수정. 카페24 OAuth/API 클라이언트는 향후 주문관리와 공유하기 위해 **공통 계층 `app/integrations/cafe24/`** 에 둔다 — 라우터에서 `httpx`/`requests` 직접 호출 금지. 토큰은 Fernet 암호화 저장(`CAFE24_TOKEN_SECRET`), 로그/화면에 토큰·시크릿 절대 미출력. 쓰기 직전 항상 카페24 현재 HTML 을 다시 읽어 `BACKUP` revision 생성(로컬 값을 현재값으로 가정 금지). 예약은 DB 저장 + 별도 worker(`app/modules/cafe24/worker.py`, compose 서비스 `dbx-cafe24-worker`)가 처리 — 웹 프로세스에서 대기하지 않는다. 권한키 `cafe24`(연결/해제는 admin 전용). 상세는 `docs/CAFE24_MODULE.md`
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 생성시 기본 4단계 seed)·멤버 배정(`project_members`)·활동이력(`project_activity`). 메인 뷰 달력(FullCalendar)/타임라인(vis-timeline) 버튼 토글 + 보드(드래그로 단계 이동)/리스트. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 프로젝트 생성/삭제·사용자 배정은 `is_admin` 만, 배정 멤버(또는 owner)는 서브프로젝트/업무/단계 CRUD. 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
- 프로젝트 관리 (`app/modules/project/`, `project_db`) — 아사나식. 프로젝트/서브프로젝트(self-FK `parent_id`, CASCADE)·업무(`tasks`: 담당자·우선순위·시작/마감)·진행단계(`project_stages` 칸반, 새 프로젝트는 섹션 없이 시작)·멤버 배정(`project_members`)·활동이력(`project_activity`). 메인 뷰 달력(FullCalendar)/타임라인(vis-timeline) 버튼 토글 + 보드(드래그로 단계 이동)/리스트. 진입 권한키 `project`(관리자 페이지 토글로 직원별 부여, admin 자동). 권한은 등급(수퍼관리자 > Admin > Pro user > User, 2026-10-12)과 멤버십 기준 — 표는 `docs/PROJECT_MODULE.md` 6-14, 공통 판단 `access.py`(관리자도 멤버가 아니면 프로젝트가 안 보임, 예외는 수퍼관리자). 멤버 배정 후보는 `project` 권한 보유 등록 사용자에서 자동 목록(`GET /project/api/assignable-users`). 업무 배정·완료 시 관리자에게 메일(`app/mail.py` stdlib smtplib, `SMTP_*`+`PROJECT_NOTIFY_EMAIL` env, 미설정 시 조용히 skip, `BackgroundTasks` 비동기). 상세는 `docs/PROJECT_MODULE.md`
상세는 `docs/PROJECT_OVERVIEW.md`.
- 자산관리 (`app/modules/asset/`, `asset_db`) — 사무집기·전산장비 등록/배정/반납/상태·구매/보증·이력.
HWiNFO XML 분석·사양 조회·이전 보고서와 원본 보존. 권한키 `asset`, 환경변수 `ASSET_DB_URL`.
사진 등록/갤러리·모니터 자산 조회/등록/연결·수퍼 관리자 삭제(이력/원본 보존). 기존 설치는 마이그레이션 `asset_db_002_photos_monitors.sql` 필요.
DB 미설정 시 저장 비활성, XML 분석 미리보기 가능. DB 생성은 사용자가 서버 명령으로 직접 진행. 상세 `docs/ASSET_MODULE.md`.
---
## 개발 원칙
@@ -47,7 +52,7 @@ Codex는 이 저장소에서 작업을 시작하기 전에 **반드시 아래
- 기존 코드를 수정하기 전 관련 파일을 먼저 읽고 구조를 파악한다.
- 위험 명령은 **반드시 사용자 확인 후** 실행한다 (아래 "위험 명령" 절 참고).
- `.env`, API 키, DB 비밀번호, OAuth Secret, 토큰은 절대 Git에 올리지 않는다.
- 신규 DB가 필요하면 **승인 요청 후** 생성하며, DB명은 반드시 `_db`로 끝낸다 (예: `inventory_db`).
- 신규 DB가 필요하면 **서버에서 실행할 명령을 제공하고 생성은 사용자가 직접 진행한다** (사용자 지시: 2026-10-06). DB명은 반드시 `_db`로 끝낸다 (예: `inventory_db`). 대상 서버·현재 DB·백업 상태와 생성 후 스키마·앱 계정 권한·연결 확인 명령을 함께 제공한다. 기존 DB 삭제·덮어쓰기 등 위험 명령은 아래의 별도 승인 원칙을 그대로 따른다.
- 예전 문서/코드의 `orderlist_app`은 현재 기준 `orderlist_db`이다. 발견 시 수정 대상.
---
+4 -3
View File
File diff suppressed because one or more lines are too long
+2
View File
@@ -45,6 +45,7 @@ from .errors import (
Cafe24AuthError,
Cafe24ConfigError,
Cafe24Error,
Cafe24FtpConflict,
Cafe24FtpError,
Cafe24RateLimitError,
)
@@ -80,6 +81,7 @@ __all__ = [
"Cafe24RateLimitError",
"Cafe24ApiError",
"Cafe24FtpError",
"Cafe24FtpConflict",
]
+12 -2
View File
@@ -164,6 +164,10 @@ class Cafe24Client:
method = method.upper()
forced_refresh = False
last_error: Exception | None = None
# 쓰기 요청이 카페24에 도달했을 수도 있는 시도가 있었나(5xx 응답·응답 전 끊김).
# 최종 오류에 실어 호출부가 "반영 여부 모름"을 구분하게 한다(errors.Cafe24ApiError).
writes = method in ("PUT", "POST", "DELETE", "PATCH")
maybe_applied = False
for attempt in range(self._max_retries + 1):
self._pace()
@@ -224,7 +228,9 @@ class Cafe24Client:
time.sleep(wait)
continue
error = Cafe24ApiError(message, status=status, endpoint=endpoint)
if writes and status >= 500:
maybe_applied = True
error = Cafe24ApiError(message, status=status, endpoint=endpoint, maybe_applied=maybe_applied)
if error.retryable and attempt < self._max_retries:
last_error = error
time.sleep(min(8.0, 0.5 * (2**attempt)))
@@ -241,7 +247,11 @@ class Cafe24Client:
http_status=status, result="ERROR", error_message=message,
duration_ms=elapsed,
)
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint)
# 연결조차 안 된 경우만 "도달하지 않음"이 확실하다. 그 밖(읽기 타임아웃,
# 응답 도중 끊김)은 카페24가 요청을 처리했을 수 있다.
if writes and not isinstance(exc, (httpx.ConnectError, httpx.ConnectTimeout)):
maybe_applied = True
last_error = Cafe24ApiError(message, status=0, endpoint=endpoint, maybe_applied=maybe_applied)
if attempt < self._max_retries:
time.sleep(min(8.0, 0.5 * (2**attempt)))
continue
+128 -17
View File
@@ -7,15 +7,28 @@ Admin API(OAuth)로는 스킨 파일을 다루지 못한다(`config.py` 상단
실물 확인(스크린샷): 호스트 `{mall_id}.ftp.cafe24.com`, 포트 21, SSL/TLS 미사용
(평문 FTP). 파일은 텍스트(UTF-8)로 다룬다.
쓰기는 원본에 직접 STOR 하지 않는다 (write_text_file)
직접 STOR 는 전송 도중 끊기면 원본이 **앞부분만 남은 채** 잘린다(스킨 템플릿이면
모든 상품 페이지가 깨진다). 그래서
1) 같은 폴더의 임시 파일에 올리고 (원본은 아직 그대로)
2) 다시 받아 바이트 단위로 검증하고
3) 교체 직전 원본을 다시 읽어 편집 시작 값과 같은지 확인하고(충돌 방지)
4) RNFR/RNTO 로 이름을 바꿔 교체한다
서버가 "이미 있는 이름으로 바꾸기"를 거부하면 원본을 옆 이름으로 비킨 뒤 교체하고,
실패하면 원본을 제자리로 되돌린다. 이름 바꾸기 자체를 지원하지 않으면 **중단**한다
(직접 STOR 로 물러서지 않는다).
"""
from __future__ import annotations
import ftplib
import io
import posixpath
import uuid
from .config import Cafe24FtpConfig
from .errors import Cafe24FtpError
from .errors import Cafe24FtpConflict, Cafe24FtpError
# 응답이 없을 때 무한 대기하지 않도록 — 관리 화면 요청 안에서 동기 호출되므로
# 너무 길면 안 되지만, 파일 하나(수십 KB) 전송에는 충분히 넉넉해야 한다.
@@ -35,37 +48,135 @@ def _connect(config: Cafe24FtpConfig) -> ftplib.FTP:
raise Cafe24FtpError(f"FTP 연결/로그인에 실패했습니다: {exc}") from exc
def _close(ftp: ftplib.FTP) -> None:
try:
ftp.quit()
except Exception: # noqa: BLE001 — 정리 실패는 무시
ftp.close()
def _retr(ftp: ftplib.FTP, path: str) -> bytes:
buf = io.BytesIO()
ftp.retrbinary(f"RETR {path}", buf.write)
return buf.getvalue()
def _delete_quiet(ftp: ftplib.FTP, path: str) -> None:
try:
ftp.delete(path)
except ftplib.all_errors:
pass # 임시 파일 정리 실패는 무시(이름에 cf24tmp 가 붙어 있어 구분된다)
def read_text_file(config: Cafe24FtpConfig, path: str) -> str:
"""디자인 보관함의 파일 1개를 읽어 텍스트로 돌려준다."""
ftp = _connect(config)
try:
buf = io.BytesIO()
try:
ftp.retrbinary(f"RETR {path}", buf.write)
raw = _retr(ftp, path)
except ftplib.all_errors as exc:
raise Cafe24FtpError(f"파일을 읽지 못했습니다({path}): {exc}") from exc
try:
return buf.getvalue().decode("utf-8")
return raw.decode("utf-8")
except UnicodeDecodeError as exc:
raise Cafe24FtpError(f"파일 인코딩을 UTF-8로 해석하지 못했습니다({path}): {exc}") from exc
finally:
try:
ftp.quit()
except Exception: # noqa: BLE001 — 정리 실패는 무시
ftp.close()
_close(ftp)
def write_text_file(config: Cafe24FtpConfig, path: str, content: str) -> None:
"""디자인 보관함의 파일 1개를 통째로 덮어쓴다."""
def temp_names(path: str, tag: str) -> tuple[str, str]:
"""(임시 업로드 이름, 원본을 잠시 비킬 이름) — 같은 폴더, 원본 이름 + 표식."""
folder, name = posixpath.split(path)
return (posixpath.join(folder, f"{name}.cf24tmp-{tag}"),
posixpath.join(folder, f"{name}.cf24old-{tag}"))
def write_text_file(
config: Cafe24FtpConfig, path: str, content: str, *, expected_current: str | None = None
) -> None:
"""디자인 보관함의 파일 1개를 안전하게 교체한다(모듈 설명 참고).
expected_current: 편집 시작(또는 백업) 때 읽은 원본. 주면 교체 직전 원본을 다시
읽어 다르면 Cafe24FtpConflict 로 멈춘다(원본 그대로).
실패 시 Cafe24FtpError — maybe_applied=True 면 원본이 이미 바뀌었을 수 있다.
"""
data = content.encode("utf-8")
tmp, aside = temp_names(path, uuid.uuid4().hex[:10])
ftp = _connect(config)
try:
buf = io.BytesIO(content.encode("utf-8"))
# 1) 임시 파일에 올린다 — 원본은 아직 그대로다.
try:
ftp.storbinary(f"STOR {path}", buf)
ftp.storbinary(f"STOR {tmp}", io.BytesIO(data))
except ftplib.all_errors as exc:
raise Cafe24FtpError(f"파일을 쓰지 못했습니다({path}): {exc}") from exc
finally:
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(f"임시 파일을 올리지 못했습니다 — 원본은 그대로입니다({path}): {exc}") from exc
# 2) 검증 — 다시 받아 바이트 단위로 비교한다(전송이 잘렸으면 여기서 잡힌다).
try:
ftp.quit()
except Exception: # noqa: BLE001 — 정리 실패는 무시
ftp.close()
uploaded = _retr(ftp, tmp)
except ftplib.all_errors as exc:
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(f"올린 임시 파일을 확인하지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
if uploaded != data:
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(
f"올린 임시 파일이 보낸 내용과 다릅니다({len(uploaded)}/{len(data)}바이트) — 원본은 그대로입니다."
)
# 3) 충돌 확인 — 교체 직전의 원본이 편집 시작 값 그대로인가.
if expected_current is not None:
try:
now = _retr(ftp, path)
except ftplib.all_errors as exc:
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(f"교체 직전 원본을 다시 읽지 못했습니다 — 원본은 그대로입니다: {exc}") from exc
if now != expected_current.encode("utf-8"):
_delete_quiet(ftp, tmp)
raise Cafe24FtpConflict(
"적용하는 사이 FTP 파일이 바뀌었습니다 — 원본은 그대로입니다. 새로고침해 확인한 뒤 다시 적용하세요."
)
# 4) 교체 — 이름 바꾸기. 덮어쓰기를 거부하는 서버면 원본을 비킨 뒤 교체한다.
moved_aside = False
try:
ftp.rename(tmp, path)
except ftplib.all_errors as first:
try:
ftp.rename(path, aside)
except ftplib.all_errors as exc:
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(
"이 FTP 서버가 파일 이름 바꾸기(rename)를 지원하지 않아 중단했습니다 — 원본은 그대로입니다. "
f"({first} / {exc})"
) from exc
try:
ftp.rename(tmp, path)
except ftplib.all_errors as exc:
try:
ftp.rename(aside, path)
except ftplib.all_errors as exc2:
raise Cafe24FtpError(
f"교체에 실패했고 원본 되돌리기도 실패했습니다. FTP 에서 {aside} 를 {path} 로 "
f"직접 되돌리세요: {exc} / {exc2}",
maybe_applied=True,
) from exc2
_delete_quiet(ftp, tmp)
raise Cafe24FtpError(f"교체에 실패해 원본을 되돌렸습니다: {exc}") from exc
moved_aside = True
# 5) 확인 — 교체 뒤 원본 경로가 새 내용인가.
try:
final = _retr(ftp, path)
except ftplib.all_errors as exc:
raise Cafe24FtpError(
f"교체 뒤 확인 조회에 실패했습니다 — 적용됐을 수 있으니 파일을 다시 열어 확인하세요: {exc}",
maybe_applied=True,
) from exc
if final != data:
raise Cafe24FtpError(
"교체 뒤 파일 내용이 보낸 것과 다릅니다 — 파일을 다시 열어 확인하세요.", maybe_applied=True
)
if moved_aside:
_delete_quiet(ftp, aside)
finally:
_close(ftp)
+22 -3
View File
@@ -32,16 +32,35 @@ class Cafe24RateLimitError(Cafe24Error):
class Cafe24FtpError(Cafe24Error):
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등)."""
"""디자인 보관함 FTP 연결/전송 실패 (product-swiper.js 편집 등).
maybe_applied: 원본 경로가 이미 새 내용으로 바뀌었을 수 있다(교체 뒤 확인 단계 실패).
False 면 원본은 그대로다(임시 파일 단계에서 멈춤).
"""
def __init__(self, message: str, *, maybe_applied: bool = False):
super().__init__(message)
self.maybe_applied = maybe_applied
class Cafe24FtpConflict(Cafe24FtpError):
"""교체 직전 다시 읽은 원본이 편집 시작 때와 다르다 — 남의 수정을 덮지 않고 멈춘다."""
class Cafe24ApiError(Cafe24Error):
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다."""
"""그 외 API 오류(4xx/5xx). status 로 재시도 가능 여부를 판단한다.
def __init__(self, message: str, *, status: int = 0, endpoint: str = ""):
maybe_applied: 쓰기 요청(PUT/POST/DELETE)이 카페24에 **도달했을 수도** 있는가.
응답을 받기 전에 끊겼거나(읽기 타임아웃 등) 5xx 를 받은 시도가 한 번이라도
있으면 True — 반영됐는지 모르므로 호출부는 재적용하지 말고 "확인 필요"로 둔다.
연결 자체가 안 된 경우(ConnectError)와 4xx 는 반영되지 않은 것이 확실하다.
"""
def __init__(self, message: str, *, status: int = 0, endpoint: str = "", maybe_applied: bool = False):
super().__init__(message)
self.status = status
self.endpoint = endpoint
self.maybe_applied = maybe_applied
@property
def retryable(self) -> bool:
+40 -10
View File
@@ -22,6 +22,7 @@ from dataclasses import dataclass
from typing import Any
from .client import Cafe24Client
from .errors import Cafe24Error
# 카페24 상품 목록 API 의 1회 최대 조회 수
PAGE_LIMIT = 100
@@ -476,26 +477,55 @@ def wait_for_variants(
return latest
VARIANT_CHUNK = 100 # 카페24 문서상 PUT variants 1회 최대 건수
# update_variants 행별 결과 상태
VARIANT_OK = "ok" # 카페24가 받아들임
VARIANT_FAILED = "failed" # 거절 — 반영되지 않음이 확실
VARIANT_UNKNOWN = "unknown" # 요청이 도달했을 수 있으나 응답을 못 받음 — 반영 여부 모름
def update_variants(
client: Cafe24Client, product_no: int, requests: list[dict[str, Any]]
) -> list[dict[str, Any]]:
"""여러 품목 부분 수정. 100건씩 나눠 보낸다(문서상 1회 100건 제한)."""
"""여러 품목 부분 수정 — **행별 결과**를 돌려준다(요청 순서 그대로).
[{"variant_code": "...", "status": "ok"|"failed"|"unknown",
"error": "", "variant": {카페24 응답의 그 품목 — 없으면 {}}}]
100건씩 나눠 보낸다(문서상 1회 100건 제한). 한 묶음이 실패해도 멈추지 않고 다음
묶음을 보낸다 — 앞 묶음이 이미 반영됐는데 전체를 실패로 알리면 화면과 카페24가
어긋나고, 사용자가 반영된 행까지 다시 보내게 된다. 호출부는 ok 인 행만 반영됨으로
기록한다.
"""
no = int(product_no)
out: list[dict[str, Any]] = []
for start in range(0, len(requests), 100):
chunk = requests[start : start + 100]
for start in range(0, len(requests), VARIANT_CHUNK):
chunk = requests[start : start + VARIANT_CHUNK]
if not chunk:
continue
payload = client.put(
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
)
try:
payload = client.put(
f"/admin/products/{no}/variants", json={"shop_no": 1, "requests": chunk}, product_no=no
)
except Cafe24Error as exc:
status = VARIANT_UNKNOWN if getattr(exc, "maybe_applied", False) else VARIANT_FAILED
for row in chunk:
out.append({"variant_code": str(row.get("variant_code") or ""), "status": status,
"error": str(exc), "variant": {}})
continue
result = payload.get("variants") if isinstance(payload, dict) else None
returned: list[dict[str, Any]] = []
if isinstance(result, list):
out.extend(result)
returned = [r for r in result if isinstance(r, dict)]
elif isinstance(result, dict):
out.append(result)
elif isinstance(payload.get("variant"), dict):
out.append(payload["variant"])
returned = [result]
elif isinstance(payload, dict) and isinstance(payload.get("variant"), dict):
returned = [payload["variant"]]
by_code = {str(r.get("variant_code") or ""): r for r in returned}
for row in chunk:
code = str(row.get("variant_code") or "")
out.append({"variant_code": code, "status": VARIANT_OK, "error": "", "variant": by_code.get(code, {})})
return out
+184
View File
@@ -0,0 +1,184 @@
"""Google 슬라이드(회의록 보드) 공통 계층 — 공유 드라이브 폴더에 빈 슬라이드를 만들거나 찾는다.
인증은 google_sheets 와 같은 설정을 쓰되 권한 범위(scope)가 다르다(Drive + Slides).
설정된 쪽을 자동 선택(서비스 계정 우선).
1) 사용자 OAuth 리프레시 토큰
· `GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN` — 없으면 `GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN`
토큰은 Drive·Slides 권한까지 받아야 한다: `python scripts/google_sheets_authorize.py`(스프레드시트·Drive·Slides 한 번에)
· `GOOGLE_SHEETS_OAUTH_CLIENT_ID` / `..._SECRET`(없으면 로그인용 `GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET`)
2) 서비스 계정 JSON — `GOOGLE_SHEETS_CREDENTIALS` / `GOOGLE_SHEETS_CREDENTIALS_JSON`
서비스 계정 이메일을 대상 공유 드라이브의 **콘텐츠 관리자** 이상으로 추가해야 한다.
- 회의록 보드 폴더: `MEETING_BOARD_FOLDER_ID`(기본 = 회의록 보드 공유 드라이브).
- 같은 주차 보드를 다시 누르면 새로 만들지 않고 Drive 파일 appProperties(`dbxMeetingWeek` = 주차 시작일)로 찾는다
— 파일 이름을 바꿔도 같은 보드가 열린다. 휴지통에 버리면 다음에 새로 만든다.
- 비밀값(키/토큰)은 로그·화면에 절대 출력하지 않는다. 라이브러리·설정이 없으면 `enabled = False`.
"""
from __future__ import annotations
import json
import os
import re
import threading
from typing import Any
SCOPES = ["https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/presentations"]
TOKEN_URI = "https://oauth2.googleapis.com/token"
DEFAULT_BOARD_FOLDER_ID = "0AGF3CIEboPQiUk9PVA"
PRESENTATION_MIME = "application/vnd.google-apps.presentation"
WEEK_KEY = "dbxMeetingWeek"
# googleapiclient 의 HTTP 클라이언트는 스레드 안전하지 않고, 같은 주차를 두 사람이 동시에 누르면
# 보드가 두 개 생길 수 있으므로 찾기·만들기는 한 번에 하나씩.
_LOCK = threading.Lock()
class GoogleSlidesError(RuntimeError):
"""화면에 보여도 되는 사유(비밀값 없음)."""
def board_folder_id() -> str:
return (os.getenv("MEETING_BOARD_FOLDER_ID") or "").strip() or DEFAULT_BOARD_FOLDER_ID
def board_url(file_id: str) -> str:
return f"https://docs.google.com/presentation/d/{file_id}/edit"
class GoogleSlidesClient:
def __init__(self) -> None:
self.enabled = False
self.reason = ""
self.auth_mode = ""
self._drive: Any = None
self._slides: Any = None
try:
from googleapiclient.discovery import build
except ImportError:
self.reason = "google-api-python-client 미설치"
return
creds = self._service_account_creds()
if creds is None:
creds = self._oauth_creds()
if creds is None:
if not self.reason:
self.reason = "Google 인증 미설정(GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN 또는 GOOGLE_SHEETS_* 설정 필요)"
return
try:
self._drive = build("drive", "v3", credentials=creds, cache_discovery=False)
self._slides = build("slides", "v1", credentials=creds, cache_discovery=False)
except Exception as exc: # noqa: BLE001 — 사유만(비밀값 미출력)
self.reason = f"Google 클라이언트 생성 실패: {type(exc).__name__}"
return
self.enabled = True
# ── 인증(google_sheets 와 같은 설정, 범위만 Drive·Slides) ──
def _service_account_creds(self) -> Any:
raw = (os.getenv("GOOGLE_SHEETS_CREDENTIALS_JSON") or "").strip()
path = (os.getenv("GOOGLE_SHEETS_CREDENTIALS") or "").strip()
if not raw and not path:
return None
try:
info = json.loads(raw) if raw else json.loads(open(path, encoding="utf-8").read())
from google.oauth2.service_account import Credentials
creds = Credentials.from_service_account_info(info, scopes=SCOPES)
except Exception as exc: # noqa: BLE001
self.reason = f"서비스 계정 인증 실패: {type(exc).__name__}"
return None
self.auth_mode = "service_account"
return creds
def _oauth_creds(self) -> Any:
token = (os.getenv("GOOGLE_SLIDES_OAUTH_REFRESH_TOKEN") or os.getenv("GOOGLE_SHEETS_OAUTH_REFRESH_TOKEN") or "").strip()
if not token:
return None
cid = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_ID") or os.getenv("GOOGLE_CLIENT_ID") or "").strip()
secret = (os.getenv("GOOGLE_SHEETS_OAUTH_CLIENT_SECRET") or os.getenv("GOOGLE_CLIENT_SECRET") or "").strip()
if not cid or not secret:
self.reason = "GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET 미설정"
return None
try:
from google.oauth2.credentials import Credentials
creds = Credentials(token=None, refresh_token=token, token_uri=TOKEN_URI,
client_id=cid, client_secret=secret, scopes=SCOPES)
except Exception as exc: # noqa: BLE001
self.reason = f"OAuth 자격 생성 실패: {type(exc).__name__}"
return None
self.auth_mode = "oauth"
return creds
# ────────────────────────────────────────────────
def open_week_board(self, *, folder_id: str, week_key: str, title: str) -> dict[str, Any]:
"""그 주차 보드(빈 슬라이드)를 찾고, 없으면 폴더에 만든다 → {id, url, created}."""
if not self.enabled:
raise GoogleSlidesError(self.reason or "Google 슬라이드 연동이 꺼져 있습니다.")
with _LOCK:
try:
found = self._find(folder_id, week_key)
if found:
return {"id": found, "url": board_url(found), "created": False}
file_id = self._create_blank(folder_id, week_key, title)
except GoogleSlidesError:
raise
except Exception as exc: # noqa: BLE001
raise GoogleSlidesError(_friendly(exc)) from None
return {"id": file_id, "url": board_url(file_id), "created": True}
def _find(self, folder_id: str, week_key: str) -> str | None:
q = (f"'{folder_id}' in parents and trashed = false and mimeType = '{PRESENTATION_MIME}' "
f"and appProperties has {{ key='{WEEK_KEY}' and value='{week_key}' }}")
res = self._drive.files().list(
q=q, fields="files(id)", pageSize=1, supportsAllDrives=True, includeItemsFromAllDrives=True,
corpora="allDrives",
).execute()
files = res.get("files") or []
return files[0]["id"] if files else None
def _create_blank(self, folder_id: str, week_key: str, title: str) -> str:
meta = {"name": title, "mimeType": PRESENTATION_MIME, "parents": [folder_id],
"appProperties": {WEEK_KEY: week_key}}
file_id = self._drive.files().create(body=meta, fields="id", supportsAllDrives=True).execute()["id"]
# 새 프레젠테이션의 첫 장은 "제목·부제목" 틀(TITLE 레이아웃) — 틀 없는 빈 장(BLANK) 하나만 남긴다
pres = self._slides.presentations().get(presentationId=file_id, fields="slides.objectId").execute()
reqs: list[dict[str, Any]] = [{"createSlide": {"insertionIndex": 0, "slideLayoutReference": {"predefinedLayout": "BLANK"}}}]
reqs += [{"deleteObject": {"objectId": s["objectId"]}} for s in pres.get("slides") or []]
self._slides.presentations().batchUpdate(presentationId=file_id, body={"requests": reqs}).execute()
return file_id
def _friendly(exc: Exception) -> str:
"""Google API 오류 → 화면용 문구(비밀값·원문 응답 미포함)."""
status = getattr(getattr(exc, "resp", None), "status", None)
text = str(exc)
# 토큰 갱신 실패(RefreshError) — Google 이 준 OAuth 오류 코드(비밀값 아님)를 보여 원인을 바로 알 수 있게
m = re.search(r"\b(invalid_scope|invalid_grant|invalid_client|unauthorized_client|deleted_client|access_denied|invalid_request)\b", text)
code = m.group(1) if m else ""
if code in ("unauthorized_client", "invalid_client", "deleted_client"):
return (f"Google 토큰 갱신 실패({code}) — 토큰을 발급한 OAuth 클라이언트와 서버 .env 의 "
"GOOGLE_SHEETS_OAUTH_CLIENT_ID/SECRET(없으면 GOOGLE_CLIENT_ID/SECRET)이 다릅니다.")
if "invalid_scope" in text or "insufficient" in text.lower() or "ACCESS_TOKEN_SCOPE_INSUFFICIENT" in text:
return "Google 권한(Drive·Slides)이 없는 토큰입니다. 토큰을 다시 발급해 주세요(scripts/google_sheets_authorize.py)."
if "invalid_grant" in text:
return "Google 토큰이 만료·폐기되었습니다. 토큰을 다시 발급해 주세요."
if status == 404:
return "회의록 보드 폴더를 찾을 수 없습니다(MEETING_BOARD_FOLDER_ID·공유 드라이브 접근 권한 확인)."
if status == 403:
return "Google Drive·Slides 접근이 거부되었습니다(API 사용 설정·공유 드라이브 권한 확인)."
return f"Google 슬라이드 처리 실패({type(exc).__name__}{f' {status}' if status else ''}{f' {code}' if code else ''})."
_CLIENT: GoogleSlidesClient | None = None
_CLIENT_LOCK = threading.Lock()
def get_client() -> GoogleSlidesClient:
"""프로세스당 하나(설정이 비어 있으면 매번 다시 확인 — .env 를 고치고 재시작 없이도 사유가 갱신되게)."""
global _CLIENT
with _CLIENT_LOCK:
if _CLIENT is None or not _CLIENT.enabled:
_CLIENT = GoogleSlidesClient()
return _CLIENT
+39 -3
View File
@@ -15,6 +15,8 @@ from pydantic import BaseModel
from starlette.middleware.sessions import SessionMiddleware
from .modules.cafe24 import build_cafe24_store
from .modules.asset import build_asset_store
from .modules.asset import router as asset_router
from .modules.cafe24 import router as cafe24_router
from .modules.cupang import build_cupang_store, build_itemcode_reader
from .modules.cupang import router as cupang_router
@@ -33,6 +35,8 @@ from .modules.vacation import router as vacation_router
from .store import (
APPROVER_KEYS,
MODULE_KEYS,
ROLE_LABELS,
ROLES,
SUPER_ADMIN_EMAIL,
UserStore,
allowed_modules,
@@ -52,6 +56,7 @@ MODULE_LABELS: dict[str, str] = {
"project": "프로젝트 관리",
"cafe24": "카페24 상품관리",
"performance": "실적",
"asset": "자산관리",
"expense_approver": "개인경비",
"vacation_approver": "휴가",
}
@@ -140,6 +145,7 @@ _MODULE_TEMPLATE_DIRS = [
BASE_DIR / "modules" / "project" / "templates",
BASE_DIR / "modules" / "cafe24" / "templates",
BASE_DIR / "modules" / "performance" / "templates",
BASE_DIR / "modules" / "asset" / "templates",
]
templates = Jinja2Templates(directory=str(BASE_DIR / "templates"))
templates.env.loader = ChoiceLoader(
@@ -202,6 +208,7 @@ app.state.cafe24_store = build_cafe24_store(dsn=env("CAFE24_DB_URL") or None)
# 실적(쇼핑몰 통합 매출): PERFORMANCE_DB_URL 없으면 store=None(라우터가 "설정 필요" 안내).
# 쇼핑몰 API 인증정보는 설정 화면에서 입력 → APP_ENCRYPTION_KEY 로 암호화해 performance_db 에 저장.
app.state.performance_store = build_performance_store(dsn=env("PERFORMANCE_DB_URL") or None)
app.state.asset_store = build_asset_store(dsn=env("ASSET_DB_URL") or None)
# 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄.
app.include_router(expense_router)
@@ -212,6 +219,7 @@ app.include_router(dispatch_router)
app.include_router(project_router)
app.include_router(cafe24_router)
app.include_router(performance_router)
app.include_router(asset_router)
def public_url_for(request: Request, route_name: str) -> str:
@@ -376,7 +384,7 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
},
{
"key": "project",
"title": "프로젝트 관리",
"title": "Project",
"subtitle": "Projects",
"description": "프로젝트·서브프로젝트·업무를 달력/타임라인/보드로 관리합니다(아사나식).",
"url": "/project/",
@@ -405,6 +413,11 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
"category": "관리",
},
]
items.append({
"key": "asset", "title": "자산관리", "subtitle": "Asset Management",
"description": "사무집기·전산장비의 배정·반납·구매 이력과 HWiNFO 컴퓨터 사양을 관리합니다.",
"url": "/asset/", "health_url": "/asset/health", "status": "ready", "category": "관리",
})
allowed = allowed_modules(user_rec)
for item in items:
item["allowed"] = item["key"] in allowed
@@ -414,6 +427,7 @@ def _menu_items_for(user_rec: dict[str, Any]) -> list[dict[str, Any]]:
def _icon_svg(name: str) -> str:
"""좌측 사이드바용 인라인 아이콘. 외부 의존 없는 작은 SVG."""
paths = {
"asset": '<rect x="3" y="3" width="18" height="13" rx="2"/><path d="M8 21h8M12 16v5"/><path d="M7 7h10M7 11h6"/>',
"home": '<path d="M3 11 12 3l9 8"/><path d="M5 10v10h14V10"/>',
"expense": '<rect x="3" y="6" width="18" height="13" rx="2"/><path d="M3 10h18"/><path d="M7 15h4"/>',
"vacation": '<path d="M8 2v4"/><path d="M16 2v4"/><rect x="3" y="6" width="18" height="15" rx="2"/><path d="M3 11h18"/>',
@@ -476,16 +490,36 @@ def build_erp_nav(
return items
def _login_orbit_names(limit: int = 40) -> list[str]:
"""로그인 화면 왼쪽 패널 — King 주위를 도는 사용자 아이디(이메일 @ 앞, 첫 글자 대문자). 이메일·실명은 내보내지 않는다."""
names: set[str] = set()
try:
users = user_store.list_all()
except Exception: # noqa: BLE001 — 장식이라 실패해도 로그인 화면은 그대로
return []
for u in users:
email = str(u.get("email") or "").lower().strip()
local = email.split("@", 1)[0]
if not local or email == SUPER_ADMIN_EMAIL:
continue
names.add(local[:1].upper() + local[1:])
return sorted(names)[:limit]
def _render_login(request: Request) -> HTMLResponse:
return render_template(request, "login.html", {"orbit_names": _login_orbit_names()})
@app.get("/", response_class=HTMLResponse)
async def home(request: Request) -> HTMLResponse:
sess = get_session_user(request)
if not sess:
return render_template(request, "login.html")
return _render_login(request)
user_rec = user_store.get(sess["email"])
if user_rec is None:
# 도메인은 통과했으나 저장소에 없음 — 세션 정리 후 재로그인
request.session.clear()
return render_template(request, "login.html")
return _render_login(request)
# 슈퍼 관리자 → 업무 모듈 선택 화면(main.html).
# 일반 사용자 → ERP 메인(좌측 메뉴 + 우측 콘텐츠).
@@ -631,6 +665,8 @@ async def admin_page(request: Request) -> HTMLResponse:
"module_keys": list(MODULE_KEYS),
"module_labels": MODULE_LABELS,
"approver_keys": list(APPROVER_KEYS),
"roles": list(ROLES),
"role_labels": ROLE_LABELS,
"super_admin_email": SUPER_ADMIN_EMAIL,
"is_admin": True,
},
+9
View File
@@ -0,0 +1,9 @@
"""Company asset management; PostgreSQL only, never creates databases at startup."""
from .router import router
def build_asset_store(*, dsn: str | None):
if not dsn:
return None
from .db import AssetStore
return AssetStore(dsn)
+282
View File
@@ -0,0 +1,282 @@
"""자산·보고서·이력을 함께 저장합니다. DB 생성은 사용자가 서버에서 SQL로 진행합니다."""
from __future__ import annotations
import uuid
from datetime import date, datetime
from decimal import Decimal
from psycopg.rows import dict_row
from psycopg.types.json import Jsonb
from psycopg_pool import ConnectionPool
from .store import AssetConflict, transition
from .media import MAX_PHOTOS
from .monitors import compatible_monitor, monitor_devices
FIELDS = ("tag", "name", "category", "manufacturer", "model", "serial", "location", "department",
"purchased_on", "purchase_cost", "vendor", "warranty_until", "notes")
SORTS = {"updated": "a.updated_at DESC", "name": "a.name ASC", "tag": "a.tag ASC",
"cost": "a.purchase_cost DESC NULLS LAST", "warranty": "a.warranty_until ASC NULLS LAST"}
def serialize(row):
if row is None:
return None
return {k: (v.isoformat() if isinstance(v, (date, datetime)) else str(v) if isinstance(v, Decimal) else v)
for k, v in row.items()}
def filters(q="", category="", status="", location="", assignee="", warranty=False, group=""):
conditions, params = ["a.deleted_at IS NULL"], []
if q:
# %와 _도 입력한 글자 그대로 검색합니다. 검색어는 SQL과 분리해서 전달합니다.
value = "%" + q.replace("\\", "\\\\").replace("%", "\\%").replace("_", "\\_") + "%"
conditions.append("(concat_ws(' ',a.tag,a.name,a.model,a.serial,a.manufacturer,a.location,a.department,a.assignee_email) ILIKE %s)")
params.append(value)
for col, value in (("category", category), ("status", status), ("location", location), ("assignee_email", assignee)):
if value:
conditions.append(f"a.{col} = %s")
params.append(value)
if warranty:
conditions.append("a.warranty_until BETWEEN (now() AT TIME ZONE 'Asia/Seoul')::date AND (now() AT TIME ZONE 'Asia/Seoul')::date + 30 AND a.status <> 'retired'")
if group == "furniture":
conditions.append("a.category IN ('desk','chair','furniture')")
elif group == "computer":
conditions.append("a.category NOT IN ('desk','chair','furniture')")
return " AND ".join(conditions), params
class AssetStore:
def __init__(self, dsn):
self._pool = ConnectionPool(dsn, min_size=0, max_size=5, timeout=5, open=False,
kwargs={"row_factory": dict_row, "autocommit": True})
self._pool.open(wait=False)
def close(self):
self._pool.close()
def health(self):
with self._pool.connection(timeout=5) as conn:
conn.execute("SELECT id,deleted_at FROM assets LIMIT 1")
conn.execute("SELECT id FROM asset_photos LIMIT 0")
conn.execute("SELECT monitor_key FROM asset_monitor_links LIMIT 0")
def list_assets(self, *, page=1, page_size=25, sort="updated", **kwargs):
# 전체 개수와 목록을 같은 시점의 데이터로 읽어 페이지 숫자가 어긋나지 않게 합니다.
where, params = filters(**kwargs)
with self._pool.connection() as conn, conn.transaction():
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
total = conn.execute(f"SELECT count(*) AS n FROM assets a WHERE {where}", params).fetchone()["n"]
rows = conn.execute(
f"SELECT a.*,r.parsed->'summary' AS specs,r.uploaded_at AS report_at FROM assets a "
"LEFT JOIN asset_reports r ON r.id=a.latest_report_id "
f"WHERE {where} ORDER BY {SORTS.get(sort, SORTS['updated'])},a.id LIMIT %s OFFSET %s",
[*params, page_size, (page - 1) * page_size]).fetchall()
return {"items": [serialize(r) for r in rows], "total": total, "page": page, "page_size": page_size}
def dashboard(self):
with self._pool.connection() as conn, conn.transaction():
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
totals = conn.execute("""SELECT count(*) AS total,
count(*) FILTER(WHERE status='available') AS available,
count(*) FILTER(WHERE status='in_use') AS in_use,
count(*) FILTER(WHERE status='maintenance') AS maintenance,
count(*) FILTER(WHERE status='lost') AS lost,
count(*) FILTER(WHERE status='retired') AS retired,
coalesce(sum(purchase_cost) FILTER(WHERE status<>'retired'),0) AS purchase_total,
count(*) FILTER(WHERE status<>'retired' AND warranty_until BETWEEN
(now() AT TIME ZONE 'Asia/Seoul')::date AND (now() AT TIME ZONE 'Asia/Seoul')::date+30) AS warranty_soon
FROM assets WHERE deleted_at IS NULL""").fetchone()
categories = conn.execute("SELECT category,count(*) AS count FROM assets WHERE deleted_at IS NULL GROUP BY category ORDER BY count(*) DESC,category").fetchall()
locations = conn.execute("SELECT DISTINCT location FROM assets WHERE location<>'' AND deleted_at IS NULL ORDER BY location").fetchall()
activity = conn.execute("SELECT e.*,a.tag,a.name FROM asset_events e JOIN assets a ON a.id=e.asset_id WHERE a.deleted_at IS NULL ORDER BY e.id DESC LIMIT 12").fetchall()
return {"totals": serialize(totals), "categories": categories, "locations": [r["location"] for r in locations],
"activity": [serialize(r) for r in activity]}
def detail(self, asset_id):
with self._pool.connection() as conn, conn.transaction():
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
asset = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL", (asset_id,)).fetchone()
if not asset:
raise KeyError(asset_id)
reports = conn.execute("SELECT id,filename,sha256,uploaded_at,actor,parsed->'summary' AS summary,parsed->>'scan_time' AS scan_time FROM asset_reports WHERE asset_id=%s ORDER BY uploaded_at DESC,id DESC", (asset_id,)).fetchall()
report = conn.execute("SELECT id,filename,uploaded_at,parsed FROM asset_reports WHERE id=%s AND asset_id=%s", (asset["latest_report_id"], asset_id)).fetchone() if asset["latest_report_id"] else None
events = conn.execute("SELECT * FROM asset_events WHERE asset_id=%s ORDER BY id DESC LIMIT 200", (asset_id,)).fetchall()
photos = conn.execute("SELECT id,filename,width,height,uploaded_at,actor FROM asset_photos WHERE asset_id=%s ORDER BY uploaded_at DESC,id", (asset_id,)).fetchall()
monitors = self._monitor_matches(conn, asset_id, report["parsed"]) if report else []
return {"asset": serialize(asset), "report": serialize(report), "reports": [serialize(r) for r in reports],
"events": [serialize(r) for r in events], "photos": [serialize(r) for r in photos], "monitors": monitors}
@staticmethod
def _lock(conn, asset_id, version):
# 같은 자산을 동시에 변경할 때 먼저 저장한 사용자의 값을 보호합니다.
asset = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL FOR UPDATE", (asset_id,)).fetchone()
if not asset or asset.get("deleted_at"):
raise KeyError(asset_id)
if asset["version"] != version:
raise AssetConflict("다른 사용자가 수정했습니다. 상세 화면을 새로 열고 다시 시도하세요.")
return asset
@staticmethod
def _event(conn, asset_id, actor, kind, note, changes):
conn.execute("INSERT INTO asset_events(asset_id,actor,kind,note,changes) VALUES(%s,%s,%s,%s,%s)",
(asset_id, actor, kind, note, Jsonb(changes)))
def create(self, payload, actor, report=None):
with self._pool.connection() as conn, conn.transaction():
return self._create(conn, payload, actor, report)
def _create(self, conn, payload, actor, report=None):
# 모니터 등록도 같은 트랜잭션 안에서 자산 생성과 연결을 함께 처리합니다.
data = payload.model_dump()
asset_id = uuid.uuid4().hex
if not data["tag"]:
data["tag"] = "AST-" + str(conn.execute("SELECT nextval('asset_tag_seq') AS n").fetchone()["n"]).zfill(6)
conn.execute(f"INSERT INTO assets(id,{','.join(FIELDS)}) VALUES({','.join(['%s'] * (len(FIELDS) + 1))})",
[asset_id, *[data[k] for k in FIELDS]])
self._event(conn, asset_id, actor, "create", "자산 등록", {"after": serialize(data)})
if report:
if data["category"] != "computer":
raise ValueError("HWiNFO 보고서는 컴퓨터 자산에만 연결할 수 있습니다.")
self._save_report(conn, asset_id, actor, *report)
return asset_id
def update(self, asset_id, payload, actor):
data = payload.model_dump(exclude={"version"})
with self._pool.connection() as conn, conn.transaction():
old = self._lock(conn, asset_id, payload.version)
if old["latest_report_id"] and data["category"] != "computer":
raise ValueError("사양 보고서가 연결된 자산은 컴퓨터 분류를 유지해야 합니다.")
if not data["tag"]:
data["tag"] = old["tag"]
changes = {k: {"before": serialize(old)[k], "after": serialize(data)[k]} for k in FIELDS if old[k] != data[k]}
if changes:
conn.execute(f"UPDATE assets SET {','.join(k+'=%s' for k in FIELDS)},version=version+1,updated_at=now() WHERE id=%s",
[*[data[k] for k in FIELDS], asset_id])
self._event(conn, asset_id, actor, "update", "자산 정보 수정", changes)
def action(self, asset_id, payload, actor):
with self._pool.connection() as conn, conn.transaction():
old = self._lock(conn, asset_id, payload.version)
status, assignee = transition(old, payload)
location = payload.location or old["location"]
conn.execute("UPDATE assets SET status=%s,assignee_email=%s,location=%s,version=version+1,updated_at=now() WHERE id=%s",
(status, assignee, location, asset_id))
changes = {k: {"before": old[k], "after": value} for k, value in
(("status", status), ("assignee_email", assignee), ("location", location)) if old[k] != value}
self._event(conn, asset_id, actor, payload.action, payload.note, changes)
def _save_report(self, conn, asset_id, actor, filename, raw, parsed):
# 원본과 분석 결과를 함께 저장하고 최신 보고서만 교체합니다. 이전 보고서는 남습니다.
existing = conn.execute("SELECT id FROM asset_reports WHERE asset_id=%s AND sha256=%s", (asset_id, parsed["sha256"])).fetchone()
if existing:
raise AssetConflict("이 자산에 동일한 보고서가 이미 등록되어 있습니다.")
report_id = uuid.uuid4().hex
conn.execute("INSERT INTO asset_reports(id,asset_id,filename,sha256,raw_xml,parsed,actor) VALUES(%s,%s,%s,%s,%s,%s,%s)",
(report_id, asset_id, filename, parsed["sha256"], raw, Jsonb(parsed), actor))
conn.execute("UPDATE assets SET latest_report_id=%s,version=version+1,updated_at=now() WHERE id=%s", (report_id, asset_id))
self._event(conn, asset_id, actor, "report", filename, {"report_id": report_id, "summary": parsed["summary"]})
return report_id
def attach_report(self, asset_id, version, actor, filename, raw, parsed):
with self._pool.connection() as conn, conn.transaction():
asset = self._lock(conn, asset_id, version)
if asset["category"] != "computer":
raise ValueError("HWiNFO 보고서는 컴퓨터 자산에만 연결할 수 있습니다.")
return self._save_report(conn, asset_id, actor, filename, raw, parsed)
def report(self, asset_id, report_id, *, raw=False):
columns = "r.filename,r.raw_xml" if raw else "r.id,r.filename,r.parsed,r.uploaded_at"
with self._pool.connection() as conn:
row = conn.execute(f"SELECT {columns} FROM asset_reports r JOIN assets a ON a.id=r.asset_id WHERE r.asset_id=%s AND r.id=%s AND a.deleted_at IS NULL", (asset_id, report_id)).fetchone()
if not row:
raise KeyError(report_id)
return serialize(row)
def delete(self, asset_id, version, actor, note):
# 수퍼 관리자 삭제도 이력과 원본은 보존하고 대장·다운로드에서 제외합니다.
with self._pool.connection() as conn, conn.transaction():
self._lock(conn, asset_id, version)
self._event(conn, asset_id, actor, "delete", note, {})
conn.execute("UPDATE assets SET deleted_at=now(),deleted_by=%s,version=version+1,updated_at=now() WHERE id=%s", (actor, asset_id))
def add_photo(self, asset_id, version, actor, filename, image, mime, width, height):
with self._pool.connection() as conn, conn.transaction():
self._lock(conn, asset_id, version)
count = conn.execute("SELECT count(*) AS n FROM asset_photos WHERE asset_id=%s", (asset_id,)).fetchone()["n"]
if count >= MAX_PHOTOS:
raise ValueError(f"사진은 자산당 {MAX_PHOTOS}개까지 등록할 수 있습니다.")
photo_id = uuid.uuid4().hex
conn.execute("INSERT INTO asset_photos(id,asset_id,filename,image,mime,width,height,actor) VALUES(%s,%s,%s,%s,%s,%s,%s,%s)",
(photo_id, asset_id, filename, image, mime, width, height, actor))
conn.execute("UPDATE assets SET version=version+1,updated_at=now() WHERE id=%s", (asset_id,))
self._event(conn, asset_id, actor, "photo", filename, {"photo_id": photo_id})
return photo_id
def photo(self, asset_id, photo_id):
with self._pool.connection() as conn:
row = conn.execute("SELECT p.image,p.mime FROM asset_photos p JOIN assets a ON a.id=p.asset_id WHERE p.asset_id=%s AND p.id=%s AND a.deleted_at IS NULL", (asset_id, photo_id)).fetchone()
if not row:
raise KeyError(photo_id)
return row
@staticmethod
def _monitor_matches(conn, computer_id, parsed):
result = []
for device in monitor_devices(parsed):
linked = conn.execute("SELECT a.* FROM asset_monitor_links l JOIN assets a ON a.id=l.monitor_asset_id WHERE l.computer_id=%s AND l.monitor_key=%s AND a.category='monitor' AND a.deleted_at IS NULL", (computer_id, device["key"])).fetchone()
matches = conn.execute("SELECT * FROM assets WHERE category='monitor' AND deleted_at IS NULL AND lower(btrim(serial))=%s ORDER BY id LIMIT 21", (device["serial"].casefold(),)).fetchall() if device["serial"] else []
compatible = [a for a in matches if compatible_monitor(a, device)]
asset = linked or (compatible[0] if len(compatible) == 1 else None)
candidates = matches if not asset else []
# candidate_by — 후보가 같은 시리얼(같은 실물일 가능성)인지, 참고용 같은 모델·이름인지.
# 같은 모델은 여러 대일 수 있으므로(듀얼 모니터 등) 새 등록을 막지 않는다(2026-10-07).
candidate_by = "serial" if candidates else ""
if not asset and not candidates:
candidates = conn.execute("SELECT * FROM assets WHERE category='monitor' AND deleted_at IS NULL AND (lower(btrim(model))=%s OR lower(btrim(name))=%s) ORDER BY id LIMIT 20", (device["model"].casefold(), device["name"].casefold())).fetchall()
candidate_by = "model" if candidates else ""
result.append({**device, "asset": serialize(asset), "candidates": [serialize(r) for r in candidates],
"candidate_by": candidate_by,
"match": "linked" if linked else "serial" if asset else "unconfirmed"})
return result
def report_monitors(self, asset_id, report_id):
with self._pool.connection() as conn, conn.transaction():
conn.execute("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ READ ONLY")
row = conn.execute("SELECT r.parsed FROM asset_reports r JOIN assets a ON a.id=r.asset_id WHERE r.asset_id=%s AND r.id=%s AND a.deleted_at IS NULL", (asset_id, report_id)).fetchone()
if not row:
raise KeyError(report_id)
return self._monitor_matches(conn, asset_id, row["parsed"])
def register_monitor(self, computer_id, index, payload, actor):
with self._pool.connection() as conn, conn.transaction():
computer = self._lock(conn, computer_id, payload.version)
if computer["category"] != "computer" or computer["latest_report_id"] != payload.report_id:
raise AssetConflict("최신 컴퓨터 보고서를 다시 열고 모니터를 등록하세요.")
row = conn.execute("SELECT parsed FROM asset_reports WHERE asset_id=%s AND id=%s", (computer_id, payload.report_id)).fetchone()
devices = monitor_devices(row["parsed"]) if row else []
if index < 0 or index >= len(devices):
raise KeyError(index)
device = devices[index]
# 서로 다른 컴퓨터에서 동일 시리얼을 동시에 등록하는 경우도 중복을 막습니다.
if device["serial"]:
conn.execute("SELECT pg_advisory_xact_lock(hashtextextended(%s,0))", ("asset-monitor:" + device["serial"].casefold(),))
if payload.asset_id:
target = conn.execute("SELECT * FROM assets WHERE id=%s AND deleted_at IS NULL FOR UPDATE", (payload.asset_id,)).fetchone()
if not target or target["category"] != "monitor":
raise ValueError("등록된 모니터 자산을 선택하세요.")
monitor_id = target["id"]
else:
match = self._monitor_matches(conn, computer_id, row["parsed"])[index]
# 같은 시리얼(같은 실물)만 막는다 — 같은 모델이지만 시리얼이 다른 모니터는 새 자산으로 등록된다.
if match["asset"] or match["candidate_by"] == "serial":
raise AssetConflict(f"같은 시리얼({device['serial']})의 모니터가 이미 등록되어 있습니다. 기존 자산에 연결하세요."
if device["serial"] else "이 모니터는 이미 자산에 연결되어 있습니다.")
# 보고서의 실제 시리얼을 유지해야 이후 보고서에서도 같은 장비를 찾습니다.
data = payload.asset.model_copy(update={"serial": device["serial"] or payload.asset.serial})
monitor_id = self._create(conn, data, actor)
conn.execute("INSERT INTO asset_monitor_links(computer_id,monitor_key,monitor_asset_id,actor) VALUES(%s,%s,%s,%s) ON CONFLICT(computer_id,monitor_key) DO UPDATE SET monitor_asset_id=EXCLUDED.monitor_asset_id,actor=EXCLUDED.actor,linked_at=now()",
(computer_id, device["key"], monitor_id, actor))
conn.execute("UPDATE assets SET version=version+1,updated_at=now() WHERE id=%s", (computer_id,))
self._event(conn, computer_id, actor, "monitor", "모니터 자산 연결", {"monitor_asset_id": monitor_id, "model": device["model"]})
return monitor_id
+129
View File
@@ -0,0 +1,129 @@
"""HWiNFO XML을 부품별로 읽습니다. 외부 파일이나 엔티티는 열지 않습니다."""
from __future__ import annotations
import hashlib
import re
from datetime import datetime
from xml.etree.ElementTree import ParseError
from defusedxml.ElementTree import fromstring
from defusedxml.common import DefusedXmlException
MAX_REPORT_BYTES = 10 * 1024 * 1024
SECTION_LABELS = {
"SYSTEM": "시스템", "CPU": "프로세서", "MOBO": "메인보드 · BIOS",
"MEMORY": "메모리", "VIDEO": "그래픽", "MONITOR": "모니터",
"DRIVES": "저장장치", "NETWORK": "네트워크", "SOUND": "오디오",
"PORTS": "포트 · USB", "BUS": "버스 · 컨트롤러",
}
def _text(node, tag):
return (node.findtext(tag) or "").strip()
def _props(node):
return [{"label": _text(p, "Entry"), "value": _text(p, "Description"),
"type": _text(p, "PropertyType")} for p in node.findall("Property")]
def _pick(nodes, *, types=(), labels=()):
# 언어와 무관한 PropertyType을 먼저 사용하고, 없을 때 한글/영문 항목명을 찾습니다.
properties = [p for n in nodes for p in n["properties"]]
for kind in types:
for p in properties:
if p["type"] == kind and p["value"]:
return p["value"]
for label in labels:
for p in properties:
if p["label"].casefold() == label.casefold() and p["value"]:
return p["value"]
return ""
def parse_hwinfo(raw: bytes) -> dict:
if not raw or len(raw) > MAX_REPORT_BYTES:
raise ValueError("XML 보고서는 비어 있지 않은 10 MB 이하 파일이어야 합니다.")
try:
# HWiNFO의 DTD 선언은 허용하되 파일을 읽지 않습니다. 엔티티는 모두 차단합니다.
root = fromstring(raw, forbid_dtd=False, forbid_entities=True, forbid_external=True)
except (ParseError, DefusedXmlException, ValueError, LookupError) as exc:
raise ValueError("XML을 읽을 수 없습니다. HWiNFO XML 보고서인지 확인하세요.") from exc
if root.tag != "HWINFO" or len(root.findall("COMPUTER")) != 1:
raise ValueError("컴퓨터 한 대의 HWiNFO XML 보고서만 업로드할 수 있습니다.")
computer = root.find("COMPUTER")
sections = [{"key": "SYSTEM", "label": "시스템", "nodes": []}]
count = 0
def walk(node, path, result, depth=0):
nonlocal count
count += 1
if count > 30000 or depth > 64:
raise ValueError("보고서 구조가 너무 크거나 깊습니다.")
name = _text(node, "NodeName")
trail = path + ([name] if name else [])
props = _props(node)
if props:
result.append({"name": name or node.tag, "path": " › ".join(trail), "properties": props})
for child in node:
if child.tag in {"SubNodes", "SubNode"}:
walk(child, trail, result, depth + 1)
elif child.find("NodeName") is not None:
walk(child, trail, result, depth + 1)
sections[0]["nodes"] = [{"name": _text(computer, "NodeName") or "컴퓨터",
"path": "시스템", "properties": _props(computer)}]
subnodes = computer.find("SubNodes")
if subnodes is not None:
for node in subnodes:
group = {"key": node.tag, "label": SECTION_LABELS.get(node.tag, _text(node, "NodeName") or node.tag), "nodes": []}
walk(node, [], group["nodes"])
sections.append(group)
by_key = {s["key"]: s["nodes"] for s in sections}
get = lambda key, **kw: _pick(by_key.get(key, []), **kw)
summary = {
"computer_name": _text(computer, "NodeName") or get("SYSTEM", labels=("컴퓨터 이름", "Computer Name")),
"os": get("SYSTEM", labels=("운영 체제", "Operating System")),
"manufacturer": get("SYSTEM", labels=("컴퓨터 브랜드", "Computer Brand Name")),
"cpu": get("CPU", types=("CPU_NAME",), labels=("프로세서 이름", "Processor Name")),
"cores": get("CPU", labels=("프로세서 코어 수", "CPU 코어 수", "Number of CPU Cores", "Number of Processor Cores")),
"threads": get("CPU", labels=("논리 프로세서 수", "논리 CPU 수", "Number of Logical CPUs", "Number of Logical Processors")),
"motherboard": get("MOBO", types=("SYSTEM_MAINBOARD",)),
"bios": get("MOBO", labels=("BIOS 버전", "BIOS Version")),
"memory": get("MEMORY", labels=("총 메모리 크기", "Total Memory Size")),
"gpu": get("VIDEO", types=("GFXCARD_CHIPSET", "GFXCARD")),
"gpu_memory": get("VIDEO", labels=("그래픽 메모리", "Video Memory", "Video Memory Size")),
"serial": get("MOBO", labels=("제품 일련 번호", "Product Serial Number", "System Serial Number")),
}
if summary["serial"].casefold() in {"system serial number", "to be filled by o.e.m.", "default string", "none", "n/a"}:
summary["serial"] = ""
if not summary["memory"]:
mb = get("MEMORY", types=("SYSTEM_MEMORY",))
if re.fullmatch(r"\d+(\.\d+)?", mb):
summary["memory"] = f"{float(mb) / 1024:g} GiB"
devices = {}
for key, types, labels in [
("DRIVES", ("HDD",), ("드라이브 모델", "Drive Model")),
("MEMORY", (), ("모듈 부품 번호", "Module Part Number")),
("MONITOR", ("MONITOR",), ("모니터 이름", "Monitor Name")),
("NETWORK", ("NETCARD",), ("네트워크 카드", "Network Card")),
("VIDEO", ("GFXCARD_CHIPSET", "GFXCARD"), ("그래픽 프로세서", "Video Chipset")),
]:
devices[key] = []
for node in by_key.get(key, []):
model = _pick([node], types=types, labels=labels)
if model:
devices[key].append({"name": model, "node": node["name"], "properties": node["properties"]})
summary["drive_count"] = len(devices["DRIVES"])
summary["monitor_count"] = len(devices["MONITOR"])
if not summary["computer_name"] or not any(summary[k] for k in ("cpu", "motherboard", "memory", "gpu")):
raise ValueError("컴퓨터 이름과 하드웨어 사양이 포함된 HWiNFO 보고서가 필요합니다.")
scan_time = _text(computer, "ScanTime")
try:
scan_time = datetime.strptime(scan_time, "%d.%m.%Y %H:%M").isoformat(timespec="minutes")
except ValueError:
pass # 날짜 형식이 다르면 원래 보고서에 적힌 시각을 그대로 보존합니다.
warnings = [p["value"] for p in _props(computer) if p["label"] in ("가상 머신 경고", "Virtual Machine Warning") and p["value"]]
return {"summary": summary, "sections": sections, "devices": devices, "scan_time": scan_time,
"warnings": warnings, "sha256": hashlib.sha256(raw).hexdigest(),
"property_count": sum(len(n["properties"]) for s in sections for n in s["nodes"])}
+38
View File
@@ -0,0 +1,38 @@
"""사진을 실제 이미지로 확인하고 위치 정보 등 메타데이터를 제거합니다."""
import io
import warnings
from PIL import Image, ImageOps, UnidentifiedImageError
MAX_PHOTO_BYTES = 8 * 1024 * 1024
MAX_STORED_BYTES = 5 * 1024 * 1024
MAX_PHOTOS = 10
def prepare_photo(raw):
if not raw or len(raw) > MAX_PHOTO_BYTES:
raise ValueError("사진은 비어 있지 않은 8 MB 이하 파일이어야 합니다.")
try:
with warnings.catch_warnings():
warnings.simplefilter("error", Image.DecompressionBombWarning)
with Image.open(io.BytesIO(raw)) as source:
if source.format not in {"JPEG", "PNG", "WEBP"}:
raise ValueError("JPG, PNG, WebP 사진만 등록할 수 있습니다.")
if source.width * source.height > 20_000_000:
raise ValueError("사진은 2천만 화소 이하로 등록하세요.")
source.load()
image = ImageOps.exif_transpose(source)
image.thumbnail((2400, 2400))
transparent = "A" in image.getbands() or "transparency" in image.info
mode = "RGBA" if transparent else "RGB"
# 새 캔버스에 복사해 EXIF, GPS, 촬영기기 정보를 저장하지 않습니다.
clean = Image.new(mode, image.size)
clean.paste(image.convert(mode))
output = io.BytesIO()
clean.save(output, format="PNG" if transparent else "JPEG", **({} if transparent else {"quality": 88}))
data = output.getvalue()
if len(data) > MAX_STORED_BYTES:
raise ValueError("사진을 압축해 다시 등록하세요. 저장 크기는 5 MB 이하입니다.")
return data, "image/png" if transparent else "image/jpeg", clean.width, clean.height
except (UnidentifiedImageError, OSError, SyntaxError, Image.DecompressionBombError, Image.DecompressionBombWarning) as exc:
raise ValueError("사진을 읽을 수 없습니다. 정상적인 JPG, PNG, WebP 파일을 선택하세요.") from exc
+47
View File
@@ -0,0 +1,47 @@
"""이전 보고서에도 적용할 수 있도록 저장된 모니터 항목에서 식별 정보를 읽습니다."""
import hashlib
import re
def usable_serial(value):
value = value.strip()
if value.casefold() in {"", "unknown", "n/a", "none", "not specified", "serial number", "알 수 없음"}:
return ""
if re.fullmatch(r"[0\s-]+", value):
return ""
return value
def compatible_monitor(asset, device):
"""다른 제조사나 다른 모델이 같은 시리얼을 쓰면 자동 연결하지 않습니다."""
def normalized(value):
return "".join(c for c in value.casefold() if c.isalnum())
brand = normalized(asset.get("manufacturer", ""))
reported_brand = normalized(device["manufacturer"])
if brand and reported_brand and brand != reported_brand:
return False
model = normalized(asset.get("model", ""))
if not model:
return True
return any(model == value or len(model) >= 4 and model in value
for value in (normalized(device["model"]), normalized(device["name"])))
def monitor_devices(parsed):
devices = []
for index, item in enumerate(parsed.get("devices", {}).get("MONITOR", [])):
props = item.get("properties", [])
def pick(*labels, kind=""):
return next((p["value"].strip() for p in props if p.get("label", "").casefold() in
{label.casefold() for label in labels} or kind and p.get("type") == kind), "")
name = item.get("name", "모니터")
model = pick("모니터 이름(제조업체)", "Monitor Name (Manuf)", "Monitor Name (Manufacturer)") or name
serial = usable_serial(pick("일련 번호", "Serial Number", "Monitor Serial Number"))
instance = pick("디바이스 인스턴스 ID", "Device Instance ID", kind="DeviceInstanceId")
# 시리얼이 없는 장치는 모델명만으로 동일 자산이라고 판단하지 않습니다.
identity = ("serial:" + serial.casefold() + ":" + model.casefold()) if serial else (
"instance:" + instance.casefold() if instance else f"report:{parsed.get('sha256', '')}:{index}")
devices.append({"index": index, "key": hashlib.sha256(identity.encode()).hexdigest(),
"name": name, "model": model[:200], "serial": serial[:200],
"manufacturer": name.split(" ", 1)[0][:150], "properties": props})
return devices
+304
View File
@@ -0,0 +1,304 @@
from __future__ import annotations
# 화면, 권한 검사, 파일 업로드를 담당합니다. 실제 저장은 db.py에서 처리합니다.
import io
import secrets
from contextlib import contextmanager
from typing import Annotated
from urllib.parse import quote
from fastapi import APIRouter, Depends, File, Form, HTTPException, Query, Request, UploadFile
from fastapi.responses import RedirectResponse, Response
from openpyxl import Workbook
from pydantic import ValidationError
from psycopg import Error as DBError
from psycopg.errors import UniqueViolation
from psycopg_pool import PoolTimeout
from starlette.concurrency import run_in_threadpool
from .hwinfo import MAX_REPORT_BYTES, parse_hwinfo
from .store import ActionInput, AssetConflict, AssetInput, AssetUpdate, CATEGORIES, STATUSES
from .store import DeleteInput, MonitorInput
from .media import MAX_PHOTO_BYTES, prepare_photo
router = APIRouter(prefix="/asset", tags=["asset"])
def _user(request: Request):
from app.main import get_current_user_record
from app.store import has_module
user = get_current_user_record(request)
if not user:
raise HTTPException(401, "로그인이 필요합니다.")
if not has_module(user, "asset"):
raise HTTPException(403, "자산관리 권한이 없습니다.")
return user
def _write(request: Request, user=Depends(_user)):
expected = request.session.get("asset_csrf", "")
token = request.headers.get("x-asset-csrf", "")
if not expected or not secrets.compare_digest(expected, token):
raise HTTPException(403, "화면을 새로 열고 다시 시도하세요.")
return user
def _super(user):
from app.store import SUPER_ADMIN_EMAIL
return user.get("email", "").lower() == SUPER_ADMIN_EMAIL
def _super_write(user=Depends(_write)):
if not _super(user):
raise HTTPException(403, "수퍼 관리자만 자산을 삭제할 수 있습니다.")
return user
def _store(request):
store = getattr(request.app.state, "asset_store", None)
if store is None:
raise HTTPException(503, "자산관리 DB 설정이 필요합니다. 관리자에게 문의하세요.")
return store
@contextmanager
def _errors():
try:
yield
except AssetConflict as exc:
raise HTTPException(409, str(exc)) from exc
except KeyError as exc:
raise HTTPException(404, "자산 또는 보고서를 찾을 수 없습니다.") from exc
except ValueError as exc:
raise HTTPException(422, str(exc)) from exc
except UniqueViolation as exc:
raise HTTPException(409, "이미 등록된 자산번호입니다. 다른 번호를 사용하세요.") from exc
except (DBError, PoolTimeout) as exc:
# DB 오류에 접속 비밀번호가 섞일 수 있어 원문 대신 일반 안내만 보여줍니다.
raise HTTPException(503, "자산관리 DB에 연결할 수 없습니다. 설정과 초기화를 확인하세요.") from exc
@router.get("/")
def index(request: Request):
from app.main import build_erp_nav, get_current_user_record, render_template
from app.store import has_module, is_admin
user = get_current_user_record(request)
if not user:
return RedirectResponse("/login", 303)
if not has_module(user, "asset"):
return render_template(request, "denied.html", {"reason": "자산관리 권한이 없습니다.", "user": user,
"is_admin": is_admin(user)}, status_code=403)
request.session.setdefault("asset_csrf", secrets.token_urlsafe(32))
return render_template(request, "asset/index.html", {
"user": user, "is_admin": is_admin(user), "nav_items": build_erp_nav(user, active="asset"),
"page_title": "자산관리", "page_subtitle": "사무집기부터 컴퓨터 사양까지, 회사 자산을 한곳에서",
"categories": CATEGORIES, "statuses": STATUSES, "csrf_token": request.session["asset_csrf"],
"configured": getattr(request.app.state, "asset_store", None) is not None,
"can_delete": _super(user),
})
@router.get("/health")
def health(request: Request, user=Depends(_user)):
with _errors():
_store(request).health()
return {"ok": True}
@router.get("/api/bootstrap")
def bootstrap(request: Request, user=Depends(_user)):
from app.main import user_store
with _errors():
data = _store(request).dashboard()
data["users"] = [{"email": u["email"], "name": u.get("name") or u["email"]} for u in user_store.list_all()]
return data
def _query(q="", category="", status="", location="", assignee="", warranty=False, group=""):
if category and category not in CATEGORIES or status and status not in STATUSES:
raise HTTPException(422, "분류 또는 상태 필터가 올바르지 않습니다.")
if group not in {"", "computer", "furniture"}:
raise HTTPException(422, "자산 구분 필터가 올바르지 않습니다.")
return dict(q=q, category=category, status=status, location=location, assignee=assignee, warranty=warranty, group=group)
@router.get("/api/assets")
def assets(request: Request, q: str = Query("", max_length=200), category: str = "", status: str = "",
location: str = Query("", max_length=150), assignee: str = Query("", max_length=254), warranty: bool = False,
page: int = Query(1, ge=1, le=100000), page_size: int = Query(25, ge=1, le=100),
sort: str = "updated", group: str = "", user=Depends(_user)):
with _errors():
return _store(request).list_assets(page=page, page_size=page_size, sort=sort,
**_query(q, category, status, location, assignee, warranty, group))
@router.get("/api/export")
def export(request: Request, q: str = Query("", max_length=200), category: str = "", status: str = "",
location: str = Query("", max_length=150), assignee: str = Query("", max_length=254), warranty: bool = False,
group: str = "", user=Depends(_user)):
from app.timezone import today_kst
with _errors():
data = _store(request).list_assets(page=1, page_size=10001, **_query(q, category, status, location, assignee, warranty, group))
if data["total"] > 10000:
raise HTTPException(422, "한 번에 10,000개까지 내보낼 수 있습니다. 필터를 좁혀주세요.")
book = Workbook()
sheet = book.active
sheet.title = "자산대장"
headers = ["자산번호", "자산명", "분류", "상태", "제조사", "모델", "시리얼", "위치", "부서", "사용자", "구매일", "구매금액(원)", "구매처", "보증종료", "메모", "CPU", "메모리", "GPU", "운영체제"]
sheet.append(headers)
for row in data["items"]:
specs = row.get("specs") or {}
values = [row["tag"], row["name"], CATEGORIES[row["category"]], STATUSES[row["status"]],
*[row[k] for k in ("manufacturer", "model", "serial", "location", "department", "assignee_email", "purchased_on")],
float(row["purchase_cost"]) if row["purchase_cost"] is not None else None,
row["vendor"], row["warranty_until"], row["notes"], *[specs.get(k, "") for k in ("cpu", "memory", "gpu", "os")]]
sheet.append(values)
# =로 시작하는 자산명도 엑셀 수식 대신 일반 글자로 저장합니다.
for cell in sheet[sheet.max_row]:
if isinstance(cell.value, str):
cell.data_type = "s"
sheet.freeze_panes = "C2"
sheet.auto_filter.ref = sheet.dimensions
from openpyxl.styles import Font, PatternFill
from openpyxl.utils import get_column_letter
for cell in sheet[1]:
cell.font = Font(bold=True, color="FFFFFF")
cell.fill = PatternFill("solid", fgColor="171717")
for i in range(1, len(headers) + 1):
sheet.column_dimensions[get_column_letter(i)].width = 22 if i > 2 else 28
buffer = io.BytesIO()
book.save(buffer)
return Response(buffer.getvalue(), media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
headers={"Content-Disposition": f'attachment; filename="assets-{today_kst().isoformat()}.xlsx"'})
@router.post("/api/assets")
def create(request: Request, payload: AssetInput, user=Depends(_write)):
with _errors():
asset_id = _store(request).create(payload, user["email"])
return {"id": asset_id}
@router.get("/api/assets/{asset_id}")
def detail(request: Request, asset_id: str, user=Depends(_user)):
with _errors():
return _store(request).detail(asset_id)
@router.put("/api/assets/{asset_id}")
def update(request: Request, asset_id: str, payload: AssetUpdate, user=Depends(_write)):
with _errors():
_store(request).update(asset_id, payload, user["email"])
return {"ok": True}
@router.delete("/api/assets/{asset_id}")
def delete(request: Request, asset_id: str, payload: DeleteInput, user=Depends(_super_write)):
with _errors():
_store(request).delete(asset_id, payload.version, user["email"], payload.note)
return {"ok": True}
@router.post("/api/assets/{asset_id}/photos")
async def add_photo(request: Request, asset_id: str, file: Annotated[UploadFile, File()],
version: Annotated[int, Form(ge=1)], user=Depends(_write)):
filename = (file.filename or "photo.jpg").replace("\\", "/").rsplit("/", 1)[-1]
try:
if len(filename) > 200 or any(ord(c) < 32 for c in filename):
raise HTTPException(422, "사진 파일 이름을 확인하세요.")
raw = await file.read(MAX_PHOTO_BYTES + 1)
finally:
await file.close()
with _errors():
image, mime, width, height = await run_in_threadpool(prepare_photo, raw)
photo_id = await run_in_threadpool(_store(request).add_photo, asset_id, version, user["email"], filename, image, mime, width, height)
return {"id": photo_id}
@router.get("/api/assets/{asset_id}/photos/{photo_id}")
def photo(request: Request, asset_id: str, photo_id: str, user=Depends(_user)):
with _errors():
row = _store(request).photo(asset_id, photo_id)
return Response(bytes(row["image"]), media_type=row["mime"],
headers={"X-Content-Type-Options": "nosniff", "Cache-Control": "no-store"})
@router.get("/api/assets/{asset_id}/reports/{report_id}/monitors")
def report_monitors(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
with _errors():
return {"items": _store(request).report_monitors(asset_id, report_id)}
@router.post("/api/assets/{asset_id}/monitors/{index}")
def register_monitor(request: Request, asset_id: str, index: int, payload: MonitorInput, user=Depends(_write)):
with _errors():
monitor_id = _store(request).register_monitor(asset_id, index, payload, user["email"])
return {"id": monitor_id}
@router.post("/api/assets/{asset_id}/actions")
def action(request: Request, asset_id: str, payload: ActionInput, user=Depends(_write)):
from app.main import user_store
if payload.action == "checkout" and not user_store.get(payload.assignee_email.lower()):
raise HTTPException(422, "등록된 회사 사용자를 선택하세요.")
with _errors():
_store(request).action(asset_id, payload, user["email"])
return {"ok": True}
async def _report_file(file):
filename = (file.filename or "report.xml").replace("\\", "/").rsplit("/", 1)[-1]
if not filename.lower().endswith(".xml") or len(filename) > 200 or any(ord(c) < 32 for c in filename):
raise HTTPException(422, "이름이 200자 이하인 XML 보고서를 선택하세요.")
try:
raw = await file.read(MAX_REPORT_BYTES + 1)
finally:
await file.close()
with _errors():
parsed = await run_in_threadpool(parse_hwinfo, raw)
return filename, raw, parsed
@router.post("/api/reports/preview")
async def preview(file: Annotated[UploadFile, File()], user=Depends(_write)):
filename, raw, parsed = await _report_file(file)
return {"filename": filename, "summary": parsed["summary"], "scan_time": parsed["scan_time"],
"property_count": parsed["property_count"], "warnings": parsed["warnings"]}
@router.post("/api/reports/import")
async def import_report(request: Request, file: Annotated[UploadFile, File()], payload: Annotated[str, Form(max_length=20000)], user=Depends(_write)):
with _errors():
try:
data = AssetInput.model_validate_json(payload)
except ValidationError as exc:
raise HTTPException(422, "자산명·분류·구매일·금액을 확인하세요.") from exc
report = await _report_file(file)
with _errors():
asset_id = await run_in_threadpool(_store(request).create, data, user["email"], report)
return {"id": asset_id}
@router.post("/api/assets/{asset_id}/reports")
async def attach(request: Request, asset_id: str, file: Annotated[UploadFile, File()],
version: Annotated[int, Form(ge=1)], user=Depends(_write)):
filename, raw, parsed = await _report_file(file)
with _errors():
report_id = await run_in_threadpool(_store(request).attach_report, asset_id, version, user["email"], filename, raw, parsed)
return {"id": report_id}
@router.get("/api/assets/{asset_id}/reports/{report_id}")
def report_detail(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
with _errors():
return _store(request).report(asset_id, report_id)
@router.get("/api/assets/{asset_id}/reports/{report_id}/download")
def download(request: Request, asset_id: str, report_id: str, user=Depends(_user)):
with _errors():
row = _store(request).report(asset_id, report_id, raw=True)
return Response(bytes(row["raw_xml"]), media_type="application/octet-stream",
headers={"Content-Disposition": f"attachment; filename=hwinfo.xml; filename*=UTF-8''{quote(row['filename'], safe='')}",
"X-Content-Type-Options": "nosniff", "Cache-Control": "no-store"})
+106
View File
@@ -0,0 +1,106 @@
"""Asset validation and lifecycle rules, shared by API and storage."""
from datetime import date
from decimal import Decimal
from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
CATEGORIES = {"computer": "컴퓨터", "monitor": "모니터", "mouse": "마우스", "keyboard": "키보드",
"camera": "카메라", "hub": "허브 · 네트워크", "lighting": "조명", "desk": "책상",
"chair": "의자", "furniture": "기타 사무집기", "equipment": "기타 전산장비"}
STATUSES = {"available": "사용 가능", "in_use": "사용 중", "maintenance": "수리 중", "lost": "분실", "retired": "폐기"}
class AssetInput(BaseModel):
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
tag: str = Field(default="", max_length=64)
name: str = Field(min_length=1, max_length=200)
category: str
manufacturer: str = Field(default="", max_length=150)
model: str = Field(default="", max_length=200)
serial: str = Field(default="", max_length=200)
location: str = Field(default="", max_length=150)
department: str = Field(default="", max_length=100)
purchased_on: date | None = None
purchase_cost: Decimal | None = Field(default=None, ge=0, le=10**12, decimal_places=2)
vendor: str = Field(default="", max_length=200)
warranty_until: date | None = None
notes: str = Field(default="", max_length=10000)
@field_validator("category")
@classmethod
def valid_category(cls, value):
if value not in CATEGORIES:
raise ValueError("자산 분류가 올바르지 않습니다.")
return value
@model_validator(mode="after")
def valid_dates(self):
if self.purchased_on and self.warranty_until and self.warranty_until < self.purchased_on:
raise ValueError("보증 종료일은 구매일 이후여야 합니다.")
return self
class AssetUpdate(AssetInput):
version: int = Field(ge=1)
class DeleteInput(BaseModel):
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
version: int = Field(ge=1)
note: str = Field(min_length=1, max_length=2000)
class MonitorInput(BaseModel):
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
version: int = Field(ge=1)
report_id: str = Field(min_length=1, max_length=64)
asset: AssetInput | None = None
asset_id: str = Field(default="", max_length=64)
@model_validator(mode="after")
def require_target(self):
if bool(self.asset) == bool(self.asset_id):
raise ValueError("등록할 정보 또는 연결할 모니터 자산 중 하나를 지정하세요.")
if self.asset and self.asset.category != "monitor":
raise ValueError("모니터 분류로 등록하세요.")
return self
class ActionInput(BaseModel):
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
version: int = Field(ge=1)
action: str
assignee_email: str = Field(default="", max_length=254)
location: str = Field(default="", max_length=150)
note: str = Field(default="", max_length=2000)
@model_validator(mode="after")
def require_reason(self):
if self.action in {"lost", "retired"} and not self.note:
raise ValueError("분실·폐기 사유를 입력하세요.")
return self
class AssetConflict(ValueError):
pass
def transition(asset, payload: ActionInput):
state = asset["status"]
if payload.action == "checkout":
if state != "available" or not payload.assignee_email:
raise ValueError("사용 가능한 자산을 선택하고 배정할 사용자를 지정하세요.")
return "in_use", payload.assignee_email.lower()
if payload.action == "checkin":
if state != "in_use":
raise ValueError("사용 중인 자산만 반납할 수 있습니다.")
return "available", ""
if payload.action == "maintenance" and state == "available":
return "maintenance", ""
if payload.action == "available" and state in {"maintenance", "lost", "retired"}:
return "available", ""
if payload.action == "lost" and state in {"available", "in_use", "maintenance"}:
return "lost", asset.get("assignee_email", "")
if payload.action == "retired" and state in {"available", "maintenance", "lost"}:
return "retired", ""
raise ValueError("현재 상태에서 처리할 수 없습니다. 배정된 자산은 먼저 반납하세요.")
@@ -0,0 +1,70 @@
{% extends "erp_base.html" %}
{% set force_sidebar_collapsed = true %}
{% block head_extra %}<link rel="stylesheet" href="/static/asset.css?v=20261006c">{% endblock %}
{% block content %}
<div id="asset-app" class="am-workspace" data-csrf="{{ csrf_token }}" data-configured="{{ 'true' if configured else 'false' }}" data-can-delete="{{ 'true' if can_delete else 'false' }}">
<aside class="am-nav" aria-label="자산관리 탐색">
<div class="am-nav-brand"><span class="am-mark">A</span><div><strong>회사 자산</strong><small>ASSET MANAGEMENT</small></div></div>
<button class="am-nav-link is-active" data-view="all"><span>전체 자산</span><span id="am-nav-total" class="am-count">—</span></button>
<button class="am-nav-link" data-view="computer"><span>컴퓨터 · 전산장비</span></button>
<button class="am-nav-link" data-view="furniture"><span>사무실 · 집기</span></button>
<p class="am-nav-label">자산 상태</p>
{% for key,label in statuses.items() %}<button class="am-nav-link" data-state="{{ key }}"><span><i class="am-dot am-dot-{{ key }}"></i>{{ label }}</span><span class="am-count" id="am-count-{{ key }}">—</span></button>{% endfor %}
<p class="am-nav-label">확인할 항목</p>
<button class="am-nav-link" data-view="warranty"><span>보증 만료 예정</span><span class="am-count" id="am-count-warranty">—</span></button>
<div class="am-nav-foot"><strong>자산 한 개, 기록 하나</strong><p>개별 자산번호로 등록하고<br>배정부터 폐기까지 추적하세요.</p><button class="am-text-btn" id="am-help-open">사용 안내 ↗</button></div>
</aside>
<section class="am-main" aria-label="자산대장">
<div class="am-heading"><div><p class="am-eyebrow">COMPANY INVENTORY</p><h2>회사 자산 대장</h2><p>어떤 자산이, 어디에, 누구에게 있는지 확인하세요.</p></div><div class="am-heading-actions"><button class="erp-btn erp-btn-outline" id="am-import">↑ HWiNFO 보고서</button><button class="erp-btn erp-btn-primary" id="am-create" {% if not configured %}disabled{% endif %}>+ 자산 등록</button></div></div>
{% if not configured %}<div class="am-notice" role="status"><strong>자산관리 저장소 설정이 필요합니다.</strong><p>관리자가 자산관리 DB를 연결하면 등록·배정·반납을 사용할 수 있습니다. HWiNFO 보고서는 지금도 분석 결과를 미리 볼 수 있습니다.</p></div>{% endif %}
<div id="am-message" class="am-message" role="status" aria-live="polite" hidden></div>
<div class="am-kpis" aria-label="자산 현황">
<button data-kpi="all" class="am-kpi"><span>전체 자산</span><strong id="am-total">—</strong><small>회사에 등록된 자산</small></button>
<button data-kpi="in_use" class="am-kpi"><span><i class="am-dot am-dot-in_use"></i>사용 중</span><strong id="am-in_use">—</strong><small>직원에게 배정된 자산</small></button>
<button data-kpi="available" class="am-kpi"><span><i class="am-dot am-dot-available"></i>사용 가능</span><strong id="am-available">—</strong><small>새로 배정할 수 있는 자산</small></button>
<button data-kpi="maintenance" class="am-kpi"><span><i class="am-dot am-dot-maintenance"></i>수리 중</span><strong id="am-maintenance">—</strong><small>점검 · 수리 중인 자산</small></button>
<button data-kpi="warranty" class="am-kpi"><span>보증 만료 예정</span><strong id="am-warranty_soon">—</strong><small>오늘부터 30일 이내</small></button>
</div>
<div class="am-register">
<div class="am-register-head"><div><h3 id="am-list-title">전체 자산</h3><span id="am-result-count">자산을 불러오는 중</span></div><div><button class="am-text-btn" id="am-refresh" aria-label="자산 새로고침">↻ 새로고침</button><button class="erp-btn erp-btn-outline" id="am-export" {% if not configured %}disabled{% endif %}>엑셀 내보내기 ↓</button></div></div>
<form class="am-filters" id="am-filters" role="search">
<label class="am-search"><span aria-hidden="true">⌕</span><input id="am-query" type="search" maxlength="200" placeholder="자산명, 번호, 모델, 시리얼 검색" aria-label="자산 검색"></label>
<select id="am-category" aria-label="분류"><option value="">모든 분류</option>{% for key,label in categories.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select>
<select id="am-status" aria-label="상태"><option value="">모든 상태</option>{% for key,label in statuses.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select>
<select id="am-location" aria-label="위치"><option value="">모든 위치</option></select>
<select id="am-assignee" aria-label="배정 사용자"><option value="">모든 사용자</option></select>
<select id="am-sort" aria-label="정렬"><option value="updated">최근 변경순</option><option value="name">자산명순</option><option value="tag">자산번호순</option><option value="cost">구매금액순</option><option value="warranty">보증종료순</option></select>
<button type="button" class="am-text-btn" id="am-reset">초기화</button>
</form>
<div class="am-table-scroll"><table class="am-table"><thead><tr><th>자산</th><th>분류</th><th>상태</th><th>사용자 / 위치</th><th>구매금액</th><th>보증 종료</th><th>사양</th></tr></thead><tbody id="am-rows"><tr><td colspan="7" class="am-empty">{% if configured %}자산을 불러오는 중입니다.{% else %}등록된 자산이 여기에 표시됩니다.{% endif %}</td></tr></tbody></table></div>
<div class="am-pagination"><span id="am-page-info">—</span><div><button class="erp-btn erp-btn-outline" id="am-prev" disabled>← 이전</button><span id="am-page-number">1</span><button class="erp-btn erp-btn-outline" id="am-next" disabled>다음 →</button></div></div>
</div>
<div class="am-bottom"><section class="am-panel"><div class="am-panel-head"><h3>자산 구성</h3><span>분류별 등록 수</span></div><div id="am-breakdown" class="am-breakdown"><p class="am-muted">등록된 자산이 없습니다.</p></div><div class="am-value"><span>보유 자산 구매금액 <small>폐기 제외 · 입력된 금액 기준</small></span><strong id="am-value">—</strong></div></section><section class="am-panel"><div class="am-panel-head"><h3>최근 활동</h3><span>등록 · 배정 · 반납 · 변경</span></div><div id="am-activity" class="am-activity"><p class="am-muted">활동 이력이 여기에 표시됩니다.</p></div></section></div>
</section>
</div>
<dialog id="am-detail" class="am-drawer" aria-labelledby="am-detail-title"><div class="am-dialog-head"><div><small id="am-detail-tag">자산 상세</small><h2 id="am-detail-title">자산 정보</h2></div><button type="button" class="am-close" data-close="am-detail" aria-label="자산 상세 닫기">×</button></div><div id="am-detail-content"></div></dialog>
<dialog id="am-editor" class="am-dialog" aria-labelledby="am-editor-title"><div class="am-dialog-head"><div><small>ASSET REGISTER</small><h2 id="am-editor-title">자산 등록</h2></div><button type="button" class="am-close" data-close="am-editor" aria-label="등록 창 닫기">×</button></div><form id="am-editor-form" class="am-form"><div class="am-form-grid">
<label>자산명 <span>*</span><input name="name" maxlength="200" required placeholder="예: 디자인팀 데스크톱"></label>
<label>자산번호<input name="tag" maxlength="64" placeholder="비워두면 자동 발급 (AST-000001)"></label>
<label>분류 <span>*</span><select name="category" required>{% for key,label in categories.items() %}<option value="{{ key }}">{{ label }}</option>{% endfor %}</select></label>
<label>제조사<input name="manufacturer" maxlength="150" placeholder="예: Dell, 시디즈"></label>
<label>모델<input name="model" maxlength="200"></label><label>시리얼 번호<input name="serial" maxlength="200"></label>
<label>위치<input name="location" maxlength="150" list="am-locations" placeholder="예: 본사 3층 디자인팀"></label><label>부서<input name="department" maxlength="100"></label>
<label>구매일<input type="date" name="purchased_on"></label><label>구매금액 (원)<input type="number" name="purchase_cost" min="0" max="1000000000000" step="0.01" placeholder="미입력 가능"></label>
<label>구매처<input name="vendor" maxlength="200"></label><label>보증 종료일<input type="date" name="warranty_until"></label>
<label class="am-wide">메모<textarea name="notes" maxlength="10000" rows="3" placeholder="관리에 필요한 추가 정보를 입력하세요."></textarea></label>
</div><p class="am-form-hint">같은 모델도 자산번호를 각각 발급합니다. 사용자 배정은 등록 후 상세 화면에서 진행합니다.</p><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-editor">취소</button><button type="submit" class="erp-btn erp-btn-primary">자산 저장</button></div></form></dialog>
<dialog id="am-upload" class="am-dialog am-upload-dialog" aria-labelledby="am-upload-title"><div class="am-dialog-head"><div><small>HWiNFO XML IMPORT</small><h2 id="am-upload-title">컴퓨터 보고서 가져오기</h2></div><button type="button" class="am-close" data-close="am-upload" aria-label="업로드 창 닫기">×</button></div><form id="am-upload-form" class="am-form">
<p class="am-form-hint" id="am-upload-hint">HWiNFO에서 저장한 XML 보고서를 선택하세요. 사양을 분석한 뒤 자산으로 등록합니다.</p>
<label class="am-drop" id="am-drop"><span class="am-upload-icon">↑</span><strong>XML 보고서 선택</strong><span>파일을 여기에 놓거나 클릭하세요 · 최대 10 MB</span><input type="file" id="am-report-file" accept=".xml" aria-label="HWiNFO XML 보고서 선택" required></label>
<div id="am-report-preview" hidden></div>
<div id="am-import-fields" class="am-form-grid" hidden><label>자산명 <span>*</span><input id="am-import-name" maxlength="200" required></label><label>위치<input id="am-import-location" maxlength="150" list="am-locations" placeholder="예: 본사 3층"></label></div>
<div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><span id="am-upload-status" class="am-muted"></span><button type="button" class="erp-btn erp-btn-outline" data-close="am-upload">취소</button><button type="submit" class="erp-btn erp-btn-primary" id="am-import-save" disabled>자산으로 등록</button></div>
</form></dialog>
<dialog id="am-action" class="am-dialog am-action-dialog" aria-labelledby="am-action-title"><div class="am-dialog-head"><div><small id="am-action-tag"></small><h2 id="am-action-title">자산 배정</h2></div><button type="button" class="am-close" data-close="am-action" aria-label="처리 창 닫기">×</button></div><form id="am-action-form" class="am-form"><p id="am-action-hint" class="am-form-hint"></p><label id="am-action-user-label">배정할 사용자 <span>*</span><select id="am-action-user"><option value="">사용자 선택</option></select></label><label>자산 위치<input id="am-action-location" list="am-locations" maxlength="150"></label><label>처리 메모<textarea id="am-action-note" maxlength="2000" rows="3" placeholder="배정 사유, 반납 상태, 수리 내용 등을 기록하세요."></textarea></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-action">취소</button><button type="submit" class="erp-btn erp-btn-primary" id="am-action-save">처리하기</button></div></form></dialog>
<dialog id="am-help" class="am-dialog" aria-labelledby="am-help-title"><div class="am-dialog-head"><h2 id="am-help-title">자산관리 사용 안내</h2><button class="am-close" data-close="am-help" aria-label="사용 안내 닫기">×</button></div><div class="am-form am-help"><h3>01. 자산 등록</h3><p>책상·의자·마우스 등은 개별 자산으로 등록합니다. 자산번호를 비워두면 자동 발급합니다. 컴퓨터는 HWiNFO 보고서를 가져오면 이름과 주요 사양을 확인하고 등록할 수 있습니다.</p><h3>02. 배정과 반납</h3><p>사용 가능한 자산을 등록된 회사 사용자에게 배정합니다. 사용 중인 자산은 반납 후 수리·폐기할 수 있습니다. 위치·사유와 처리자가 이력에 남습니다. 분실 처리 시 기존 배정 사용자도 기록됩니다.</p><h3>03. 컴퓨터 사양</h3><p>HWiNFO → 보고서 저장 → XML 형식을 선택합니다. 핵심 사양, 부품별 상세와 보고서 전체 항목을 볼 수 있습니다. 재업로드할 때 컴퓨터 이름을 확인하세요. 이전 보고서와 원본 XML은 보존됩니다.</p><h3>04. 찾기와 내보내기</h3><p>검색·분류·상태·위치·사용자 필터를 조합합니다. 엑셀 내보내기는 현재 필터에 해당하는 자산 전체를 포함하며 최대 10,000개입니다. 보증 만료 예정은 오늘부터 30일 이내입니다.</p><p class="am-form-hint">보고서에는 시리얼·MAC 주소 등 회사 장비 정보가 포함될 수 있습니다. 자산관리 권한을 가진 사용자만 조회할 수 있습니다.</p></div></dialog>
<datalist id="am-locations"></datalist>
<dialog id="am-photo" class="am-dialog" aria-labelledby="am-photo-title"><div class="am-dialog-head"><h2 id="am-photo-title">자산 사진 등록</h2><button type="button" class="am-close" data-close="am-photo" aria-label="사진 등록 닫기">×</button></div><form id="am-photo-form" class="am-form"><p class="am-form-hint">JPG · PNG · WebP, 파일당 8 MB 이하 · 자산당 최대 10장. 촬영 위치 정보는 제거해 보관합니다.</p><label>사진 선택<input id="am-photo-file" type="file" accept="image/jpeg,image/png,image/webp" required></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-photo">취소</button><button type="submit" class="erp-btn erp-btn-primary">사진 저장</button></div></form></dialog>
<dialog id="am-delete" class="am-dialog" aria-labelledby="am-delete-title"><div class="am-dialog-head"><h2 id="am-delete-title">자산 삭제</h2><button type="button" class="am-close" data-close="am-delete" aria-label="삭제 창 닫기">×</button></div><form id="am-delete-form" class="am-form"><p class="am-warning" id="am-delete-hint"></p><p class="am-form-hint">자산대장과 현황에서 제외됩니다. 사진·보고서·처리 이력은 보존됩니다.</p><label>삭제할 자산번호 확인<input id="am-delete-confirm" required autocomplete="off"></label><label>삭제 사유<textarea id="am-delete-note" required maxlength="2000" rows="3"></textarea></label><div class="am-form-error" role="alert" hidden></div><div class="am-dialog-footer"><button type="button" class="erp-btn erp-btn-outline" data-close="am-delete">취소</button><button type="submit" class="erp-btn am-danger">자산 삭제</button></div></form></dialog>
{% endblock %}
{% block scripts %}<script id="am-config" type="application/json">{{ {"categories":categories,"statuses":statuses}|tojson }}</script><script src="/static/asset.js?v=20261007a" defer></script>{% endblock %}
+503 -96
View File
@@ -14,10 +14,12 @@ API 로그에는 토큰/시크릿을 넣지 않는다.
from __future__ import annotations
import logging
import uuid
from contextlib import contextmanager
from datetime import date, datetime
from typing import Any, Iterator
from psycopg import errors as pg_errors
from psycopg.rows import dict_row
from psycopg_pool import ConnectionPool
@@ -97,6 +99,315 @@ class Cafe24Store:
def close(self) -> None:
self._pool.close()
# ════════════════════════════════════════════════════════════
# 마이그레이션 005(쓰기 안전장치) 적용 여부
# 쓰기 경로는 잠금·시도 기록 없이 카페24에 쓰지 않는다 — 적용 전이면 거부한다.
# 읽기 경로는 005 가 없어도 동작하게 둔다(배포 순서가 어긋나도 화면은 열린다).
# ════════════════════════════════════════════════════════════
_schema_ok = False
def write_schema_ready(self) -> bool:
if self._schema_ok:
return True
with self._pool.connection() as conn:
row = conn.execute(
"""
SELECT to_regclass('public.cafe24_write_locks') IS NOT NULL
AND to_regclass('public.cafe24_write_attempts') IS NOT NULL
AND EXISTS (SELECT 1 FROM information_schema.columns
WHERE table_name = 'cafe24_product_schedules'
AND column_name = 'lease_token')
AND EXISTS (SELECT 1 FROM information_schema.columns
WHERE table_name = 'cafe24_product_revisions'
AND column_name = 'source') AS ok
"""
).fetchone()
self._schema_ok = bool(row and row.get("ok"))
return self._schema_ok
# ════════════════════════════════════════════════════════════
# 쓰기 잠금 (lease) — 웹 여러 프로세스 + 예약 worker 가 공유한다.
# 같은 lock_key 는 한 번에 하나만 잡는다. 만료(expires_at)가 지나면 다른 쪽이
# 가져갈 수 있다(잡은 프로세스가 죽어도 영구히 막히지 않는다). 원격 쓰기 직전
# renew_lock 으로 "아직 내 잠금인가"를 확인한다(펜싱) — 아니면 쓰지 않는다.
# ════════════════════════════════════════════════════════════
def acquire_lock(self, key: str, *, owner: str, purpose: str, ttl_seconds: int) -> str | None:
"""잠금을 잡으면 token, 남이 잡고 있으면 None."""
token = uuid.uuid4().hex
with self._pool.connection() as conn:
row = conn.execute(
"""
INSERT INTO cafe24_write_locks (lock_key, owner, token, purpose, acquired_at, expires_at)
VALUES (%s, %s, %s, %s, now(), now() + %s * interval '1 second')
ON CONFLICT (lock_key) DO UPDATE SET
owner = EXCLUDED.owner, token = EXCLUDED.token, purpose = EXCLUDED.purpose,
acquired_at = now(), expires_at = EXCLUDED.expires_at
WHERE cafe24_write_locks.expires_at < now()
RETURNING token
""",
(key, (owner or "")[:200], token, (purpose or "")[:200], max(1, int(ttl_seconds))),
).fetchone()
return str(row["token"]) if row else None
def renew_lock(self, key: str, token: str, *, ttl_seconds: int) -> bool:
"""아직 내 잠금이고 만료 전이면 연장하고 True. 이미 넘어갔으면 False."""
with self._pool.connection() as conn:
row = conn.execute(
"""
UPDATE cafe24_write_locks
SET expires_at = now() + %s * interval '1 second'
WHERE lock_key = %s AND token = %s AND expires_at > now()
RETURNING lock_key
""",
(max(1, int(ttl_seconds)), key, token),
).fetchone()
return row is not None
def release_lock(self, key: str, token: str) -> None:
with self._pool.connection() as conn:
conn.execute(
"DELETE FROM cafe24_write_locks WHERE lock_key = %s AND token = %s",
(key, token),
)
def lock_holder(self, key: str) -> dict[str, Any]:
"""지금 잠금을 잡고 있는 쪽(안내 문구용). 없거나 만료됐으면 {}."""
with self._pool.connection() as conn:
row = conn.execute(
"""
SELECT owner, purpose, acquired_at, expires_at FROM cafe24_write_locks
WHERE lock_key = %s AND expires_at > now()
""",
(key,),
).fetchone()
return self._serialize(row)
# ════════════════════════════════════════════════════════════
# 쓰기 시도 기록 (cafe24_write_attempts) — 운영용 가변 표.
# 원격 PUT 직전에 STARTED 로 남기고, 결과에 따라 상태를 바꾼다.
# ════════════════════════════════════════════════════════════
_ATTEMPT_FIELDS: tuple[str, ...] = (
"product_no", "mall_id", "shop_no", "origin", "schedule_id", "actor",
"backup_revision_id", "observed_digest", "base_digest", "target_digest",
"target_html", "target_revision_id", "set_display", "set_selling", "memo",
)
def start_attempt(self, **fields: Any) -> int:
cols = [k for k in self._ATTEMPT_FIELDS if k in fields]
values = [fields[k] for k in cols]
with self._pool.connection() as conn:
row = conn.execute(
f"""
INSERT INTO cafe24_write_attempts ({", ".join(cols)}, status)
VALUES ({", ".join(["%s"] * len(cols))}, %s)
RETURNING id
""",
(*values, store.ATTEMPT_STARTED),
).fetchone()
return int(row["id"]) if row else 0
def update_attempt(
self,
attempt_id: int,
*,
status: str | None = None,
error: str | None = None,
remote_updated_at: str | None = None,
remote_ok: bool = False,
resolved_by: str | None = None,
only_from: tuple[str, ...] | None = None,
) -> bool:
"""상태 전이. only_from 을 주면 그 상태에서만 바꾼다(늦게 도착한 갱신 무시)."""
sets: list[str] = []
args: list[Any] = []
if status is not None:
sets.append("status = %s")
args.append(status)
if error is not None:
sets.append("error = %s")
args.append((error or "")[:1000])
if remote_updated_at is not None:
sets.append("remote_updated_at = %s")
args.append(str(remote_updated_at or ""))
if remote_ok:
sets.append("remote_at = COALESCE(remote_at, now())")
if resolved_by is not None:
sets.append("resolved_by = %s")
args.append(resolved_by[:200])
if not sets:
return False
where = "id = %s"
args.append(int(attempt_id))
if only_from:
where += " AND status = ANY(%s)"
args.append(list(only_from))
with self._pool.connection() as conn:
row = conn.execute(
f"UPDATE cafe24_write_attempts SET {', '.join(sets)} WHERE {where} RETURNING id",
args,
).fetchone()
return row is not None
def record_attempt_revision(
self,
attempt_id: int,
*,
revision_type: str,
memo: str,
created_by: str,
source: str = "",
source_revision_id: int | None = None,
) -> int:
"""원격 반영된 시도의 버전(MANUAL/SCHEDULED/ROLLBACK)을 남기고 RECORDED 로 바꾼다.
한 트랜잭션에서 한다 — 시도 행을 잠그고, 이미 기록돼 있으면 그 버전 id 를 돌려준다
(기록 복구가 두 번 돌아도 버전이 둘 생기지 않는다). 내용은 시도에 보관한
target_html(없으면 target_revision_id 의 내용)이다. 기록 뒤 target_html 은 비운다.
"""
with self._pool.connection() as conn:
with conn.transaction():
att = conn.execute(
"""
SELECT a.*, COALESCE(NULLIF(a.target_html, ''), t.html_content, '') AS body
FROM cafe24_write_attempts a
LEFT JOIN cafe24_product_revisions t ON t.id = a.target_revision_id
WHERE a.id = %s
FOR UPDATE OF a
""",
(int(attempt_id),),
).fetchone()
if att is None:
return 0
if att.get("applied_revision_id"):
return int(att["applied_revision_id"])
row = conn.execute(
"""
INSERT INTO cafe24_product_revisions
(product_no, html_content, revision_type, memo, created_by,
mall_id, shop_no, source, source_revision_id)
VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)
RETURNING id
""",
(
int(att["product_no"]), att["body"] or "",
store.normalize_revision_type(revision_type), (memo or "")[:500],
created_by or "", att.get("mall_id") or "", int(att.get("shop_no") or 1),
source or "", source_revision_id,
),
).fetchone()
revision_id = int(row["id"])
conn.execute(
"""
UPDATE cafe24_write_attempts
SET status = %s, applied_revision_id = %s, target_html = '',
remote_at = COALESCE(remote_at, now())
WHERE id = %s
""",
(store.ATTEMPT_RECORDED, revision_id, int(attempt_id)),
)
return revision_id
def get_attempt(self, attempt_id: int) -> dict[str, Any]:
with self._pool.connection() as conn:
row = conn.execute(
"SELECT * FROM cafe24_write_attempts WHERE id = %s", (int(attempt_id),)
).fetchone()
return self._serialize(row)
def latest_attempt_for_schedule(self, schedule_id: int) -> dict[str, Any]:
with self._pool.connection() as conn:
row = conn.execute(
"""
SELECT * FROM cafe24_write_attempts WHERE schedule_id = %s
ORDER BY created_at DESC, id DESC LIMIT 1
""",
(int(schedule_id),),
).fetchone()
return self._serialize(row)
def open_attempts(self, product_no: int, *, since: datetime) -> list[dict[str, Any]]:
"""결과 확정이 필요한 시도(STARTED/REMOTE_OK/UNKNOWN), 유예시간 안, 오래된 순.
005 적용 전이면 빈 목록(읽기 경로는 막지 않는다)."""
try:
with self._pool.connection() as conn:
rows = conn.execute(
"""
SELECT id, product_no, origin, schedule_id, actor, status, target_digest,
target_revision_id, backup_revision_id, set_display, set_selling,
error, created_at, remote_at, memo
FROM cafe24_write_attempts
WHERE product_no = %s AND status = ANY(%s) AND created_at >= %s
ORDER BY created_at ASC, id ASC
""",
(int(product_no), list(store.ATTEMPT_OPEN), since),
).fetchall()
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
return []
return [self._serialize(r) for r in rows]
def attempts_needing_record(self, *, since: datetime, limit: int = 20) -> list[dict[str, Any]]:
"""원격 반영됐는데 버전 기록이 안 된 시도(REMOTE_OK) — worker 가 기록을 채운다."""
with self._pool.connection() as conn:
rows = conn.execute(
"""
SELECT id, product_no, origin, schedule_id, actor, memo, target_revision_id, target_digest
FROM cafe24_write_attempts
WHERE status = %s AND created_at >= %s
ORDER BY created_at ASC, id ASC LIMIT %s
""",
(store.ATTEMPT_REMOTE_OK, since, max(1, int(limit))),
).fetchall()
return [self._serialize(r) for r in rows]
def write_lineage(self, product_no: int, *, since: datetime, limit: int = 30) -> list[dict[str, Any]]:
"""원격 반영이 **확인된** 상세설명 쓰기(REMOTE_OK/RECORDED), 최신 순.
읽기 지연 판정의 유일한 근거다. 충돌로 거절된 적용의 백업, 예약 초안, 실패·결과
모름 시도는 들어오지 않는다. 첫 행에만 html_content(마지막으로 쓴 HTML)를 채운다.
created_at 은 원격 반영 시각(remote_at)이다. 005 적용 전이면 빈 목록.
"""
try:
with self._pool.connection() as conn:
rows = conn.execute(
"""
SELECT id, origin, actor, status, schedule_id, observed_digest, base_digest,
target_digest, remote_updated_at, remote_at, applied_revision_id,
target_revision_id
FROM cafe24_write_attempts
WHERE product_no = %s AND status = ANY(%s) AND target_digest <> ''
AND remote_at >= %s
ORDER BY remote_at DESC, id DESC
LIMIT %s
""",
(int(product_no), list(store.ATTEMPT_CONFIRMED), since, max(1, int(limit))),
).fetchall()
if not rows:
return []
top = conn.execute(
"""
SELECT COALESCE(NULLIF(a.target_html, ''), r.html_content, t.html_content, '') AS body
FROM cafe24_write_attempts a
LEFT JOIN cafe24_product_revisions r ON r.id = a.applied_revision_id
LEFT JOIN cafe24_product_revisions t ON t.id = a.target_revision_id
WHERE a.id = %s
""",
(rows[0]["id"],),
).fetchone()
except (pg_errors.UndefinedTable, pg_errors.UndefinedColumn):
return []
out: list[dict[str, Any]] = []
for index, row in enumerate(rows):
item = dict(row)
at = item.get("remote_at")
if isinstance(at, datetime) and at.tzinfo is None:
at = at.replace(tzinfo=KST)
item["created_at"] = at
item["created_by"] = item.get("actor") or ""
item["html_content"] = (top or {}).get("body", "") if index == 0 else ""
out.append(item)
return out
# ════════════════════════════════════════════════════════════
# OAuth 토큰 — app/integrations/cafe24/tokens.py 가 요구하는 3개 메서드
# ════════════════════════════════════════════════════════════
@@ -281,31 +592,38 @@ class Cafe24Store:
# 마이그레이션 004 의 두 컬럼(last_write_snapshot, last_written_at)을 쓴다.
# 스냅샷 JSON 모양:
# {"product": {"data": {...store.SNAPSHOT_FIELDS...}, "written_at": ISO},
# "options": {"data": {...GET/PUT options 응답...}, "written_at": ISO},
# "variants": {"data": {variant_code: {...}}, "written_at": ISO}}
# "options": {"data": {...GET/PUT options 응답..., "_before_signature", "_recent_values"},
# "written_at": ISO},
# "variants": {"data": {variant_code: {필드..., "_at", "_deleted"?}}, "written_at": ISO}}
# 섹션별로 따로 갱신한다(가격만 바꿨는데 옵션 스냅샷이 사라지면 안 된다).
def save_write_snapshot(self, product_no: int, section: str, data: Any) -> None:
# 품목은 코드별·필드별로 병합한다(store.merge_variant_snapshot). 품목 전체 초기화
# (옵션 삭제·재생성)는 replace=True 로 명시한다 — {} 를 넘기는 것은 "변경 없음"이다.
def save_write_snapshot(self, product_no: int, section: str, data: Any, *, replace: bool = False) -> None:
from psycopg.types.json import Jsonb # noqa: WPS433
no = int(product_no)
if no <= 0 or section not in ("product", "options", "variants"):
return
now_iso = datetime.now(KST).isoformat(timespec="seconds")
with self._pool.connection() as conn:
with conn.transaction():
# 행이 없으면 먼저 만든다 — FOR UPDATE 가 잠글 행이 있어야 동시 저장이
# 서로의 병합 결과를 덮지 않는다.
conn.execute(
"INSERT INTO cafe24_products (product_no) VALUES (%s) ON CONFLICT (product_no) DO NOTHING",
(no,),
)
row = conn.execute(
"SELECT last_write_snapshot FROM cafe24_products WHERE product_no = %s FOR UPDATE",
(no,),
).fetchone()
current = dict(row["last_write_snapshot"]) if row and row.get("last_write_snapshot") else {}
if section == "variants" and isinstance(data, dict):
# 품목은 코드별로 누적 병합 — 일부만 바꿔도 이전에 바꾼 것을 잃지 않게.
merged = dict((current.get("variants") or {}).get("data") or {})
merged.update(data)
data = merged
current[section] = {
"data": data,
"written_at": datetime.now(KST).isoformat(timespec="seconds"),
}
if section == "variants":
previous = (current.get("variants") or {}).get("data") or {}
data = store.merge_variant_snapshot(
previous, data if isinstance(data, dict) else {}, at=now_iso, replace=replace
)
current[section] = {"data": data, "written_at": now_iso}
product = data if section == "product" and isinstance(data, dict) else {}
conn.execute(
"""
@@ -345,51 +663,14 @@ class Cafe24Store:
return {}
return dict(row["last_write_snapshot"])
# ── 읽기 지연 판정용 revision 조회 ──
def latest_write_revision(self, product_no: int, *, since: datetime) -> dict[str, Any] | None:
"""유예시간 안의 가장 최근 '쓰기' revision(MANUAL/SCHEDULED/ROLLBACK) — HTML 포함."""
with self._pool.connection() as conn:
row = conn.execute(
"""
SELECT id, product_no, revision_type, html_content, memo, created_by, created_at
FROM cafe24_product_revisions
WHERE product_no = %s
AND revision_type = ANY(%s)
AND created_at >= %s
ORDER BY created_at DESC, id DESC
LIMIT 1
""",
(int(product_no), list(store.WRITE_REVISION_TYPES), since),
).fetchone()
if not row:
return None
out = dict(row)
at = out.get("created_at")
if isinstance(at, datetime) and at.tzinfo is None:
out["created_at"] = at.replace(tzinfo=KST)
return out
def revision_digests(self, product_no: int, *, since: datetime) -> set[str]:
"""유예시간 안의 revision 들의 내용 해시(store.content_digest 와 같은 md5 hex).
내용을 통째로 옮기지 않고 DB 에서 해시만 계산한다(상세페이지는 수 MB 일 수 있다).
md5 를 쓰는 이유: 모든 PostgreSQL 버전에 있고, 여기서는 충돌 저항이 아니라
"같은 내용인가"만 필요하다.
"""
with self._pool.connection() as conn:
rows = conn.execute(
"""
SELECT md5(html_content) AS digest
FROM cafe24_product_revisions
WHERE product_no = %s AND created_at >= %s
""",
(int(product_no), since),
).fetchall()
return {str(r["digest"]) for r in rows if r.get("digest")}
# ════════════════════════════════════════════════════════════
# 상세페이지 HTML 버전 (append-only — UPDATE/DELETE 하지 않는다)
# 쓰기 직전 BACKUP 을 남기는 것이 유일한 복구 수단이다.
# 읽기 지연 판정은 이 표가 아니라 cafe24_write_attempts(확인된 쓰기)를 본다 —
# 여기에는 충돌로 거절된 적용의 백업·예약 초안처럼 카페24에 올라간 적 없는 값도
# 들어 있기 때문이다(write_lineage 참고).
# 메타데이터(마이그레이션 005): mall_id·shop_no(복원 시 일치 검사), source
# (BACKUP 이 카페24 관측값인지, 지연 중이라 마지막 확인된 쓰기인지), source_revision_id.
# ════════════════════════════════════════════════════════════
def add_revision(
self,
@@ -399,13 +680,18 @@ class Cafe24Store:
revision_type: str,
memo: str = "",
created_by: str = "",
mall_id: str = "",
shop_no: int = 1,
source: str = "",
source_revision_id: int | None = None,
) -> int:
with self._pool.connection() as conn:
row = conn.execute(
"""
INSERT INTO cafe24_product_revisions
(product_no, html_content, revision_type, memo, created_by)
VALUES (%s,%s,%s,%s,%s)
(product_no, html_content, revision_type, memo, created_by,
mall_id, shop_no, source, source_revision_id)
VALUES (%s,%s,%s,%s,%s,%s,%s,%s,%s)
RETURNING id
""",
(
@@ -414,24 +700,33 @@ class Cafe24Store:
store.normalize_revision_type(revision_type),
(memo or "")[:500],
created_by or "",
mall_id or "",
int(shop_no or 1),
source or "",
source_revision_id,
),
).fetchone()
return int(row["id"]) if row else 0
def list_revisions(self, product_no: int, *, limit: int = 20) -> list[dict[str, Any]]:
"""버전 목록. html_content 는 수 MB 일 수 있어 길이만 계산해서 준다."""
with self._pool.connection() as conn:
rows = conn.execute(
"""
SELECT id, product_no, revision_type, memo, created_by, created_at,
length(html_content) AS html_length
FROM cafe24_product_revisions
WHERE product_no = %s
ORDER BY created_at DESC, id DESC
LIMIT %s
""",
(int(product_no), max(1, min(int(limit), 200))),
).fetchall()
"""버전 목록. html_content 는 수 MB 일 수 있어 길이만 계산해서 준다.
005 적용 전이면 출처(source) 없이 돌려준다(읽기 경로는 막지 않는다)."""
sql = """
SELECT id, product_no, revision_type, memo, created_by, created_at,
length(html_content) AS html_length{extra}
FROM cafe24_product_revisions
WHERE product_no = %s
ORDER BY created_at DESC, id DESC
LIMIT %s
"""
args = (int(product_no), max(1, min(int(limit), 200)))
try:
with self._pool.connection() as conn:
rows = conn.execute(sql.format(extra=", source, source_revision_id, mall_id"), args).fetchall()
except pg_errors.UndefinedColumn:
with self._pool.connection() as conn:
rows = conn.execute(sql.format(extra=""), args).fetchall()
return [self._serialize(r) for r in rows]
def get_revision(self, revision_id: int) -> dict[str, Any]:
@@ -568,18 +863,24 @@ class Cafe24Store:
)
return True
@contextmanager
def claim_due_schedule(self, *, now: datetime) -> Iterator[dict[str, Any] | None]:
"""실행할 예약 1건을 잡아 PROCESSING 으로 바꾼다(worker 전용).
# ── 예약 실행 lease (마이그레이션 005) ──
# PROCESSING 은 lease_expires_at 까지만 유효하다. worker 가 죽으면 만료 후
# claim_expired_schedules 로 다른(또는 재기동한) worker 가 가져가 시도 기록을 보고
# 성공/재시도/확인 필요로 나눈다(worker.recover_expired). 모든 상태 변경은
# lease_token 이 맞을 때만 한다 — 만료 뒤 늦게 끝난 worker 가 결과를 덮지 않게.
def claim_due_schedule(self, *, now: datetime, owner: str, ttl_seconds: int) -> dict[str, Any] | None:
"""실행할 예약 1건을 잡아 PROCESSING + lease 로 바꾼다(worker 전용).
`FOR UPDATE SKIP LOCKED` 로 잠그므로 worker 가 여러 개 떠 있어도 같은 예약을
두 번 실행하지 않는다. 재시도 대기(next_retry_at)가 남아 있으면 건너뛴다.
두 번 잡지 않는다. 재시도 대기(next_retry_at)가 남아 있으면 건너뛴다.
반환 행의 lease_token 으로 renew/finish 한다.
"""
token = uuid.uuid4().hex
with self._pool.connection() as conn:
with conn.transaction():
row = conn.execute(
"""
SELECT * FROM cafe24_product_schedules
SELECT id FROM cafe24_product_schedules
WHERE status = 'PENDING'
AND scheduled_at <= %s
AND (next_retry_at IS NULL OR next_retry_at <= %s)
@@ -589,48 +890,154 @@ class Cafe24Store:
""",
(now, now),
).fetchone()
if row is not None:
conn.execute(
"""
UPDATE cafe24_product_schedules
SET status = 'PROCESSING', started_at = now(), last_error = ''
WHERE id = %s
""",
(row["id"],),
if row is None:
return None
claimed = conn.execute(
"""
UPDATE cafe24_product_schedules
SET status = 'PROCESSING', started_at = now(), last_error = '',
lease_owner = %s, lease_token = %s,
lease_expires_at = now() + %s * interval '1 second'
WHERE id = %s
RETURNING *
""",
((owner or "")[:200], token, max(1, int(ttl_seconds)), row["id"]),
).fetchone()
return dict(claimed) if claimed else None
def claim_expired_schedules(
self, *, owner: str, ttl_seconds: int, legacy_minutes: int, limit: int = 20
) -> list[dict[str, Any]]:
"""lease 가 만료된 PROCESSING 예약을 이 worker 에게 다시 lease 한다(복구 전용).
lease 컬럼이 비어 있는 옛 행(005 이전에 PROCESSING 이 된 것)은 started_at 이
legacy_minutes 보다 오래됐으면 만료로 본다.
"""
with self._pool.connection() as conn:
with conn.transaction():
rows = conn.execute(
"""
WITH picked AS (
SELECT id FROM cafe24_product_schedules
WHERE status = 'PROCESSING'
AND (lease_expires_at < now()
OR (lease_expires_at IS NULL
AND COALESCE(started_at, updated_at)
< now() - %s * interval '1 minute'))
ORDER BY id
LIMIT %s
FOR UPDATE SKIP LOCKED
)
yield dict(row) if row is not None else None
UPDATE cafe24_product_schedules s
SET lease_owner = %s,
lease_token = md5(random()::text || clock_timestamp()::text || s.id::text),
lease_expires_at = now() + %s * interval '1 second'
FROM picked
WHERE s.id = picked.id
RETURNING s.*
""",
(max(1, int(legacy_minutes)), max(1, int(limit)), (owner or "")[:200],
max(1, int(ttl_seconds))),
).fetchall()
return [dict(r) for r in rows]
def renew_schedule_lease(self, schedule_id: int, token: str, *, ttl_seconds: int) -> bool:
"""아직 내 lease 면 연장하고 True. 만료돼 넘어갔으면 False — 카페24에 쓰지 않는다."""
with self._pool.connection() as conn:
row = conn.execute(
"""
UPDATE cafe24_product_schedules
SET lease_expires_at = now() + %s * interval '1 second'
WHERE id = %s AND status = 'PROCESSING' AND lease_token = %s
AND lease_expires_at > now()
RETURNING id
""",
(max(1, int(ttl_seconds)), int(schedule_id), token),
).fetchone()
return row is not None
def finish_schedule(
self,
schedule_id: int,
*,
token: str,
status: str,
error: str = "",
next_retry_at: datetime | None = None,
retry_count: int | None = None,
) -> None:
"""예약 종료 처리. 재시도로 되돌릴 때는 status='PENDING' + next_retry_at."""
) -> bool:
"""예약 종료 처리(lease 가 내 것일 때만). 재시도로 되돌릴 때는 status='PENDING' + next_retry_at.
반환: 반영했으면 True. lease 를 잃었으면 False(다른 worker 가 복구 중 — 덮지 않는다).
"""
normalized = store.normalize_schedule_status(status)
with self._pool.connection() as conn:
conn.execute(
row = conn.execute(
"""
UPDATE cafe24_product_schedules
SET status = %s,
last_error = %s,
next_retry_at = %s,
retry_count = COALESCE(%s, retry_count),
lease_owner = '', lease_token = '', lease_expires_at = NULL,
completed_at = CASE WHEN %s IN ('SUCCESS','FAILED','CANCELLED')
THEN now() ELSE completed_at END
WHERE id = %s
WHERE id = %s AND status = 'PROCESSING' AND lease_token = %s
RETURNING id
""",
(
store.normalize_schedule_status(status),
(error or "")[:1000],
next_retry_at,
retry_count,
store.normalize_schedule_status(status),
int(schedule_id),
),
)
(normalized, (error or "")[:1000], next_retry_at, retry_count, normalized,
int(schedule_id), token),
).fetchone()
return row is not None
def get_schedule(self, schedule_id: int) -> dict[str, Any]:
with self._pool.connection() as conn:
row = conn.execute(
"SELECT * FROM cafe24_product_schedules WHERE id = %s", (int(schedule_id),)
).fetchone()
return self._serialize(row)
def review_schedule(
self, schedule_id: int, *, status: str, note: str, actor: str, action: str
) -> dict[str, Any]:
"""확인 필요(NEEDS_REVIEW) 예약을 사람이 확정한다 — SUCCESS / FAILED / PENDING(다시 실행).
SUCCESS 가 아니면 그 예약의 열린 쓰기 시도(STARTED/UNKNOWN)를 ABANDONED 로 닫는다
(반영 안 됨으로 확정 / 재실행으로 대체). SUCCESS 면 호출부가 버전 기록을 채운다.
반환: 바뀐 예약 행. NEEDS_REVIEW 가 아니었으면 {}.
"""
normalized = store.normalize_schedule_status(status)
with self._pool.connection() as conn:
with conn.transaction():
row = conn.execute(
"""
UPDATE cafe24_product_schedules
SET status = %s, last_error = %s,
next_retry_at = CASE WHEN %s = 'PENDING' THEN now() ELSE NULL END,
completed_at = CASE WHEN %s IN ('SUCCESS','FAILED') THEN now() ELSE NULL END
WHERE id = %s AND status = 'NEEDS_REVIEW'
RETURNING *
""",
(normalized, (note or "")[:1000], normalized, normalized, int(schedule_id)),
).fetchone()
if row is None:
return {}
if normalized != store.STATUS_SUCCESS:
conn.execute(
"""
UPDATE cafe24_write_attempts
SET status = %s, resolved_by = %s
WHERE schedule_id = %s AND status = ANY(%s)
""",
(store.ATTEMPT_ABANDONED, (actor or "")[:200], int(schedule_id),
[store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN]),
)
self._insert_audit(
conn, actor=actor, action=f"schedule_review:{action}",
product_no=row["product_no"], schedule_id=row["id"], result="SUCCESS",
detail=note,
)
return self._serialize(row)
# ════════════════════════════════════════════════════════════
# 직렬화 — datetime → KST ISO, date → ISO (다른 모듈과 동일)
+63 -56
View File
@@ -13,8 +13,11 @@
다른 데이터를 다루지만, 여기는 파일마다 경로만 다르고 나머지는 동일하다).
쓰기 순서는 상세페이지 적용과 동일한 원칙을 따른다:
FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부) → FTP 에 쓴다
파일별 DB 잠금(writes.write_lock, 'design:{file_key}')
→ FTP 에서 현재 내용을 다시 읽는다(로컬 값을 현재값으로 가정하지 않는다)
→ BACKUP 버전 저장 → 지문 대조(충돌 시 거부)
→ 임시 파일 업로드·검증 → 교체 직전 원본 재확인 → 이름 바꾸기로 교체
(design_ftp.write_text_file — 원본에 직접 STOR 하지 않는다)
→ MANUAL 버전 + 감사로그
핸들러는 `async def` 가 아니라 `def`(동기)다 — FTP 호출이 블로킹이므로
@@ -24,12 +27,14 @@ FastAPI 스레드풀에서 돌게 둔다(다른 cafe24 라우트와 동일한
from __future__ import annotations
import logging
from urllib.parse import quote
from fastapi import APIRouter, Form, HTTPException, Request
from fastapi.responses import HTMLResponse, RedirectResponse
from app.integrations.cafe24 import (
DESIGN_FILE_SPECS,
Cafe24FtpConflict,
Cafe24FtpError,
design_file_label,
design_file_path,
@@ -38,7 +43,7 @@ from app.integrations.cafe24 import (
load_ftp_config,
)
from . import store
from . import store, writes
from .common import base_ctx, guard
from .routes_products import _no_store
@@ -128,74 +133,76 @@ def design_file_apply(
st, user = checked
actor = str(user.get("email") or "")
back = f"/cafe24/design/{file_key}"
action = f"apply_design:{file_key}"
def go(*, msg: str = "", err: str = "") -> RedirectResponse:
key, text = ("err", err) if err else ("msg", msg)
return RedirectResponse(url=f"{back}?{key}={quote(text, safe='')}", status_code=303)
path = design_file_path(file_key)
ftp_config = _ftp_config()
if not ftp_config.configured:
return RedirectResponse(
url=f"{back}?err=" + "FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing),
status_code=303,
)
return go(err="FTP 설정이 필요합니다: " + ", ".join(ftp_config.missing))
# 브라우저 textarea 는 줄바꿈을 CRLF 로 보낸다 — 그대로 저장하면 실제 수정이
# 없어도 매번 파일 전체의 줄바꿈이 바뀌어(지문 비교·"변경 없음" 판정이 어긋난다).
submitted = content.replace("\r\n", "\n")
if not submitted.strip():
return RedirectResponse(
url=f"{back}?err=" + "내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.",
status_code=303,
)
return go(err="내용이 비어 있습니다. 파일을 비우려면 FTP 로 직접 하세요.")
# 같은 파일을 두 사람이 동시에 적용하지 못하게 파일별 DB 잠금 안에서 한다.
try:
current = design_ftp.read_text_file(ftp_config, path)
except Cafe24FtpError as exc:
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", result="FAIL",
detail=f"현재값 조회 실패: {exc}",
)
return RedirectResponse(url=f"{back}?err=현재 파일을 읽지 못해 중단했습니다: {exc}", status_code=303)
with writes.write_lock(st, writes.design_lock_key(file_key), actor=actor, purpose=f"{file_key} 적용"):
try:
current = design_ftp.read_text_file(ftp_config, path)
except Cafe24FtpError as exc:
writes.audit_safe(st, actor=actor, action=action, result="FAIL", detail=f"현재값 조회 실패: {exc}")
return go(err=f"현재 파일을 읽지 못해 중단했습니다: {exc}")
backup_id = st.add_design_revision(
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업", created_by=actor,
)
backup_id = st.add_design_revision(
file_key=file_key, content=current, revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업", created_by=actor,
)
if base_fingerprint and base_fingerprint != store.fingerprint(current):
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨",
)
return RedirectResponse(
url=f"{back}?err=편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
status_code=303,
)
if base_fingerprint and base_fingerprint != store.fingerprint(current):
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="FAIL", detail="충돌 — 편집 중 파일이 변경됨")
return go(err="편집하는 동안 파일이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.")
if submitted == current:
return RedirectResponse(url=f"{back}?msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)
if submitted == current:
return go(msg="변경된 내용이 없어 적용하지 않았습니다.")
try:
design_ftp.write_text_file(ftp_config, path, submitted)
except Cafe24FtpError as exc:
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=backup_id,
result="FAIL", detail=str(exc),
)
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
return RedirectResponse(
url=f"{back}?err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
status_code=303,
)
try:
# 임시 파일 업로드 → 검증 → 교체 직전 원본 재확인(current 와 같아야) → 이름 바꾸기.
design_ftp.write_text_file(ftp_config, path, submitted, expected_current=current)
except Cafe24FtpConflict as exc:
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="FAIL", detail=f"충돌 — 교체 직전 파일이 변경됨: {exc}")
return go(err=f"{exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
except Cafe24FtpError as exc:
maybe = bool(getattr(exc, "maybe_applied", False))
writes.audit_safe(st, actor=actor, action=action, revision_id=backup_id,
result="UNKNOWN" if maybe else "FAIL", detail=str(exc))
logger.warning("디자인 파일 적용 실패(%s): %s", file_key, exc)
return go(err=f"적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)")
revision_id = st.add_design_revision(
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
memo=memo, created_by=actor,
)
st.log_audit(
actor=actor, action=f"apply_design:{file_key}", revision_id=revision_id, result="SUCCESS",
detail=f"{len(submitted)}자 적용 (백업 {backup_id})",
# 파일은 이미 바뀌었다 — 여기서의 기록 실패는 "적용 실패"가 아니다.
record_note = ""
try:
revision_id = st.add_design_revision(
file_key=file_key, content=submitted, revision_type=store.REVISION_MANUAL,
memo=memo, created_by=actor,
)
except Exception: # noqa: BLE001
logger.exception("디자인 파일(%s) 적용 후 버전 기록 실패", file_key)
revision_id = None
record_note = " ※ 파일은 적용됐지만 버전 기록 저장에 실패했습니다 — 다시 적용하지 마세요."
except (writes.WriteBusy, writes.WriteSetupError) as exc:
return go(err=str(exc))
writes.audit_safe(
st, actor=actor, action=action, revision_id=revision_id, result="SUCCESS",
detail=f"{len(submitted)}자 적용 (백업 {backup_id}, 임시 파일 교체 방식)" + (" / 버전 기록 실패" if record_note else ""),
)
logger.info("디자인 파일 적용(%s) (%s)", file_key, actor)
return RedirectResponse(
url=f"{back}?msg=적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.",
status_code=303,
)
return go(msg=f"적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.{record_note}")
+378 -203
View File
@@ -9,15 +9,20 @@
PUT /products/{no}/options 옵션명 · 옵션값 이름/이미지/표시방식 수정
DELETE /products/{no}/options 옵션 삭제 (품목도 함께 삭제 — 확인 후)
POST /products/{no}/options/image 옵션값 썸네일 업로드만 (경로 반환)
PUT /products/{no}/variants 품목 자체코드 · 추가금액 · 진열 · 판매
PUT /products/{no}/variants 품목 자체코드 · 추가금액 · 진열 · 판매 (행별 결과)
공통 규칙
- 카페24 호출은 `app.integrations.cafe24` 만 통한다(httpx 직접 호출 금지).
- 쓰기는 상품별 DB 잠금(writes.write_lock) 안에서 한다 — 같은 상품을 웹 여러
프로세스·예약 worker 가 동시에 쓰지 않게. 못 잡으면 409.
- 쓰기 전에 현재값을 읽되, **읽기 지연을 보정한 유효 현재값**과 비교해 바뀐
것만 보낸다(routes_products.load_product). 이걸 안 하면 "A→B 로 바꾼 직후
다시 B→A" 가 카페24의 예전 값(A)과 같다고 판단돼 무시된다.
- PUT 응답이 곧 현재값이다. 응답을 스냅샷(`save_write_snapshot`)에 남기고 화면도
응답으로 그린다 — 다시 GET 하지 않는다(GET 은 한동안 예전 값을 돌려준다).
PUT 이 성공한 뒤의 기록 실패는 쓰기 실패로 알리지 않는다(재전송을 부르지 않게).
- 품목은 **품목코드**(안정 식별자)로 짝짓는다. 옵션값 이름을 바꾼 직후 GET 품목이
예전 이름을 돌려줘도 스냅샷의 품목코드별 표기로 바로잡는다(store.apply_variant_patch).
- 모든 쓰기는 감사로그(`cafe24_audit_logs`)에 남긴다.
"""
@@ -31,9 +36,9 @@ from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
from app.timezone import now_kst
from . import store
from . import store, writes
from .common import read_lag_grace_minutes, require_store
from .routes_products import load_product, remember_write
from .routes_products import load_product, locked_json, remember_write
logger = logging.getLogger("cafe24.product_info")
@@ -110,39 +115,40 @@ def product_basic(
raise HTTPException(status_code=400, detail="바꿀 항목이 없습니다.")
api = build_cafe24_api(st)
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}")
raise _http_from_cafe24(exc) from exc
if not current:
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
with locked_json(st, product_no, actor=actor, purpose="상품명·가격 변경"):
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}")
raise _http_from_cafe24(exc) from exc
if not current:
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
changes: dict[str, str] = {}
before: dict[str, str] = {}
for key, value in want.items():
old = str(current.get(key) or "")
same = old == value if key == "product_name" else store.price_equal(old, value)
if not same:
changes[key] = value
before[key] = old
if not changes:
return {"ok": True, "changed": [], "product": _scalar_view(current)}
changes: dict[str, str] = {}
before: dict[str, str] = {}
for key, value in want.items():
old = str(current.get(key) or "")
same = old == value if key == "product_name" else store.price_equal(old, value)
if not same:
changes[key] = value
before[key] = old
if not changes:
return {"ok": True, "changed": [], "product": _scalar_view(current)}
try:
updated = products.update_product(api.client, product_no, **changes)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
result="FAIL", detail=f"{changes} 실패: {exc}")
logger.warning("카페24 상품 %s 기본정보 변경 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
try:
updated = products.update_product(api.client, product_no, **changes)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
result="FAIL", detail=f"{changes} 실패: {exc}")
logger.warning("카페24 상품 %s 기본정보 변경 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
merged = {**current, **(updated if isinstance(updated, dict) else {}), **changes}
detail = ", ".join(f"{k}: '{before[k]}' → '{v}'" for k, v in changes.items())
st.log_audit(actor=actor, action="update_basic", product_no=product_no,
result="SUCCESS", detail=detail)
writes.audit_safe(st, actor=actor, action="update_basic", product_no=product_no,
result="SUCCESS", detail=detail)
logger.info("카페24 상품 %s 기본정보 변경 (%s): %s", product_no, actor, detail)
return {"ok": True, "changed": list(changes.keys()), "product": _scalar_view(merged)}
@@ -169,30 +175,31 @@ def product_image(
data = _read_image(file)
api = build_cafe24_api(st)
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc
if not current:
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
before = str(current.get("detail_image") or "")
with locked_json(st, product_no, actor=actor, purpose="대표 이미지 교체"):
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc
if not current:
raise HTTPException(status_code=404, detail="카페24에서 상품을 찾지 못했습니다.")
before = str(current.get("detail_image") or "")
try:
images = products.set_main_image(
api.client, product_no, data, content_type=(file.content_type or "").lower()
)
if not images.get("detail_image"):
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
except Cafe24Error as exc:
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
result="FAIL", detail=f"등록 실패: {exc}")
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
try:
images = products.set_main_image(
api.client, product_no, data, content_type=(file.content_type or "").lower()
)
if not images.get("detail_image"):
raise Cafe24Error("카페24가 등록된 이미지 경로를 돌려주지 않았습니다.")
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="set_main_image", product_no=product_no,
result="FAIL", detail=f"등록 실패: {exc}")
logger.warning("카페24 상품 %s 대표이미지 변경 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
remember_write(st, product_no, merged)
st.log_audit(actor=actor, action="set_main_image", product_no=product_no,
result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
merged = {**current, **images, "updated_date": now_kst().isoformat(timespec="seconds")}
remember_write(st, product_no, merged)
writes.audit_safe(st, actor=actor, action="set_main_image", product_no=product_no,
result="SUCCESS", detail=f"'{before}' → '{images['detail_image']}'")
logger.info("카페24 상품 %s 대표이미지 변경 (%s)", product_no, actor)
return {"ok": True, "product": _scalar_view(merged)}
@@ -208,6 +215,8 @@ def _variant_view(v: dict[str, Any]) -> dict[str, Any]:
{"name": str(o.get("name") or ""), "value": str(o.get("value") or "")}
for o in opts if isinstance(o, dict)
],
# 첫 옵션의 옵션값 번호(value_no) — 화면이 이름보다 먼저 이것으로 옵션값과 짝짓는다.
"value_no": v.get("value_no"),
"custom_variant_code": str(v.get("custom_variant_code") or ""),
"additional_amount": str(v.get("additional_amount") or "0.00"),
"display": products._flag(v.get("display")), # noqa: SLF001
@@ -238,6 +247,7 @@ def _options_view(option: dict[str, Any]) -> dict[str, Any]:
"option_link_image": str(v.get("option_link_image") or ""),
"option_color": str(v.get("option_color") or ""),
"value_no": v.get("value_no"),
"pending": bool(v.get("pending")),
}
for v in values if isinstance(v, dict)
],
@@ -252,43 +262,125 @@ def _options_view(option: dict[str, Any]) -> dict[str, Any]:
}
def _apply_variant_snapshot(st: Any, product_no: int, variants: list[dict[str, Any]]) -> list[dict[str, Any]]:
"""GET 품목 목록에 유예시간 안의 우리 쓰기(스냅샷)를 덮어씌운다.
def _snapshot_sections(st: Any, product_no: int) -> tuple[dict[str, Any], dict[str, Any]]:
"""(옵션 섹션, 품목 섹션) — 각각 {"data":…, "written_at":…} 또는 {}."""
snap = st.get_write_snapshot(product_no) or {}
return snap.get("options") or {}, snap.get("variants") or {}
삭제한 품목(`{"_deleted": true}`)은 카페24 GET 이 한동안 계속 돌려주므로 걸러낸다.
"""
section = (st.get_write_snapshot(product_no) or {}).get("variants") or {}
def _within(written_at: object) -> bool:
return store.within_grace(written_at, grace_minutes=read_lag_grace_minutes())
def _patch_variants(section: dict[str, Any], variants: list[dict[str, Any]]) -> list[dict[str, Any]]:
"""GET 품목 목록에 품목코드별 쓰기 기록을 덮어씌운다(삭제한 품목은 뺀다)."""
data = section.get("data") or {}
if not data or not store.within_grace(section.get("written_at"), grace_minutes=read_lag_grace_minutes()):
return variants
if not isinstance(data, dict) or not data:
return list(variants)
out = []
for v in variants:
code = str(v.get("variant_code") or "")
patch = data.get(code)
if isinstance(patch, dict) and patch.get("_deleted"):
continue
out.append({**v, **patch} if isinstance(patch, dict) else v)
patched = store.apply_variant_patch(
v, data.get(str(v.get("variant_code") or "")),
section_written_at=section.get("written_at"), grace_minutes=read_lag_grace_minutes(),
)
if patched is not None:
out.append(patched)
return out
def _apply_options_snapshot(st: Any, product_no: int, option: dict[str, Any]) -> dict[str, Any]:
"""GET 옵션이 우리 마지막 쓰기와 다르고 유예시간 안이면 스냅샷(우리 쓰기)을 쓴다."""
section = (st.get_write_snapshot(product_no) or {}).get("options") or {}
data = section.get("data")
if not isinstance(data, dict) or not store.within_grace(
section.get("written_at"), grace_minutes=read_lag_grace_minutes()
):
return option
return data
def _annotate(option: dict[str, Any], variants: list[dict[str, Any]], recent: list[str]) -> tuple[dict, list]:
"""옵션 1개 상품: 품목에 첫 옵션값 번호(value_no)를, 품목이 아직 안 보이는 최근 추가
옵션값에 pending 표시를 붙인다(화면이 "품목 없는 옵션값"으로 오해하지 않게)."""
groups = option.get("options") if isinstance(option.get("options"), list) else []
if len(groups) != 1 or not isinstance(groups[0], dict):
return option, variants
values = [v for v in (groups[0].get("option_value") or []) if isinstance(v, dict)]
by_text = {str(v.get("option_text") or ""): v.get("value_no") for v in values}
used: set[str] = set()
out_variants = []
for v in variants:
opts = v.get("options") if isinstance(v.get("options"), list) else []
first = str(opts[0].get("value") or "") if opts and isinstance(opts[0], dict) else ""
used.add(first)
out_variants.append({**v, "value_no": by_text.get(first)} if first in by_text else v)
recent_set = set(recent or [])
new_values = [
{**v, "pending": True} if str(v.get("option_text") or "") in recent_set
and str(v.get("option_text") or "") not in used else v
for v in values
]
return {**option, "options": [{**groups[0], "option_value": new_values}]}, out_variants
def _load_options_and_variants(st: Any, api: Any, product_no: int) -> dict[str, Any]:
option = _apply_options_snapshot(st, product_no, products.get_options(api.client, product_no))
view = _options_view(option)
raw_option = products.get_options(api.client, product_no)
osec, vsec = _snapshot_sections(st, product_no)
option, _stale = store.overlay_options(
raw_option, snapshot=osec.get("data"), written_at=osec.get("written_at"),
grace_minutes=read_lag_grace_minutes(),
)
raw_variants: list[dict[str, Any]] = []
variants: list[dict[str, Any]] = []
if view["has_option"]:
variants = _apply_variant_snapshot(st, product_no, products.list_variants(api.client, product_no))
return {"option": view, "variants": [_variant_view(v) for v in variants], "raw_options": option}
if products._flag(option.get("has_option"), default=False): # noqa: SLF001
raw_variants = products.list_variants(api.client, product_no)
variants = _patch_variants(vsec, raw_variants)
recent = _recent_values(osec)
shown_option, shown_variants = _annotate(option, variants, recent)
return {
"option": _options_view(shown_option),
"variants": [_variant_view(v) for v in shown_variants],
"raw_option": raw_option,
"effective_option": option,
"raw_variants": raw_variants,
"effective_variants": variants,
"options_section": osec,
"variants_section": vsec,
}
def _recent_values(osec: dict[str, Any]) -> list[str]:
data = osec.get("data") if isinstance(osec.get("data"), dict) else {}
if not data or not _within(osec.get("written_at")):
return []
return [str(v) for v in (data.get("_recent_values") or [])]
def _prior_signatures(osec: dict[str, Any]) -> list[str]:
data = osec.get("data") if isinstance(osec.get("data"), dict) else {}
if not data or not _within(osec.get("written_at")):
return []
return [str(s) for s in (data.get("_before_signatures") or []) if isinstance(s, str)]
def _unique(items: list[Any]) -> list[Any]:
out: list[Any] = []
for item in items:
if item not in out:
out.append(item)
return out
def _options_snapshot(
written: dict[str, Any], *, befores: list[dict[str, Any]], osec: dict[str, Any], recent: list[str]
) -> dict[str, Any]:
"""옵션 스냅샷 = 카페24 응답 + 쓰기 직전 모양들의 서명 + 최근 추가한 옵션값."""
signatures = _unique(_prior_signatures(osec) + [store.options_signature(b) for b in befores if b])
texts = {
str(v.get("option_text") or "")
for o in (written.get("options") or []) if isinstance(o, dict)
for v in (o.get("option_value") or []) if isinstance(v, dict)
}
keep = [t for t in _unique(_recent_values(osec) + list(recent)) if t in texts]
return {**written, "_before_signatures": signatures, "_recent_values": keep}
def _save_snapshot_safe(st: Any, product_no: int, section: str, data: Any, **kw: Any) -> str:
try:
st.save_write_snapshot(product_no, section, data, **kw)
except Exception as exc: # noqa: BLE001 — 카페24에는 이미 반영됐다
logger.exception("상품 %s %s 스냅샷 저장 실패", product_no, section)
return f"{type(exc).__name__}: {exc}"
return ""
@product_info_router.get("/products/{product_no}/options")
@@ -322,29 +414,40 @@ def options_create(
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc
values = [v["option_text"] for v in body["options"][0]["option_value"]]
api = build_cafe24_api(st)
try:
existing = products.get_options(api.client, product_no)
if products._flag(existing.get("has_option"), default=False): # noqa: SLF001
raise HTTPException(status_code=409, detail="이미 옵션이 있는 상품입니다. 수정하거나 삭제한 뒤 다시 만드세요.")
created = products.create_options(api.client, product_no, body)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="create_options", product_no=product_no,
result="FAIL", detail=f"{body['options'][0]['option_name']} 실패: {exc}")
raise _http_from_cafe24(exc) from exc
with locked_json(st, product_no, actor=actor, purpose="옵션 생성"):
try:
existing = products.get_options(api.client, product_no)
if products._flag(existing.get("has_option"), default=False): # noqa: SLF001
raise HTTPException(status_code=409, detail="이미 옵션이 있는 상품입니다. 수정하거나 삭제한 뒤 다시 만드세요.")
created = products.create_options(api.client, product_no, body)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="create_options", product_no=product_no,
result="FAIL", detail=f"{body['options'][0]['option_name']} 실패: {exc}")
raise _http_from_cafe24(exc) from exc
st.save_write_snapshot(product_no, "options", created)
values = [v["option_text"] for v in body["options"][0]["option_value"]]
st.log_audit(actor=actor, action="create_options", product_no=product_no, result="SUCCESS",
detail=f"옵션 '{body['options'][0]['option_name']}' 생성: {', '.join(values)}")
osec, _vsec = _snapshot_sections(st, product_no)
record_error = _save_snapshot_safe(
st, product_no, "options",
_options_snapshot(created, befores=[existing], osec=osec, recent=values),
)
# 새 옵션의 품목은 새 품목코드다 — 이전 품목 기록은 모두 버린다(전체 초기화).
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", {}, replace=True)
# 카페24가 자동 생성한 품목(코드 부여)을 바로 돌려준다 — 읽기 지연이 있어 짧게 재시도.
# 화면은 이 코드로 자체코드·추가금액을 이어서 PUT 한다. 다 안 보이면 pending 으로 표시.
variants = products.wait_for_variants(api.client, product_no, len(values))
writes.audit_safe(st, actor=actor, action="create_options", product_no=product_no, result="SUCCESS",
detail=f"옵션 '{body['options'][0]['option_name']}' 생성: {', '.join(values)}")
logger.info("카페24 상품 %s 옵션 생성 (%s)", product_no, actor)
# 카페24가 자동 생성한 품목(코드 부여)을 바로 돌려준다 — 읽기 지연이 있어 짧게 재시도.
# 화면은 이 코드로 자체코드·추가금액을 이어서 PUT 한다.
variants = products.wait_for_variants(api.client, product_no, len(values))
if len(variants) < len(values):
logger.warning("카페24 상품 %s 옵션 생성 후 품목 %s/%s 건만 조회됨", product_no, len(variants), len(values))
return {"ok": True, "option": _options_view(created), "variants": [_variant_view(v) for v in variants]}
shown_option, shown_variants = _annotate(created, variants, values)
return {"ok": True, "option": _options_view(shown_option),
"variants": [_variant_view(v) for v in shown_variants],
"missing_variants": max(0, len(values) - len(variants)),
"record_warning": record_error}
@product_info_router.put("/products/{product_no}/options")
@@ -358,6 +461,8 @@ def options_update(
카페24 PUT 은 `original_options`(수정 전)와 `options`(수정 후)를 짝지어 받는다.
수정 전 값은 화면이 들고 있던 것이 아니라 **지금 카페24에서 다시 읽은 값**(읽기
지연 보정 후)을 쓴다 — 그래야 다른 곳에서 바뀐 이름과 어긋나지 않는다.
이름을 바꾸면 품목코드별로 새 표기를 스냅샷에 남긴다(GET 품목이 예전 이름을
돌려주는 동안에도 품목이 옵션값과 제대로 짝지어 보이게).
"""
st, user = require_store(request)
actor = str(user.get("email") or "")
@@ -366,64 +471,99 @@ def options_update(
raise HTTPException(status_code=400, detail="옵션 목록이 비어 있습니다.")
api = build_cafe24_api(st)
try:
loaded = _load_options_and_variants(st, api, product_no)
except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc
if not loaded["option"]["has_option"]:
raise HTTPException(status_code=409, detail="옵션이 없는 상품입니다. 먼저 옵션을 만드세요.")
original = loaded["option"]["options"]
try:
body = store.build_update_options_request(
original, edited, option_list_type=str(payload.get("option_list_type") or ""),
allow_append=True,
with locked_json(st, product_no, actor=actor, purpose="옵션 수정"):
try:
loaded = _load_options_and_variants(st, api, product_no)
except Cafe24Error as exc:
raise _http_from_cafe24(exc) from exc
if not loaded["option"]["has_option"]:
raise HTTPException(status_code=409, detail="옵션이 없는 상품입니다. 먼저 옵션을 만드세요.")
original = loaded["option"]["options"]
try:
body = store.build_update_options_request(
original, edited, option_list_type=str(payload.get("option_list_type") or ""),
allow_append=True,
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc
if loaded["option"]["option_preset_code"]:
body["option_preset_code"] = loaded["option"]["option_preset_code"]
# 뒤에 덧붙인 옵션값 — 카페24가 받아들이면 품목을 자동 생성한다(재시도 조회).
added_texts = [
v["option_text"]
for o, n in zip(body["original_options"], body["options"])
for v in n["option_value"][len(o["option_value"]):]
]
added = len(added_texts)
try:
updated = products.update_options(api.client, product_no, body)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
result="FAIL", detail=str(exc))
logger.warning("카페24 상품 %s 옵션 수정 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
# ── 여기부터는 카페24에 반영된 뒤 — 기록 실패는 경고로만 알린다 ──
record_error = _save_snapshot_safe(
st, product_no, "options",
_options_snapshot(updated, befores=[loaded["raw_option"], loaded["effective_option"]],
osec=loaded["options_section"], recent=added_texts),
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc)) from exc
if loaded["option"]["option_preset_code"]:
body["option_preset_code"] = loaded["option"]["option_preset_code"]
# 뒤에 덧붙인 옵션값 수 — 카페24가 받아들이면 품목을 자동 생성한다(재시도 조회).
added = sum(
max(0, len(n["option_value"]) - len(o["option_value"]))
for o, n in zip(body["original_options"], body["options"])
)
# 이름 바꾸기 표(수정 전 → 수정 후) — 위치로 짝지어진다(build_update_options_request).
rename: dict[tuple[str, str], tuple[str, str]] = {}
for o, n in zip(original, body["options"]):
for ov, nv in zip(o["option_value"], n["option_value"]):
rename[(o["option_name"], ov["option_text"])] = (n["option_name"], nv["option_text"])
raw_labels = {str(v.get("variant_code") or ""): v.get("options") for v in loaded["raw_variants"]}
previous = (loaded["variants_section"].get("data") or {}) if _within(
loaded["variants_section"].get("written_at")) else {}
label_patch: dict[str, Any] = {}
renamed_variants: list[dict[str, Any]] = []
for v in loaded["effective_variants"]:
code = str(v.get("variant_code") or "")
current = store.labels_as_json(v.get("options"))
new = [
dict(zip(("name", "value"), rename.get((o["name"], o["value"]), (o["name"], o["value"]))))
for o in current
]
renamed_variants.append({**v, "options": new})
if new != current and code:
prior = previous.get(code) if isinstance(previous.get(code), dict) else {}
history = [
[{"name": a, "value": b} for a, b in labels]
for labels in store.label_history(prior.get("_options_before"))
]
befores = _unique(history + [current, store.labels_as_json(raw_labels.get(code))])
label_patch[code] = {"options": new, "_options_before": [b for b in befores if b != new]}
if label_patch:
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", label_patch)
summary = "; ".join(
f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"])
for o in body["options"]
) + (f" (+{added} 추가)" if added else "")
try:
updated = products.update_options(api.client, product_no, body)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="update_options", product_no=product_no,
result="FAIL", detail=str(exc))
logger.warning("카페24 상품 %s 옵션 수정 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
st.save_write_snapshot(product_no, "options", updated)
summary = "; ".join(
f"{o['option_name']}: " + ", ".join(v["option_text"] for v in o["option_value"])
for o in body["options"]
) + (f" (+{added} 추가)" if added else "")
st.log_audit(actor=actor, action="update_options", product_no=product_no,
result="SUCCESS", detail=summary[:900])
fresh: list[dict[str, Any]] | None = None
if added:
# 새 옵션값의 품목코드를 받아 돌려준다 — 화면이 자체코드/추가금액을 이어서 PUT 한다.
# 늦게 나타나는 품목은 pending 으로 표시된다(_annotate).
_osec, vsec = _snapshot_sections(st, product_no)
fresh = _patch_variants(
vsec, products.wait_for_variants(api.client, product_no, len(loaded["raw_variants"]) + added)
)
writes.audit_safe(st, actor=actor, action="update_options", product_no=product_no,
result="SUCCESS", detail=summary[:900])
logger.info("카페24 상품 %s 옵션 수정 (%s)", product_no, actor)
shown_option, shown_variants = _annotate(
updated, fresh if fresh is not None else renamed_variants, added_texts
)
out: dict[str, Any] = {"ok": True, "option": _options_view(shown_option),
"variants": [_variant_view(v) for v in shown_variants],
"record_warning": record_error}
if added:
# 새 옵션값의 품목코드를 받아 돌려준다 — 화면이 자체코드/추가금액을 이어서 PUT 한다.
fresh = products.wait_for_variants(api.client, product_no, len(loaded["variants"]) + added)
fresh = _apply_variant_snapshot(st, product_no, fresh)
return {"ok": True, "option": _options_view(updated), "variants": [_variant_view(v) for v in fresh],
"added": added}
# 품목의 옵션값 표기는 이름을 바꾼 만큼 달라진다 — 응답값으로 다시 맞춘다.
variants = loaded["variants"]
rename: dict[tuple[str, str], tuple[str, str]] = {}
for o, n in zip(original, body["options"]):
for ov, nv in zip(o["option_value"], n["option_value"]):
rename[(o["option_name"], ov["option_text"])] = (n["option_name"], nv["option_text"])
for v in variants:
v["options"] = [
dict(zip(("name", "value"), rename.get((opt["name"], opt["value"]), (opt["name"], opt["value"]))))
for opt in v["options"]
]
return {"ok": True, "option": _options_view(updated), "variants": variants}
out["added"] = added
return out
@product_info_router.delete("/products/{product_no}/options")
@@ -432,22 +572,29 @@ def options_delete(request: Request, product_no: int) -> dict[str, Any]:
st, user = require_store(request)
actor = str(user.get("email") or "")
api = build_cafe24_api(st)
try:
before = products.get_options(api.client, product_no)
products.delete_options(api.client, product_no)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="delete_options", product_no=product_no,
result="FAIL", detail=str(exc))
raise _http_from_cafe24(exc) from exc
names = ", ".join(
str(o.get("option_name") or "") for o in (before.get("options") or []) if isinstance(o, dict)
)
st.save_write_snapshot(product_no, "options", {"has_option": "F", "options": []})
st.save_write_snapshot(product_no, "variants", {})
st.log_audit(actor=actor, action="delete_options", product_no=product_no,
result="SUCCESS", detail=f"삭제된 옵션: {names or '(없음)'}")
with locked_json(st, product_no, actor=actor, purpose="옵션 삭제"):
try:
before = products.get_options(api.client, product_no)
products.delete_options(api.client, product_no)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="delete_options", product_no=product_no,
result="FAIL", detail=str(exc))
raise _http_from_cafe24(exc) from exc
names = ", ".join(
str(o.get("option_name") or "") for o in (before.get("options") or []) if isinstance(o, dict)
)
osec, _vsec = _snapshot_sections(st, product_no)
record_error = _save_snapshot_safe(
st, product_no, "options",
_options_snapshot({"has_option": "F", "options": []}, befores=[before], osec=osec, recent=[]),
)
# 품목 전체 초기화 — 빈 dict 병합(=변경 없음)이 아니라 명시적 replace.
record_error = record_error or _save_snapshot_safe(st, product_no, "variants", {}, replace=True)
writes.audit_safe(st, actor=actor, action="delete_options", product_no=product_no,
result="SUCCESS", detail=f"삭제된 옵션: {names or '(없음)'}")
logger.info("카페24 상품 %s 옵션 삭제 (%s)", product_no, actor)
return {"ok": True, "option": _options_view({"has_option": "F"}), "variants": []}
return {"ok": True, "option": _options_view({"has_option": "F"}), "variants": [],
"record_warning": record_error}
@product_info_router.post("/products/{product_no}/options/image")
@@ -464,13 +611,13 @@ def option_image_upload(
try:
path = products.upload_image_bytes(api.client, data)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="upload_option_image", product_no=product_no,
result="FAIL", detail=str(exc))
writes.audit_safe(st, actor=actor, action="upload_option_image", product_no=product_no,
result="FAIL", detail=str(exc))
raise _http_from_cafe24(exc) from exc
if not path:
raise HTTPException(status_code=502, detail="카페24가 업로드 경로를 돌려주지 않았습니다.")
st.log_audit(actor=actor, action="upload_option_image", product_no=product_no,
result="SUCCESS", detail=path)
writes.audit_safe(st, actor=actor, action="upload_option_image", product_no=product_no,
result="SUCCESS", detail=path)
return {"ok": True, "path": path}
@@ -483,18 +630,20 @@ def variant_delete(request: Request, product_no: int, variant_code: str) -> dict
if not store.VARIANT_CODE_RE.match(code):
raise HTTPException(status_code=400, detail=f"품목코드 형식이 올바르지 않습니다: {code}")
api = build_cafe24_api(st)
try:
products.delete_variant(api.client, product_no, code)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="delete_variant", product_no=product_no,
result="FAIL", detail=f"{code}: {exc}")
raise _http_from_cafe24(exc) from exc
# 카페24 GET 은 한동안 삭제된 품목을 계속 돌려준다 — 스냅샷에 삭제 표식을 남겨 걸러낸다.
st.save_write_snapshot(product_no, "variants", {code: {"_deleted": True}})
st.log_audit(actor=actor, action="delete_variant", product_no=product_no,
result="SUCCESS", detail=code)
with locked_json(st, product_no, actor=actor, purpose="품목 삭제"):
try:
products.delete_variant(api.client, product_no, code)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action="delete_variant", product_no=product_no,
result="FAIL", detail=f"{code}: {exc}")
raise _http_from_cafe24(exc) from exc
# 카페24 GET 은 한동안 삭제된 품목을 계속 돌려준다 — 삭제 표식을 남겨 걸러낸다.
# 표식은 이후 늦게 도착한 수정이 있어도 유지된다(store.merge_variant_snapshot).
record_error = _save_snapshot_safe(st, product_no, "variants", {code: {"_deleted": True}})
writes.audit_safe(st, actor=actor, action="delete_variant", product_no=product_no,
result="SUCCESS", detail=code)
logger.info("카페24 상품 %s 품목 %s 삭제 (%s)", product_no, code, actor)
return {"ok": True, "variant_code": code}
return {"ok": True, "variant_code": code, "record_warning": record_error}
@product_info_router.put("/products/{product_no}/variants")
@@ -503,7 +652,13 @@ def variants_update(
product_no: int,
payload: dict[str, Any] = Body(default_factory=dict),
) -> dict[str, Any]:
"""품목 여러 건의 자체코드 · 추가금액 · 진열 · 판매를 한 번에 바꾼다."""
"""품목 여러 건의 자체코드 · 추가금액 · 진열 · 판매를 한 번에 바꾼다 — **행별 결과**.
응답 {"ok": 전부 성공?, "partial": 일부만?, "updated": {code: 반영된 값},
"failed": {code: 사유}, "unknown": {code: 사유}}
100건 묶음 중 일부가 실패해도 성공한 행은 성공으로 기록·표시한다(화면이 그 행을
다시 보내지 않게). 하나도 반영되지 않았으면 502.
"""
st, user = require_store(request)
actor = str(user.get("email") or "")
rows = payload.get("rows")
@@ -517,31 +672,51 @@ def variants_update(
raise HTTPException(status_code=400, detail="바뀐 값이 없습니다.")
api = build_cafe24_api(st)
try:
with locked_json(st, product_no, actor=actor, purpose="품목 수정"):
results = products.update_variants(api.client, product_no, requests)
except Cafe24Error as exc:
st.log_audit(actor=actor, action="update_variants", product_no=product_no,
result="FAIL", detail=f"{len(requests)}건 실패: {exc}")
logger.warning("카페24 상품 %s 품목 수정 실패: %s", product_no, exc)
raise _http_from_cafe24(exc) from exc
# 우리가 보낸 값이 곧 현재값이다(카페24가 받아들였으므로). 응답에 담긴 값이 있으면
# 그것을 우선한다.
by_code: dict[str, dict[str, Any]] = {}
for r in requests:
by_code[r["variant_code"]] = {k: v for k, v in r.items() if k != "variant_code"}
for r in results:
code = str(r.get("variant_code") or "")
if code in by_code:
for key in ("custom_variant_code", "additional_amount", "display", "selling", "display_order"):
if key in r and r[key] is not None:
by_code[code][key] = r[key]
st.save_write_snapshot(product_no, "variants", by_code)
# 카페24가 받아들인 행만 현재값으로 기록한다. 응답에 담긴 값이 있으면 그것을 우선한다.
sent = {r["variant_code"]: {k: v for k, v in r.items() if k != "variant_code"} for r in requests}
by_code: dict[str, dict[str, Any]] = {}
failed: dict[str, str] = {}
unknown: dict[str, str] = {}
for result in results:
code = result["variant_code"]
if result["status"] == products.VARIANT_OK:
patch = dict(sent.get(code) or {})
for key in ("custom_variant_code", "additional_amount", "display", "selling", "display_order"):
value = (result.get("variant") or {}).get(key)
if value is not None:
patch[key] = value
by_code[code] = patch
elif result["status"] == products.VARIANT_UNKNOWN:
unknown[code] = result["error"]
else:
failed[code] = result["error"]
record_error = _save_snapshot_safe(st, product_no, "variants", by_code) if by_code else ""
detail = "; ".join(
f"{code}: " + ", ".join(f"{k}={v}" for k, v in patch.items()) for code, patch in by_code.items()
)
st.log_audit(actor=actor, action="update_variants", product_no=product_no,
result="SUCCESS", detail=detail[:900])
logger.info("카페24 상품 %s 품목 %s건 수정 (%s)", product_no, len(by_code), actor)
return {"ok": True, "updated": {code: _variant_view({"variant_code": code, **patch})
for code, patch in by_code.items()}}
if failed or unknown:
detail = (f"성공 {len(by_code)} / 실패 {len(failed)} / 결과 모름 {len(unknown)} — " + detail)
first = next(iter({**failed, **unknown}.values()), "")
detail += f" / 오류: {first}"
result_label = "SUCCESS" if not (failed or unknown) else ("PARTIAL" if by_code else "FAIL")
writes.audit_safe(st, actor=actor, action="update_variants", product_no=product_no,
result=result_label, detail=detail[:900])
if not by_code:
first = next(iter({**failed, **unknown}.values()), "알 수 없는 오류")
note = " (일부는 반영됐을 수 있습니다 — 다시 불러와 확인하세요)" if unknown else ""
logger.warning("카페24 상품 %s 품목 수정 실패: %s", product_no, first)
raise HTTPException(status_code=502, detail=f"{first}{note}")
logger.info("카페24 상품 %s 품목 %s건 수정 (%s, 실패 %s, 모름 %s)",
product_no, len(by_code), actor, len(failed), len(unknown))
return {
"ok": not (failed or unknown),
"partial": bool(failed or unknown),
"updated": {code: _variant_view({"variant_code": code, **patch}) for code, patch in by_code.items()},
"failed": failed,
"unknown": unknown,
"record_warning": record_error,
}
+330 -167
View File
@@ -50,10 +50,11 @@ PC/모바일은 구분하지 않는다 — 적용 시 `description` 만 쓰고
from __future__ import annotations
import logging
from contextlib import contextmanager
from datetime import timedelta
from decimal import Decimal
from typing import Any
from urllib.parse import urlencode
from typing import Any, Iterator
from urllib.parse import quote, urlencode
from fastapi import APIRouter, Body, Form, HTTPException, Request
from fastapi.responses import HTMLResponse, RedirectResponse
@@ -61,7 +62,7 @@ from fastapi.responses import HTMLResponse, RedirectResponse
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
from app.timezone import now_kst
from . import store
from . import store, writes
from .common import base_ctx, guard, read_lag_grace_minutes, require_store
logger = logging.getLogger("cafe24.products")
@@ -121,6 +122,16 @@ def _short_dt(value: Any) -> str:
return text.replace("T", " ")[:16]
def _iso(value: Any) -> str:
"""datetime 이면 KST ISO, 아니면 문자열 그대로."""
if hasattr(value, "astimezone"):
from app.timezone import KST # noqa: WPS433
aware = value if value.tzinfo else value.replace(tzinfo=KST)
return aware.astimezone(KST).isoformat(timespec="seconds")
return str(value or "")
def _row_for_list(raw: dict[str, Any]) -> dict[str, Any]:
"""왼쪽 목록에 쓸 필드만 — 상품번호·상품명·진열·판매·최근수정."""
normalized = products.normalize_product(raw)
@@ -187,30 +198,34 @@ def load_product(st: Any, api: Any, product_no: int) -> tuple[dict[str, Any], bo
def resolve_description(
st: Any, product_no: int, cafe24_html: str
st: Any, product_no: int, cafe24_html: str, *, fetched_updated: object = None
) -> tuple[str, str, dict[str, Any] | None]:
"""(유효 HTML, 상태, 마지막 쓰기 revision). 상태는 store.SYNC_*."""
grace = read_lag_grace_minutes()
since = now_kst() - timedelta(minutes=grace)
last_write = st.latest_write_revision(product_no, since=since)
if not last_write:
return cafe24_html, store.SYNC_NONE, None
digests = st.revision_digests(product_no, since=since)
effective, state = store.resolve_description(
cafe24_html, last_write=last_write, known_digests=digests, grace_minutes=grace
)
return effective, state, last_write
"""(유효 HTML, 상태, 마지막 확인된 쓰기). 상태는 store.SYNC_*.
근거는 원격 반영이 확인된 쓰기(cafe24_write_attempts)뿐이다 — writes.resolve_effective.
"""
return writes.resolve_effective(st, product_no, cafe24_html, fetched_updated=fetched_updated)
def remember_write(st: Any, product_no: int, updated: dict[str, Any]) -> dict[str, Any]:
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. 정규화된 캐시 행을 돌려준다."""
info = products.normalize_product(updated) if updated else {}
if info.get("product_no"):
st.upsert_products([info])
st.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. 정규화된 캐시 행을 돌려준다.
카페24에는 이미 반영된 뒤라 기록 실패로 예외를 내지 않는다(로그만 — writes 참고).
"""
info, _error = writes.remember_product_write(st, product_no, updated)
return info
@contextmanager
def locked_json(st: Any, product_no: int, *, actor: str, purpose: str) -> Iterator[Any]:
"""JSON API 용 상품 쓰기 잠금 — 못 잡으면 409, 스키마가 없으면 503."""
try:
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose=purpose) as lock:
yield lock
except (writes.WriteBusy, writes.WriteSetupError) as exc:
raise HTTPException(status_code=exc.http_status, detail=str(exc)) from exc
def _info(product: dict[str, Any]) -> dict[str, Any]:
"""편집기·정보 패널 공용 상품 요약."""
info = products.normalize_product(product) if product else {}
@@ -245,11 +260,27 @@ def _editor_ctx(st: Any, product_no: int) -> dict[str, Any]:
product, scalar_stale = load_product(st, api, product_no)
desc = products.descriptions_from_product(product)
st.upsert_products([products.normalize_product(product)])
html_effective, sync_state, last_write = resolve_description(st, product_no, desc.description)
html_effective, sync_state, last_write = resolve_description(
st, product_no, desc.description, fetched_updated=product.get("updated_date")
)
except Cafe24Error as exc:
error = str(exc)
logger.warning("카페24 상품 %s 조회 실패: %s", product_no, exc)
# 반영 여부를 모르는 이전 시도 — 편집기 위에 확정 버튼과 함께 보여준다.
# (REMOTE_OK 는 반영이 확인된 것이라 여기 올리지 않는다 — 기록은 자동 복구된다.)
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
open_attempts = [
{**a, "label": writes.describe_attempt(a),
"status_label": "결과 모름" if a.get("status") == store.ATTEMPT_UNKNOWN else "중단됨"}
for a in st.open_attempts(product_no, since=since)
if a.get("status") in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN)
]
revisions = [
{**r, "type_label": store.REVISION_LABELS.get(str(r.get("revision_type") or ""), "")}
for r in st.list_revisions(product_no, limit=20)
]
return {
"product_no": product_no,
# 고객이 보는 상세페이지 주소 (CAFE24_SHOP_URL, 없으면 카페24 기본 도메인)
@@ -268,9 +299,10 @@ def _editor_ctx(st: Any, product_no: int) -> dict[str, Any]:
"sync_pending": sync_state == store.SYNC_PENDING,
"sync_external": sync_state == store.SYNC_EXTERNAL,
"scalar_stale": scalar_stale,
"last_write_at": _short_dt(last_write.get("created_at").isoformat() if last_write and last_write.get("created_at") else ""),
"last_write_at": _short_dt(_iso(last_write.get("created_at")) if last_write else ""),
"last_write_by": (last_write or {}).get("created_by") or "",
"revisions": st.list_revisions(product_no, limit=20),
"revisions": revisions,
"open_attempts": open_attempts,
"editor_error": error,
"option_display_types": store.OPTION_DISPLAY_LABELS,
}
@@ -384,33 +416,34 @@ def product_rename(
raise HTTPException(status_code=400, detail=f"상품명은 {NAME_MAX}자를 넘을 수 없습니다.")
api = build_cafe24_api(st)
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
st.log_audit(
actor=actor, action="rename_product", product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}",
)
raise HTTPException(status_code=502, detail=f"카페24 현재값을 읽지 못했습니다: {exc}") from exc
with locked_json(st, product_no, actor=actor, purpose="상품명 변경"):
try:
current, _ = load_product(st, api, product_no)
except Cafe24Error as exc:
writes.audit_safe(
st, actor=actor, action="rename_product", product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}",
)
raise HTTPException(status_code=502, detail=f"카페24 현재값을 읽지 못했습니다: {exc}") from exc
before = str(current.get("product_name") or "")
if before == name:
return {"ok": True, "product_name": before, "changed": False}
before = str(current.get("product_name") or "")
if before == name:
return {"ok": True, "product_name": before, "changed": False}
try:
updated = products.update_product(api.client, product_no, product_name=name)
except Cafe24Error as exc:
st.log_audit(
actor=actor, action="rename_product", product_no=product_no,
result="FAIL", detail=f"'{before}' → '{name}' 실패: {exc}",
)
logger.warning("카페24 상품 %s 이름 변경 실패: %s", product_no, exc)
raise HTTPException(status_code=502, detail=str(exc)) from exc
try:
updated = products.update_product(api.client, product_no, product_name=name)
except Cafe24Error as exc:
writes.audit_safe(
st, actor=actor, action="rename_product", product_no=product_no,
result="FAIL", detail=f"'{before}' → '{name}' 실패: {exc}",
)
logger.warning("카페24 상품 %s 이름 변경 실패: %s", product_no, exc)
raise HTTPException(status_code=502, detail=str(exc)) from exc
info = remember_write(st, product_no, updated)
info = remember_write(st, product_no, updated)
after = str(info.get("product_name") or name)
st.log_audit(
actor=actor, action="rename_product", product_no=product_no,
writes.audit_safe(
st, actor=actor, action="rename_product", product_no=product_no,
result="SUCCESS", detail=f"'{before}' → '{after}'",
)
logger.info("카페24 상품 %s 이름 변경 (%s)", product_no, actor)
@@ -442,31 +475,32 @@ def product_status(
want = bool(payload.get("value"))
api = build_cafe24_api(st)
try:
updated = products.update_product(api.client, product_no, **{field: want})
except Cafe24Error as exc:
st.log_audit(
actor=actor, action=f"set_{field}", product_no=product_no,
result="FAIL", detail=f"{want} 설정 실패: {exc}",
)
logger.warning("카페24 상품 %s %s 변경 실패: %s", product_no, field, exc)
raise HTTPException(status_code=502, detail=str(exc)) from exc
# 응답이 상품 dict 면 그것이 곧 현재 상태다. 모양이 다르면(방어) 다시 조회한다.
if "display" not in updated or "selling" not in updated:
with locked_json(st, product_no, actor=actor, purpose="진열/판매 변경"):
try:
updated, _ = load_product(st, api, product_no)
except Cafe24Error as exc: # 쓰기는 됐다 — 화면만 요청값으로 맞춘다.
logger.warning("카페24 상품 %s 상태 재조회 실패: %s", product_no, exc)
updated = {}
updated = products.update_product(api.client, product_no, **{field: want})
except Cafe24Error as exc:
writes.audit_safe(
st, actor=actor, action=f"set_{field}", product_no=product_no,
result="FAIL", detail=f"{want} 설정 실패: {exc}",
)
logger.warning("카페24 상품 %s %s 변경 실패: %s", product_no, field, exc)
raise HTTPException(status_code=502, detail=str(exc)) from exc
info = remember_write(st, product_no, updated)
# 응답이 상품 dict 면 그것이 곧 현재 상태다. 모양이 다르면(방어) 다시 조회한다.
if "display" not in updated or "selling" not in updated:
try:
updated, _ = load_product(st, api, product_no)
except Cafe24Error as exc: # 쓰기는 됐다 — 화면만 요청값으로 맞춘다.
logger.warning("카페24 상품 %s 상태 재조회 실패: %s", product_no, exc)
updated = {}
info = remember_write(st, product_no, updated)
state = {
"display": bool(info.get("display", want if field == "display" else True)),
"selling": bool(info.get("selling", want if field == "selling" else True)),
}
st.log_audit(
actor=actor, action=f"set_{field}", product_no=product_no,
writes.audit_safe(
st, actor=actor, action=f"set_{field}", product_no=product_no,
result="SUCCESS", detail=f"{field}={'T' if want else 'F'}",
)
logger.info("카페24 상품 %s %s=%s (%s)", product_no, field, want, actor)
@@ -479,6 +513,95 @@ def product_redirect(request: Request, product_no: int):
return RedirectResponse(url=f"/cafe24/?selected={product_no}", status_code=303)
def _back_url(product_no: int, list_query: str) -> str:
"""적용 후 돌아갈 주소 — 검색·필터를 유지한 채 같은 상품이 선택된 화면."""
base = f"/cafe24/?{list_query}" if list_query else f"/cafe24/?selected={product_no}"
return base if f"selected={product_no}" in base else f"{base}&selected={product_no}"
def _with_msg(back: str, *, msg: str = "", err: str = "") -> str:
"""안내 문구를 쿼리에 붙인다. 문구 안의 &·#·% 가 주소를 깨지 않게 인코딩한다."""
key, text = ("err", err) if err else ("msg", msg)
return f"{back}&{key}={quote(text, safe='')}"
def _run_description_write(
st: Any,
user: dict[str, Any],
product_no: int,
*,
html: str,
base_fingerprint: str,
memo: str,
list_query: str,
origin: str,
action: str,
target_revision_id: int | None = None,
) -> RedirectResponse:
"""즉시 적용·버전 복원 공용 — writes.write_product 를 잠금 안에서 부르고 결과를 안내한다."""
actor = str(user.get("email") or "")
back = _back_url(product_no, list_query)
verb = "복원" if origin == store.ORIGIN_ROLLBACK else "적용"
api = build_cafe24_api(st)
try:
with writes.write_lock(
st, writes.product_lock_key(product_no), actor=actor, purpose=f"상세설명 {verb}"
) as lock:
outcome = writes.write_product(
st, api, product_no,
lock=lock, origin=origin, actor=actor, html=html,
base_fingerprint=base_fingerprint, target_revision_id=target_revision_id,
memo=memo, skip_if_same=True,
)
except (writes.WriteSetupError, writes.WriteBusy, writes.WriteBlocked, writes.WriteConflict) as exc:
detail = "충돌 — 편집 중 카페24 값이 변경됨" if isinstance(exc, writes.WriteConflict) else str(exc)
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
revision_id=exc.backup_id or None, result="FAIL", detail=detail)
return RedirectResponse(url=_with_msg(back, err=str(exc)), status_code=303)
except writes.RemoteWriteUnknown as exc:
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
revision_id=exc.backup_id or None, result="UNKNOWN",
detail=f"시도 #{exc.attempt_id} 반영 여부 모름: {exc}")
logger.warning("카페24 상품 %s %s 결과 모름(시도 #%s): %s", product_no, verb, exc.attempt_id, exc)
return RedirectResponse(url=_with_msg(back, err=(
f"카페24 응답을 받지 못해 {verb} 여부를 알 수 없습니다({exc}). 다시 {verb}하지 말고 "
f"쇼핑몰에서 확인한 뒤 편집기 위 안내에서 결과를 확정하세요. "
f"(직전 내용은 버전 {exc.backup_id} 로 보관됨)")), status_code=303)
except writes.RemoteWriteFailed as exc:
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
revision_id=exc.backup_id or None, result="FAIL", detail=str(exc))
logger.warning("카페24 상품 %s %s 실패: %s", product_no, verb, exc)
return RedirectResponse(url=_with_msg(back, err=(
f"{verb}에 실패했습니다: {exc} (직전 내용은 버전 {exc.backup_id} 로 보관됨)")), status_code=303)
except Cafe24Error as exc:
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}")
return RedirectResponse(url=_with_msg(back, err=f"카페24 현재값을 읽지 못해 중단했습니다: {exc}"),
status_code=303)
if not outcome.changed:
return RedirectResponse(url=_with_msg(back, msg=f"변경된 내용이 없어 {verb}하지 않았습니다."), status_code=303)
detail = (
f"{len(html)}자 {verb} (백업 {outcome.backup_id}, 시도 #{outcome.attempt_id}, 모바일 PC와 동일 유지, "
f"카페24 재조회 {'확인' if outcome.confirmed else '지연 — 마지막 적용값 표시'})"
)
if target_revision_id:
detail += f" / 원본 버전 {target_revision_id}"
if outcome.record_error:
detail += f" / 기록 실패(자동 복구 예정): {outcome.record_error}"
writes.audit_safe(st, actor=actor, action=action, product_no=product_no,
revision_id=outcome.revision_id or None, result="SUCCESS", detail=detail)
logger.info("카페24 상품 %s 상세설명 %s (%s, 재조회 확인=%s)", product_no, verb, actor, outcome.confirmed)
note = "" if outcome.confirmed else " 카페24 관리자 API 반영은 잠시 늦을 수 있어 방금 적용한 내용을 표시합니다."
if outcome.record_error:
note += " ※ 카페24에는 반영됐지만 버전 기록 저장에 실패했습니다 — 자동으로 복구하니 다시 적용하지 마세요."
return RedirectResponse(
url=_with_msg(back, msg=f"카페24에 {verb}했습니다. 직전 내용은 버전 {outcome.backup_id} 로 보관됩니다.{note}"),
status_code=303,
)
@products_router.post("/products/{product_no}/apply")
def product_apply(
request: Request,
@@ -490,125 +613,165 @@ def product_apply(
):
"""편집한 HTML 을 카페24에 즉시 적용한다.
순서를 지키는 것이 이 함수의 핵심이다.
1) 카페24에서 **현재** HTML 을 다시 읽는다(로컬 값을 현재값으로 믿지 않는다)
2) 읽기 지연을 판정해 **유효 현재값**을 정한다(예전 값을 돌려주는 중이면
우리 마지막 쓰기가 현재값이다)
3) 그 값으로 BACKUP 버전을 남긴다 ← 유일한 복구 수단
4) 편집 시작 시점의 지문과 비교해 충돌이면 거부한다
5) 쓰고, 스냅샷·MANUAL 버전·감사로그를 남긴다
순서(writes.write_product): 상품 잠금 → 카페24 현재값 재조회(로컬 값을 현재값으로
믿지 않는다) → 결과 모르는 이전 시도 확인 → 유효 현재값(읽기 지연 보정) → BACKUP
← 유일한 복구 수단 → 지문 대조(충돌 거부) → 시도 기록 → PUT → 버전·스냅샷 기록.
PC/모바일을 구분하지 않는다 — 두 필드에 같은 HTML 을 쓴다. 분리 사용 상품의
모바일 내용이 PC 와 달랐다면 덮어쓰기 전에 그 내용도 BACKUP 으로 남긴다.
PC/모바일을 구분하지 않는다 — description 만 쓰고 separated_mobile_description="F".
분리 사용 상품의 모바일 내용이 PC 와 달랐다면 덮어쓰기 전에 그 내용도 BACKUP 으로 남긴다.
"""
checked = guard(request)
if not isinstance(checked, tuple):
return checked
st, user = checked
actor = str(user.get("email") or "")
# 적용 후에는 검색·필터를 유지한 채 같은 상품이 선택된 화면으로 돌아온다.
base = f"/cafe24/?{list_query}" if list_query else f"/cafe24/?selected={product_no}"
back = base if f"selected={product_no}" in base else f"{base}&selected={product_no}"
# 화면에서 보던 그대로(정리된 소스)를 카페24에 반영한다. 한글 이미지 경로는
# 원래의 퍼센트 인코딩으로 되돌린다.
submitted = store.format_html(store.encode_html_urls(html or ""))
if not submitted.strip():
return RedirectResponse(
url=f"{back}&err=내용이 비어 있습니다. 상세페이지를 비우려면 카페24 관리자에서 하세요.",
url=_with_msg(_back_url(product_no, list_query),
err="내용이 비어 있습니다. 상세페이지를 비우려면 카페24 관리자에서 하세요."),
status_code=303,
)
return _run_description_write(
st, user, product_no,
html=submitted, base_fingerprint=base_fingerprint, memo=memo, list_query=list_query,
origin=store.ORIGIN_MANUAL, action="apply_description",
)
api = build_cafe24_api(st)
# ════════════════════════════════════════════════════════════
# 버전 이력 — 원문 확인 · 선택 복원
# 자동 복원(예약 종료 후 되돌리기)은 쓰지 않는다. 사람이 버전을 골라 누를 때만
# 정상 쓰기 경로(잠금·백업·지문 대조·시도 기록)로 한 번 적용하고 ROLLBACK 을 남긴다.
# ════════════════════════════════════════════════════════════
def _revision_for(st: Any, product_no: int, revision_id: int) -> dict[str, Any]:
"""이 쇼핑몰·이 상품의 버전만 돌려준다. 아니면 404(다른 상품 버전을 주소로 못 끌어온다)."""
from app.integrations.cafe24 import load_config # noqa: WPS433
revision = st.get_revision(revision_id)
if not revision or int(revision.get("product_no") or 0) != int(product_no):
raise HTTPException(status_code=404, detail="이 상품의 버전을 찾을 수 없습니다.")
mall = load_config().mall_id
rev_mall = str(revision.get("mall_id") or "")
# mall_id 가 빈 행은 005 이전 기록이다 — cafe24_db 는 쇼핑몰 1개 전용이라 같은 쇼핑몰로 본다.
if rev_mall and mall and rev_mall != mall:
raise HTTPException(status_code=404, detail="다른 쇼핑몰의 버전입니다.")
if int(revision.get("shop_no") or 1) != 1:
raise HTTPException(status_code=404, detail="다른 멀티쇼핑몰(shop_no)의 버전입니다.")
return revision
@products_router.get("/products/{product_no}/revisions/{revision_id}")
def revision_detail(request: Request, product_no: int, revision_id: int) -> dict[str, Any]:
"""버전 원문(JSON). 화면은 textContent 로만 넣는다(HTML 로 해석하지 않는다)."""
st, _user = require_store(request)
revision = _revision_for(st, product_no, revision_id)
body = str(revision.get("html_content") or "")
rtype = str(revision.get("revision_type") or "")
return {
"ok": True,
"revision": {
"id": revision.get("id"),
"product_no": revision.get("product_no"),
"revision_type": rtype,
"type_label": store.REVISION_LABELS.get(rtype, rtype),
"source": revision.get("source") or "",
"created_at": revision.get("created_at") or "",
"created_by": revision.get("created_by") or "",
"memo": revision.get("memo") or "",
"length": len(body),
# 편집기와 같은 표시(이미지 경로의 %EC… 를 한글로). 복원은 저장된 원문 그대로 쓴다.
"html": store.decode_html_urls(body),
},
}
@products_router.post("/products/{product_no}/revisions/{revision_id}/restore")
def revision_restore(
request: Request,
product_no: int,
revision_id: int,
base_fingerprint: str = Form(""),
memo: str = Form(""),
list_query: str = Form(""),
):
"""고른 버전을 카페24에 다시 적용한다(ROLLBACK). 즉시 적용과 같은 경로·같은 보호."""
checked = guard(request)
if not isinstance(checked, tuple):
return checked
st, user = checked
back = _back_url(product_no, list_query)
try:
current = products.fetch_descriptions(api.client, product_no)
except Cafe24Error as exc:
st.log_audit(
actor=actor, action="apply_description", product_no=product_no,
result="FAIL", detail=f"현재값 조회 실패: {exc}",
)
return RedirectResponse(url=f"{back}&err=카페24 현재값을 읽지 못해 중단했습니다: {exc}", status_code=303)
# 읽기 지연 판정 — 카페24가 아직 예전 값을 돌려주면 우리 마지막 쓰기가 현재값이다.
effective, sync_state, _ = resolve_description(st, product_no, current.description)
pending = sync_state == store.SYNC_PENDING
backup_id = st.add_revision(
product_no=product_no,
html_content=effective,
revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업" + (" (카페24 읽기 지연 — 마지막 적용값 기준)" if pending else ""),
created_by=actor,
)
# 모바일 내용이 PC 와 달랐다면 그것도 따로 남긴다. 아래에서 모바일을 PC 와 같게
# 덮어쓰므로, 백업하지 않으면 그 내용을 되찾을 방법이 없다.
if current.mobile_description and current.mobile_description != current.description:
st.add_revision(
product_no=product_no,
html_content=current.mobile_description,
revision_type=store.REVISION_BACKUP,
memo="적용 직전 자동 백업 (모바일 — PC와 달랐던 내용)",
created_by=actor,
)
if base_fingerprint and base_fingerprint != store.fingerprint(effective):
st.log_audit(
actor=actor, action="apply_description", product_no=product_no,
revision_id=backup_id, result="FAIL", detail="충돌 — 편집 중 카페24 값이 변경됨",
)
revision = _revision_for(st, product_no, revision_id)
except HTTPException as exc:
return RedirectResponse(url=_with_msg(back, err=str(exc.detail)), status_code=303)
body = str(revision.get("html_content") or "")
if not body.strip():
return RedirectResponse(url=_with_msg(back, err="내용이 빈 버전은 복원할 수 없습니다."), status_code=303)
if not base_fingerprint:
# 편집기가 본 현재값 없이 복원하면 그 사이 바뀐 내용을 모르고 덮는다.
return RedirectResponse(
url=f"{back}&err=편집하는 동안 카페24 값이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
status_code=303,
url=_with_msg(back, err="편집기를 새로고침한 뒤 버전 이력에서 다시 복원하세요."), status_code=303
)
note = f"버전 {revision_id} 복원" + (f" — {memo.strip()}" if memo.strip() else "")
return _run_description_write(
st, user, product_no,
html=body, base_fingerprint=base_fingerprint, memo=note, list_query=list_query,
origin=store.ORIGIN_ROLLBACK, action="restore_revision", target_revision_id=int(revision_id),
)
if submitted == effective:
return RedirectResponse(url=f"{back}&msg=변경된 내용이 없어 적용하지 않았습니다.", status_code=303)
# ════════════════════════════════════════════════════════════
# 반영 여부를 모르는 시도 — 사람이 쇼핑몰을 확인하고 확정한다
# ════════════════════════════════════════════════════════════
@products_router.post("/products/{product_no}/attempts/{attempt_id}/resolve")
def attempt_resolve(
request: Request,
product_no: int,
attempt_id: int,
result: str = Form(""),
list_query: str = Form(""),
):
"""applied = 반영됨(그 내용을 마지막 쓰기로 기록) / not_applied = 반영 안 됨(닫기).
예약에서 난 시도면 그 예약도 함께 완료/실패로 바꾼다. 다시 적용하는 것은 사람이
편집기에서 한다(자동 재적용 없음).
"""
checked = guard(request)
if not isinstance(checked, tuple):
return checked
st, user = checked
actor = str(user.get("email") or "")
back = _back_url(product_no, list_query)
if result not in ("applied", "not_applied"):
return RedirectResponse(url=_with_msg(back, err="확정할 결과를 고르세요."), status_code=303)
open_states = (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN)
try:
# mobile_description 은 보내지 않는다 — update_descriptions 가
# separated_mobile_description="F" 로 "PC 상세설명과 동일"을 강제하고
# 카페24가 모바일 값을 자동으로 맞춰준다(모바일도 항상 PC와 같다).
updated = products.update_descriptions(api.client, product_no, description=submitted)
except Cafe24Error as exc:
st.log_audit(
actor=actor, action="apply_description", product_no=product_no,
revision_id=backup_id, result="FAIL", detail=str(exc),
)
logger.warning("카페24 상품 %s 적용 실패: %s", product_no, exc)
return RedirectResponse(
url=f"{back}&err=적용에 실패했습니다: {exc} (직전 내용은 버전 {backup_id} 로 보관됨)",
status_code=303,
)
# PUT 응답은 쓰기 직후의 실제 값 — 스냅샷으로 남긴다(상품명·가격·updated_date 등).
remember_write(st, product_no, updated if isinstance(updated, dict) else {})
# MANUAL revision 을 **먼저** 남긴다. 이것이 "마지막 쓰기" 기준이 되어, 카페24 GET 이
# 한동안 예전 값을 돌려줘도 편집기는 방금 적용한 내용을 보여준다.
revision_id = st.add_revision(
product_no=product_no,
html_content=submitted,
revision_type=store.REVISION_MANUAL,
memo=memo,
created_by=actor,
)
# 카페24 관리자 API 는 쓰기 직후 몇 초간 이전 값을 돌려줄 때가 있다(쇼핑몰
# 화면에는 바로 반영됨). 여기서 짧게 확인만 한다 — 확인이 안 돼도 화면은 위
# MANUAL revision 을 기준으로 그리므로 문제없다.
confirmed = products.wait_for_description(api.client, product_no, submitted)
st.log_audit(
actor=actor, action="apply_description", product_no=product_no,
revision_id=revision_id, result="SUCCESS",
detail=(
f"{len(submitted)}자 적용 (백업 {backup_id}, 모바일 PC와 동일 유지, "
f"카페24 재조회 {'확인' if confirmed else '지연 — 마지막 적용값 표시'})"
),
)
logger.info("카페24 상품 %s 상세설명 적용 (%s, 재조회 확인=%s)", product_no, actor, confirmed)
note = "" if confirmed else " 카페24 관리자 API 반영은 잠시 늦을 수 있어 방금 적용한 내용을 표시합니다."
return RedirectResponse(
url=f"{back}&msg=카페24에 적용했습니다. 직전 내용은 버전 {backup_id} 로 보관됩니다.{note}",
status_code=303,
)
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose="적용 결과 확정"):
attempt = st.get_attempt(attempt_id)
if (not attempt or int(attempt.get("product_no") or 0) != int(product_no)
or attempt.get("status") not in open_states):
return RedirectResponse(url=_with_msg(back, err="이미 확정됐거나 없는 시도입니다."), status_code=303)
schedule_id = attempt.get("schedule_id")
if result == "applied":
st.update_attempt(attempt_id, status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
resolved_by=actor, only_from=open_states)
revision_id = writes.record_attempt(st, attempt)
if schedule_id:
st.review_schedule(int(schedule_id), status=store.STATUS_SUCCESS,
note=f"{actor} 가 반영됨으로 확정", actor=actor, action="applied")
text = f"시도 #{attempt_id} 를 반영됨으로 확정했습니다(버전 {revision_id})."
else:
st.update_attempt(attempt_id, status=store.ATTEMPT_ABANDONED, resolved_by=actor,
only_from=open_states)
if schedule_id:
st.review_schedule(int(schedule_id), status=store.STATUS_FAILED,
note=f"{actor} 가 반영 안 됨으로 확정", actor=actor, action="not_applied")
text = f"시도 #{attempt_id} 를 반영 안 됨으로 확정했습니다. 필요하면 다시 적용하세요."
except (writes.WriteBusy, writes.WriteSetupError) as exc:
return RedirectResponse(url=_with_msg(back, err=str(exc)), status_code=303)
writes.audit_safe(st, actor=actor, action=f"resolve_attempt:{result}", product_no=product_no,
result="SUCCESS", detail=f"시도 #{attempt_id}")
return RedirectResponse(url=_with_msg(back, msg=text), status_code=303)
+59 -2
View File
@@ -22,9 +22,9 @@ import logging
from fastapi import APIRouter, Form, Request
from fastapi.responses import HTMLResponse, RedirectResponse
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, load_config, products
from . import store
from . import store, writes
from .common import base_ctx, guard
from .routes_products import _no_store
@@ -55,6 +55,7 @@ def schedules_page(request: Request) -> HTMLResponse:
set_selling=row.get("set_selling"),
),
"editable": store.is_editable(row.get("status") or ""),
"needs_review": row.get("status") == store.STATUS_NEEDS_REVIEW,
}
)
@@ -65,6 +66,7 @@ def schedules_page(request: Request) -> HTMLResponse:
"page_subtitle": "지정 시각에 상세페이지·진열/판매 자동 적용",
"rows": rows,
"pending": sum(1 for r in rows if r["status"] == store.STATUS_PENDING),
"review": sum(1 for r in rows if r["needs_review"]),
"flash": request.query_params.get("msg", ""),
"flash_error": request.query_params.get("err", ""),
}
@@ -114,6 +116,12 @@ def schedule_create(
except ValueError as exc:
return RedirectResponse(url=f"{back}&err={exc}", status_code=303)
# 예약은 worker 가 잠금·시도 기록(마이그레이션 005)으로 실행한다 — 없으면 등록도 받지 않는다.
try:
writes.require_schema(st)
except writes.WriteSetupError as exc:
return RedirectResponse(url=f"{back}&err={exc}", status_code=303)
revision_id: int | None = None
if want_html:
body = store.format_html(store.encode_html_urls(html or ""))
@@ -127,6 +135,7 @@ def schedule_create(
revision_type=store.REVISION_DRAFT,
memo=f"예약 등록 ({run_at.strftime('%Y-%m-%d %H:%M')} 적용 예정)",
created_by=actor,
mall_id=load_config().mall_id,
)
schedule_id = st.create_schedule(
@@ -187,3 +196,51 @@ def schedule_current_flags(request: Request, product_no: int) -> dict:
"display": normalized["display"],
"selling": normalized["selling"],
}
# 확인 필요(NEEDS_REVIEW) 예약의 사람 확정 — 반영 여부를 모르는 채로 worker 가 멈춘 것.
# applied = 쇼핑몰에 반영돼 있음(완료 + 버전 기록) / rerun = 다시 실행 / close = 실패로 종료.
_REVIEW_ACTIONS = {
"applied": (store.STATUS_SUCCESS, "반영됨으로 확정"),
"rerun": (store.STATUS_PENDING, "다시 실행"),
"close": (store.STATUS_FAILED, "실패로 종료"),
}
@schedules_router.post("/schedules/{schedule_id}/review")
def schedule_review(request: Request, schedule_id: int, action: str = Form("")):
"""확인 필요 예약을 확정한다. 자동으로 다시 실행하지 않는다 — 사람이 쇼핑몰을 보고 고른다."""
checked = guard(request)
if not isinstance(checked, tuple):
return checked
st, user = checked
actor = str(user.get("email") or "")
if action not in _REVIEW_ACTIONS:
return RedirectResponse(url="/cafe24/schedules?err=확정할 동작을 고르세요.", status_code=303)
status, label = _REVIEW_ACTIONS[action]
row = st.get_schedule(schedule_id)
if not row or row.get("status") != store.STATUS_NEEDS_REVIEW:
return RedirectResponse(
url=f"/cafe24/schedules?err=예약 #{schedule_id} 은 확인 필요 상태가 아닙니다.", status_code=303
)
product_no = int(row.get("product_no") or 0)
try:
with writes.write_lock(st, writes.product_lock_key(product_no), actor=actor, purpose="예약 결과 확정"):
attempt = st.latest_attempt_for_schedule(schedule_id)
open_attempt = attempt if attempt.get("status") in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN) else {}
if action == "applied":
if not open_attempt:
return RedirectResponse(
url=f"/cafe24/schedules?err=예약 #{schedule_id} 에는 확정할 적용 시도가 없습니다 — "
"다시 실행하거나 실패로 종료하세요.",
status_code=303,
)
st.update_attempt(int(open_attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
resolved_by=actor,
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN))
writes.record_attempt(st, open_attempt)
st.review_schedule(schedule_id, status=status, note=f"{actor} — {label}", actor=actor, action=action)
except (writes.WriteBusy, writes.WriteSetupError) as exc:
return RedirectResponse(url=f"/cafe24/schedules?err={exc}", status_code=303)
logger.info("카페24 예약 #%s 확인 필요 → %s (%s)", schedule_id, label, actor)
return RedirectResponse(url=f"/cafe24/schedules?msg=예약 #{schedule_id} — {label}", status_code=303)
+228 -2
View File
@@ -6,6 +6,7 @@
from __future__ import annotations
import hashlib
import json
import re
from datetime import datetime, timedelta
from urllib.parse import quote
@@ -44,6 +45,9 @@ STATUS_PROCESSING = "PROCESSING"
STATUS_SUCCESS = "SUCCESS"
STATUS_FAILED = "FAILED"
STATUS_CANCELLED = "CANCELLED"
# 원격 반영 여부를 모른다(네트워크 끊김·worker 중단) — 사람이 카페24를 보고 확정한다.
# 자동으로 PENDING 에 돌려 재적용하지 않는다(마이그레이션 005).
STATUS_NEEDS_REVIEW = "NEEDS_REVIEW"
SCHEDULE_STATUSES: tuple[str, ...] = (
STATUS_PENDING,
@@ -51,6 +55,7 @@ SCHEDULE_STATUSES: tuple[str, ...] = (
STATUS_SUCCESS,
STATUS_FAILED,
STATUS_CANCELLED,
STATUS_NEEDS_REVIEW,
)
SCHEDULE_STATUS_LABELS: dict[str, str] = {
@@ -59,8 +64,36 @@ SCHEDULE_STATUS_LABELS: dict[str, str] = {
STATUS_SUCCESS: "완료",
STATUS_FAILED: "실패",
STATUS_CANCELLED: "취소",
STATUS_NEEDS_REVIEW: "확인 필요",
}
# ── 쓰기 시도 상태 (cafe24_write_attempts.status, 마이그레이션 005) ──
ATTEMPT_STARTED = "STARTED" # PUT 직전 기록. 이대로 남으면 결과를 모른다.
ATTEMPT_REMOTE_OK = "REMOTE_OK" # 카페24 반영 성공, 로컬 버전 기록 전(기록 복구 필요)
ATTEMPT_RECORDED = "RECORDED" # 반영 성공 + 버전 기록 완료
ATTEMPT_REMOTE_FAILED = "REMOTE_FAILED" # 카페24가 거절 — 반영되지 않은 것이 확실
ATTEMPT_UNKNOWN = "UNKNOWN" # 반영 여부 모름 → 사람 확인
ATTEMPT_ABANDONED = "ABANDONED" # 사람이 "반영 안 됨"으로 확정 / 재실행으로 대체
# 원격 반영이 확인된 시도 — 읽기 지연 판정의 근거는 이것뿐이다.
ATTEMPT_CONFIRMED: tuple[str, ...] = (ATTEMPT_REMOTE_OK, ATTEMPT_RECORDED)
# 결과 확정이 필요한 시도 — 이것이 남아 있으면 같은 상품 상세설명을 다시 쓰지 않는다.
ATTEMPT_OPEN: tuple[str, ...] = (ATTEMPT_STARTED, ATTEMPT_REMOTE_OK, ATTEMPT_UNKNOWN)
ORIGIN_MANUAL = "MANUAL"
ORIGIN_SCHEDULED = "SCHEDULED"
ORIGIN_ROLLBACK = "ROLLBACK"
# 시도 출처 → 성공 시 남길 버전 종류
ORIGIN_REVISION_TYPE: dict[str, str] = {
ORIGIN_MANUAL: "MANUAL",
ORIGIN_SCHEDULED: "SCHEDULED",
ORIGIN_ROLLBACK: "ROLLBACK",
}
# ── BACKUP 출처 (cafe24_product_revisions.source) ──
SOURCE_OBSERVED = "OBSERVED" # 카페24 GET 으로 읽은 값 그대로
SOURCE_LAST_WRITE = "LAST_WRITE" # 카페24가 읽기 지연 중 — 우리 마지막(확인된) 쓰기를 현재값으로 봄
SOURCE_REVISION = "REVISION" # ROLLBACK — 과거 버전을 그대로 다시 올림
# 사용자가 손댈 수 있는 상태 — PROCESSING/SUCCESS 는 임의 변경 금지
EDITABLE_STATUSES: tuple[str, ...] = (STATUS_PENDING,)
@@ -509,11 +542,20 @@ def resolve_description(
known_digests: set[str] | frozenset[str],
grace_minutes: int,
now: datetime | None = None,
fetched_updated: object = None,
) -> tuple[str, str]:
"""(화면·적용에 쓸 유효 HTML, 상태) 를 돌려준다.
last_write: 최근 쓰기 revision — {"html_content", "created_at"}.
known_digests: 유예시간 안의 revision 들의 내용 해시(`content_digest()` 결과) 집합.
last_write: **원격 반영이 확인된** 마지막 쓰기 — {"html_content", "created_at",
"remote_updated_at"(선택: 그 PUT 응답의 updated_date)}.
known_digests: 확인된 쓰기들이 **덮어쓴 값**(쓰기 직전 관측값·기준값)과 쓴 값의
내용 해시(`content_digest()`) 집합. 충돌로 거절된 적용의 백업, 예약 초안처럼
카페24에 올라간 적 없는 값은 넣지 않는다 — 넣으면 관리자에서 직접 고친 값이
우연히 그와 같을 때 "읽기 지연"으로 오판해 그 수정을 덮어쓴다.
fetched_updated: 이번 GET 의 updated_date. 마지막 쓰기의 PUT 응답 updated_date 보다
**뒤**라면 GET 은 우리 쓰기 이후의 레코드다 — 지연이 아니므로 카페24 값을 믿는다
(관리자가 우리 적용 뒤 예전 값으로 되돌린 경우를 구분한다). 같거나 판단할 수
없으면 내용 해시로 판정한다.
"""
if not last_write:
return cafe24_html, SYNC_NONE
@@ -523,11 +565,29 @@ def resolve_description(
last_html = str(last_write.get("html_content") or "")
if cafe24_html == last_html:
return cafe24_html, SYNC_SYNCED
fetched_at = _as_aware(fetched_updated)
written_at = _as_aware(last_write.get("remote_updated_at"))
if fetched_at is not None and written_at is not None and fetched_at > written_at:
return cafe24_html, SYNC_EXTERNAL
if content_digest(cafe24_html) in known_digests:
return last_html, SYNC_PENDING
return cafe24_html, SYNC_EXTERNAL
def lineage_digests(lineage: list[dict]) -> set[str]:
"""확인된 쓰기 목록 → 읽기 지연 판정에 쓸 내용 해시 집합.
각 쓰기의 직전 관측값(observed)·기준값(base)·쓴 값(target). 빈 해시는 뺀다.
"""
out: set[str] = set()
for item in lineage or []:
for key in ("observed_digest", "base_digest", "target_digest"):
value = str(item.get(key) or "")
if value:
out.add(value)
return out
def content_digest(html: str) -> str:
"""revision 내용 대조용 md5 hex — DB 의 `md5(html_content)` 와 같은 값.
@@ -598,6 +658,172 @@ def overlay_recent_write(
return merged, True
# ── 품목 스냅샷: 코드별 · 필드별 병합 ──
# 스냅샷 모양: {variant_code: {필드: 값, ..., "_at": ISO, "_deleted": bool,
# "options": [{name,value}...], "_options_before": [...]}}
def merge_variant_snapshot(current: dict | None, patch: dict | None, *, at: str, replace: bool = False) -> dict:
"""품목 스냅샷 병합.
- 같은 품목의 이전 필드는 유지하고 새로 쓴 필드만 덮는다. (예전에는 품목 단위로
통째로 바꿔서, 자체코드를 고친 뒤 진열만 바꾸면 자체코드 기록이 사라졌다.)
- replace=True 는 전체 초기화(옵션 삭제·재생성) — 이전 품목 기록을 모두 버린다.
빈 patch({}) 를 "초기화" 로 해석하지 않는다(병합에서 {} 는 아무것도 안 바꾼다).
- 삭제 표식(_deleted)은 한 번 붙으면 유지한다. 삭제 뒤에 늦게 도착한 수정이
그 품목을 되살리지 않게 한다.
- 품목마다 기록 시각(_at)을 남겨 유예시간을 품목별로 판정한다.
"""
base: dict = {} if replace else {
str(code): dict(fields) for code, fields in (current or {}).items() if isinstance(fields, dict)
}
for code, fields in (patch or {}).items():
if not isinstance(fields, dict):
continue
code = str(code)
entry = base.get(code, {})
if entry.get("_deleted") and not fields.get("_deleted"):
continue # 삭제된 품목에 대한 늦은 수정 — 되살리지 않는다
if fields.get("_deleted"):
base[code] = {"_deleted": True, "_at": at}
continue
entry.update(fields)
entry["_at"] = at
base[code] = entry
return base
def _labels(options: object) -> list[tuple[str, str]]:
if not isinstance(options, list):
return []
return [
(str(o.get("name") or ""), str(o.get("value") or ""))
for o in options if isinstance(o, dict)
]
def apply_variant_patch(
variant: dict,
patch: dict | None,
*,
section_written_at: object,
grace_minutes: int,
now: datetime | None = None,
) -> dict | None:
"""GET 품목 1건에 우리 쓰기 기록을 덮어씌운다. 삭제한 품목이면 None.
옵션 표기(options)는 **품목코드**(안정 식별자)로 짝지은 기록이다. 옵션값 이름을
바꾼 직후 GET 품목이 아직 예전 이름을 돌려주면(읽기 지연) 이름으로는 짝이 안 맞아
정상 품목이 "품목 없는 옵션값"으로 보였다. 그래서
- GET 표기가 쓰기 직전 표기들(_options_before) 중 하나 → 지연 → 우리가 쓴 표기로
- GET 표기 == 우리가 쓴 표기 → 이미 따라잡음
- 둘 다 아님 → 관리자에서 다시 고침 → GET 을 믿는다
_options_before 는 유예시간 안에 연달아 바꾼 이전 표기를 모두 담은 목록이다
(A→B→C 직후 GET 이 A 를 돌려줘도 지연으로 본다).
"""
if not isinstance(patch, dict) or not patch:
return variant
at = patch.get("_at") or section_written_at
if not within_grace(at, grace_minutes=grace_minutes, now=now):
return variant
if patch.get("_deleted"):
return None
out = dict(variant)
for key, value in patch.items():
if key.startswith("_") or key == "options":
continue
out[key] = value
if "options" in patch:
current = _labels(variant.get("options"))
wanted = _labels(patch.get("options"))
befores = label_history(patch.get("_options_before"))
if current != wanted and (patch.get("_options_before") is None or current in befores):
out["options"] = [{"name": n, "value": v} for n, v in wanted]
return out
def label_history(raw: object) -> list[list[tuple[str, str]]]:
"""_options_before → 표기 목록의 목록. 옛 모양(표기 하나 = dict 목록)도 받는다."""
if not isinstance(raw, list) or not raw:
return []
if all(isinstance(item, dict) for item in raw):
return [_labels(raw)]
return [_labels(item) for item in raw if isinstance(item, list)]
def labels_as_json(options: object) -> list[dict]:
"""표기(options) → 스냅샷 저장 모양 [{name, value}]."""
return [{"name": n, "value": v} for n, v in _labels(options)]
# ── 옵션 스냅샷: 쓰기 직전 모양과 비교해 지연/외부 변경을 가린다 ──
def options_signature(option: object) -> str:
"""옵션 dict 의 비교용 서명 — 옵션 사용 여부, 옵션명·표시방식, 옵션값 이름·이미지."""
if not isinstance(option, dict):
return ""
raw = option.get("has_option")
has = raw is True or str(raw or "").strip().upper() in ("T", "TRUE", "1", "Y")
groups = []
if has:
for o in option.get("options") or []:
if not isinstance(o, dict):
continue
values = [
[str(v.get("option_text") or ""), str(v.get("option_image_file") or ""),
str(v.get("option_link_image") or "")]
for v in (o.get("option_value") or []) if isinstance(v, dict)
]
groups.append([str(o.get("option_name") or ""), str(o.get("option_display_type") or ""), values])
return json.dumps([has, groups], ensure_ascii=False, sort_keys=True)
def overlay_options(
fetched: dict,
*,
snapshot: dict | None,
written_at: object,
grace_minutes: int,
now: datetime | None = None,
) -> tuple[dict, bool]:
"""(보여줄 옵션 dict, 지연 여부). 스냅샷에 `_before_signatures`(쓰기 직전 모양들의
서명 — 유예시간 안에 연달아 바꾼 이전 모양 포함)가 있으면 GET 이 그중 하나일 때만
지연으로 본다 — 관리자에서 다시 고친 옵션을 유예시간 동안 덮지 않게.
서명 목록이 없는 옛 스냅샷은 예전처럼 유예시간 안이면 스냅샷을 쓴다."""
if not isinstance(snapshot, dict) or not snapshot:
return fetched, False
if not within_grace(written_at, grace_minutes=grace_minutes, now=now):
return fetched, False
got = options_signature(fetched)
if got == options_signature(snapshot):
return fetched, False
befores = snapshot.get("_before_signatures")
if isinstance(befores, list) and got not in befores:
return fetched, False
return snapshot, True
# ── 예약 worker 가 lease 만료된 PROCESSING 을 복구할 때의 판정 ──
RECOVER_SUCCESS = "SUCCESS" # 이미 반영·기록됨
RECOVER_RECORD = "RECORD" # 반영됨 — 버전 기록만 채우고 SUCCESS
RECOVER_RETRY = "RETRY" # 반영 안 됨이 확실 — 재시도 예산 안에서 다시 대기
RECOVER_FAIL = "FAIL" # 반영 안 됨 + 재시도 예산 소진
RECOVER_REVIEW = "REVIEW" # 반영 여부 모름 — NEEDS_REVIEW (자동 재적용 금지)
def recovery_decision(attempt: dict | None, retry_count: object) -> tuple[str, str]:
"""(판정, 사람이 읽을 사유). attempt 는 그 예약의 가장 최근 쓰기 시도(없으면 None)."""
if not attempt:
note = "worker 가 카페24에 쓰기 전에 중단되었습니다"
return (RECOVER_RETRY if can_retry(retry_count) else RECOVER_FAIL), note
status = str(attempt.get("status") or "")
if status == ATTEMPT_RECORDED:
return RECOVER_SUCCESS, "카페24 반영·기록이 끝난 뒤 중단되었습니다"
if status == ATTEMPT_REMOTE_OK:
return RECOVER_RECORD, "카페24에는 반영됐고 로컬 기록 전에 중단되었습니다"
if status in (ATTEMPT_REMOTE_FAILED, ATTEMPT_ABANDONED):
note = "카페24가 요청을 반영하지 않았습니다"
return (RECOVER_RETRY if can_retry(retry_count) else RECOVER_FAIL), note
return RECOVER_REVIEW, "카페24에 쓰는 도중 중단되어 반영 여부를 알 수 없습니다 — 쇼핑몰에서 확인하세요"
# ════════════════════════════════════════════════════════════
# 기본 정보(상품명·가격) 입력 검증 — 오른쪽 정보 패널
# ════════════════════════════════════════════════════════════
@@ -14,6 +14,33 @@
{# 읽기 지연 배너 — 카페24 관리자 API 가 아직 이전 값을 돌려주는 동안에는 마지막으로
적용한 내용(MANUAL/SCHEDULED revision)을 편집기에 보여준다. 쇼핑몰 화면에는 이미
반영돼 있다(실물 관찰). 지문도 이 값으로 만들어 다음 적용이 충돌로 오판되지 않는다. #}
{# 반영 여부를 모르는 이전 적용 — 네트워크가 끊겼거나 처리 도중 멈춘 것. 확정 전에는 이 상품
상세설명을 다시 쓰지 않는다(재적용 금지). 쇼핑몰을 보고 사람이 결과를 고른다.
카페24 값이 그 적용 내용과 같아지면 다음 적용 때 자동으로 "반영됨"이 된다. #}
{% for att in open_attempts or [] %}
<div class="cf24-flash cf24-flash-err cf24-attempt" data-attempt-id="{{ att.id }}">
<strong>적용 결과 확인 필요</strong> — {{ att.label }} · {{ att.status_label }}{% if att.error %} ({{ att.error }}){% endif %}.
쇼핑몰 상세페이지를 열어 이 적용이 반영됐는지 확인한 뒤 고르세요. 확정하기 전에는 이 상품 상세설명을 다시 적용할 수 없습니다.
<span class="cf24-attempt-actions">
<form method="post" action="/cafe24/products/{{ product_no }}/attempts/{{ att.id }}/resolve" style="display:inline;"
data-erp-confirm="쇼핑몰에서 이 적용 내용이 보이는 것을 확인했나요? 반영됨으로 기록합니다.">
<input type="hidden" name="result" value="applied" />
<input type="hidden" name="list_query" value="{{ list_query }}" />
<button type="submit" class="erp-btn erp-btn-outline cf24-btn-inline">반영됨</button>
</form>
<form method="post" action="/cafe24/products/{{ product_no }}/attempts/{{ att.id }}/resolve" style="display:inline;"
data-erp-confirm="이 적용이 쇼핑몰에 반영되지 않은 것을 확인했나요? 반영 안 됨으로 닫습니다(다시 적용은 직접 하세요).">
<input type="hidden" name="result" value="not_applied" />
<input type="hidden" name="list_query" value="{{ list_query }}" />
<button type="submit" class="erp-btn erp-btn-outline cf24-btn-inline">반영 안 됨</button>
</form>
</span>
</div>
{% endfor %}
{# 적용·예약이 오류로 돌아왔을 때 브라우저에 남겨 둔 편집본을 여기서 되살린다(products.html JS). #}
<div id="cf24-draft-slot"></div>
{% if sync_pending %}
<div class="cf24-flash cf24-flash-warn" id="cf24-sync-banner">
<strong>카페24 반영 대기 중</strong> — 카페24 관리자 API 가 아직 이전 소스를 돌려주고 있어
@@ -199,28 +226,40 @@
</form>
</details>
<details class="cf24-details">
<details class="cf24-details" id="cf24-history">
<summary>버전 이력 {% if revisions %}({{ revisions | length }}건){% endif %}</summary>
{% if revisions %}
<div class="cf24-scroll">
<table class="erp-table cf24-compact">
<thead>
<tr><th>시각</th><th>유형</th><th>길이</th><th>작업자</th><th>메모</th></tr>
<tr><th>시각</th><th>유형</th><th>길이</th><th>작업자</th><th>메모</th><th></th></tr>
</thead>
<tbody>
{% for rev in revisions %}
<tr>
<td class="cf24-nowrap">{{ rev.created_at }}</td>
<td class="cf24-nowrap"><code>{{ rev.revision_type }}</code></td>
<td class="cf24-nowrap" title="{{ rev.type_label }}">
<code>{{ rev.revision_type }}</code>
{% if rev.source == 'LAST_WRITE' %}<span class="cf24-muted" title="카페24가 읽기 지연 중이라 마지막으로 확인된 적용값을 백업했습니다">지연</span>{% endif %}
</td>
<td class="cf24-nowrap">{{ rev.html_length }}자</td>
<td class="cf24-nowrap">{{ rev.created_by or '—' }}</td>
<td>{{ rev.memo or '' }}</td>
<td class="cf24-nowrap">
{% if rev.html_length %}
<button type="button" class="erp-btn erp-btn-outline cf24-btn-inline" data-rev-view="{{ rev.id }}">원문</button>
{% endif %}
</td>
</tr>
{% endfor %}
</tbody>
</table>
</div>
<p class="cf24-muted">버전 선택 복원은 Phase 6 에서 붙습니다. 내용은 모두 보관됩니다.</p>
<p class="cf24-muted">
「원문」에서 그 버전의 소스를 확인·복사하고, 필요하면 「이 버전으로 복원」으로 카페24에 다시 적용합니다.
복원도 적용과 같은 순서(현재값 재조회 → 직전 내용 자동 백업 → 편집 중 변경 확인)를 거치며 이력에
<code>ROLLBACK</code> 으로 남습니다. 자동 복원(예약 종료 후 되돌리기)은 쓰지 않습니다.
</p>
{% else %}
<p class="cf24-muted">아직 이 상품의 변경 이력이 없습니다.</p>
{% endif %}
@@ -13,7 +13,7 @@
<div class="erp-card cf24-card">
<div class="cf24-card-head">
<h3>예약 목록</h3>
<span class="cf24-muted">대기 {{ pending }}건 · 최근 200건</span>
<span class="cf24-muted">대기 {{ pending }}건{% if review %} · <strong class="cf24-err">확인 필요 {{ review }}건</strong>{% endif %} · 최근 200건</span>
</div>
<p class="cf24-note">
@@ -22,6 +22,11 @@
적용 직전 내용은 상품별 <code>BACKUP</code> 버전으로 보관됩니다.
<strong>대기</strong> 상태인 예약만 취소할 수 있습니다.
</p>
<p class="cf24-note">
<strong>확인 필요</strong> — 카페24에 쓰는 도중 응답이 끊겼거나 worker 가 멈춰 반영 여부를 알 수 없는 예약입니다.
자동으로 다시 실행하지 않습니다. 쇼핑몰에서 상세페이지·진열/판매를 확인한 뒤
「반영됨」(완료로 기록) · 「다시 실행」 · 「실패로 종료」 중 하나를 고르세요.
</p>
{% if rows %}
<div class="cf24-scroll">
@@ -53,12 +58,13 @@
{% if r.status == 'SUCCESS' %}<span class="erp-badge cf24-badge-ok">{{ r.status_label }}</span>
{% elif r.status == 'FAILED' %}<span class="cf24-err">{{ r.status_label }}</span>
{% elif r.status == 'PENDING' %}<span class="cf24-warn">{{ r.status_label }}</span>
{% elif r.status == 'NEEDS_REVIEW' %}<span class="erp-badge cf24-badge-off">{{ r.status_label }}</span>
{% else %}<span class="cf24-muted">{{ r.status_label }}</span>{% endif %}
{% if r.retry_count %}<span class="cf24-muted">({{ r.retry_count }}회)</span>{% endif %}
</td>
<td>
{{ r.memo or '' }}
{% if r.last_error %}<div class="cf24-err">{{ r.last_error }}</div>{% endif %}
{% if r.last_error %}<div class="{{ 'cf24-muted' if r.status == 'SUCCESS' else 'cf24-err' }}">{{ r.last_error }}</div>{% endif %}
</td>
<td class="cf24-nowrap">{{ r.created_by or '—' }}</td>
<td class="cf24-nowrap">
@@ -67,6 +73,22 @@
data-erp-confirm="예약 #{{ r.id }} 을 취소할까요?">
<button type="submit" class="erp-btn erp-btn-outline">취소</button>
</form>
{% elif r.needs_review %}
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
data-erp-confirm="쇼핑몰에서 반영된 것을 확인했나요? 예약 #{{ r.id }} 을 완료로 기록합니다.">
<input type="hidden" name="action" value="applied" />
<button type="submit" class="erp-btn erp-btn-outline">반영됨</button>
</form>
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
data-erp-confirm="예약 #{{ r.id }} 을 다시 실행합니다. 이미 반영돼 있었다면 같은 내용을 한 번 더 적용합니다. 계속할까요?">
<input type="hidden" name="action" value="rerun" />
<button type="submit" class="erp-btn erp-btn-outline">다시 실행</button>
</form>
<form method="post" action="/cafe24/schedules/{{ r.id }}/review" class="cf24-review-form"
data-erp-confirm="예약 #{{ r.id }} 을 실패로 종료할까요?">
<input type="hidden" name="action" value="close" />
<button type="submit" class="erp-btn erp-btn-outline">실패로 종료</button>
</form>
{% endif %}
</td>
</tr>
+523
View File
@@ -0,0 +1,523 @@
"""카페24 모듈 단위 테스트용 대역 — 메모리 저장소 · 가짜 카페24 · 가짜 FTP.
실제 DB 의 동작(잠금 만료, SKIP LOCKED, JSONB 병합 등)은 이 대역으로 증명되지 않는다.
그 부분은 test_cafe24_db.py(격리된 로컬 PostgreSQL)가 검증한다. 여기서는 쓰기 순서와
분기(백업·충돌·결과 분류·복구 판정)를 빠르게 확인한다.
"""
from __future__ import annotations
import copy
import ftplib
import itertools
import uuid
from contextlib import contextmanager
from datetime import datetime, timedelta
from typing import Any
from app.integrations.cafe24.errors import Cafe24ApiError
from app.modules.cafe24 import store
from app.timezone import KST, now_kst
class MemoryStore:
"""Cafe24Store 가 writes/worker/라우터에 주는 메서드를 메모리로 흉내낸다."""
def __init__(self) -> None:
self._ids = itertools.count(1)
self.revisions: dict[int, dict[str, Any]] = {}
self.attempts: dict[int, dict[str, Any]] = {}
self.locks: dict[str, dict[str, Any]] = {}
self.schedules: dict[int, dict[str, Any]] = {}
self.snapshots: dict[int, dict[str, Any]] = {}
self.audits: list[dict[str, Any]] = []
self.products: dict[int, dict[str, Any]] = {}
self.fail_on: set[str] = set() # 이 메서드 이름이 들어 있으면 예외(기록 실패 재현)
self.schema_ok = True
def _maybe_fail(self, name: str) -> None:
if name in self.fail_on:
raise RuntimeError(f"DB 장애({name})")
# ── 스키마 ──
def write_schema_ready(self) -> bool:
return self.schema_ok
# ── 잠금 ──
def acquire_lock(self, key, *, owner, purpose, ttl_seconds):
now = now_kst()
held = self.locks.get(key)
if held and held["expires_at"] > now:
return None
token = uuid.uuid4().hex
self.locks[key] = {"owner": owner, "purpose": purpose, "token": token,
"expires_at": now + timedelta(seconds=ttl_seconds)}
return token
def renew_lock(self, key, token, *, ttl_seconds):
held = self.locks.get(key)
if not held or held["token"] != token or held["expires_at"] <= now_kst():
return False
held["expires_at"] = now_kst() + timedelta(seconds=ttl_seconds)
return True
def release_lock(self, key, token):
if self.locks.get(key, {}).get("token") == token:
del self.locks[key]
def lock_holder(self, key):
held = self.locks.get(key)
return dict(held) if held and held["expires_at"] > now_kst() else {}
def expire_lock(self, key):
if key in self.locks:
self.locks[key]["expires_at"] = now_kst() - timedelta(seconds=1)
# ── 버전 ──
def add_revision(self, *, product_no, html_content, revision_type, memo="", created_by="",
mall_id="", shop_no=1, source="", source_revision_id=None):
self._maybe_fail("add_revision")
rid = next(self._ids)
self.revisions[rid] = {
"id": rid, "product_no": int(product_no), "html_content": html_content or "",
"revision_type": store.normalize_revision_type(revision_type), "memo": memo,
"created_by": created_by, "mall_id": mall_id, "shop_no": shop_no, "source": source,
"source_revision_id": source_revision_id, "created_at": now_kst().isoformat(),
}
return rid
def get_revision(self, revision_id):
return dict(self.revisions.get(int(revision_id), {}))
def list_revisions(self, product_no, *, limit=20):
rows = [dict(r, html_length=len(r["html_content"])) for r in self.revisions.values()
if r["product_no"] == int(product_no)]
return sorted(rows, key=lambda r: -r["id"])[:limit]
def of_type(self, revision_type):
return [r for r in self.revisions.values() if r["revision_type"] == revision_type]
# ── 쓰기 시도 ──
def start_attempt(self, **fields):
self._maybe_fail("start_attempt")
aid = next(self._ids)
row = {"id": aid, "status": store.ATTEMPT_STARTED, "error": "", "remote_updated_at": "",
"remote_at": None, "resolved_by": "", "applied_revision_id": None,
"created_at": now_kst(), "target_html": "", "target_revision_id": None,
"observed_digest": "", "base_digest": "", "target_digest": "", "schedule_id": None,
"set_display": None, "set_selling": None, "memo": "", "actor": "", "origin": "MANUAL"}
row.update(fields)
self.attempts[aid] = row
return aid
def update_attempt(self, attempt_id, *, status=None, error=None, remote_updated_at=None,
remote_ok=False, resolved_by=None, only_from=None):
self._maybe_fail("update_attempt")
row = self.attempts.get(int(attempt_id))
if not row or (only_from and row["status"] not in only_from):
return False
if status is not None:
row["status"] = status
if error is not None:
row["error"] = error
if remote_updated_at is not None:
row["remote_updated_at"] = remote_updated_at
if remote_ok and row["remote_at"] is None:
row["remote_at"] = now_kst()
if resolved_by is not None:
row["resolved_by"] = resolved_by
return True
def record_attempt_revision(self, attempt_id, *, revision_type, memo, created_by, source="",
source_revision_id=None):
self._maybe_fail("record_attempt_revision")
row = self.attempts[int(attempt_id)]
if row.get("applied_revision_id"):
return row["applied_revision_id"]
body = row.get("target_html") or self.revisions.get(row.get("target_revision_id") or 0, {}).get("html_content", "")
rid = self.add_revision(product_no=row["product_no"], html_content=body, revision_type=revision_type,
memo=memo, created_by=created_by, mall_id=row.get("mall_id", ""),
source=source, source_revision_id=source_revision_id)
row.update(status=store.ATTEMPT_RECORDED, applied_revision_id=rid, target_html="")
if row["remote_at"] is None:
row["remote_at"] = now_kst()
return rid
def get_attempt(self, attempt_id):
return dict(self.attempts.get(int(attempt_id), {}))
def latest_attempt_for_schedule(self, schedule_id):
rows = [a for a in self.attempts.values() if a.get("schedule_id") == int(schedule_id)]
return dict(max(rows, key=lambda a: a["id"])) if rows else {}
def open_attempts(self, product_no, *, since):
return [dict(a) for a in sorted(self.attempts.values(), key=lambda a: a["id"])
if a["product_no"] == int(product_no) and a["status"] in store.ATTEMPT_OPEN
and a["created_at"] >= since]
def attempts_needing_record(self, *, since, limit=20):
return [dict(a) for a in self.attempts.values()
if a["status"] == store.ATTEMPT_REMOTE_OK and a["created_at"] >= since][:limit]
def write_lineage(self, product_no, *, since, limit=30):
rows = [a for a in self.attempts.values()
if a["product_no"] == int(product_no) and a["status"] in store.ATTEMPT_CONFIRMED
and a["target_digest"] and a["remote_at"] and a["remote_at"] >= since]
rows.sort(key=lambda a: (a["remote_at"], a["id"]), reverse=True)
out = []
for i, a in enumerate(rows[:limit]):
body = ""
if i == 0:
body = (a.get("target_html")
or self.revisions.get(a.get("applied_revision_id") or 0, {}).get("html_content")
or self.revisions.get(a.get("target_revision_id") or 0, {}).get("html_content") or "")
out.append({**a, "created_at": a["remote_at"], "created_by": a.get("actor", ""), "html_content": body})
return out
# ── 상품 캐시 · 스냅샷 ──
def upsert_products(self, rows):
self._maybe_fail("upsert_products")
for r in rows:
self.products[int(r["product_no"])] = dict(r)
return len(rows)
def save_write_snapshot(self, product_no, section, data, *, replace=False):
self._maybe_fail("save_write_snapshot")
at = now_kst().isoformat(timespec="seconds")
current = self.snapshots.setdefault(int(product_no), {})
if section == "variants":
previous = (current.get("variants") or {}).get("data") or {}
data = store.merge_variant_snapshot(previous, data, at=at, replace=replace)
current[section] = {"data": data, "written_at": at}
def get_write_snapshot(self, product_no):
return dict(self.snapshots.get(int(product_no), {}))
# ── 예약 ──
def add_schedule(self, **fields):
sid = next(self._ids)
row = {"id": sid, "product_no": 131, "revision_id": None, "set_display": None, "set_selling": None,
"status": store.STATUS_PENDING, "retry_count": 0, "next_retry_at": None, "last_error": "",
"scheduled_at": now_kst() - timedelta(minutes=1), "lease_token": "", "lease_owner": "",
"lease_expires_at": None, "started_at": None}
row.update(fields)
self.schedules[sid] = row
return sid
def claim_due_schedule(self, *, now, owner, ttl_seconds):
due = [s for s in sorted(self.schedules.values(), key=lambda s: (s["scheduled_at"], s["id"]))
if s["status"] == store.STATUS_PENDING and s["scheduled_at"] <= now
and (s["next_retry_at"] is None or s["next_retry_at"] <= now)]
if not due:
return None
row = due[0]
row.update(status=store.STATUS_PROCESSING, lease_owner=owner, lease_token=uuid.uuid4().hex,
lease_expires_at=now_kst() + timedelta(seconds=ttl_seconds), started_at=now_kst(),
last_error="")
return dict(row)
def claim_expired_schedules(self, *, owner, ttl_seconds, legacy_minutes, limit=20):
out = []
for row in self.schedules.values():
if row["status"] != store.STATUS_PROCESSING:
continue
expired = row["lease_expires_at"] is not None and row["lease_expires_at"] < now_kst()
legacy = row["lease_expires_at"] is None and (row["started_at"] or now_kst()) < now_kst() - timedelta(minutes=legacy_minutes)
if expired or legacy:
row.update(lease_owner=owner, lease_token=uuid.uuid4().hex,
lease_expires_at=now_kst() + timedelta(seconds=ttl_seconds))
out.append(dict(row))
return out[:limit]
def renew_schedule_lease(self, schedule_id, token, *, ttl_seconds):
row = self.schedules.get(int(schedule_id))
if (not row or row["status"] != store.STATUS_PROCESSING or row["lease_token"] != token
or row["lease_expires_at"] <= now_kst()):
return False
row["lease_expires_at"] = now_kst() + timedelta(seconds=ttl_seconds)
return True
def finish_schedule(self, schedule_id, *, token, status, error="", next_retry_at=None, retry_count=None):
self._maybe_fail("finish_schedule")
row = self.schedules.get(int(schedule_id))
if not row or row["status"] != store.STATUS_PROCESSING or row["lease_token"] != token:
return False
row.update(status=store.normalize_schedule_status(status), last_error=error, next_retry_at=next_retry_at,
lease_token="", lease_owner="", lease_expires_at=None)
if retry_count is not None:
row["retry_count"] = retry_count
return True
def expire_schedule_lease(self, schedule_id):
self.schedules[int(schedule_id)]["lease_expires_at"] = now_kst() - timedelta(seconds=1)
def get_schedule(self, schedule_id):
return dict(self.schedules.get(int(schedule_id), {}))
def review_schedule(self, schedule_id, *, status, note, actor, action):
row = self.schedules.get(int(schedule_id))
if not row or row["status"] != store.STATUS_NEEDS_REVIEW:
return {}
row.update(status=status, last_error=note,
next_retry_at=now_kst() if status == store.STATUS_PENDING else None)
if status != store.STATUS_SUCCESS:
for a in self.attempts.values():
if a.get("schedule_id") == int(schedule_id) and a["status"] in (store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN):
a.update(status=store.ATTEMPT_ABANDONED, resolved_by=actor)
return dict(row)
# ── 감사 ──
def log_audit(self, **fields):
self._maybe_fail("log_audit")
self.audits.append(fields)
def log_api_call(self, **_fields):
pass
class FakeConfig:
mall_id = "testmall"
shop_base = "https://testmall.cafe24.com"
def product_url(self, no):
return f"https://testmall.cafe24.com/product/detail.html?product_no={no}"
class FakeCafe24:
"""카페24 상품 API 대역 — 상세설명·진열/판매·updated_date 를 들고 있고,
읽기 지연(lag)·PUT 실패·응답 유실을 흉내낸다."""
def __init__(self, description: str = "<p>A</p>", *, product_no: int = 131):
self.product_no = product_no
self.state = {"product_no": product_no, "product_name": "상품", "product_code": "P000000B",
"description": description, "mobile_description": description,
"separated_mobile_description": "F", "display": "T", "selling": "T",
"updated_date": "2026-09-30T10:00:00+09:00"}
self.stale: dict | None = None # 설정하면 GET 이 이 값을 돌려준다(읽기 지연)
self.put_error: Exception | None = None
self.put_error_after_apply = False # True 면 반영한 뒤 오류(응답 유실)
self.calls: list[tuple] = []
self._clock = 0
self.option: dict = {"has_option": "F", "options": []}
self.variants: list = []
self.stale_option: dict | None = None # 설정하면 GET options 가 이 값을 돌려준다
self.stale_variants: list | None = None # 설정하면 GET variants 가 이 값을 돌려준다
self.hidden_variants = 0 # 새로 생긴 품목이 GET 에 늦게 나타나는 횟수
self.fail_variant_chunk = 0 # n번째 PUT variants 묶음을 실패시킨다
self.variant_error: Exception | None = None
self._variant_puts = 0
self._code_seq = 0
def external_edit(self, description: str) -> None:
"""카페24 관리자에서 사람이 직접 고친 것."""
self._tick()
self.state.update(description=description, mobile_description=description)
def _tick(self) -> None:
self._clock += 1
self.state["updated_date"] = (datetime(2026, 9, 30, 10, 0, tzinfo=KST)
+ timedelta(minutes=self._clock)).isoformat()
# Cafe24Client 흉내 — products.* 래퍼가 부르는 get/put
def get(self, path, **kw):
self.calls.append(("GET", path))
if path == f"/admin/products/{self.product_no}":
return {"product": dict(self.stale if self.stale is not None else self.state)}
out = self._options_call("GET", path, None)
return copy.deepcopy(out) if out is not None else {}
# ── 옵션 / 품목 ── (상태는 __init__ 에서 만든다)
def _new_code(self) -> str:
self._code_seq += 1
return f"P000000B{self._code_seq:04X}"
def _options_call(self, method, path, json):
no = self.product_no
req = (json or {}).get("request") or {}
if path == f"/admin/products/{no}/options":
if method == "GET":
return {"option": self.stale_option if self.stale_option is not None else self.option}
if method == "POST":
opt = req["options"][0]
values = [{"option_text": v["option_text"], "value_no": i + 1} for i, v in enumerate(opt["option_value"])]
self.option = {"has_option": "T", "option_type": "T", "option_list_type": "S",
"options": [{"option_name": opt["option_name"], "option_code": "O1",
"option_display_type": opt.get("option_display_type", "S"),
"option_value": values}]}
self.variants = [{"variant_code": self._new_code(), "options": [{"name": opt["option_name"], "value": v["option_text"]}],
"custom_variant_code": "", "additional_amount": "0.00", "display": "T", "selling": "T"}
for v in values]
return {"option": self.option}
if method == "PUT":
new = req["options"]
for gi, group in enumerate(new):
cur = self.option["options"][gi]
old_name = cur["option_name"]
old_values = [v["option_text"] for v in cur["option_value"]]
cur["option_name"] = group["option_name"]
vals = []
for vi, v in enumerate(group["option_value"]):
vals.append({"option_text": v["option_text"], "value_no": vi + 1,
"option_image_file": v.get("option_image_file", "")})
if vi < len(old_values):
for var in self.variants:
for o in var["options"]:
if o["name"] == old_name and o["value"] == old_values[vi]:
o["value"] = v["option_text"]
else:
self.variants.append({"variant_code": self._new_code(),
"options": [{"name": group["option_name"], "value": v["option_text"]}],
"custom_variant_code": "", "additional_amount": "0.00",
"display": "T", "selling": "T", "_new": True})
for var in self.variants:
for o in var["options"]:
if o["name"] == old_name:
o["name"] = group["option_name"]
cur["option_value"] = vals
return {"option": self.option}
if method == "DELETE":
self.option = {"has_option": "F", "options": []}
self.variants = []
return {"option": {"product_no": no}}
if path == f"/admin/products/{no}/variants":
if method == "GET":
if self.stale_variants is not None:
return {"variants": [dict(v) for v in self.stale_variants]}
shown = [dict(v) for v in self.variants]
if self.hidden_variants > 0:
self.hidden_variants -= 1
shown = [v for v in shown if not v.get("_new")]
return {"variants": shown}
if method == "PUT":
self._variant_puts += 1
if self.fail_variant_chunk and self._variant_puts == self.fail_variant_chunk:
raise self.variant_error or Cafe24ApiError("품목 수정 거절", status=422)
out = []
for r in (json or {}).get("requests") or []:
for var in self.variants:
if var["variant_code"] == r["variant_code"]:
var.update({k: v for k, v in r.items() if k != "variant_code"})
out.append(dict(var))
return {"variants": out}
if path.startswith(f"/admin/products/{no}/variants/") and method == "DELETE":
code = path.rsplit("/", 1)[1]
self.variants = [v for v in self.variants if v["variant_code"] != code]
return {"variant": {"variant_code": code}}
return None
def post(self, path, *, json=None, **kw):
self.calls.append(("POST", path, json))
out = self._options_call("POST", path, json)
return copy.deepcopy(out) if out is not None else {}
def delete(self, path, **kw):
self.calls.append(("DELETE", path))
out = self._options_call("DELETE", path, None)
return out if out is not None else {}
def put(self, path, *, json=None, **kw):
self.calls.append(("PUT", path, json))
if path != f"/admin/products/{self.product_no}":
out = self._options_call("PUT", path, json)
return copy.deepcopy(out) if out is not None else {}
if self.put_error is not None and not self.put_error_after_apply:
raise self.put_error
req = (json or {}).get("request", {})
self._tick()
for key in ("description", "display", "selling", "product_name", "separated_mobile_description"):
if key in req:
self.state[key] = req[key]
if "description" in req:
self.state["mobile_description"] = req["description"]
if self.put_error is not None:
raise self.put_error
return {"product": dict(self.state)}
def puts(self):
return [c for c in self.calls if c[0] == "PUT"]
class FakeApi:
def __init__(self, client):
self.client = client
self.config = FakeConfig()
def network_error(maybe_applied: bool = True) -> Cafe24ApiError:
return Cafe24ApiError("네트워크 오류 (ReadTimeout)", status=0, maybe_applied=maybe_applied)
class FakeFTP:
"""ftplib.FTP 대역 — RETR/STOR/RNFR·RNTO/DELE 를 메모리 파일로. 실패를 주입할 수 있다."""
files: dict[str, bytes] = {}
rename_mode = "overwrite" # overwrite | no_overwrite | unsupported
truncate_store = False # STOR 가 앞부분만 쓰고 끝난 것처럼
on_before_rename = None # 교체 직전 끼어들기(남이 원본을 바꿈 등)
log: list[tuple] = []
def __init__(self):
pass
def connect(self, host, port, timeout=None):
FakeFTP.log.append(("connect",))
def login(self, user, password):
pass
def set_pasv(self, value):
pass
def retrbinary(self, cmd, callback):
path = cmd.split(" ", 1)[1]
if path not in self.files:
raise ftplib.error_perm("550 No such file")
callback(self.files[path])
def storbinary(self, cmd, fp):
path = cmd.split(" ", 1)[1]
data = fp.read()
FakeFTP.log.append(("STOR", path))
self.files[path] = data[: len(data) // 2] if FakeFTP.truncate_store else data
def rename(self, src, dst):
FakeFTP.log.append(("RENAME", src, dst))
if FakeFTP.on_before_rename is not None:
hook, FakeFTP.on_before_rename = FakeFTP.on_before_rename, None
hook(self.files)
if FakeFTP.rename_mode == "unsupported":
raise ftplib.error_perm("502 RNFR not implemented")
if src not in self.files:
raise ftplib.error_perm("550 No such file")
if dst in self.files and FakeFTP.rename_mode == "no_overwrite":
raise ftplib.error_perm("553 File exists")
self.files[dst] = self.files.pop(src)
def delete(self, path):
FakeFTP.log.append(("DELE", path))
self.files.pop(path, None)
def quit(self):
pass
def close(self):
pass
@classmethod
def reset(cls, files):
cls.files = dict(files)
cls.rename_mode = "overwrite"
cls.truncate_store = False
cls.on_before_rename = None
cls.log = []
@contextmanager
def patched_ftp():
saved = ftplib.FTP
ftplib.FTP = FakeFTP
try:
yield FakeFTP
finally:
ftplib.FTP = saved
+655 -152
View File
@@ -8,6 +8,7 @@ DB/네트워크 없이 검증한다(가짜 저장소 + refresh 함수 주입).
from __future__ import annotations
import ftplib
import logging
import os
from contextlib import contextmanager
from datetime import timedelta
@@ -15,7 +16,8 @@ from datetime import timedelta
from app.integrations.cafe24 import config as cfgmod
from app.integrations.cafe24 import crypto, oauth, products, tokens
from app.integrations.cafe24.errors import Cafe24ApiError, Cafe24AuthError, Cafe24ConfigError
from app.modules.cafe24 import store, worker
from app.modules.cafe24 import store, worker, writes
from app.modules.cafe24.tests import fakes
from app.timezone import now_kst
SECRET = "unit-test-secret"
@@ -25,6 +27,8 @@ SECRET = "unit-test-secret"
# 값을 돌려줌) 재시도 예산을 다 채우게 되는데, 테스트에서까지 그 시간을 그대로
# 기다릴 필요는 없다.
products.time.sleep = lambda *_a, **_k: None
# 장애 주입 테스트가 남기는 logger.exception 출력은 결과와 무관하다 — 조용히.
logging.getLogger("cafe24").setLevel(logging.CRITICAL)
_TEST_ENV = {
"CAFE24_MALL_ID": "testmall",
@@ -711,203 +715,303 @@ def test_design_file_path_env_override():
os.environ["CAFE24_PC_DETAIL_FTP_PATH"] = saved
class _FakeFTP:
"""ftplib.FTP 대역 — 실제 소켓 없이 RETR/STOR 명령만 흉내낸다."""
files: dict[str, bytes] = {}
def __init__(self):
self.calls = []
def connect(self, host, port, timeout=None):
self.calls.append(("connect", host, port))
def login(self, user, password):
self.calls.append(("login", user, password))
def set_pasv(self, value):
pass
def retrbinary(self, cmd, callback):
path = cmd.split(" ", 1)[1]
if path not in self.files:
raise ftplib.error_perm("550 No such file")
callback(self.files[path])
def storbinary(self, cmd, fp):
path = cmd.split(" ", 1)[1]
self.files[path] = fp.read()
def quit(self):
self.calls.append(("quit",))
_FTP_CFG = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
_SWIPER = "/sde_design/mobile11/product-swiper/product-swiper.js"
def test_design_ftp_read_and_write_roundtrip():
from app.integrations.cafe24 import design_ftp
path = "/sde_design/mobile11/product-swiper/product-swiper.js"
_FakeFTP.files = {path: "old".encode("utf-8")}
saved = ftplib.FTP
ftplib.FTP = _FakeFTP
try:
cfg = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
content = design_ftp.read_text_file(cfg, path)
assert content == "old"
design_ftp.write_text_file(cfg, path, "new content")
assert design_ftp.read_text_file(cfg, path) == "new content"
finally:
ftplib.FTP = saved
with fakes.patched_ftp() as ftp:
ftp.reset({_SWIPER: "old".encode("utf-8")})
assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "old"
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "new content", expected_current="old")
assert design_ftp.read_text_file(_FTP_CFG, _SWIPER) == "new content"
# 원본에 직접 STOR 하지 않는다 — 임시 파일에 올린 뒤 이름 바꾸기로 교체
stors = [e for e in ftp.log if e[0] == "STOR"]
assert stors and all(".cf24tmp-" in e[1] for e in stors), ftp.log
assert any(e[0] == "RENAME" and e[2] == _SWIPER for e in ftp.log)
# 임시 파일이 남지 않는다
assert set(ftp.files) == {_SWIPER}
def test_design_ftp_missing_file_raises_cafe24_error():
from app.integrations.cafe24 import design_ftp
from app.integrations.cafe24.errors import Cafe24FtpError
_FakeFTP.files = {}
saved = ftplib.FTP
ftplib.FTP = _FakeFTP
try:
cfg = cfgmod.Cafe24FtpConfig(host="h", port=21, user="u", password="p")
with fakes.patched_ftp() as ftp:
ftp.reset({})
try:
design_ftp.read_text_file(cfg, "/missing.js")
design_ftp.read_text_file(_FTP_CFG, "/missing.js")
raise AssertionError("Cafe24FtpError 가 났어야 한다")
except Cafe24FtpError:
pass
finally:
ftplib.FTP = saved
def test_design_ftp_truncated_upload_keeps_original():
"""[04] 전송이 잘려도 원본은 그대로 — 임시 파일 검증에서 멈춘다."""
from app.integrations.cafe24 import design_ftp
from app.integrations.cafe24.errors import Cafe24FtpError
with fakes.patched_ftp() as ftp:
ftp.reset({_SWIPER: b"ORIGINAL"})
ftp.truncate_store = True
try:
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW CONTENT 1234", expected_current="ORIGINAL")
raise AssertionError("잘린 업로드를 성공으로 처리했다")
except Cafe24FtpError as exc:
assert exc.maybe_applied is False
assert ftp.files == {_SWIPER: b"ORIGINAL"} # 원본 그대로 + 임시 파일 정리
def test_design_ftp_rename_unsupported_aborts_without_direct_stor():
"""[04] 이름 바꾸기를 지원하지 않으면 중단 — 원본에 직접 쓰지 않는다."""
from app.integrations.cafe24 import design_ftp
from app.integrations.cafe24.errors import Cafe24FtpError
with fakes.patched_ftp() as ftp:
ftp.reset({_SWIPER: b"ORIGINAL"})
ftp.rename_mode = "unsupported"
try:
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL")
raise AssertionError("rename 미지원인데 진행했다")
except Cafe24FtpError as exc:
assert "rename" in str(exc)
assert ftp.files == {_SWIPER: b"ORIGINAL"}
assert not any(e == ("STOR", _SWIPER) for e in ftp.log)
def test_design_ftp_no_overwrite_rename_swaps_safely():
"""덮어쓰기 rename 을 거부하는 서버 — 원본을 비킨 뒤 교체하고 비킨 파일은 지운다."""
from app.integrations.cafe24 import design_ftp
with fakes.patched_ftp() as ftp:
ftp.reset({_SWIPER: b"ORIGINAL"})
ftp.rename_mode = "no_overwrite"
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "NEW", expected_current="ORIGINAL")
assert ftp.files == {_SWIPER: b"NEW"}
def test_design_ftp_conflict_right_before_replace():
"""[04] 교체 직전 원본이 바뀌어 있으면(남이 수정) 덮지 않고 멈춘다."""
from app.integrations.cafe24 import design_ftp
from app.integrations.cafe24.errors import Cafe24FtpConflict
with fakes.patched_ftp() as ftp:
ftp.reset({_SWIPER: b"SOMEONE ELSE"})
try:
design_ftp.write_text_file(_FTP_CFG, _SWIPER, "MINE", expected_current="ORIGINAL")
raise AssertionError("충돌을 못 잡았다")
except Cafe24FtpConflict:
pass
assert ftp.files == {_SWIPER: b"SOMEONE ELSE"}
# ════════════════════════════════════════════════════════════
# 예약 worker — 성공/재시도/최종실패
# 예약 worker — 성공/재시도/최종실패/확인 필요/중단 복구 (메모리 저장소 대역)
# 실제 DB 의 lease·SKIP LOCKED 는 test_cafe24_db.py 에서 검증한다.
# ════════════════════════════════════════════════════════════
class _FakeStore:
"""worker 가 쓰는 저장소 메서드만 흉내낸다."""
def __init__(self, rows):
self.rows = list(rows)
self.revisions = {}
self.added = []
self.finished = []
self.audits = []
@contextmanager
def claim_due_schedule(self, *, now):
yield self.rows.pop(0) if self.rows else None
def get_revision(self, revision_id):
return self.revisions.get(int(revision_id), {})
def add_revision(self, **fields):
self.added.append(fields)
return 900 + len(self.added)
def save_write_snapshot(self, product_no, section, data):
self.snapshots = getattr(self, "snapshots", [])
self.snapshots.append((product_no, section, data))
def finish_schedule(self, schedule_id, *, status, error="", next_retry_at=None, retry_count=None):
self.finished.append(
{"id": schedule_id, "status": status, "error": error,
"next_retry_at": next_retry_at, "retry_count": retry_count}
)
def log_audit(self, **fields):
self.audits.append(fields)
class _FakeApi:
def __init__(self, client):
self.client = client
class _WorkerClient(_FakeClient):
"""PUT 을 실패시킬 수 있는 클라이언트."""
def __init__(self, payload=None, fail_put=None):
super().__init__(payload)
self.fail_put = fail_put
def put(self, path, *, params=None, json=None, product_no=None):
if self.fail_put:
raise self.fail_put
return super().put(path, params=params, json=json, product_no=product_no)
def _schedule_row(**overrides):
row = {
"id": 7, "product_no": 131, "revision_id": 55,
"set_display": True, "set_selling": None, "retry_count": 0,
}
row.update(overrides)
return row
def _worker_env(description="<p>A</p>", **schedule):
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24(description)
api = fakes.FakeApi(cafe)
rid = st.add_revision(product_no=131, html_content="<p>예약 내용</p>", revision_type="DRAFT")
fields = {"revision_id": rid, "set_display": True}
fields.update(schedule)
sid = st.add_schedule(**fields)
return st, cafe, api, sid, rid
def test_worker_applies_html_and_flags():
st = _FakeStore([_schedule_row()])
st.revisions[55] = {"html_content": "<p>예약 내용</p>"}
client = _WorkerClient({"product": _PRODUCT})
assert worker.process_once(st, _FakeApi(client)) == 1
st, cafe, api, sid, _rid = _worker_env()
assert worker.process_once(st, api) == 1
# 쓰기 직전 현재값을 읽어 BACKUP 을 남겼는가
assert any(r["revision_type"] == store.REVISION_BACKUP for r in st.added)
backups = st.of_type(store.REVISION_BACKUP)
assert backups and backups[0]["html_content"] == "<p>A</p>"
assert backups[0]["source"] == store.SOURCE_OBSERVED
# HTML 과 진열 상태를 한 번의 PUT 으로 보냈는가
put = [c for c in client.calls if c["method"] == "PUT"][0]
assert put["json"]["request"]["description"] == "<p>예약 내용</p>"
put = cafe.puts()[0]
assert put[2]["request"]["description"] == "<p>예약 내용</p>"
# mobile_description 은 보내지 않는다 — separated_mobile_description="F" 로
# "PC 상세설명과 동일"을 강제한다(직접 보내면 "직접 등록"으로 바뀌어버린다).
assert "mobile_description" not in put["json"]["request"]
assert put["json"]["request"]["separated_mobile_description"] == "F"
assert put["json"]["request"]["display"] == "T"
assert "selling" not in put["json"]["request"] # 변경 없음이면 보내지 않는다
assert st.finished == [
{"id": 7, "status": store.STATUS_SUCCESS, "error": "",
"next_retry_at": None, "retry_count": None}
]
assert "mobile_description" not in put[2]["request"]
assert put[2]["request"]["separated_mobile_description"] == "F"
assert put[2]["request"]["display"] == "T"
assert "selling" not in put[2]["request"] # 변경 없음이면 보내지 않는다
row = st.schedules[sid]
assert row["status"] == store.STATUS_SUCCESS and row["last_error"] == ""
assert row["lease_token"] == "" # 끝나면 lease 를 비운다
assert len(st.of_type(store.REVISION_SCHEDULED)) == 1
assert list(st.attempts.values())[0]["status"] == store.ATTEMPT_RECORDED
assert st.locks == {} # 상품 잠금 해제
def test_worker_flags_only_skips_backup():
"""HTML 없이 진열/판매만 바꾸는 예약은 상세설명을 읽거나 백업하지 않는다."""
st = _FakeStore([_schedule_row(revision_id=None, set_selling=False)])
client = _WorkerClient({"product": _PRODUCT})
assert worker.process_once(st, _FakeApi(client)) == 1
assert st.added == [] # 백업 없음
put = [c for c in client.calls if c["method"] == "PUT"][0]
assert "description" not in put["json"]["request"]
assert put["json"]["request"] == {"display": "T", "selling": "F"}
st, cafe, api, sid, _ = _worker_env(revision_id=None, set_selling=False)
before = len(st.revisions)
assert worker.process_once(st, api) == 1
assert len(st.revisions) == before # 백업·SCHEDULED 버전 없음
put = cafe.puts()[0]
assert put[2]["request"] == {"display": "T", "selling": "F"}
assert st.schedules[sid]["status"] == store.STATUS_SUCCESS
def test_worker_retries_then_fails():
"""실패는 재시도 예산 안에서 다시 시도하고, 소진되면 FAILED 로 확정한다."""
boom = Cafe24ApiError("서버 오류", status=500)
st = _FakeStore([_schedule_row(retry_count=0)])
st.revisions[55] = {"html_content": "<p>x</p>"}
worker.process_once(st, _FakeApi(_WorkerClient({"product": _PRODUCT}, fail_put=boom)))
first = st.finished[0]
"""거절(반영 안 됨이 확실)은 재시도 예산 안에서 다시 시도하고, 소진되면 FAILED."""
st, cafe, api, sid, _ = _worker_env()
cafe.put_error = Cafe24ApiError("잘못된 요청", status=422)
worker.process_once(st, api)
first = st.schedules[sid]
assert first["status"] == store.STATUS_PENDING # 다시 대기로
assert first["retry_count"] == 1
assert first["next_retry_at"] is not None
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
st2 = _FakeStore([_schedule_row(retry_count=store.MAX_RETRY)])
st2.revisions[55] = {"html_content": "<p>x</p>"}
worker.process_once(st2, _FakeApi(_WorkerClient({"product": _PRODUCT}, fail_put=boom)))
assert st2.finished[0]["status"] == store.STATUS_FAILED
st2, cafe2, api2, sid2, _ = _worker_env(retry_count=store.MAX_RETRY)
cafe2.put_error = Cafe24ApiError("서버 오류", status=400)
worker.process_once(st2, api2)
assert st2.schedules[sid2]["status"] == store.STATUS_FAILED
assert any(a["result"] == "FAIL" for a in st2.audits)
def test_worker_missing_revision_is_failure_not_crash():
st = _FakeStore([_schedule_row(revision_id=999, retry_count=store.MAX_RETRY)])
worker.process_once(st, _FakeApi(_WorkerClient({"product": _PRODUCT})))
assert st.finished[0]["status"] == store.STATUS_FAILED
assert "999" in st.finished[0]["error"]
st, _cafe, api, sid, _ = _worker_env(revision_id=999, retry_count=store.MAX_RETRY)
worker.process_once(st, api)
assert st.schedules[sid]["status"] == store.STATUS_FAILED
assert "999" in st.schedules[sid]["last_error"]
def test_worker_stops_when_nothing_due():
st = _FakeStore([])
assert worker.process_once(st, _FakeApi(_WorkerClient())) == 0
st = fakes.MemoryStore()
assert worker.process_once(st, fakes.FakeApi(fakes.FakeCafe24())) == 0
def test_worker_unknown_result_needs_review_not_retry():
"""[05][07] 응답 유실(반영 여부 모름) — 재시도로 한 번 더 쓰지 않고 확인 필요로 둔다."""
st, cafe, api, sid, _ = _worker_env()
cafe.put_error = fakes.network_error(maybe_applied=True)
cafe.put_error_after_apply = True
worker.process_once(st, api)
assert st.schedules[sid]["status"] == store.STATUS_NEEDS_REVIEW
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_UNKNOWN
worker.process_once(st, api)
assert len(cafe.puts()) == 1 # 다시 쓰지 않았다
def test_worker_remote_ok_but_record_failure_is_success_not_failed():
"""[07] PUT 성공 뒤 로컬 버전 기록 실패 → FAILED 가 아니라 SUCCESS + 기록 복구 메모, 재적용 없음."""
st, cafe, api, sid, _ = _worker_env()
st.fail_on.add("record_attempt_revision")
worker.process_once(st, api)
row = st.schedules[sid]
assert row["status"] == store.STATUS_SUCCESS, row
assert "기록" in row["last_error"]
attempt = list(st.attempts.values())[-1]
assert attempt["status"] == store.ATTEMPT_REMOTE_OK # 반영됨, 기록 복구 대기
# 다음 주기: 기록 복구만 하고 다시 PUT 하지 않는다
st.fail_on.clear()
worker.process_once(st, api)
assert len(cafe.puts()) == 1
assert attempt["status"] == store.ATTEMPT_RECORDED
assert len(st.of_type(store.REVISION_SCHEDULED)) == 1
def test_worker_busy_product_defers_without_burning_retry():
"""[02] 같은 상품을 다른 작업이 쓰는 중이면 쓰지 않고 잠시 뒤로 미룬다(재시도 횟수 그대로)."""
st, cafe, api, sid, _ = _worker_env()
st.acquire_lock("product:131", owner="king|web:1", purpose="상세설명 적용", ttl_seconds=60)
worker.process_once(st, api)
row = st.schedules[sid]
assert row["status"] == store.STATUS_PENDING and row["retry_count"] == 0
assert row["next_retry_at"] is not None
assert cafe.puts() == []
def test_worker_backup_uses_confirmed_last_write_during_lag():
"""[06] 예약 직전 카페24가 읽기 지연으로 옛 HTML 을 돌려줘도, 백업은 마지막 확인된 적용값."""
st, cafe, api, sid, _ = _worker_env(description="<p>OLD</p>")
# 방금 웹에서 NEW 를 적용(확인된 쓰기) — 카페24 GET 은 아직 OLD
with writes.write_lock(st, "product:131", actor="king", purpose="t") as lock:
writes.write_product(st, api, 131, lock=lock, origin=store.ORIGIN_MANUAL, actor="king",
html="<p>NEW</p>", wait_confirm=False)
cafe.stale = {**cafe.state, "description": "<p>OLD</p>", "mobile_description": "<p>OLD</p>",
"updated_date": "2026-09-30T09:00:00+09:00"}
worker.process_once(st, api)
backups = [r for r in st.of_type(store.REVISION_BACKUP) if "예약" in r["memo"]]
assert backups and backups[-1]["html_content"] == "<p>NEW</p>", backups
assert backups[-1]["source"] == store.SOURCE_LAST_WRITE
def test_worker_recovers_expired_processing_by_attempt_state():
"""[05] lease 만료 PROCESSING — 시도 기록으로 판정(무조건 PENDING 금지)."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
rid = st.add_revision(product_no=131, html_content="<p>예약</p>", revision_type="DRAFT")
def processing(**fields):
sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING,
lease_token="dead", started_at=now_kst(), **fields)
st.expire_schedule_lease(sid)
return sid
# (1) 원격 쓰기 전에 죽음 → 재시도 대기
s1 = processing()
# (2) 반영·기록까지 끝난 뒤 죽음 → 완료
s2 = processing()
st.start_attempt(product_no=131, schedule_id=s2, origin="SCHEDULED", target_digest="x",
target_revision_id=rid)
st.attempts[max(st.attempts)]["status"] = store.ATTEMPT_RECORDED
# (3) 반영됐고 기록 전에 죽음 → 기록 채우고 완료(재적용 없음)
s3 = processing()
a3 = st.start_attempt(product_no=131, schedule_id=s3, origin="SCHEDULED",
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
st.attempts[a3]["status"] = store.ATTEMPT_REMOTE_OK
# (4) PUT 도중 죽음, 카페24 값은 예약 결과와 다름 → 확인 필요
s4 = processing()
st.start_attempt(product_no=131, schedule_id=s4, origin="SCHEDULED",
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
# (5) 레거시(lease 없음) PROCESSING, 40분 전 → 만료로 보고 재시도 대기
s5 = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="",
started_at=now_kst() - timedelta(minutes=40))
worker.recover(st, api)
assert st.schedules[s1]["status"] == store.STATUS_PENDING and st.schedules[s1]["retry_count"] == 1
assert st.schedules[s2]["status"] == store.STATUS_SUCCESS
assert st.schedules[s3]["status"] == store.STATUS_SUCCESS
assert st.attempts[a3]["status"] == store.ATTEMPT_RECORDED
assert st.schedules[s4]["status"] == store.STATUS_NEEDS_REVIEW
assert st.schedules[s5]["status"] == store.STATUS_PENDING
assert cafe.puts() == [] # 복구는 쓰지 않는다
def test_worker_recover_verifies_remote_value():
"""[05] 결과 모름 시도라도 카페24 현재값이 예약 결과와 같으면 반영됨으로 확정."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>예약</p>") # 이미 반영돼 있다
api = fakes.FakeApi(cafe)
rid = st.add_revision(product_no=131, html_content="<p>예약</p>", revision_type="DRAFT")
sid = st.add_schedule(revision_id=rid, status=store.STATUS_PROCESSING, lease_token="dead",
started_at=now_kst())
st.expire_schedule_lease(sid)
aid = st.start_attempt(product_no=131, schedule_id=sid, origin="SCHEDULED",
target_digest=store.content_digest("<p>예약</p>"), target_revision_id=rid)
worker.recover(st, api)
assert st.schedules[sid]["status"] == store.STATUS_SUCCESS
assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED
def test_worker_late_finish_after_lease_loss_does_not_overwrite():
"""[05] lease 를 잃은 worker 의 늦은 결과는 반영되지 않는다(token 불일치)."""
st, _cafe, _api, sid, _ = _worker_env()
row = st.claim_due_schedule(now=now_kst(), owner="w1", ttl_seconds=60)
st.expire_schedule_lease(sid)
st.claim_expired_schedules(owner="w2", ttl_seconds=60, legacy_minutes=30)
assert st.finish_schedule(sid, token=row["lease_token"], status=store.STATUS_FAILED) is False
assert st.schedules[sid]["status"] == store.STATUS_PROCESSING
# ════════════════════════════════════════════════════════════
# 카페24 읽기 지연 보정 — 마지막 쓰기가 권위
# ════════════════════════════════════════════════════════════
@@ -1185,7 +1289,8 @@ def test_upload_images_and_variants_wrappers():
assert products.list_variants(client, 7) == [{"variant_code": "P000000R000A"}]
assert products.get_options(client, 7)["has_option"] == "T"
assert products.update_variants(client, 7, [{"variant_code": "P000000R000A", "display": "F"}]) == [
{"variant_code": "P000000R000A", "display": "F"}
{"variant_code": "P000000R000A", "status": "ok", "error": "",
"variant": {"variant_code": "P000000R000A", "display": "F"}}
]
sent = [c for c in client.calls if c[0] == "PUT"][-1]
assert sent[2]["requests"][0]["variant_code"] == "P000000R000A"
@@ -1221,6 +1326,404 @@ def test_set_main_image_uses_product_images_endpoint():
assert products.set_main_image(client, 13, b"") == {}
# ════════════════════════════════════════════════════════════
# 쓰기 공통 처리(writes.write_product) — [01][02][06][07] 회귀
# ════════════════════════════════════════════════════════════
def _apply(st, api, html, *, fp=None, origin=store.ORIGIN_MANUAL, actor="king", **kw):
with writes.write_lock(st, "product:131", actor=actor, purpose="t", wait_seconds=0) as lock:
return writes.write_product(st, api, 131, lock=lock, origin=origin, actor=actor, html=html,
base_fingerprint=fp, wait_confirm=False, **kw)
def _editor_view(st, cafe):
"""편집기가 보여줄 유효 현재값과 지문(routes_products._editor_ctx 와 같은 판정)."""
product = cafe.get(f"/admin/products/{cafe.product_no}")["product"]
effective, state, _ = writes.resolve_effective(st, 131, product["description"],
fetched_updated=product.get("updated_date"))
return effective, state, store.fingerprint(effective)
def test_01_rejected_conflict_backup_does_not_mask_external_edit():
"""[01] 충돌로 거절된 적용의 BACKUP(=외부 값 X)이 읽기 지연 근거가 되면 X 를 덮어쓴다."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
_apply(st, api, "<p>W1</p>") # 우리 쓰기(확인됨)
_eff, _state, stale_fp = _editor_view(st, cafe) # 사용자 1: W1 을 보고 편집 시작
cafe.external_edit("<p>X</p>") # 관리자에서 직접 X 로 고침
try:
_apply(st, api, "<p>Y</p>", fp=stale_fp) # 사용자 1 적용 → 충돌로 거절(BACKUP X 가 남는다)
raise AssertionError("충돌을 못 잡았다")
except writes.WriteConflict:
pass
assert any(r["html_content"] == "<p>X</p>" for r in st.of_type(store.REVISION_BACKUP))
effective, state, fp = _editor_view(st, cafe)
assert (effective, state) == ("<p>X</p>", store.SYNC_EXTERNAL), (effective, state)
try:
_apply(st, api, "<p>Y</p>", fp=stale_fp) # 같은 옛 지문으로 다시 → 여전히 충돌
raise AssertionError("외부 수정 X 를 덮어썼다")
except writes.WriteConflict:
pass
assert cafe.state["description"] == "<p>X</p>"
_apply(st, api, "<p>Y</p>", fp=fp) # 새로 본 X 기준이면 적용된다
assert cafe.state["description"] == "<p>Y</p>"
def test_01_draft_value_is_not_treated_as_known():
"""[01] 예약 초안(DRAFT)은 카페24에 올라간 적이 없다 — 관리자가 그 값으로 고쳐도 외부 변경."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
_apply(st, api, "<p>W1</p>")
st.add_revision(product_no=131, html_content="<p>D</p>", revision_type="DRAFT")
cafe.external_edit("<p>D</p>")
assert _editor_view(st, cafe)[:2] == ("<p>D</p>", store.SYNC_EXTERNAL)
def test_01_read_lag_still_shows_last_confirmed_write():
"""읽기 지연 보정은 유지 — GET 이 쓰기 직전 값(A)을 돌려주면 마지막 확인된 쓰기를 보여준다."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
_apply(st, api, "<p>B</p>")
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
assert _editor_view(st, cafe)[:2] == ("<p>B</p>", store.SYNC_PENDING)
_apply(st, api, "<p>C</p>") # A→B→C 직후 GET 이 A 여도 지연
assert _editor_view(st, cafe)[:2] == ("<p>C</p>", store.SYNC_PENDING)
def test_01_revert_after_our_write_detected_by_updated_date():
"""[01] 관리자가 우리 적용 뒤 예전 값(A)으로 되돌림 — updated_date 가 더 뒤라 외부 변경."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
_apply(st, api, "<p>B</p>")
cafe.external_edit("<p>A</p>")
assert _editor_view(st, cafe)[:2] == ("<p>A</p>", store.SYNC_EXTERNAL)
def test_01_failed_write_is_not_lineage():
"""[01] 카페24가 거절한 쓰기는 "마지막 쓰기"가 아니다."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
cafe.put_error = Cafe24ApiError("거절", status=422)
try:
_apply(st, api, "<p>B</p>")
raise AssertionError("실패를 삼켰다")
except writes.RemoteWriteFailed:
pass
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
assert _editor_view(st, cafe)[:2] == ("<p>A</p>", store.SYNC_NONE)
assert st.of_type(store.REVISION_MANUAL) == []
def test_02_second_writer_is_serialized_and_detects_conflict():
"""[02] 같은 편집 기준(A)으로 두 사람이 동시에 적용 — 잠금으로 순서가 생기고 뒤 사람은 충돌."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
fp_a = store.fingerprint("<p>A</p>")
with writes.write_lock(st, "product:131", actor="alice", purpose="t", wait_seconds=0):
try: # 앞 사람이 쓰는 동안 뒤 사람은 잠금을 못 잡는다
with writes.write_lock(st, "product:131", actor="bob", purpose="t", wait_seconds=0):
raise AssertionError("잠금이 겹쳤다")
except writes.WriteBusy as exc:
assert "alice" in str(exc)
_apply(st, api, "<p>ALICE</p>", fp=fp_a, actor="alice")
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
try: # GET 이 지연으로 A 를 돌려줘도, 마지막 확인된 쓰기(ALICE)가 기준이라 충돌
_apply(st, api, "<p>BOB</p>", fp=fp_a, actor="bob")
raise AssertionError("둘 다 성공했다")
except writes.WriteConflict:
pass
assert cafe.state["description"] == "<p>ALICE</p>"
def test_02_expired_lock_cannot_write_fencing():
"""[02] 잠금이 만료돼 남에게 넘어간 뒤에는 PUT 하지 않는다(펜싱)."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
with writes.write_lock(st, "product:131", actor="slow", purpose="t", wait_seconds=0) as lock:
st.expire_lock("product:131")
with writes.write_lock(st, "product:131", actor="other", purpose="t", wait_seconds=0):
pass # 만료 뒤 다른 요청이 가져갔다가 풀었다
try:
writes.write_product(st, api, 131, lock=lock, origin="MANUAL", actor="slow",
html="<p>S</p>", wait_confirm=False)
raise AssertionError("만료된 잠금으로 썼다")
except writes.WriteBusy:
pass
assert cafe.puts() == []
def test_02_schema_missing_refuses_to_write():
st = fakes.MemoryStore()
st.schema_ok = False
try:
with writes.write_lock(st, "product:131", actor="k", purpose="t"):
raise AssertionError("스키마 없이 잠금을 줬다")
except writes.WriteSetupError as exc:
assert "005" in str(exc)
def test_06_manual_backup_marks_source():
"""[06] BACKUP 메타데이터 — 관측값(OBSERVED) / 지연 중 마지막 확인된 쓰기(LAST_WRITE)."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
first = _apply(st, api, "<p>B</p>")
b1 = st.revisions[first.backup_id]
assert (b1["html_content"], b1["source"]) == ("<p>A</p>", store.SOURCE_OBSERVED)
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
second = _apply(st, api, "<p>C</p>")
b2 = st.revisions[second.backup_id]
assert (b2["html_content"], b2["source"]) == ("<p>B</p>", store.SOURCE_LAST_WRITE)
assert b2["source_revision_id"] == first.revision_id
def test_07_manual_record_failure_is_not_apply_failure():
"""[07] PUT 성공 뒤 버전 기록 실패 — 예외 없이 record_error, 시도는 REMOTE_OK(기록 복구 대기)."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
st.fail_on.add("record_attempt_revision")
out = _apply(st, api, "<p>B</p>")
assert out.record_error and not out.revision_id
attempt = st.attempts[out.attempt_id]
assert attempt["status"] == store.ATTEMPT_REMOTE_OK and attempt["target_html"] == "<p>B</p>"
# 기록이 없어도 확인된 쓰기로 본다 — 지연 중에도 B 를 보여준다
cafe.stale = {**cafe.state, "description": "<p>A</p>", "updated_date": "2026-09-30T09:00:00+09:00"}
assert _editor_view(st, cafe)[:2] == ("<p>B</p>", store.SYNC_PENDING)
# 다음 쓰기 때 기록을 채운다(다시 PUT 하지 않음)
st.fail_on.clear()
puts = len(cafe.puts())
cafe.stale = None
_apply(st, api, "<p>C</p>")
assert attempt["status"] == store.ATTEMPT_RECORDED and attempt["target_html"] == ""
assert len(cafe.puts()) == puts + 1 # C 쓰기 한 번뿐
def test_07_unknown_result_blocks_rewrite_until_verified():
"""[07] 응답 유실 — UNKNOWN. 확정 전에는 같은 상품 상세설명을 다시 쓰지 않는다.
카페24 값이 그 시도의 결과와 같아지면(=반영됨) 자동으로 확정한다."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
cafe.put_error = fakes.network_error(maybe_applied=True)
try:
_apply(st, api, "<p>B</p>")
raise AssertionError("결과 모름을 성공/실패로 판정했다")
except writes.RemoteWriteUnknown as exc:
aid = exc.attempt_id
assert st.attempts[aid]["status"] == store.ATTEMPT_UNKNOWN
cafe.put_error = None
try:
_apply(st, api, "<p>C</p>")
raise AssertionError("결과 모름 시도가 있는데 또 썼다")
except writes.WriteBlocked:
pass
cafe.state.update(description="<p>B</p>") # 확인해 보니 반영돼 있었다
_apply(st, api, "<p>C</p>")
assert st.attempts[aid]["status"] == store.ATTEMPT_RECORDED
assert [r["html_content"] for r in st.of_type(store.REVISION_MANUAL)] == ["<p>B</p>", "<p>C</p>"]
def test_07_connect_error_is_definite_failure():
"""연결조차 안 된 오류는 반영 안 됨이 확실 — UNKNOWN 이 아니라 REMOTE_FAILED."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
cafe.put_error = fakes.network_error(maybe_applied=False)
try:
_apply(st, fakes.FakeApi(cafe), "<p>B</p>")
except writes.RemoteWriteFailed:
pass
assert list(st.attempts.values())[-1]["status"] == store.ATTEMPT_REMOTE_FAILED
def test_rollback_records_rollback_revision():
"""[13] 선택 복원은 정상 경로로 한 번 적용하고 ROLLBACK(원본 버전 표시)을 남긴다."""
st = fakes.MemoryStore()
cafe = fakes.FakeCafe24("<p>A</p>")
api = fakes.FakeApi(cafe)
first = _apply(st, api, "<p>B</p>")
backup = first.backup_id # A
out = _apply(st, api, st.revisions[backup]["html_content"], fp=store.fingerprint("<p>B</p>"),
origin=store.ORIGIN_ROLLBACK, target_revision_id=backup, memo=f"버전 {backup} 복원")
assert cafe.state["description"] == "<p>A</p>"
rb = st.revisions[out.revision_id]
assert rb["revision_type"] == "ROLLBACK" and rb["source_revision_id"] == backup
assert rb["html_content"] == "<p>A</p>"
# ════════════════════════════════════════════════════════════
# 스냅샷 병합 · 품목 표기 · 옵션 모양 — [10][11]
# ════════════════════════════════════════════════════════════
def test_11_variant_snapshot_field_merge():
at = now_kst().isoformat()
a = store.merge_variant_snapshot({}, {"V1": {"custom_variant_code": "C1"}}, at=at)
b = store.merge_variant_snapshot(a, {"V1": {"display": "F"}}, at=at)
assert b["V1"]["custom_variant_code"] == "C1" and b["V1"]["display"] == "F"
def test_11_empty_patch_is_not_reset_but_replace_is():
at = now_kst().isoformat()
a = store.merge_variant_snapshot({}, {"V1": {"display": "F"}}, at=at)
assert store.merge_variant_snapshot(a, {}, at=at) == a
assert store.merge_variant_snapshot(a, {}, at=at, replace=True) == {}
def test_11_deleted_variant_is_not_resurrected():
at = now_kst().isoformat()
a = store.merge_variant_snapshot({}, {"V1": {"_deleted": True}}, at=at)
b = store.merge_variant_snapshot(a, {"V1": {"display": "T", "custom_variant_code": "X"}}, at=at)
assert b["V1"].get("_deleted") is True and "custom_variant_code" not in b["V1"]
v = store.apply_variant_patch({"variant_code": "V1"}, b["V1"], section_written_at=at, grace_minutes=60)
assert v is None
def test_11_per_code_grace():
old = (now_kst() - timedelta(hours=10)).isoformat()
patch = {"display": "F", "_at": old}
v = store.apply_variant_patch({"variant_code": "V1", "display": "T"}, patch,
section_written_at=now_kst().isoformat(), grace_minutes=60)
assert v["display"] == "T" # 그 품목 기록은 유예시간이 지났다
def test_10_lagging_variant_labels_matched_by_code():
"""[10] 옵션값 이름 변경 직후 GET 품목이 옛 이름 — 품목코드 기록으로 새 이름을 보여준다."""
at = now_kst().isoformat()
patch = {"options": [{"name": "색상", "value": "Jet"}], "_options_before": [[{"name": "색상", "value": "Black"}]],
"_at": at}
lag = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Black"}]},
patch, section_written_at=at, grace_minutes=60)
assert lag["options"] == [{"name": "색상", "value": "Jet"}]
ext = store.apply_variant_patch({"variant_code": "V1", "options": [{"name": "색상", "value": "Onyx"}]},
patch, section_written_at=at, grace_minutes=60)
assert ext["options"] == [{"name": "색상", "value": "Onyx"}] # 관리자에서 다시 고친 이름은 믿는다
def test_10_options_overlay_respects_external_change():
at = now_kst().isoformat()
before = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Black"}]}]}
ours = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Jet"}]}]}
other = {"has_option": "T", "options": [{"option_name": "색상", "option_value": [{"option_text": "Onyx"}]}]}
snap = {**ours, "_before_signatures": [store.options_signature(before)]}
assert store.overlay_options(before, snapshot=snap, written_at=at, grace_minutes=60) == (snap, True)
assert store.overlay_options(other, snapshot=snap, written_at=at, grace_minutes=60) == (other, False)
assert store.overlay_options(ours, snapshot=snap, written_at=at, grace_minutes=60) == (ours, False)
def test_05_recovery_decision_table():
rd = store.recovery_decision
assert rd(None, 0)[0] == store.RECOVER_RETRY
assert rd(None, store.MAX_RETRY)[0] == store.RECOVER_FAIL
assert rd({"status": "RECORDED"}, 0)[0] == store.RECOVER_SUCCESS
assert rd({"status": "REMOTE_OK"}, 0)[0] == store.RECOVER_RECORD
assert rd({"status": "REMOTE_FAILED"}, 0)[0] == store.RECOVER_RETRY
assert rd({"status": "STARTED"}, 0)[0] == store.RECOVER_REVIEW
assert rd({"status": "UNKNOWN"}, 99)[0] == store.RECOVER_REVIEW # 예산과 무관하게 사람 확인
def test_resolve_description_updated_date_rule():
lw = {"html_content": "B", "created_at": now_kst(), "remote_updated_at": "2026-09-30T10:05:00+09:00"}
digests = {store.content_digest("A")}
newer = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
fetched_updated="2026-09-30T10:06:00+09:00")
same = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
fetched_updated="2026-09-30T10:05:00+09:00")
older = store.resolve_description("A", last_write=lw, known_digests=digests, grace_minutes=60,
fetched_updated="2026-09-30T10:00:00+09:00")
assert newer == ("A", store.SYNC_EXTERNAL)
assert same == ("B", store.SYNC_PENDING) and older == ("B", store.SYNC_PENDING)
# ════════════════════════════════════════════════════════════
# 품목 일괄 수정 행별 결과 — [09]
# ════════════════════════════════════════════════════════════
class _ChunkClient:
def __init__(self, fail_chunk: int, error):
self.fail_chunk = fail_chunk
self.error = error
self.n = 0
def put(self, path, *, json=None, **kw):
self.n += 1
if self.n == self.fail_chunk:
raise self.error
return {"variants": [{"variant_code": r["variant_code"], "display": r.get("display")} for r in json["requests"]]}
def _codes(n):
return [{"variant_code": f"P0000000{i:04d}", "display": "F"} for i in range(n)]
def test_09_partial_chunk_failure_reports_per_row():
rows = products.update_variants(_ChunkClient(2, Cafe24ApiError("거절", status=422)), 7, _codes(150))
assert [r["status"] for r in rows[:100]] == ["ok"] * 100
assert [r["status"] for r in rows[100:]] == ["failed"] * 50
assert rows[0]["variant"]["display"] == "F" and rows[120]["error"] == "거절"
def test_09_first_chunk_failure_still_sends_second():
client = _ChunkClient(1, fakes.network_error(maybe_applied=True))
rows = products.update_variants(client, 7, _codes(150))
assert client.n == 2
assert {r["status"] for r in rows[:100]} == {"unknown"}
assert {r["status"] for r in rows[100:]} == {"ok"}
# ════════════════════════════════════════════════════════════
# 전송 계층 — 쓰기 요청이 카페24에 닿았을 수 있는가(maybe_applied)
# ════════════════════════════════════════════════════════════
def _client_with(handler):
import httpx
from app.integrations.cafe24 import client as client_mod
class _Tokens:
def get_access_token(self):
return "AT"
def force_expire(self):
pass
real = httpx.Client
transport = httpx.MockTransport(handler)
client_mod.httpx.Client = lambda **kw: real(transport=transport, **kw)
client_mod.time.sleep = lambda *_a, **_k: None
return client_mod.Cafe24Client(_config(), _Tokens(), min_interval=0), (client_mod, real)
def _restore(saved):
client_mod, real = saved
client_mod.httpx.Client = real
def test_client_maybe_applied_classification():
import httpx
cases = [
("PUT", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), True),
("PUT", lambda req: (_ for _ in ()).throw(httpx.ConnectError("c", request=req)), False),
("PUT", lambda req: httpx.Response(500, json={"error": {"message": "서버"}}), True),
("PUT", lambda req: httpx.Response(422, json={"error": {"message": "검증"}}), False),
("GET", lambda req: (_ for _ in ()).throw(httpx.ReadTimeout("t", request=req)), False),
]
for method, handler, expected in cases:
client, saved = _client_with(handler)
try:
client.request(method, "/admin/products/1", json={"request": {}} if method == "PUT" else None)
raise AssertionError("오류가 나야 한다")
except Cafe24ApiError as exc:
assert exc.maybe_applied is expected, (method, expected, str(exc))
finally:
_restore(saved)
def _run_all():
fns = [v for k, v in sorted(globals().items()) if k.startswith("test_") and callable(v)]
for fn in fns:
+223 -119
View File
@@ -8,14 +8,28 @@
웹 요청 안에서 기다리는 방식은 프록시 타임아웃·재기동에 그대로 무너진다.
compose 서비스 `dbx-cafe24-worker` 가 web 과 같은 이미지로 이 모듈을 돌린다.
한 번에 한 건씩 처리한다
`claim_due_schedule` 이 `FOR UPDATE SKIP LOCKED` 로 한 건을 잠그고 PROCESSING 으로
바꾼다. worker 가 실수로 두 개 떠도 같은 예약이 두 번 적용되지 않는다.
한 번에 한 건씩, lease 로 잡는다 (마이그레이션 005)
`claim_due_schedule` 이 `FOR UPDATE SKIP LOCKED` 로 한 건을 잡아 PROCESSING + lease
(만료 시각·token)로 바꾼다. worker 가 여럿이어도 같은 예약을 두 번 잡지 않는다.
카페24에 쓰기 직전 lease 를 연장해 "아직 내 것인가"를 확인하고(펜싱), 결과는
token 이 맞을 때만 남긴다 — 만료 뒤 늦게 끝난 worker 가 남의 결과를 덮지 않는다.
적용 순서는 화면 편집과 같다
카페24 현재값 재조회 → BACKUP revision → PUT → SUCCESS + 감사로그
실패하면 재시도 예산(store.MAX_RETRY) 안에서 간격을 두고 다시 시도하고,
소진되면 FAILED 로 확정한다. 되돌리기는 쓰지 않는다.
적용 순서는 화면 편집과 같다 (writes.write_product 공용)
상품 잠금 → 카페24 현재값 재조회 → 유효 현재값(읽기 지연 보정) → BACKUP
→ 시도 기록 → PUT → 버전(SCHEDULED)·스냅샷 기록
예약 직전 백업도 읽기 지연을 보정한 값이다(카페24가 아직 옛 HTML 을 돌려줘도
그것을 "직전 내용"으로 남기지 않는다). 백업의 source 로 관측값/확인된 적용값을 구분한다.
결과 분류
카페24가 거절 → 재시도 예산(store.MAX_RETRY) 안에서 간격을 두고 다시, 소진되면 FAILED
반영 여부 모름 → NEEDS_REVIEW (자동 재적용 금지 — 사람이 쇼핑몰을 보고 확정)
반영 성공·기록 실패 → SUCCESS + "기록 복구 필요" 메모. 기록은 다음 주기에 채운다(재적용 없음)
같은 상품을 다른 작업이 쓰는 중 → 재시도 횟수를 쓰지 않고 잠시 뒤 다시
중단 복구 (recover)
lease 가 만료된 PROCESSING 은 그 예약의 마지막 쓰기 시도를 보고 판정한다
(store.recovery_decision). 무조건 PENDING 으로 돌리지 않는다 — 카페24에 이미 반영됐을
수 있기 때문이다. 카페24 현재값이 예약 결과와 같으면 반영된 것으로 확정한다.
토큰 갱신은 TokenService 가 행 잠금 안에서 하므로 web 과 동시에 떠 있어도 안전하다.
"""
@@ -25,6 +39,7 @@ from __future__ import annotations
import argparse
import logging
import os
import socket
import sys
import time
from datetime import timedelta
@@ -33,141 +48,230 @@ from typing import Any
from app.integrations.cafe24 import Cafe24Error, build_cafe24_api, products
from app.timezone import now_kst
from . import store
from . import store, writes
from .common import read_lag_grace_minutes
logger = logging.getLogger("cafe24.worker")
ACTOR = "SCHEDULER"
DEFAULT_LEASE_SEC = 600 # 한 건 처리(현재값 조회 + PUT + 확인)에 넉넉한 시간
LEGACY_PROCESSING_MIN = 30 # lease 컬럼이 없는 옛 PROCESSING 을 만료로 볼 시간
BUSY_RETRY_SECONDS = 30 # 같은 상품을 다른 작업이 쓰는 중일 때 다시 볼 간격
SETUP_RETRY_SECONDS = 300 # 마이그레이션 미적용 등 설정 문제일 때 다시 볼 간격
def _apply(store_db: Any, api: Any, row: dict[str, Any]) -> str:
"""예약 1건 적용. 성공 시 사람이 읽을 요약 문자열."""
def lease_seconds() -> int:
try:
value = int(str(os.getenv("CAFE24_SCHEDULE_LEASE_SEC") or "").strip())
except ValueError:
return DEFAULT_LEASE_SEC
return max(60, value)
def worker_owner() -> str:
return f"{ACTOR}|{socket.gethostname()}:{os.getpid()}"
def _summary(row: dict[str, Any]) -> str:
return store.describe_schedule_action(
has_html=bool(row.get("revision_id")),
set_display=row.get("set_display"),
set_selling=row.get("set_selling"),
)
def _retry_or_fail(st: Any, row: dict[str, Any], token: str, error: str) -> str:
"""재시도 예산 안이면 PENDING + 대기, 아니면 FAILED. 반환: 결과 상태."""
retry_count = int(row.get("retry_count") or 0)
schedule_id = int(row["id"])
if store.can_retry(retry_count):
wait = store.retry_backoff_seconds(retry_count)
st.finish_schedule(
schedule_id, token=token, status=store.STATUS_PENDING, error=error,
next_retry_at=now_kst() + timedelta(seconds=wait), retry_count=retry_count + 1,
)
logger.warning("예약 #%s 상품 %s 실패 — %s초 후 재시도 (%s/%s): %s",
schedule_id, row.get("product_no"), wait, retry_count + 1, store.MAX_RETRY, error)
return store.STATUS_PENDING
st.finish_schedule(schedule_id, token=token, status=store.STATUS_FAILED, error=error)
writes.audit_safe(st, actor=ACTOR, action="schedule_apply", product_no=row.get("product_no"),
schedule_id=schedule_id, result="FAIL", detail=error)
logger.error("예약 #%s 상품 %s 최종 실패: %s", schedule_id, row.get("product_no"), error)
return store.STATUS_FAILED
def run_one(st: Any, api: Any, row: dict[str, Any]) -> str:
"""lease 로 잡은 예약 1건 실행. 반환: 남긴 상태(또는 'LEASE_LOST')."""
schedule_id = int(row["id"])
product_no = int(row["product_no"])
token = str(row.get("lease_token") or "")
lease = lease_seconds()
revision_id = row.get("revision_id")
set_display = row.get("set_display")
set_selling = row.get("set_selling")
html: str | None = None
if revision_id:
revision = store_db.get_revision(int(revision_id))
if not revision:
raise Cafe24Error(f"예약이 가리키는 버전 {revision_id} 을 찾을 수 없습니다.")
html = revision.get("html_content") or ""
if not html.strip():
raise Cafe24Error(f"버전 {revision_id} 의 내용이 비어 있습니다.")
def fence() -> bool:
return bool(st.renew_schedule_lease(schedule_id, token, ttl_seconds=lease))
# 상세설명을 바꿀 때는 쓰기 직전 현재값을 읽어 백업한다(로컬 값을 믿지 않는다).
backup_id = 0
if html is not None:
current = products.fetch_descriptions(api.client, product_no)
backup_id = store_db.add_revision(
product_no=product_no,
html_content=current.description,
revision_type=store.REVISION_BACKUP,
memo=f"예약 #{schedule_id} 적용 직전 자동 백업",
created_by=ACTOR,
)
if current.mobile_description and current.mobile_description != current.description:
store_db.add_revision(
product_no=product_no,
html_content=current.mobile_description,
revision_type=store.REVISION_BACKUP,
memo=f"예약 #{schedule_id} 적용 직전 자동 백업 (모바일)",
created_by=ACTOR,
try:
html: str | None = None
if revision_id:
revision = st.get_revision(int(revision_id))
if not revision:
raise Cafe24Error(f"예약이 가리키는 버전 {revision_id} 을 찾을 수 없습니다.")
html = str(revision.get("html_content") or "")
if not html.strip():
raise Cafe24Error(f"버전 {revision_id} 의 내용이 비어 있습니다.")
with writes.write_lock(
st, writes.product_lock_key(product_no), actor=ACTOR,
purpose=f"예약 #{schedule_id} 실행", wait_seconds=0,
) as lock:
outcome = writes.write_product(
st, api, product_no,
lock=lock, origin=store.ORIGIN_SCHEDULED, actor=ACTOR, html=html,
set_display=set_display, set_selling=set_selling,
schedule_id=schedule_id, target_revision_id=int(revision_id) if revision_id else None,
memo=f"예약 #{schedule_id} 적용", extra_fence=fence,
)
except writes.WriteSetupError as exc:
st.finish_schedule(schedule_id, token=token, status=store.STATUS_PENDING, error=str(exc),
next_retry_at=now_kst() + timedelta(seconds=SETUP_RETRY_SECONDS))
logger.error("예약 #%s 실행 보류 — %s", schedule_id, exc)
return store.STATUS_PENDING
except writes.WriteBusy as exc:
# 다른 작업이 같은 상품을 쓰는 중이거나 lease 를 잃었다. 재시도 횟수를 쓰지 않는다.
# (lease 를 잃었으면 finish 는 token 이 안 맞아 아무것도 바꾸지 않는다.)
done = st.finish_schedule(schedule_id, token=token, status=store.STATUS_PENDING, error=str(exc),
next_retry_at=now_kst() + timedelta(seconds=BUSY_RETRY_SECONDS))
logger.info("예약 #%s 상품 %s 보류(%s): %s", schedule_id, product_no, "재대기" if done else "lease 잃음", exc)
return store.STATUS_PENDING if done else "LEASE_LOST"
except (writes.WriteBlocked, writes.RemoteWriteUnknown) as exc:
st.finish_schedule(schedule_id, token=token, status=store.STATUS_NEEDS_REVIEW, error=str(exc))
writes.audit_safe(st, actor=ACTOR, action="schedule_apply", product_no=product_no,
schedule_id=schedule_id, result="UNKNOWN", detail=str(exc))
logger.error("예약 #%s 상품 %s 확인 필요: %s", schedule_id, product_no, exc)
return store.STATUS_NEEDS_REVIEW
except (writes.RemoteWriteFailed, Cafe24Error) as exc:
return _retry_or_fail(st, row, token, str(exc))
except Exception as exc: # noqa: BLE001 — 카페24에 쓰기 전의 사고(원격 이후는 write_product 가 삼킨다)
logger.exception("예약 #%s 처리 중 예상치 못한 오류(카페24 쓰기 전)", schedule_id)
return _retry_or_fail(st, row, token, f"{type(exc).__name__}: {exc}")
# PC/모바일은 구분하지 않는다 — mobile_description 은 보내지 않고
# separated_mobile_description="F" 로 "PC 상세설명과 동일"을 강제한다.
# (mobile_description 을 직접 보내면 카페24가 그 설정을 "직접 등록"으로 바꿔버린다.)
updated = products.update_product(
api.client,
product_no,
description=html,
separated_mobile_description="F" if html is not None else None,
display=set_display,
selling=set_selling,
note = ""
if outcome.record_error:
note = f"카페24 반영 성공 · 로컬 기록 실패(자동 복구 예정, 재적용 안 함): {outcome.record_error}"
done = st.finish_schedule(schedule_id, token=token, status=store.STATUS_SUCCESS, error=note)
if not done:
# 반영은 됐다. 결과를 못 남겼어도 lease 만료 후 recover 가 시도 기록(REMOTE_OK/RECORDED)을
# 보고 SUCCESS 로 확정한다 — 다시 적용하지 않는다.
logger.warning("예약 #%s 적용됨 — 결과 기록 실패(lease 잃음). 복구 단계가 확정합니다.", schedule_id)
summary = _summary(row)
writes.audit_safe(
st, actor=ACTOR, action="schedule_apply", product_no=product_no,
revision_id=outcome.revision_id or (int(revision_id) if revision_id else None),
schedule_id=schedule_id, result="SUCCESS",
detail=summary + (f" (백업 {outcome.backup_id})" if outcome.backup_id else "")
+ (f" / {note}" if note else ""),
)
# PUT 응답은 쓰기 직후의 실제 값이다 — 스냅샷으로 남겨 화면이 GET 의 읽기 지연에
# 흔들리지 않게 한다(routes_products._load_product 가 덮어씌운다).
if isinstance(updated, dict) and updated.get("product_no"):
logger.info("예약 #%s 상품 %s 적용 완료 — %s", schedule_id, product_no, summary)
return store.STATUS_SUCCESS
def _verify_attempt(st: Any, api: Any, attempt: dict[str, Any]) -> bool:
"""카페24 현재값이 그 시도의 결과와 같은가(같으면 반영된 것으로 확정해도 된다)."""
try:
product = products.get_product(api.client, int(attempt["product_no"]))
except Cafe24Error as exc:
logger.warning("시도 #%s 확인용 조회 실패: %s", attempt.get("id"), exc)
return False
return writes.attempt_matches_remote(attempt, product)
def recover_one(st: Any, api: Any, row: dict[str, Any]) -> str:
"""lease 만료 PROCESSING 1건 복구 판정 — 반환: 남긴 상태."""
schedule_id = int(row["id"])
token = str(row.get("lease_token") or "")
attempt = st.latest_attempt_for_schedule(schedule_id) or None
decision, note = store.recovery_decision(attempt, row.get("retry_count"))
note = f"중단 복구: {note}"
if decision == store.RECOVER_REVIEW and attempt:
try:
store_db.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
except Exception: # noqa: BLE001 — 스냅샷 실패가 예약 결과를 바꾸면 안 된다.
logger.exception("예약 #%s 상품 %s 스냅샷 저장 실패", schedule_id, product_no)
if html is not None:
# 화면 편집(apply)과 동일 — 카페24 관리자 API 의 쓰기 직후 읽기 지연을
# 여기서 짧게 흡수한다(쇼핑몰에는 바로 반영되지만 관리자 조회만 뒤쳐질 때가 있다).
# 확인이 안 돼도 실패가 아니다 — 화면은 마지막 쓰기(SCHEDULED revision)를 기준으로
# 그린다. 여기서 SCHEDULED revision 을 남겨야 그 기준이 생긴다.
products.wait_for_description(api.client, product_no, html)
store_db.add_revision(
product_no=product_no,
html_content=html,
revision_type=store.REVISION_SCHEDULED,
memo=f"예약 #{schedule_id} 적용",
created_by=ACTOR,
)
with writes.write_lock(st, writes.product_lock_key(int(row["product_no"])), actor=ACTOR,
purpose=f"예약 #{schedule_id} 복구 확인", wait_seconds=0):
if _verify_attempt(st, api, attempt):
st.update_attempt(int(attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
resolved_by="auto:카페24 값이 예약 결과와 같음",
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN))
decision, note = store.RECOVER_RECORD, "중단 복구: 카페24 현재값이 예약 결과와 같아 반영됨으로 확정"
except writes.WriteBusy:
pass # 다음 주기에 다시 — 판정은 REVIEW 로 남긴다
if decision == store.RECOVER_RECORD and attempt:
try:
writes.record_attempt(st, attempt)
except Exception as exc: # noqa: BLE001 — 반영은 됐다. 기록은 다음 주기에.
logger.exception("예약 #%s 복구 중 버전 기록 실패", schedule_id)
note += f" (버전 기록 실패 — 자동 재시도: {type(exc).__name__})"
decision = store.RECOVER_SUCCESS
summary = store.describe_schedule_action(
has_html=html is not None, set_display=set_display, set_selling=set_selling
if decision == store.RECOVER_SUCCESS:
st.finish_schedule(schedule_id, token=token, status=store.STATUS_SUCCESS, error=note)
status = store.STATUS_SUCCESS
elif decision == store.RECOVER_REVIEW:
st.finish_schedule(schedule_id, token=token, status=store.STATUS_NEEDS_REVIEW, error=note)
status = store.STATUS_NEEDS_REVIEW
else:
status = _retry_or_fail(st, row, token, note)
writes.audit_safe(st, actor=ACTOR, action="schedule_recover", product_no=row.get("product_no"),
schedule_id=schedule_id, result=status, detail=note)
logger.warning("예약 #%s 중단 복구 → %s (%s)", schedule_id, status, note)
return status
def record_pending_attempts(st: Any) -> int:
"""카페24에 반영됐는데 버전 기록이 빠진 시도(REMOTE_OK)의 기록을 채운다."""
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
done = 0
for attempt in st.attempts_needing_record(since=since):
try:
with writes.write_lock(st, writes.product_lock_key(int(attempt["product_no"])), actor=ACTOR,
purpose="기록 복구", wait_seconds=0):
writes.record_attempt(st, attempt)
done += 1
except writes.WriteBusy:
continue
except Exception: # noqa: BLE001
logger.exception("시도 #%s 기록 복구 실패", attempt.get("id"))
return done
def recover(st: Any, api: Any) -> int:
"""중단 복구 — 기록 복구 + lease 만료 PROCESSING 판정. 처리 건수."""
count = record_pending_attempts(st)
rows = st.claim_expired_schedules(
owner=worker_owner(), ttl_seconds=lease_seconds(), legacy_minutes=LEGACY_PROCESSING_MIN
)
store_db.log_audit(
actor=ACTOR,
action="schedule_apply",
product_no=product_no,
revision_id=int(revision_id) if revision_id else None,
schedule_id=schedule_id,
result="SUCCESS",
detail=summary + (f" (백업 {backup_id})" if backup_id else ""),
)
return summary
for row in rows:
try:
recover_one(st, api, row)
except Exception: # noqa: BLE001 — 한 건 때문에 나머지를 멈추지 않는다(lease 만료 후 다시)
logger.exception("예약 #%s 복구 중 오류", row.get("id"))
count += 1
return count
def process_once(store_db: Any, api: Any) -> int:
"""실행할 예약을 모두 처리한다. 처리한 건수를 돌려준다."""
def process_once(st: Any, api: Any) -> int:
"""중단 복구 후, 실행할 예약을 모두 처리한다. 처리한(잡은) 예약 건수를 돌려준다."""
try:
recover(st, api)
except Exception: # noqa: BLE001 — 복구 실패가 새 예약 실행을 막지 않게
logger.exception("중단 복구 단계 오류 — 다음 주기에 다시 시도")
handled = 0
while True:
with store_db.claim_due_schedule(now=now_kst()) as row:
if row is None:
return handled
# 잠금은 여기서 이미 풀렸다. 상태가 PROCESSING 이라 다른 worker 가 집지 않는다.
schedule_id = int(row["id"])
product_no = int(row["product_no"])
try:
summary = _apply(store_db, api, row)
except Cafe24Error as exc:
retry_count = int(row.get("retry_count") or 0)
if store.can_retry(retry_count):
wait = store.retry_backoff_seconds(retry_count)
store_db.finish_schedule(
schedule_id,
status=store.STATUS_PENDING,
error=str(exc),
next_retry_at=now_kst() + timedelta(seconds=wait),
retry_count=retry_count + 1,
)
logger.warning(
"예약 #%s 상품 %s 실패 — %s초 후 재시도 (%s/%s): %s",
schedule_id, product_no, wait, retry_count + 1, store.MAX_RETRY, exc,
)
else:
store_db.finish_schedule(
schedule_id, status=store.STATUS_FAILED, error=str(exc)
)
store_db.log_audit(
actor=ACTOR, action="schedule_apply", product_no=product_no,
schedule_id=schedule_id, result="FAIL", detail=str(exc),
)
logger.error("예약 #%s 상품 %s 최종 실패: %s", schedule_id, product_no, exc)
except Exception as exc: # noqa: BLE001 — 한 건의 사고가 worker 를 죽이면 안 된다.
store_db.finish_schedule(
schedule_id, status=store.STATUS_FAILED, error=f"{type(exc).__name__}: {exc}"
)
logger.exception("예약 #%s 처리 중 예상치 못한 오류", schedule_id)
else:
store_db.finish_schedule(schedule_id, status=store.STATUS_SUCCESS)
logger.info("예약 #%s 상품 %s 적용 완료 — %s", schedule_id, product_no, summary)
row = st.claim_due_schedule(now=now_kst(), owner=worker_owner(), ttl_seconds=lease_seconds())
if row is None:
return handled
run_one(st, api, row)
handled += 1
+531
View File
@@ -0,0 +1,531 @@
"""카페24 쓰기 공통 처리 — 잠금 · 유효 현재값 판정 · 백업 · 시도 기록 · 결과 분류.
상세설명(과 예약의 진열/판매)을 카페24에 쓰는 모든 경로 — 즉시 적용, 버전 복원,
예약 worker — 가 `write_product` 한 곳을 지난다. 경로마다 판정이 달라 생기던 문제
(예약 직전 백업이 지연된 옛 HTML 을 담는 등)를 막기 위해서다.
순서 (docs/CAFE24_MODULE.md 3-2, 3-5)
상품 잠금(DB lease) → 카페24 현재값 GET → 결과 모르는 이전 시도 확인
→ 유효 현재값(읽기 지연 보정) → BACKUP → 지문 대조(충돌 거부)
→ 잠금 펜싱 → 시도 기록(STARTED) → PUT
→ 원격 결과 분류(REMOTE_OK / REMOTE_FAILED / UNKNOWN)
→ 스냅샷 · 버전(MANUAL/SCHEDULED/ROLLBACK) 기록(RECORDED)
원칙
- 읽기 지연 판정의 근거는 **원격 반영이 확인된 쓰기**(cafe24_write_attempts 의
REMOTE_OK/RECORDED)뿐이다. 충돌로 거절된 적용의 백업·예약 초안은 넣지 않는다.
- PUT 이 성공한 뒤의 실패(스냅샷·버전 기록)는 "적용 실패"가 아니다. 결과에
record_error 로 알리고, 시도 기록(REMOTE_OK)에 남은 내용으로 나중에 복구한다.
재적용하지 않는다.
- 반영 여부를 모르는 시도(STARTED/UNKNOWN)가 남아 있으면 같은 상품 상세설명을
다시 쓰지 않는다(WriteBlocked). 카페24 값이 그 시도의 내용과 같으면 자동 확정.
- 잠금은 웹 여러 프로세스 + worker 가 공유하는 DB 표(cafe24_write_locks)다.
카페24 관리자 화면에서 사람이 동시에 고치는 것은 막을 수 없다 — 그것은 지문
대조(편집 시작 시점 값과 비교)로만 잡는다.
카페24 호출은 `app.integrations.cafe24` 만 쓴다(httpx 직접 호출 금지).
"""
from __future__ import annotations
import logging
import os
import socket
import time
from contextlib import contextmanager
from dataclasses import dataclass, field
from datetime import timedelta
from typing import Any, Callable, Iterator
from app.integrations.cafe24 import Cafe24Error, products
from app.timezone import now_kst
from . import store
from .common import read_lag_grace_minutes
logger = logging.getLogger("cafe24.writes")
DEFAULT_LOCK_TTL_SEC = 300 # 이미지 업로드(최대 120초 × 재시도)도 담을 만큼
DEFAULT_LOCK_WAIT_SEC = 3.0 # 웹 요청은 짧게만 기다린다 — 오래 걸리면 "수정 중" 안내
def _env_number(name: str, default: float) -> float:
try:
value = float(str(os.getenv(name) or "").strip())
except ValueError:
return default
return value if value >= 0 else default
def lock_ttl_seconds() -> int:
return max(30, int(_env_number("CAFE24_WRITE_LOCK_TTL_SEC", DEFAULT_LOCK_TTL_SEC)))
def lock_wait_seconds() -> float:
return min(30.0, _env_number("CAFE24_WRITE_LOCK_WAIT_SEC", DEFAULT_LOCK_WAIT_SEC))
# ════════════════════════════════════════════════════════════
# 예외 — http_status 는 JSON API 가 그대로 쓴다
# ════════════════════════════════════════════════════════════
class WriteError(Exception):
http_status = 500
def __init__(self, message: str, *, backup_id: int = 0, attempt_id: int = 0):
super().__init__(message)
self.backup_id = backup_id
self.attempt_id = attempt_id
class WriteSetupError(WriteError):
"""마이그레이션 005 미적용 등 — 안전장치 없이 쓰지 않는다."""
http_status = 503
class WriteBusy(WriteError):
"""다른 요청(또는 예약 실행)이 같은 대상을 쓰는 중이거나, 잠금을 잃었다."""
http_status = 409
class WriteConflict(WriteError):
"""편집 시작 뒤 카페24 값이 바뀌었다(지문 불일치)."""
http_status = 409
class WriteBlocked(WriteError):
"""반영 여부를 모르는 이전 시도가 남아 있다 — 사람이 확정하기 전에는 쓰지 않는다."""
http_status = 409
def __init__(self, message: str, *, attempts: list[dict[str, Any]] | None = None, **kw: Any):
super().__init__(message, **kw)
self.attempts = attempts or []
class RemoteWriteFailed(WriteError):
"""카페24가 거절 — 반영되지 않은 것이 확실하다."""
http_status = 502
class RemoteWriteUnknown(WriteError):
"""요청이 도달했을 수 있으나 응답을 못 받았다 — 반영 여부를 모른다. 재적용 금지."""
http_status = 502
# ════════════════════════════════════════════════════════════
# 잠금
# ════════════════════════════════════════════════════════════
def product_lock_key(product_no: int) -> str:
return f"product:{int(product_no)}"
def design_lock_key(file_key: str) -> str:
return f"design:{file_key}"
def lock_owner(actor: str) -> str:
"""잠금 소유자 표기 — '사람|호스트:pid'. 안내 문구에는 '|' 앞(사람)만 쓴다."""
return f"{actor or '-'}|{socket.gethostname()}:{os.getpid()}"
def require_schema(st: Any) -> None:
try:
ok = st.write_schema_ready()
except Exception as exc: # noqa: BLE001 — DB 접속 실패도 "쓰지 않음"으로
raise WriteSetupError(f"cafe24_db 상태를 확인하지 못해 카페24에 쓰지 않았습니다: {type(exc).__name__}") from exc
if not ok:
raise WriteSetupError(
"cafe24_db 마이그레이션 005(쓰기 안전장치)가 적용되지 않아 카페24에 쓰지 않았습니다. "
"관리자에게 scripts/sql/cafe24_db_005_write_safety.sql 적용을 요청하세요."
)
@dataclass
class WriteLock:
st: Any
key: str
token: str
ttl: int
def still_mine(self) -> bool:
"""아직 내 잠금이면 연장하고 True(펜싱). 만료돼 넘어갔으면 False."""
try:
return bool(self.st.renew_lock(self.key, self.token, ttl_seconds=self.ttl))
except Exception: # noqa: BLE001 — 확인할 수 없으면 쓰지 않는다
logger.exception("잠금 연장 실패 %s", self.key)
return False
@contextmanager
def write_lock(
st: Any,
key: str,
*,
actor: str,
purpose: str,
wait_seconds: float | None = None,
ttl_seconds: int | None = None,
) -> Iterator[WriteLock]:
"""DB 잠금을 잡은 채 작업한다. 못 잡으면 WriteBusy, 스키마가 없으면 WriteSetupError."""
require_schema(st)
ttl = int(ttl_seconds or lock_ttl_seconds())
wait = lock_wait_seconds() if wait_seconds is None else max(0.0, float(wait_seconds))
deadline = time.monotonic() + wait
while True:
token = st.acquire_lock(key, owner=lock_owner(actor), purpose=purpose, ttl_seconds=ttl)
if token:
break
if time.monotonic() >= deadline:
raise WriteBusy(_busy_message(st, key))
time.sleep(0.25)
lock = WriteLock(st=st, key=key, token=token, ttl=ttl)
try:
yield lock
finally:
try:
st.release_lock(key, token)
except Exception: # noqa: BLE001 — 못 풀어도 만료되면 풀린다
logger.exception("잠금 해제 실패 %s (만료 후 자동 해제)", key)
def _busy_message(st: Any, key: str) -> str:
try:
holder = st.lock_holder(key) or {}
except Exception: # noqa: BLE001
holder = {}
who = str(holder.get("owner") or "").split("|", 1)[0]
what = str(holder.get("purpose") or "")
detail = " · ".join(p for p in (what, who) if p and p != "-")
return "다른 작업이 같은 대상을 수정하고 있습니다" + (f"({detail})" if detail else "") + ". 잠시 후 다시 시도하세요."
# ════════════════════════════════════════════════════════════
# 유효 현재값 — 읽기 지연 보정 (확인된 쓰기만 근거)
# ════════════════════════════════════════════════════════════
def resolve_effective(
st: Any, product_no: int, cafe24_html: str, *, fetched_updated: object = None
) -> tuple[str, str, dict[str, Any] | None]:
"""(유효 HTML, 상태 store.SYNC_*, 마지막 확인된 쓰기)."""
grace = read_lag_grace_minutes()
since = now_kst() - timedelta(minutes=grace)
lineage = st.write_lineage(product_no, since=since)
if not lineage:
return cafe24_html, store.SYNC_NONE, None
last = lineage[0]
effective, state = store.resolve_description(
cafe24_html,
last_write=last,
known_digests=store.lineage_digests(lineage),
grace_minutes=grace,
fetched_updated=fetched_updated,
)
return effective, state, last
# ════════════════════════════════════════════════════════════
# 기록 — PUT 성공 뒤의 로컬 저장(실패해도 "적용 실패"가 아니다)
# ════════════════════════════════════════════════════════════
def remember_product_write(st: Any, product_no: int, updated: dict[str, Any]) -> tuple[dict[str, Any], str]:
"""PUT 응답(상품 dict)을 캐시·스냅샷에 남긴다. (정규화된 상품 행, 기록 오류 문자열)."""
info = products.normalize_product(updated) if updated else {}
if not info.get("product_no"):
return info, ""
try:
st.upsert_products([info])
st.save_write_snapshot(product_no, "product", store.product_snapshot(updated))
except Exception as exc: # noqa: BLE001 — 카페24에는 이미 반영됐다
logger.exception("상품 %s 쓰기 스냅샷 저장 실패", product_no)
return info, f"{type(exc).__name__}: {exc}"
return info, ""
def audit_safe(st: Any, **fields: Any) -> None:
"""감사로그 — 실패해도 호출부 결과를 바꾸지 않는다(이미 카페24에 반영된 뒤일 수 있다)."""
try:
st.log_audit(**fields)
except Exception: # noqa: BLE001
logger.exception("감사로그 기록 실패: %s", fields.get("action"))
def record_attempt(st: Any, attempt: dict[str, Any]) -> int:
"""원격 반영된 시도의 버전을 남기고 RECORDED 로 바꾼다(이미 있으면 그 id). 멱등.
진열/판매만 바꾼 시도(상세설명 없음)는 버전을 만들지 않고 상태만 RECORDED 로 둔다.
"""
if not attempt.get("target_digest") and not attempt.get("target_revision_id"):
st.update_attempt(int(attempt["id"]), status=store.ATTEMPT_RECORDED, remote_ok=True)
return 0
origin = str(attempt.get("origin") or store.ORIGIN_MANUAL)
revision_type = store.ORIGIN_REVISION_TYPE.get(origin, "MANUAL")
source = store.SOURCE_REVISION if origin == store.ORIGIN_ROLLBACK else ""
source_revision = attempt.get("target_revision_id") if origin != store.ORIGIN_MANUAL else None
return int(st.record_attempt_revision(
int(attempt["id"]),
revision_type=revision_type,
memo=str(attempt.get("memo") or ""),
created_by=str(attempt.get("actor") or ""),
source=source,
source_revision_id=int(source_revision) if source_revision else None,
))
def _flags_match(product: dict[str, Any], attempt: dict[str, Any]) -> bool:
for key in ("set_display", "set_selling"):
want = attempt.get(key)
if want is None:
continue
field_name = key.replace("set_", "")
if products._flag(product.get(field_name)) != bool(want): # noqa: SLF001 — 같은 규칙
return False
return True
def attempt_matches_remote(attempt: dict[str, Any], product: dict[str, Any]) -> bool:
"""카페24 현재값이 그 시도가 쓰려던 결과와 같은가(같으면 결과를 "반영됨"으로 확정해도 된다)."""
if not product:
return False
digest = str(attempt.get("target_digest") or "")
if digest and store.content_digest(str(product.get("description") or "")) != digest:
return False
if not digest and attempt.get("set_display") is None and attempt.get("set_selling") is None:
return False
return _flags_match(product, attempt)
def settle_open_attempts(
st: Any, product_no: int, *, product: dict[str, Any], actor: str = "SYSTEM"
) -> list[dict[str, Any]]:
"""열린 시도를 정리하고 **아직 결과를 모르는 것**만 돌려준다. 잠금 안에서 부른다.
REMOTE_OK → 버전 기록을 채운다(기록 복구)
STARTED / UNKNOWN → 카페24 현재값이 그 시도의 결과와 같으면 반영됨으로 확정
(예약이 "확인 필요"였다면 완료로 바꾼다). 다르면 남긴다.
"""
since = now_kst() - timedelta(minutes=read_lag_grace_minutes())
unresolved: list[dict[str, Any]] = []
for attempt in st.open_attempts(product_no, since=since):
status = attempt.get("status")
if status == store.ATTEMPT_REMOTE_OK:
try:
record_attempt(st, attempt)
except Exception: # noqa: BLE001 — 원격은 반영됨. 다음 기회에 다시.
logger.exception("시도 #%s 기록 복구 실패", attempt.get("id"))
continue
if attempt_matches_remote(attempt, product):
st.update_attempt(
int(attempt["id"]), status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
resolved_by="auto:카페24 값이 요청 결과와 같음",
only_from=(store.ATTEMPT_STARTED, store.ATTEMPT_UNKNOWN),
)
try:
record_attempt(st, attempt)
except Exception: # noqa: BLE001
logger.exception("시도 #%s 기록 실패(자동 확정 후)", attempt.get("id"))
if attempt.get("schedule_id"):
st.review_schedule(
int(attempt["schedule_id"]), status=store.STATUS_SUCCESS,
note="자동 확인: 카페24 현재값이 예약 내용과 같습니다", actor=actor, action="auto_verify",
)
continue
unresolved.append(attempt)
return unresolved
def describe_attempt(attempt: dict[str, Any]) -> str:
origin = {store.ORIGIN_MANUAL: "즉시 적용", store.ORIGIN_SCHEDULED: "예약", store.ORIGIN_ROLLBACK: "복원"}.get(
str(attempt.get("origin") or ""), "적용")
when = str(attempt.get("created_at") or "").replace("T", " ")[:16]
who = str(attempt.get("actor") or "")
sched = f" · 예약 #{attempt['schedule_id']}" if attempt.get("schedule_id") else ""
return f"시도 #{attempt.get('id')} ({origin}{sched}, {when}{', ' + who if who else ''})"
# ════════════════════════════════════════════════════════════
# 본 처리
# ════════════════════════════════════════════════════════════
@dataclass
class WriteOutcome:
attempt_id: int = 0
backup_id: int = 0
revision_id: int = 0
changed: bool = True # False = 바뀐 것이 없어 PUT 하지 않음
pending: bool = False # 백업이 "마지막 확인된 쓰기" 기준이었나(카페24 읽기 지연)
recorded: bool = False # 버전 기록까지 끝났나
record_error: str = "" # PUT 성공 뒤 로컬 기록 실패 사유(재적용 금지 — 자동 복구)
confirmed: bool = False # PUT 뒤 GET 이 새 값을 돌려줬나
updated: dict[str, Any] = field(default_factory=dict)
def write_product(
st: Any,
api: Any,
product_no: int,
*,
lock: WriteLock,
origin: str,
actor: str,
html: str | None,
base_fingerprint: str | None = None,
set_display: bool | None = None,
set_selling: bool | None = None,
schedule_id: int | None = None,
target_revision_id: int | None = None,
memo: str = "",
skip_if_same: bool = False,
extra_fence: Callable[[], bool] | None = None,
wait_confirm: bool = True,
) -> WriteOutcome:
"""상세설명(html)·진열/판매를 카페24에 쓴다. 잠금(lock)을 잡은 채 부른다.
예외(아무것도 쓰지 않음): Cafe24Error(현재값 조회 실패), WriteBlocked, WriteConflict,
WriteBusy(펜싱 실패) / RemoteWriteFailed(거절) / RemoteWriteUnknown(반영 여부 모름).
PUT 성공 뒤의 로컬 기록 실패는 예외가 아니라 WriteOutcome.record_error 로 알린다.
"""
mall_id = str(getattr(api.config, "mall_id", "") or "")
shop_no = 1
out = WriteOutcome()
current_html: str | None = None
effective: str | None = None
if html is not None:
product = products.get_product(api.client, product_no)
if not product:
raise Cafe24Error("카페24에서 상품을 찾지 못했습니다.")
desc = products.descriptions_from_product(product)
current_html = desc.description
unresolved = [a for a in settle_open_attempts(st, product_no, product=product, actor=actor)
if a.get("target_digest")]
if unresolved:
names = ", ".join(describe_attempt(a) for a in unresolved[:3])
raise WriteBlocked(
f"이전 적용의 반영 여부를 아직 확인하지 못했습니다: {names}. "
"쇼핑몰에서 확인한 뒤 편집기 위 안내에서 결과를 확정하고 다시 시도하세요.",
attempts=unresolved,
)
effective, state, last = resolve_effective(
st, product_no, current_html, fetched_updated=product.get("updated_date")
)
out.pending = state == store.SYNC_PENDING
label = {store.ORIGIN_SCHEDULED: f"예약 #{schedule_id} 적용 직전 자동 백업",
store.ORIGIN_ROLLBACK: "복원 직전 자동 백업"}.get(origin, "적용 직전 자동 백업")
out.backup_id = st.add_revision(
product_no=product_no,
html_content=effective,
revision_type=store.REVISION_BACKUP,
memo=label + (" (카페24 읽기 지연 — 마지막으로 확인된 적용값 기준)" if out.pending else ""),
created_by=actor,
mall_id=mall_id,
shop_no=shop_no,
source=store.SOURCE_LAST_WRITE if out.pending else store.SOURCE_OBSERVED,
source_revision_id=(last or {}).get("applied_revision_id") if out.pending else None,
)
# 모바일이 PC 와 달랐다면 그것도 남긴다 — 아래 쓰기로 모바일이 PC 와 같아진다.
if desc.mobile_description and desc.mobile_description != desc.description:
st.add_revision(
product_no=product_no,
html_content=desc.mobile_description,
revision_type=store.REVISION_BACKUP,
memo=label + " (모바일 — PC와 달랐던 내용)",
created_by=actor,
mall_id=mall_id,
shop_no=shop_no,
source=store.SOURCE_OBSERVED,
)
if base_fingerprint and base_fingerprint != store.fingerprint(effective):
raise WriteConflict(
"편집하는 동안 카페24 값이 변경되었습니다. 새로고침해 현재 내용을 확인한 뒤 다시 적용하세요.",
backup_id=out.backup_id,
)
if skip_if_same and html == effective and set_display is None and set_selling is None:
out.changed = False
return out
# 펜싱 — 잠금이 만료돼 남에게 넘어갔으면 쓰지 않는다.
if not lock.still_mine() or (extra_fence is not None and not extra_fence()):
raise WriteBusy("작업 시간이 길어져 잠금이 만료되었습니다. 카페24에 쓰지 않았습니다 — 다시 시도하세요.",
backup_id=out.backup_id)
out.attempt_id = st.start_attempt(
product_no=int(product_no),
mall_id=mall_id,
shop_no=shop_no,
origin=origin,
schedule_id=schedule_id,
actor=actor,
backup_revision_id=out.backup_id or None,
observed_digest=store.content_digest(current_html) if current_html is not None else "",
base_digest=store.content_digest(effective) if effective is not None else "",
target_digest=store.content_digest(html) if html is not None else "",
# 예약·복원은 내용이 버전(target_revision_id)에 있다 — 즉시 적용만 시도에 보관한다.
target_html=html if (html is not None and not target_revision_id) else "",
target_revision_id=target_revision_id,
set_display=set_display,
set_selling=set_selling,
memo=(memo or "")[:500],
)
try:
updated = products.update_product(
api.client,
product_no,
description=html,
# PC/모바일 구분 안 함 — mobile_description 은 보내지 않고 "PC 와 동일"을 강제.
separated_mobile_description="F" if html is not None else None,
display=set_display,
selling=set_selling,
)
except Exception as exc: # noqa: BLE001 — 분류해서 다시 던진다
known = isinstance(exc, Cafe24Error)
unknown = (not known) or bool(getattr(exc, "maybe_applied", False))
message = str(exc) if known else f"{type(exc).__name__}: {exc}"
try:
st.update_attempt(
out.attempt_id,
status=store.ATTEMPT_UNKNOWN if unknown else store.ATTEMPT_REMOTE_FAILED,
error=message,
only_from=(store.ATTEMPT_STARTED,),
)
except Exception: # noqa: BLE001 — 기록 실패 시 STARTED 로 남는다(= 결과 모름, 안전 쪽)
logger.exception("시도 #%s 결과 기록 실패", out.attempt_id)
kind = RemoteWriteUnknown if unknown else RemoteWriteFailed
raise kind(message, backup_id=out.backup_id, attempt_id=out.attempt_id) from exc
# ── 여기부터는 카페24에 반영된 뒤다. 무엇이 실패해도 "적용 실패"가 아니다. ──
out.updated = updated if isinstance(updated, dict) else {}
errors: list[str] = []
try:
st.update_attempt(
out.attempt_id, status=store.ATTEMPT_REMOTE_OK, remote_ok=True,
remote_updated_at=str(out.updated.get("updated_date") or ""),
only_from=(store.ATTEMPT_STARTED,),
)
except Exception as exc: # noqa: BLE001
logger.exception("시도 #%s REMOTE_OK 기록 실패", out.attempt_id)
errors.append(f"시도 상태: {type(exc).__name__}")
if out.updated.get("product_no"):
_, snap_error = remember_product_write(st, product_no, out.updated)
if snap_error:
errors.append(f"스냅샷: {snap_error}")
try:
out.revision_id = record_attempt(st, {
"id": out.attempt_id, "origin": origin, "actor": actor, "memo": memo,
"target_revision_id": target_revision_id,
"target_digest": store.content_digest(html) if html is not None else "",
})
out.recorded = True
except Exception as exc: # noqa: BLE001
logger.exception("시도 #%s 버전 기록 실패", out.attempt_id)
errors.append(f"버전 기록: {type(exc).__name__}: {exc}")
out.record_error = "; ".join(errors)
if html is not None and wait_confirm:
# 카페24 관리자 API 의 쓰기 직후 읽기 지연을 짧게 흡수(확인 실패는 실패가 아니다).
out.confirmed = products.wait_for_description(api.client, product_no, html)
return out
+34 -7
View File
@@ -36,10 +36,23 @@ class CupangDBStore:
open=False,
)
self._pool.open(wait=False)
self._weight_col: bool | None = None # 마이그레이션 007(weight_g) 적용 여부 — 한 번 확인되면 기억
def close(self) -> None:
self._pool.close()
def weight_enabled(self) -> bool:
"""cupang_products.weight_g(포장무게, 마이그레이션 007) 가 있는가. 있으면 기억(없으면 다음에 다시 확인)."""
if self._weight_col:
return True
with self._pool.connection() as conn:
row = conn.execute(
"SELECT 1 FROM information_schema.columns "
"WHERE table_name = 'cupang_products' AND column_name = 'weight_g'"
).fetchone()
self._weight_col = row is not None
return self._weight_col
# ════════════════════════════════════════════════════════════
# 입고센터 (cupang_centers)
# ════════════════════════════════════════════════════════════
@@ -300,32 +313,39 @@ class CupangDBStore:
product_name: str,
coupang_item_code: str | None = None,
sort_order: int = 0,
weight_g: int | None = None,
) -> dict[str, Any]:
"""제품 등록/수정.
coupang_item_code 가 None 이면 기존 값을 유지한다(빈 문자열은 지우기).
weight_g(포장무게 g) 가 None 이면 기존 값을 유지한다(수기 추가에서 비워 두면 그대로). 007 미적용이면 무시.
"""
code = (product_code or "").strip()
name = (product_name or "").strip()
cic = None if coupang_item_code is None else coupang_item_code.strip()
if not code or not name:
raise ValueError("제품코드와 제품명 모두 필요합니다.")
weight = self.weight_enabled()
with self._pool.connection() as conn:
row = conn.execute(
"""
INSERT INTO cupang_products
(product_code, product_name, coupang_item_code, sort_order)
VALUES (%(code)s, %(name)s, COALESCE(%(cic)s, ''), %(sort)s)
(product_code, product_name, coupang_item_code, sort_order"""
+ (", weight_g" if weight else "") + """)
VALUES (%(code)s, %(name)s, COALESCE(%(cic)s, ''), %(sort)s"""
+ (", %(w)s" if weight else "") + """)
ON CONFLICT (product_code) DO UPDATE
SET product_name = EXCLUDED.product_name,
coupang_item_code = COALESCE(
%(cic)s, cupang_products.coupang_item_code
),
),"""
+ ("\n weight_g = COALESCE(%(w)s, cupang_products.weight_g)," if weight else "")
+ """
sort_order = EXCLUDED.sort_order,
active = TRUE
RETURNING *
""",
{"code": code, "name": name, "cic": cic, "sort": sort_order},
{"code": code, "name": name, "cic": cic, "sort": sort_order, "w": weight_g},
).fetchone()
return self._product_serialize(row)
@@ -345,8 +365,11 @@ class CupangDBStore:
product_name: str,
product_code: str,
coupang_item_code: str = "",
weight_g: Any = ...,
) -> dict[str, Any]:
"""등록된 제품 수정(제품명/제품코드/쿠팡상품코드).
"""등록된 제품 수정(제품명/제품코드/쿠팡상품코드/포장무게).
weight_g: 정수 g 또는 None(지움). 넘기지 않으면(...) 그대로 — 007 미적용이면 무시.
제품코드가 바뀌면 같은 코드로 연결돼 있던 상자 규칙(cupang_box_rules)의
product_code 도 함께 옮긴다(출고 라인은 과거 기록이라 스냅샷 유지).
@@ -356,6 +379,7 @@ class CupangDBStore:
cic = (coupang_item_code or "").strip()
if not name or not code:
raise ValueError("제품코드와 제품명 모두 필요합니다.")
set_weight = weight_g is not ... and self.weight_enabled() # 트랜잭션 밖에서 확인(연결을 겹쳐 잡지 않게)
with self._pool.connection() as conn:
with conn.transaction():
old = conn.execute(
@@ -378,11 +402,12 @@ class CupangDBStore:
UPDATE cupang_products
SET product_name = %s,
product_code = %s,
coupang_item_code = %s
coupang_item_code = %s"""
+ (", weight_g = %s" if set_weight else "") + """
WHERE id = %s
RETURNING *
""",
(name, code, cic, product_id),
(name, code, cic) + ((weight_g,) if set_weight else ()) + (product_id,),
).fetchone()
if code != old_code:
# 새 코드로 된 규칙이 이미 있으면 옮기지 않는다(중복 방지).
@@ -1081,6 +1106,8 @@ class CupangDBStore:
out["active"] = bool(out.get("active", True))
out["sort_order"] = int(out.get("sort_order", 0))
out["coupang_item_code"] = (out.get("coupang_item_code") or "").strip()
w = out.get("weight_g") # 007 미적용이면 키 없음 → None
out["weight_g"] = int(w) if w is not None else None
for k in ("created_at", "updated_at"):
v = out.get(k)
if isinstance(v, datetime):
+23 -7
View File
@@ -193,10 +193,17 @@ def build_workbook(ship_date: str, shipments: list[dict[str, Any]]) -> Any:
# ── 상자 목록(상자 번호별 내용물) ──────────────────────────────
BOX_HEADERS = ["상자번호", "제품명", "제품코드", "수량"]
BOX_WIDTHS_PX = {1: 70, 2: 240, 3: 110, 4: 70}
BOX_WEIGHT_HEADER = "무게(g)" # with_weight 일 때 5열 — 상자 무게 합계(상자번호처럼 상자 단위로 세로 병합)
BOX_WEIGHT_WIDTH_PX = 80
def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, Any]]) -> Any:
"""상자 번호 · 제품명 · 제품코드 · 수량 한 줄씩. 시트명 = YYYYMMDD(요일)."""
def build_box_list_workbook(
shipment: dict[str, Any], box_list: list[dict[str, Any]], *, with_weight: bool = False
) -> Any:
"""상자 번호 · 제품명 · 제품코드 · 수량 한 줄씩. 시트명 = YYYYMMDD(요일).
with_weight 면 5열 "무게(g)" — 상자마다 box["weight_g"](라우터 _attach_box_weights), 모르면 빈칸."""
headers = BOX_HEADERS + ([BOX_WEIGHT_HEADER] if with_weight else [])
from openpyxl import Workbook
from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
from openpyxl.utils import get_column_letter
@@ -215,10 +222,10 @@ def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, A
ws.cell(row=1, column=1, value=f"{with_dow(ship_date)} {center} 상자 목록")
ws.cell(row=1, column=1).font = Font(size=14, bold=True)
ws.merge_cells(start_row=1, start_column=1, end_row=1, end_column=len(BOX_HEADERS))
ws.merge_cells(start_row=1, start_column=1, end_row=1, end_column=len(headers))
header_fill = PatternFill("solid", fgColor=HEADER_BG)
for idx, name in enumerate(BOX_HEADERS, start=1):
for idx, name in enumerate(headers, start=1):
cell = ws.cell(row=2, column=idx, value=name)
cell.font = Font(bold=True)
cell.alignment = center_align
@@ -235,18 +242,27 @@ def build_box_list_workbook(shipment: dict[str, Any], box_list: list[dict[str, A
ws.cell(row=row, column=3, value=it.get("product_code") or "")
ws.cell(row=row, column=4, value=int(it.get("quantity") or 0))
row += 1
# 한 상자에 여러 제품이면 상자번호 칸을 세로로 합친다.
if with_weight and contents:
w = entry.get("weight_g")
ws.cell(row=first, column=5, value=(int(w) if w is not None else None))
ws.cell(row=first, column=5).number_format = "#,##0"
# 한 상자에 여러 제품이면 상자번호(·무게) 칸을 세로로 합친다.
if row - first > 1:
ws.merge_cells(start_row=first, start_column=1, end_row=row - 1, end_column=1)
if with_weight:
ws.merge_cells(start_row=first, start_column=5, end_row=row - 1, end_column=5)
last = row - 1
for r in range(3, last + 1):
for col in range(1, len(BOX_HEADERS) + 1):
for col in range(1, len(headers) + 1):
cell = ws.cell(row=r, column=col)
cell.border = box
cell.alignment = left_align if col == 2 else center_align
for col, px in BOX_WIDTHS_PX.items():
widths = dict(BOX_WIDTHS_PX)
if with_weight:
widths[5] = BOX_WEIGHT_WIDTH_PX
for col, px in widths.items():
ws.column_dimensions[get_column_letter(col)].width = round(px / PX_PER_CHAR, 2)
ws.row_dimensions[1].height = 24
+47 -6
View File
@@ -22,7 +22,7 @@ from fastapi import APIRouter, Body, Depends, File, Form, HTTPException, Request
from fastapi.responses import HTMLResponse, JSONResponse, RedirectResponse
from .holidays import holiday_name, is_holiday
from .store import SHIP_METHODS
from .store import SHIP_METHODS, parse_weight_g
router = APIRouter(prefix="/cupang", tags=["cupang"])
@@ -411,6 +411,8 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
]
calc = _compute_boxes(store, items)
total_qty = sum(it["quantity"] for it in items)
box_list = _expand_box_list(ship, calc, items)
box_weight = _attach_box_weights(store, box_list)
return render_template(
request,
@@ -424,7 +426,9 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
"shipment": ship,
"items": items,
"calc": calc,
"box_list": _expand_box_list(ship, calc, items),
"box_list": box_list,
# 상자별 무게 합계(g) 칸 — 포장무게(마이그레이션 007) 가 있을 때만
"box_weight": box_weight,
"total_qty": total_qty,
},
)
@@ -432,7 +436,7 @@ def detail(request: Request, shipment_id: int) -> HTMLResponse:
@router.get("/{shipment_id:int}/boxes.xlsx")
def export_box_list_xlsx(request: Request, shipment_id: int) -> Any:
"""상자 목록(상자번호·제품명·제품코드·수량) 엑셀 다운로드."""
"""상자 목록(상자번호·제품명·제품코드·수량·무게) 엑셀 다운로드."""
from io import BytesIO # noqa: WPS433
from fastapi.responses import StreamingResponse # noqa: WPS433
@@ -457,8 +461,9 @@ def export_box_list_xlsx(request: Request, shipment_id: int) -> Any:
for ln in (ship.get("lines") or [])
]
box_list = _expand_box_list(ship, _compute_boxes(store, items), items)
with_weight = _attach_box_weights(store, box_list)
wb = build_box_list_workbook(ship, box_list)
wb = build_box_list_workbook(ship, box_list, with_weight=with_weight)
buf = BytesIO()
wb.save(buf)
buf.seek(0)
@@ -1185,6 +1190,36 @@ def _compute_boxes(store: Any, raw_items: list[Any]) -> dict[str, Any]:
}
def _attach_box_weights(store: Any, box_list: list[dict[str, Any]]) -> bool:
"""상자마다 무게 합계(g) — 상자에 든 제품마다 수량 × 포장무게(설정(제품명)의 지금 값, cupang_products.weight_g).
상자에 넣는 값: weight_g = 아는 무게의 합(상자 안 제품 무게가 하나도 없으면 None),
weight_missing = 무게가 없는 제품코드 목록(일부만 없으면 합계는 그 제품을 뺀 값).
포장무게 칸(마이그레이션 007)이 없으면 아무것도 넣지 않고 False.
"""
if not store.weight_enabled():
return False
weights = {
str(p.get("product_code") or "").strip(): p.get("weight_g")
for p in store.list_products(include_inactive=True)
}
for box in box_list:
contents = box.get("items") or []
total, missing = 0, []
for it in contents:
code = str(it.get("product_code") or "").strip()
w = weights.get(code)
if w is None:
if code not in missing:
missing.append(code)
continue
total += int(w) * int(it.get("quantity") or 0)
known = any(weights.get(str(it.get("product_code") or "").strip()) is not None for it in contents)
box["weight_g"] = total if known else None
box["weight_missing"] = missing
return True
def _expand_box_list(
shipment: dict[str, Any], calc: dict[str, Any], items: list[dict[str, Any]]
) -> list[dict[str, Any]]:
@@ -1349,6 +1384,8 @@ def products_page(request: Request) -> HTMLResponse:
"page_subtitle": "왼쪽 itemcode_db 목록에서 선택해 등록하면 폼 드롭다운에 노출됩니다.",
"products": store.list_products(include_inactive=True),
"registered_codes": [p["product_code"] for p in store.list_products(include_inactive=True)],
# 포장무게(g) — 마이그레이션 007 적용 전이면 무게 칸을 숨긴다
"weight_enabled": store.weight_enabled(),
"search_enabled": bool(reader and reader.enabled),
"search_reason": (reader.reason if reader else ""),
},
@@ -1412,6 +1449,7 @@ def product_upsert(
product_code: str = Form(...),
product_name: str = Form(...),
coupang_item_code: str = Form(""),
weight_g: str = Form(""),
sort_order: int = Form(0),
user: dict[str, Any] = Depends(_require_user),
) -> RedirectResponse:
@@ -1422,9 +1460,10 @@ def product_upsert(
store.upsert_product(
product_code=product_code,
product_name=product_name,
# 빈 값은 "미입력" 으로 보고 기존 쿠팡상품코드를 유지한다.
# 빈 값은 "미입력" 으로 보고 기존 쿠팡상품코드·포장무게를 유지한다.
coupang_item_code=(coupang_item_code.strip() or None),
sort_order=sort_order,
weight_g=parse_weight_g(weight_g),
)
except ValueError as exc:
raise HTTPException(status_code=400, detail=str(exc))
@@ -1457,7 +1496,8 @@ def product_edit(
payload: dict[str, Any] = Body(...),
user: dict[str, Any] = Depends(_require_user),
) -> JSONResponse:
"""등록된 제품 수정. body: {product_name, product_code, coupang_item_code}."""
"""등록된 제품 수정. body: {product_name, product_code, coupang_item_code, weight_g?}.
weight_g 키가 있으면 저장(빈 값 = 지움), 없으면 무게는 그대로."""
store = _store(request)
if store is None:
raise HTTPException(status_code=503, detail="cupang_db 미설정")
@@ -1467,6 +1507,7 @@ def product_edit(
product_name=str(payload.get("product_name") or ""),
product_code=str(payload.get("product_code") or ""),
coupang_item_code=str(payload.get("coupang_item_code") or ""),
weight_g=(parse_weight_g(payload.get("weight_g")) if "weight_g" in payload else ...),
)
except KeyError:
raise HTTPException(status_code=404, detail="제품을 찾을 수 없습니다.")
+29
View File
@@ -94,3 +94,32 @@ def compute_boxes(quantity: int, units_per_box: int | None) -> dict[str, Any]:
"remainder_units": qty % upb,
"required_boxes": math.ceil(qty / upb),
}
# 제품 포장무게(g) — cupang_products.weight_g (마이그레이션 007). 0 ~ 1,000,000g, 정수.
WEIGHT_MAX_G = 1_000_000
def parse_weight_g(value: Any) -> int | None:
"""포장무게 입력 → 그램 정수. 빈 값은 None(미입력).
"1,070" · " 1,070 " · "1070g" · "1070.0" 처럼 쉼표·공백·g 단위가 붙어도 읽는다.
숫자가 아니거나 음수·소수(0.5g 등)·범위 밖이면 ValueError.
"""
if value is None:
return None
s = str(value).strip().replace(",", "").replace(" ", "")
if s.lower().endswith("g"):
s = s[:-1]
if not s:
return None
try:
f = float(s)
except ValueError:
raise ValueError(f"포장무게는 숫자(g)로 입력하세요: {value}")
if f != f or f < 0 or f != int(f):
raise ValueError(f"포장무게는 0 이상의 정수(g)로 입력하세요: {value}")
v = int(f)
if v > WEIGHT_MAX_G:
raise ValueError(f"포장무게가 너무 큽니다(최대 {WEIGHT_MAX_G:,}g): {value}")
return v
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
<section class="cpg">
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
<section class="cpg">
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
<section class="cpg">
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
<section class="cpg">
@@ -34,6 +34,12 @@
<input class="erp-input" type="text" name="product_code" required placeholder="예: MS-1012" /></label>
<label class="erp-field"><span>쿠팡상품코드</span>
<input class="erp-input" type="text" name="coupang_item_code" placeholder="예: 1234567890" /></label>
{% if weight_enabled %}
{# 포장무게(g) — 쉼표·g 붙여도 됨(1,070). 비워 두면 같은 제품코드의 기존 무게 유지 #}
<label class="erp-field cpg-weight-field"><span>포장무게(g)</span>
<input class="erp-input" type="text" name="weight_g" inputmode="numeric" autocomplete="off"
pattern="\s*[0-9][0-9,]*\s*(g|G)?\s*" title="숫자(g)로 입력하세요. 예: 1,070" placeholder="예: 1,070" /></label>
{% endif %}
<button type="submit" class="erp-btn erp-btn-primary">추가</button>
</div>
</form>
@@ -60,6 +66,7 @@
<th><button type="button" class="cpg-sort" data-sort-key="name">제품명<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
<th><button type="button" class="cpg-sort" data-sort-key="code">제품코드<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
<th><button type="button" class="cpg-sort" data-sort-key="cpcode">쿠팡상품코드<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>
{% if weight_enabled %}<th class="cpg-weight-col"><button type="button" class="cpg-sort" data-sort-key="weight">포장무게<span class="cpg-sort-ind" aria-hidden="true"></span></button></th>{% endif %}
<th>상태</th>
<th>동작</th>
</tr>
@@ -68,10 +75,12 @@
{% for p in products %}
<tr data-name="{{ p.product_name }}" data-code="{{ p.product_code }}"
data-cpcode="{{ p.coupang_item_code }}"
data-weight="{{ p.weight_g if p.weight_g is not none else '' }}"
class="cpg-prod-row{% if not p.active %} is-inactive{% endif %}">
<td title="{{ p.product_name }}">{{ p.product_name }}</td>
<td title="{{ p.product_code }}">{{ p.product_code }}</td>
<td class="cpg-cpcode" title="{{ p.coupang_item_code }}">{% if p.coupang_item_code %}{{ p.coupang_item_code }}{% else %}<span class="erp-muted">—</span>{% endif %}</td>
{% if weight_enabled %}<td class="cpg-weight-col">{% if p.weight_g is not none %}{{ "{:,}".format(p.weight_g) }}<span class="cpg-weight-unit">g</span>{% else %}<span class="erp-muted">—</span>{% endif %}</td>{% endif %}
<td>
<!-- 배지 자체가 토글 버튼: 클릭 → 활성/비활성 전환 -->
<button type="button" class="erp-badge cpg-active-toggle
@@ -92,7 +101,7 @@
</tr>
{% endfor %}
{% if not products %}
<tr class="cpg-no-sort"><td colspan="5" class="erp-muted">등록된 제품명이 없습니다. 왼쪽에서 선택해 등록하세요.</td></tr>
<tr class="cpg-no-sort"><td colspan="{{ 6 if weight_enabled else 5 }}" class="erp-muted">등록된 제품명이 없습니다. 왼쪽에서 선택해 등록하세요.</td></tr>
{% endif %}
</tbody>
</table>
@@ -117,6 +126,10 @@
rows.sort(function (a, b) {
var av = a.getAttribute("data-" + state.key) || "";
var bv = b.getAttribute("data-" + state.key) || "";
if (state.key === "weight") { // 포장무게 — 숫자 크기순, 무게 없는 줄은 늘 맨 뒤
if (!av || !bv) return (av ? 0 : 1) - (bv ? 0 : 1);
return (Number(av) - Number(bv)) * state.dir;
}
return collator.compare(av, bv) * state.dir;
});
rows.forEach(function (r) { tbody.appendChild(r); });
@@ -150,6 +163,10 @@
<input class="erp-input" type="text" id="cpg-edit-code" /></label>
<label class="erp-field"><span>쿠팡상품코드</span>
<input class="erp-input" type="text" id="cpg-edit-cpcode" placeholder="비우면 지워집니다" /></label>
{% if weight_enabled %}
<label class="erp-field"><span>포장무게(g)</span>
<input class="erp-input" type="text" id="cpg-edit-weight" inputmode="numeric" autocomplete="off" placeholder="예: 1,070 (비우면 지워집니다)" /></label>
{% endif %}
<p class="erp-muted" id="cpg-edit-msg" style="margin:0;font-size:12px;"></p>
<div class="cpg-dlg-actions erp-page-actions">
<button type="button" class="erp-btn erp-btn-outline" data-edit-close>취소</button>
@@ -167,6 +184,7 @@
var elName = document.getElementById("cpg-edit-name");
var elCode = document.getElementById("cpg-edit-code");
var elCp = document.getElementById("cpg-edit-cpcode");
var elW = document.getElementById("cpg-edit-weight"); // 마이그레이션 007 전이면 없음
var elMsg = document.getElementById("cpg-edit-msg");
var saveBtn = document.getElementById("cpg-edit-save");
var editingId = null;
@@ -181,6 +199,10 @@
elName.value = row.getAttribute("data-name") || "";
elCode.value = row.getAttribute("data-code") || "";
elCp.value = row.getAttribute("data-cpcode") || "";
if (elW) {
var w = row.getAttribute("data-weight") || "";
elW.value = w ? Number(w).toLocaleString("ko-KR") : "";
}
elMsg.textContent = "";
dlg.hidden = false;
elName.focus();
@@ -200,6 +222,12 @@
product_code: (elCode.value || "").trim(),
coupang_item_code: (elCp.value || "").trim()
};
if (elW) {
// 포장무게 — 쉼표·g 는 서버가 읽는다. 숫자가 아니면 여기서 먼저 막는다(빈 값 = 지움)
var wv = (elW.value || "").trim();
if (wv && !/^[0-9][0-9,]*\s*g?$/i.test(wv)) { elMsg.textContent = "포장무게는 숫자(g)로 입력하세요. 예: 1,070"; return; }
body.weight_g = wv;
}
if (!body.product_name || !body.product_code) {
elMsg.textContent = "제품명과 제품코드는 필수입니다."; return;
}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
{# 쿠팡 로켓 매출 — 발주 라인별 공급가·원가·물류비·마진 #}
+14 -3
View File
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20260904f" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/cupang.css?v=20261002x" />{% endblock %}
{% block content %}
{# 출고 묶음 보기 — 상자 계산 화면과 같은 3열 구성. 읽기 전용(수정 없음). #}
@@ -80,9 +80,10 @@
<col class="cpg-boxno-c-name" />
<col class="cpg-boxno-c-code" />
<col class="cpg-boxno-c-qty" />
{% if box_weight %}<col class="cpg-boxno-c-weight" />{% endif %}
</colgroup>
<thead>
<tr><th>상자번호</th><th>제품명</th><th>제품코드</th><th>수량</th></tr>
<tr><th>상자번호</th><th>제품명</th><th>제품코드</th><th>수량</th>{% if box_weight %}<th title="상자에 든 제품의 수량 × 포장무게(설정(제품명)) 합계">무게</th>{% endif %}</tr>
</thead>
<tbody>
{% for b in box_list %}
@@ -94,11 +95,21 @@
<td title="{{ it.product_name }}">{{ it.product_name }}</td>
<td class="cpg-boxno-code">{{ it.product_code }}</td>
<td class="cpg-calc-num">{{ it.quantity }}</td>
{% if box_weight and loop.first %}
{# 상자 무게 합계 — 상자번호처럼 상자 단위로 한 칸. 무게 없는 제품이 있으면 표시 #}
{% set miss = b.weight_missing or [] %}
<td class="cpg-boxno-weight" rowspan="{{ b['items']|length }}"
{% if miss %}title="포장무게 미입력: {{ miss|join(', ') }}{% if b.weight_g is not none %} — 이 제품을 뺀 합계{% endif %} (설정(제품명)에서 입력)"{% endif %}>
{%- if b.weight_g is not none -%}
{{ "{:,}".format(b.weight_g) }}<span class="cpg-weight-unit">g</span>{% if miss %}<span class="cpg-boxno-wmiss">일부 미입력</span>{% endif %}
{%- else -%}<span class="erp-muted">—</span>{%- endif -%}
</td>
{% endif %}
</tr>
{% endfor %}
{% endfor %}
{% if not box_list %}
<tr><td colspan="4" class="erp-muted">상자 정보가 없습니다.</td></tr>
<tr><td colspan="{{ 5 if box_weight else 4 }}" class="erp-muted">상자 정보가 없습니다.</td></tr>
{% endif %}
</tbody>
</table>
+590 -8
View File
@@ -1,22 +1,604 @@
"""토스쇼핑 — 판매자 API.
"""토스쇼핑 — 토스쇼핑 API(shopping-fep).
인증 방식·필드는 연동 단계에서 공식 문서로 확정한다.
문서: https://shopping-docs.toss.im/dev (전체 목록 llms.txt, 각 쪽 주소 뒤에 .md 를 붙이면 원문)
인증(공식 방식): 토스쇼핑 파트너스 → 상점 이름 > 가맹점·계정 관리 > 자체 개발 → [키 발급](호출 IP 입력) →
Access Key·Secret Key. OAuth2 client_credentials 로 토큰을 받는다.
POST https://oauth2.cert.toss.im/token (form: grant_type=client_credentials, client_id=Access Key,
client_secret=Secret Key, scope=toss-shopping-fep:write)
응답 expires_in 은 약 1년 — 매번 새로 받으면 이용이 제한될 수 있어(문서 안내) 암호화 저장해 두고 재사용,
401 이면 한 번만 새로 받는다. **키 발급 때 넣은 IP(이 서버 외부 IP)에서만 호출된다.**
API 는 https://shopping-fep.toss.im, 헤더 Authorization: Bearer {token}. HTTP 200 + resultType FAIL 로 오류를 준다.
호출 제한: 셀러·API 별 읽기 초당 50회(넘으면 TOO_MANY_REQUEST).
매출 = 토스쇼핑 파트너스 "순 거래액" = 매출 − 환불(2026-10-01 사용자 지정, 9/6 화면: 매출 29,600 − 환불 11,900 = 17,700).
- 매출 SALE — 주문 내역 조회 GET /api/v3/shopping-fep/orders/v2?startDate=&endDate=&limit=50&nextCursor=
(한 번에 31일까지, 상태 생략 = 전체 상태, 커서 페이지). 줄 = 주문상품(orderProductId), 묶음 = 주문(orderId).
주문 하나 = 사건 하나(`toss:{orderId}`), 날짜 = 주문 시각(orderedAt, 한국 날짜 — 토스쇼핑은 주문 = 결제),
금액 = 주문상품 price(판매가 × 수량) 합 — 할인 전, 배송비 제외. 할인(totalDiscountPrice = 토스쇼핑 할인 + 토스페이 할인)은
discount_amount 로만 보관. 결제 전(BEFORE_PAYMENT)만 빼고 결제 뒤 취소·반품도 주문일 매출에 둔다(화면 "매출"도 환불 전 금액).
- 환불 CANCEL/RETURN — 환불일에 뺀다. 주문상품 하나에 한 번(사건 ID `toss:R{orderProductId}`). `merge_refunds`:
① 클레임 목록 GET /api/v3/shopping-fep/claims(날짜 조건이 없어 전체를 넘긴다)의 환불 완료(isRefunded) CANCEL·RETURN —
날짜 = refundedDt(한국 날짜). 반품은 이것뿐(주문 내역엔 반품 완료 날짜가 없다).
② 클레임이 없는 결제취소 — 주문 내역의 canceledAt(한국 날짜). 결제완료 단계의 고객 취소는 클레임이 생기지 않는다(문서).
기간보다 CANCEL_LOOKBACK_DAYS(90)일 앞 주문까지 불러 다른 날 주문을 기간 안에 취소한 것도 잡는다.
금액 = 그 주문상품의 price(판매가 × 수량, 매출과 같은 기준), 주문 내역에 없으면(90일보다 오래된 주문) 클레임 order.price.
9/6 실데이터: 9/5 주문(276435356)을 9/6 취소 11,900 — 클레임(CANCEL/COMPLETED)·canceledAt 둘 다 9/6 = 화면 환불 11,900.
정산 건별(settlement-steps)의 REFUND 는 이 취소를 담지 않아(구매확정 전 취소는 정산에 안 올라옴) 쓰지 않는다.
- 설정 화면 "쇼핑몰 원본 데이터 확인"에 날짜별 매출·환불·순 거래액과 환불 출처별(정산·취소 시각·클레임) 비교.
- 구매자·수령인 이름·연락처·주소·요청사항은 저장하지 않는다.
"""
from __future__ import annotations
from .base import CredentialField, MarketplaceAdapter
import re
import time
from datetime import date, datetime, timedelta, timezone
from typing import Any, Iterable
from .base import (
AdapterContext,
AdapterError,
ApiError,
AuthFailed,
CredentialField,
MarketplaceAdapter,
NotConfigured,
SaleEvent,
TokenExpired,
)
from .naver import field_summary, flatten
TOKEN_URL = "https://oauth2.cert.toss.im/token"
HOST = "https://shopping-fep.toss.im"
ORDERS_PATH = "/api/v3/shopping-fep/orders/v2"
SETTLEMENT_PATH = "/api/v3/shopping-fep/settlement-steps"
SETTLEMENT_SIZE = 100 # 문서 1~100
SCOPE = "toss-shopping-fep:write"
EVENT_PREFIX = "toss:"
PAGE_SIZE = 50 # 문서 최대 50
WINDOW_DAYS = 31 # 한 번에 31일까지
MAX_PAGES = 2000 # 한 구간 10만 건 — 무한 반복 방지
TOKEN_MARGIN_SEC = 3600 # 만료 1시간 전이면 새로 받는다(토큰은 약 1년)
CALL_INTERVAL_SEC = 0.1 # 읽기 초당 50회 제한 — 넉넉히
RETRY_429 = 3
PROBE_MAX_DAYS = 31
KST = timezone(timedelta(hours=9))
# 결제 전 주문만 매출에서 뺀다. 결제 뒤 취소·반품은 주문일 매출에 두고 원본 확인 표에 참고로 따로 보인다.
EXCLUDED_STATUS = frozenset({"BEFORE_PAYMENT"})
CLAIMED_STATUS = frozenset({"CANCELED_PAYMENT", "COMPLETED_RETURN"})
STATUS_KO = {
"BEFORE_PAYMENT": "결제전", "PAID": "결제완료", "PREPARING_PRODUCT": "상품준비중", "DELIVERING": "배송중",
"DELIVERED": "배송완료", "CONFIRMED_ORDER": "구매확정", "CLAIM_REQUESTED_CANCEL": "취소요청",
"CANCELED_PAYMENT": "결제취소", "CLAIM_REJECTED_CANCEL": "취소거절", "REQUESTED_EXCHANGE": "교환요청",
"ONGOING_EXCHANGE": "교환중", "COMPLETED_EXCHANGE": "교환완료", "CLAIM_REJECTED_EXCHANGE": "교환거절",
"REQUESTED_RETURN": "반품요청", "ONGOING_RETURN": "반품중", "COMPLETED_RETURN": "반품완료",
"CLAIM_REJECTED_RETURN": "반품거절", "CLAIM_COLLECTING": "수거중", "CLAIM_COLLECTED": "수거완료",
"CLAIM_DELIVERING": "재배송중",
}
# 원본 데이터 확인에서 값을 숨기는 항목(개인정보·자유 입력)
PERSONAL_KEYS = frozenset({
"ordererName", "ordererPhone", "ordererRealPhone", "receiverName", "receiverPhone", "receiverRealPhone",
"address", "detailAddress", "zipCode", "shippingNote", "shippingTrackingNumber",
# 클레임 목록(order.* · 수거 주소 · 요청 사유 자유 입력 · 첨부 사진)
"ordererPhoneNumber", "receiverPhoneNumber", "returnAddress", "requestReason", "requestDetailReason",
"requestImages[]",
})
CLAIMS_PATH = "/api/v3/shopping-fep/claims"
CLAIM_PAGE_SIZE = 100
CLAIM_MAX_PAGES = 100 # 클레임 목록은 날짜로 못 거른다(전체를 넘긴다) — 1만 건까지
CANCEL_LOOKBACK_DAYS = 90 # 환불 후보(주문 취소 시각): 이만큼 전 주문까지 본다
def _won(value: Any) -> int:
try:
return int(round(float(str(value if value is not None else 0).replace(",", ""))))
except ValueError:
return 0
def kst_day(value: Any) -> date | None:
"""주문 시각 → 한국 날짜. 시간대가 붙어 있으면(Z, +00:00 …) 한국 시간으로 바꾸고, 없으면 한국 시간으로 본다."""
s = str(value or "").strip()
if not s:
return None
try:
dt = datetime.fromisoformat(s.replace("Z", "+00:00"))
except ValueError:
m = re.match(r"(\d{4})-(\d{2})-(\d{2})", s)
if not m:
return None
try:
return date(int(m.group(1)), int(m.group(2)), int(m.group(3)))
except ValueError:
return None
if dt.tzinfo is not None:
dt = dt.astimezone(KST)
return dt.date()
def group_orders(items: Iterable[dict[str, Any]], start: date, end: date) -> dict[str, dict[str, Any]]:
"""주문상품 → 주문 하나로 합침(주문일이 [start, end] 이고 결제된 것 — 나중에 취소·반품된 것도 포함).
금액 = price(판매가 × 수량) 합(할인 전, 배송비 제외). 할인·배송비·취소/반품분은 참고용으로 모은다.
배송비는 묶음(deliveryFeeGroupId)마다 한 번만 센다."""
orders: dict[str, dict[str, Any]] = {}
ship_groups: set[str] = set()
for it in items:
oid = str(it.get("orderId") or "")
day = kst_day(it.get("orderedAt"))
status = str(it.get("orderProductStatus") or "")
if not oid or day is None or not (start <= day <= end) or status in EXCLUDED_STATUS:
continue
o = orders.setdefault(oid, {"orderId": oid, "_day": day, "amount": 0, "ship": 0, "claimed": 0, "qty": 0,
"discount": 0, "names": [], "opt": "", "statuses": []})
price = _won(it.get("price"))
o["amount"] += price
if status in CLAIMED_STATUS:
o["claimed"] += price
group = str(it.get("deliveryFeeGroupId") or f"{oid}-{it.get('orderProductId')}")
if group not in ship_groups:
ship_groups.add(group)
o["ship"] += _won(it.get("deliveryFee"))
o["qty"] += _won(it.get("quantity"))
o["discount"] += _won(it.get("totalDiscountPrice"))
name = str(it.get("productName") or "")
if name and name not in o["names"]:
o["names"].append(name)
o["opt"] = o["opt"] or str(it.get("optionName") or "")
if status and status not in o["statuses"]:
o["statuses"].append(status)
return orders
def refund_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
"""정산 건별 목록 → 환불(stepType REFUND) 상품 줄만, 환불일(transactionTs 한국 날짜)이 [start, end] 인 것.
금액은 양수로(사건에서 − 를 붙인다). 배송비 줄(orderProductId 없음)은 매출에 배송비를 넣지 않으므로 뺀다."""
out = []
for it in items:
if str(it.get("stepType") or "") != "REFUND" or not it.get("orderProductId") or not it.get("orderId"):
continue
day = kst_day(it.get("transactionTs"))
if day is None or not (start <= day <= end):
continue
amount = abs(_won(it.get("orderProductPrice"))) or abs(_won(it.get("stockPrice"))) * max(1, _won(it.get("quantity")))
out.append({"orderId": str(it["orderId"]), "orderProductId": str(it["orderProductId"]),
"_day": day, "_ts": str(it.get("transactionTs") or ""), "amount": amount,
"qty": _won(it.get("quantity")), "name": str(it.get("displayProductName") or ""),
"order_day": kst_day(it.get("originTransactionTs"))})
return out
def cancel_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
"""환불 후보 — 주문 내역의 취소 시각(canceledAt 한국 날짜)이 [start, end] 인 주문상품. 금액 = price(판매가 × 수량)."""
out = []
for it in items:
day = kst_day(it.get("canceledAt"))
if not it.get("orderId") or day is None or not (start <= day <= end):
continue
status = str(it.get("orderProductStatus") or "")
out.append({"orderId": str(it["orderId"]), "orderProductId": str(it.get("orderProductId") or ""), "_day": day,
"amount": _won(it.get("price")), "status": status, "note": STATUS_KO.get(status, status),
"order_day": kst_day(it.get("orderedAt"))})
return out
def claim_rows(items: Iterable[dict[str, Any]], start: date, end: date) -> list[dict[str, Any]]:
"""환불 후보 — 클레임 목록의 환불 완료(isRefunded, refundedDt 한국 날짜)가 [start, end] 인 것.
금액 = order.price(문서: "상품 가격" — 수량을 곱한 값인지 실데이터로 확인), 수량은 note 에."""
out = []
for it in items:
day = kst_day(it.get("refundedDt"))
order = it.get("order") if isinstance(it.get("order"), dict) else {}
product = it.get("product") if isinstance(it.get("product"), dict) else {}
if not it.get("isRefunded") or day is None or not (start <= day <= end) or not order.get("id"):
continue
out.append({"orderId": str(order["id"]), "orderProductId": str(order.get("orderProductId") or ""), "_day": day,
"amount": _won(order.get("price")), "note": f"{it.get('type') or '?'}/{it.get('status') or '?'} · "
f"수량 {_won(product.get('quantity'))}", "order_day": kst_day(order.get("createdDt"))})
return out
def merge_refunds(order_items: Iterable[dict[str, Any]], claims: Iterable[dict[str, Any]],
start: date, end: date) -> list[dict[str, Any]]:
"""환불 규칙 — 클레임 환불 완료(CANCEL·RETURN, refundedDt) + 클레임이 없는 결제취소(canceledAt), 주문상품마다 한 번.
금액은 주문 내역의 price(판매가 × 수량)를 우선(없으면 클레임 order.price). 날짜가 [start, end] 인 것만.
클레임이 있는 주문상품은 그 클레임 날짜만 쓴다(기간 밖이어도 취소 시각으로 다시 넣지 않음 — 날짜가 바뀌지 않게)."""
order_items = list(order_items)
by_op = {str(it.get("orderProductId")): it for it in order_items if it.get("orderProductId")}
out: dict[str, dict[str, Any]] = {}
claimed_ops: set[str] = set()
for c in claims:
order = c.get("order") if isinstance(c.get("order"), dict) else {}
product = c.get("product") if isinstance(c.get("product"), dict) else {}
kind = str(c.get("type") or "")
op = str(order.get("orderProductId") or "")
if not c.get("isRefunded") or kind not in ("CANCEL", "RETURN") or not order.get("id") or not op:
continue
claimed_ops.add(op)
day = kst_day(c.get("refundedDt"))
if day is None or not (start <= day <= end) or op in out:
continue
it = by_op.get(op) or {}
out[op] = {"orderId": str(order["id"]), "orderProductId": op, "_day": day, "type": kind,
"amount": _won(it["price"]) if "price" in it else _won(order.get("price")),
"qty": _won(it.get("quantity")) or _won(product.get("quantity")),
"name": str(it.get("productName") or product.get("name") or ""),
"order_day": kst_day(it.get("orderedAt") or order.get("createdDt"))}
for r in cancel_rows(order_items, start, end):
op = r["orderProductId"]
if not op or op in claimed_ops or op in out or r["status"] != "CANCELED_PAYMENT":
continue
it = by_op.get(op) or {}
out[op] = {"orderId": r["orderId"], "orderProductId": op, "_day": r["_day"], "type": "CANCEL",
"amount": r["amount"], "qty": _won(it.get("quantity")), "name": str(it.get("productName") or ""),
"order_day": kst_day(it.get("orderedAt"))}
return sorted(out.values(), key=lambda x: (x["_day"], x["orderId"], x["orderProductId"]))
def summary(rows: list[dict[str, Any]]) -> list[dict[str, Any]]:
"""원본 확인 표 — 항목별 채워진 줄·숫자 합계·예시 값(개인정보·자유 입력 항목은 값·합계 숨김)."""
fields = field_summary([flatten(r) for r in rows])
for f in fields:
if f["name"].rsplit(".", 1)[-1] in PERSONAL_KEYS:
f["personal"], f["sample"], f["sum"] = True, "", None
return fields
class TossAdapter(MarketplaceAdapter):
code = "toss"
name = "토스쇼핑"
auth_type = "api_key"
note = "입력 항목은 연동 단계에서 토스쇼핑 판매자 API 문서로 확정합니다."
auth_type = "oauth"
implemented = True
replace_range = True
event_prefix = EVENT_PREFIX
docs_url = "https://shopping-docs.toss.im/dev"
note = ("토스쇼핑 파트너스 → 가맹점·계정 관리 → 자체 개발에서 발급한 Access Key·Secret Key 를 입력합니다. "
"키 발급 때 이 서버의 외부 IP 를 등록해야 호출됩니다.")
def __init__(self) -> None:
self._last_call = 0.0
def credential_fields(self) -> list[CredentialField]:
# 키 이름(api_key·api_secret)은 처음 만든 입력칸 그대로 — 이미 저장한 값이 이어진다.
return [
CredentialField("seller_id", "판매자 ID"),
CredentialField("api_key", "API Key", secret=True),
CredentialField("api_secret", "API Secret", secret=True, required=False),
CredentialField("api_key", "Access Key", secret=True,
help="토스쇼핑 파트너스 → 가맹점·계정 관리 → 자체 개발의 Access Key"),
CredentialField("api_secret", "Secret Key", secret=True,
help="같은 화면의 Secret Key"),
CredentialField("access_token", "Access Token", secret=True, required=False, internal=True),
CredentialField("access_token_expires_at", "Access Token 만료", required=False, internal=True),
]
# ── 인증 ──────────────────────────────────────────────
def _token(self, ctx: AdapterContext, *, force: bool = False) -> str:
"""저장된 토큰이 1시간 넘게 남았으면 그대로, 아니면 새로 받아 암호화 저장."""
if not force:
tok = ctx.credentials.get("access_token")
try:
exp = float(ctx.credentials.get("access_token_expires_at") or 0)
except ValueError:
exp = 0.0
if tok and exp - time.time() > TOKEN_MARGIN_SEC:
return tok
return self._issue_token(ctx)
def _issue_token(self, ctx: AdapterContext) -> str:
import httpx # 지연 import
access_key = ctx.credentials.get("api_key").strip()
secret_key = ctx.credentials.get("api_secret").strip()
if not access_key or not secret_key:
raise NotConfigured("Access Key 와 Secret Key 를 입력하세요.")
form = {"grant_type": "client_credentials", "client_id": access_key, "client_secret": secret_key,
"scope": SCOPE}
try:
res = httpx.post(TOKEN_URL, data=form, timeout=ctx.timeout_sec,
headers={"Accept": "application/json; charset=UTF-8"})
except httpx.HTTPError as exc:
raise ApiError(f"토스 인증 서버 연결 실패: {type(exc).__name__}") from None
body = self._json(res)
if res.status_code >= 400 or not body.get("access_token"):
msg = self._err_text(body, res)
if res.status_code in (400, 401, 403):
raise AuthFailed(f"토스쇼핑 토큰 발급 실패({res.status_code}): {msg}. Access Key·Secret Key 와 "
"키 발급 때 등록한 IP(이 서버 외부 IP)를 확인하세요.")
raise ApiError(f"토스쇼핑 토큰 발급 오류({res.status_code}): {msg}")
tok = str(body["access_token"])
expires_in = _won(body.get("expires_in")) or 24 * 3600
ctx.credentials.set("access_token", tok)
ctx.credentials.set("access_token_expires_at", str(int(time.time()) + expires_in))
return tok
def authenticate(self, ctx: AdapterContext) -> None:
super().authenticate(ctx)
self._token(ctx)
def refresh_token(self, ctx: AdapterContext) -> None:
self._token(ctx, force=True)
# ── 호출 ──────────────────────────────────────────────
@staticmethod
def _json(res: Any) -> dict[str, Any]:
try:
body = res.json()
except ValueError:
return {}
return body if isinstance(body, dict) else {"data": body}
@staticmethod
def _err_text(body: dict[str, Any], res: Any) -> str:
err = body.get("error")
if isinstance(err, dict):
parts = [str(err.get(k)) for k in ("errorCode", "errorType", "reason", "message") if err.get(k)]
else:
parts = [str(body.get(k)) for k in ("error", "error_description", "code", "message") if body.get(k)]
return " ".join(parts)[:300] or res.text[:200].strip() or "응답 없음"
def _get(self, ctx: AdapterContext, path: str, params: dict[str, Any]) -> dict[str, Any]:
"""GET — 호출 간격 유지, 429·TOO_MANY_REQUEST 는 잠깐 쉬고 다시, 401 이면 토큰을 새로 받아 한 번 더.
성공이면 success 내용을 돌려준다(토스쇼핑은 HTTP 200 + resultType FAIL 로도 오류를 준다)."""
import httpx # 지연 import
retried_auth = False
for attempt in range(RETRY_429 + 1):
ctx.progress.check() # [업데이트 취소]면 여기서 멈춤
wait = CALL_INTERVAL_SEC - (time.monotonic() - self._last_call)
if wait > 0:
time.sleep(wait)
headers = {"Authorization": f"Bearer {self._token(ctx)}", "Accept": "application/json"}
try:
res = httpx.get(f"{HOST}{path}", params=params, headers=headers, timeout=ctx.timeout_sec)
except httpx.HTTPError as exc:
raise ApiError(f"토스쇼핑 API 연결 실패: {type(exc).__name__}") from None
finally:
self._last_call = time.monotonic()
body = self._json(res)
err = body.get("error") if isinstance(body.get("error"), dict) else {}
limited = res.status_code == 429 or "TOO_MANY" in str(err.get("errorCode") or err.get("errorType") or "")
if limited and attempt < RETRY_429:
time.sleep(1.0 * (2 ** attempt))
continue
if res.status_code == 401 and not retried_auth:
retried_auth = True
self._token(ctx, force=True)
continue
if res.status_code == 401:
raise TokenExpired(f"토스쇼핑 인증 만료·거부(401): {self._err_text(body, res)}")
if res.status_code == 403:
raise AuthFailed(f"토스쇼핑 권한 거부(403): {self._err_text(body, res)}. 키 발급 때 등록한 IP"
"(이 서버 외부 IP)를 확인하세요.")
if limited:
raise ApiError("토스쇼핑 API 호출 제한이 계속됩니다. 잠시 뒤 다시 시도하세요.")
if res.status_code >= 400:
raise ApiError(f"토스쇼핑 API 오류({res.status_code}): {self._err_text(body, res)}")
if body.get("resultType") == "FAIL":
raise ApiError(f"토스쇼핑 API 오류: {self._err_text(body, res)}")
success = body.get("success")
return success if isinstance(success, dict) else {}
raise ApiError("토스쇼핑 API 호출 제한이 계속됩니다. 잠시 뒤 다시 시도하세요.")
def _window_items(self, ctx: AdapterContext, a: date, b: date) -> list[dict[str, Any]]:
"""조회 기간 [a, b](31일 이하)의 주문상품 전체 — 모든 상태, 커서로 끝까지."""
params: dict[str, Any] = {"startDate": a.isoformat(), "endDate": b.isoformat(), "limit": PAGE_SIZE}
out: list[dict[str, Any]] = []
cursor = None
for _ in range(MAX_PAGES):
body = self._get(ctx, ORDERS_PATH, {**params, **({"nextCursor": cursor} if cursor else {})})
rows = [r for r in body.get("results") or [] if isinstance(r, dict)]
out.extend(rows)
cursor = body.get("nextCursor")
if not cursor or not rows:
break
return out
def _settlement_items(self, ctx: AdapterContext, a: date, b: date) -> list[dict[str, Any]]:
"""거래일 기준 [a, b](31일 이하)의 정산 건별 줄 전체(결제·환불·배송비), nextToken 으로 끝까지."""
params: dict[str, Any] = {"dateCondition": "TRANSACTION_DATE", "fromDate": a.isoformat(),
"toDate": b.isoformat(), "size": SETTLEMENT_SIZE}
out: list[dict[str, Any]] = []
token = None
for _ in range(MAX_PAGES):
body = self._get(ctx, SETTLEMENT_PATH, {**params, **({"nextToken": token} if token else {})})
rows = [r for r in body.get("items") or [] if isinstance(r, dict)]
out.extend(rows)
token = body.get("nextToken")
if not token or not rows:
break
return out
def _claims(self, ctx: AdapterContext) -> list[dict[str, Any]]:
"""클레임 목록 전체(유형·상태 조건 없음 = 전부 — 이 API 는 그 밖엔 날짜로 거를 수 없다), nextToken 으로 끝까지."""
out: list[dict[str, Any]] = []
token = None
for _ in range(CLAIM_MAX_PAGES):
body = self._get(ctx, CLAIMS_PATH, {"size": CLAIM_PAGE_SIZE, **({"nextToken": token} if token else {})})
rows = [r for r in body.get("items") or [] if isinstance(r, dict)]
out.extend(rows)
token = body.get("nextToken")
if not token or not rows or body.get("hasNext") is False:
break
return out
@staticmethod
def _windows(start: date, end: date) -> list[tuple[date, date]]:
windows = []
a = start
while a <= end:
b = min(end, a + timedelta(days=WINDOW_DAYS - 1))
windows.append((a, b))
a = b + timedelta(days=1)
return windows
def _items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
"""주문 내역(매출) — 31일 구간마다 진행 막대 한 칸(plan 은 부르는 쪽이 주문 + 정산 구간 수로 정한다)."""
for a, b in self._windows(start, end):
rows = self._window_items(ctx, a, b)
ctx.progress.step(items=len(rows))
yield from rows
def _refund_items(self, ctx: AdapterContext, start: date, end: date) -> Iterable[dict[str, Any]]:
"""정산 건별(환불이 들어 있음) — 31일 구간마다 진행 막대 한 칸."""
for a, b in self._windows(start, end):
rows = self._settlement_items(ctx, a, b)
ctx.progress.step(items=len(rows))
yield from rows
def _lookback_items(self, ctx: AdapterContext, start: date) -> list[dict[str, Any]]:
"""기간 앞 CANCEL_LOOKBACK_DAYS 일의 주문상품 — 다른 날 주문을 기간 안에 취소한 것을 찾는 용도."""
out: list[dict[str, Any]] = []
for a, b in self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1)):
rows = self._window_items(ctx, a, b)
ctx.progress.step(items=len(rows))
out.extend(rows)
return out
def _plan(self, ctx: AdapterContext, start: date, end: date, extra: int = 0) -> None:
"""진행 막대: 기간 주문 구간 + 앞 90일 주문 구간 + 클레임 목록 1단계 (+ 원본 확인의 정산 구간)."""
back = len(self._windows(start - timedelta(days=CANCEL_LOOKBACK_DAYS), start - timedelta(days=1)))
ctx.progress.plan(len(self._windows(start, end)) + back + 1 + extra, "단계")
def _claims_step(self, ctx: AdapterContext) -> list[dict[str, Any]]:
claims = self._claims(ctx)
ctx.progress.step(items=len(claims))
return claims
# ── 수집 ──────────────────────────────────────────────
def collect(self, ctx: AdapterContext, start: date, end: date) -> tuple[int, list[SaleEvent]]:
"""매출(주문일) + 환불(환불일, merge_refunds). 주문 내역은 환불 금액·취소 시각에도 쓰여 한 번만 부른다."""
self.authenticate(ctx)
self._plan(ctx, start, end)
items = list(self._items(ctx, start, end))
back = self._lookback_items(ctx, start)
claims = self._claims_step(ctx)
events: list[SaleEvent] = []
for o in group_orders(items, start, end).values():
events.extend(self.normalize_order(o))
for r in merge_refunds(back + items, claims, start, end):
events.extend(self.normalize_refund(r))
for ev in events:
ev.validate()
return len(items) + len(claims), events
def normalize_refund(self, r: dict[str, Any]) -> list[SaleEvent]:
oid, day = str(r.get("orderId") or ""), r.get("_day")
if not oid or day is None or not r.get("orderProductId"):
return []
kind = "RETURN" if r.get("type") == "RETURN" else "CANCEL"
return [SaleEvent(
event_type=kind, external_event_id=f"{EVENT_PREFIX}R{r['orderProductId']}", external_order_id=oid,
external_line_id=str(r["orderProductId"]), event_date=day, order_date=r.get("order_day"),
amount=-abs(int(r.get("amount") or 0)), product_name=str(r.get("name") or "")[:200],
quantity=int(r.get("qty") or 0), order_status="반품 환불" if kind == "RETURN" else "취소 환불",
)]
def normalize_order(self, o: dict[str, Any]) -> list[SaleEvent]:
oid, day = str(o.get("orderId") or ""), o.get("_day")
if not oid or day is None:
return []
names = o.get("names") or []
name = names[0] + (f" 외 {len(names) - 1}건" if len(names) > 1 else "") if names else ""
statuses = [STATUS_KO.get(s, s) for s in o.get("statuses") or []]
return [SaleEvent(
event_type="SALE", external_event_id=f"{EVENT_PREFIX}{oid}", external_order_id=oid,
order_date=day, payment_date=day, event_date=day, amount=max(0, int(o.get("amount") or 0)),
product_name=name[:200], option_name=str(o.get("opt") or "")[:200], quantity=int(o.get("qty") or 0),
discount_amount=max(0, int(o.get("discount") or 0)), order_status="/".join(statuses)[:50],
)]
def test_connection(self, ctx: AdapterContext) -> str:
from app.timezone import today_kst # noqa: WPS433
# 입력한 새 값으로 시험할 수 있으니 저장된 토큰을 쓰지 않고 항상 새로 받는다.
super().authenticate(ctx)
self._token(ctx, force=True)
today = today_kst()
body = self._get(ctx, ORDERS_PATH, {"startDate": today.isoformat(), "endDate": today.isoformat(), "limit": 1})
n = len(body.get("results") or [])
more = " 이상" if body.get("nextCursor") else ""
return f"토스쇼핑 API 연결 정상(토큰 발급·주문 조회 확인, 오늘 주문상품 {n}건{more})."
# ── 원본 데이터 확인(설정 화면 "쇼핑몰 원본 데이터 확인") ─────────
def reconcile(self, ctx: AdapterContext, day: date, to: date | None = None) -> dict[str, Any]:
"""기간(최대 31일)을 실제로 불러 항목별 합계·상태별 합계와 날짜별 매출·환불·순 거래액(= 저장되는 값)을 돌려준다.
환불은 출처별(클레임 환불 완료·주문 취소 시각·정산 REFUND)로도 나란히 보여 파트너스 화면과 맞춰 볼 수 있게.
개인정보 항목은 값 없이 이름만. 저장하지 않는다."""
self.authenticate(ctx)
to = min(max(to or day, day), day + timedelta(days=PROBE_MAX_DAYS - 1))
self._plan(ctx, day, to, extra=len(self._windows(day, to)))
try:
items = list(self._items(ctx, day, to))
back = self._lookback_items(ctx, day)
except AdapterError as exc:
return {"date": day.isoformat(), "to": to.isoformat(), "probes": [
{"key": "orders", "label": "주문 내역", "path": ORDERS_PATH, "ok": False, "error": exc.message[:300]}]}
by_status: dict[str, list[dict[str, Any]]] = {}
for it in items:
by_status.setdefault(str(it.get("orderProductStatus") or "?"), []).append(it)
probes = [{"key": "orders", "label": "주문 내역(전체 상태, 주문상품 단위)", "path": ORDERS_PATH,
"ok": True, "count": len(items), "fields": summary(items)}]
for st, rows in sorted(by_status.items()):
probes.append({"key": f"status-{st}", "label": f"상태 {STATUS_KO.get(st, st)}({st})"
+ (" — 매출 제외(결제 전)" if st in EXCLUDED_STATUS else
" — 결제 뒤 취소·반품(매출 포함)" if st in CLAIMED_STATUS else ""),
"path": "orderProductStatus", "ok": True, "count": len(rows),
"fields": [f for f in summary(rows) if f["sum"] is not None]})
claims_err = ""
try:
claims = self._claims_step(ctx)
probes.append({"key": "claims", "label": "클레임 목록(전체 — 날짜 조건 없음)", "path": CLAIMS_PATH, "ok": True,
"count": len(claims), "fields": summary(claims)})
except AdapterError as exc:
claims, claims_err = [], exc.message[:300]
probes.append({"key": "claims", "label": "클레임 목록", "path": CLAIMS_PATH, "ok": False, "error": claims_err})
settle_err = ""
try:
settle = list(self._refund_items(ctx, day, to))
probes.append({"key": "settlement", "label": "정산 건별(거래일 기준, 결제·환불·배송비 줄 전체 — 참고)",
"path": SETTLEMENT_PATH + " (TRANSACTION_DATE)", "ok": True, "count": len(settle),
"fields": summary(settle)})
except AdapterError as exc:
settle, settle_err = [], exc.message[:300]
probes.append({"key": "settlement", "label": "정산 건별(참고)", "path": SETTLEMENT_PATH, "ok": False,
"error": settle_err})
refunds = merge_refunds(back + items, claims, day, to) # 저장되는 환불(현재 규칙)
# ── 환불 출처별 — 파트너스 화면 "환불"과 맞춰 보는 용도 ──
candidates: list[dict[str, Any]] = [
{"key": "rule", "label": "적용 규칙(클레임 환불 + 클레임 없는 결제취소)", "rows": [
{**r, "note": "반품" if r["type"] == "RETURN" else "취소"}
for r in refunds], "error": claims_err},
{"key": "claims", "label": "클레임 환불 완료(refundedDt, 금액 order.price)", "rows": claim_rows(claims, day, to),
"error": claims_err},
{"key": "canceled", "label": f"주문 취소 시각(canceledAt, {CANCEL_LOOKBACK_DAYS}일 전 주문까지)",
"rows": cancel_rows(back + items, day, to), "error": ""},
{"key": "settlement", "label": "정산 REFUND 상품 줄(거래일) — 참고", "rows": [
{**r, "note": "정산 REFUND"} for r in refund_rows(settle, day, to)],
"error": settle_err},
]
for c in candidates:
c["days"] = {}
for r in c["rows"]:
k = r["_day"].isoformat()
c["days"][k] = c["days"].get(k, 0) + r["amount"]
c["rows"] = [{"date": r["_day"].isoformat(), "orderDate": r["order_day"].isoformat() if r.get("order_day") else "",
"orderId": r["orderId"], "orderProductId": r["orderProductId"],
"amount": r["amount"], "note": r.get("note") or ""}
for r in sorted(c["rows"], key=lambda x: (x["_day"], x["orderId"]))][:200]
days = []
orders = group_orders(items, day, to)
d = day
while d <= to:
day_orders = [o for o in orders.values() if o["_day"] == d]
sales = sum(o["amount"] for o in day_orders)
refund = sum(r["amount"] for r in refunds if r["_day"] == d)
days.append({"date": d.isoformat(), "orders": len(day_orders), "amount": sales, "claimed": refund,
"ship": sales - refund})
d += timedelta(days=1)
return {"date": day.isoformat(), "to": to.isoformat(), "probes": probes, "days": days,
"refund_candidates": candidates,
"day_cols": {"amount": "매출(주문일)", "claimed": "환불(환불일)", "ship": "순 거래액(저장되는 매출)"},
"rule": "순 거래액 = 매출 − 환불. 매출 = 주문일(orderedAt) 기준 주문상품 price(판매가 × 수량) 합(할인 전, "
"배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외). 환불 = 클레임 환불 완료(취소·반품, refundedDt) + "
"클레임 없는 결제취소(canceledAt), 주문상품마다 한 번, 금액 = 그 주문상품 price. 환불일 기준"}
+31 -4
View File
@@ -9,6 +9,8 @@
- [업데이트 취소]: SyncJob.cancel() → 각 쇼핑몰이 다음 API 호출 직전(ShopProgress.check)에 Cancelled 로 멈춘다.
수집 중에 멈춘 쇼핑몰은 DB 에 아무것도 쓰지 않는다(저장은 수집이 끝난 뒤 한 트랜잭션). 저장 중이면 그 저장은 끝낸다.
아직 차례가 안 온 쇼핑몰은 "취소됨"으로 건너뛴다.
- 쇼핑몰별 [중지]: SyncJob.stop_shop(code) → 그 쇼핑몰만 같은 방식(다음 API 호출 직전, 저장 안 함)으로 멈추고 "중지됨",
업데이트는 다음 쇼핑몰로 넘어간다. 차례가 안 온 쇼핑몰을 미리 중지하면 차례가 왔을 때 건너뛴다. 저장 중이면 못 멈춘다.
"""
from __future__ import annotations
@@ -39,8 +41,17 @@ class ShopProgress(Progress):
self.unit = "단계"
self.status = self.label = self.message = ""
self.started_at = self.finished_at = 0.0
self.stop_requested = False # 쇼핑몰별 [중지] — 이 쇼핑몰만 멈추고 다음 쇼핑몰로
self._lock = threading.Lock()
def stop(self) -> bool:
"""[중지] — 대기·수집 중일 때만(저장 중·끝난 뒤엔 못 멈춤). 받아들였으면 True."""
with self._lock:
if self.state not in ("waiting", "running"):
return False
self.stop_requested = True
return True
# ── 어댑터가 부르는 쪽(Progress) ──
def plan(self, total: int, unit: str = "단계") -> None:
with self._lock:
@@ -52,11 +63,18 @@ class ShopProgress(Progress):
def check(self) -> None:
if self.cancel_requested and self.state == "running":
raise Cancelled("사용자가 업데이트를 취소했습니다.")
raise Cancelled("사용자가 이 쇼핑몰 업데이트를 중지했습니다." if self.stopped_only else
"사용자가 업데이트를 취소했습니다.")
@property
def cancel_requested(self) -> bool:
return bool(self.job is not None and self.job.cancel_requested)
"""멈춰야 하나 — 업데이트 전체 취소 또는 이 쇼핑몰만 중지."""
return self.stop_requested or bool(self.job is not None and self.job.cancel_requested)
@property
def stopped_only(self) -> bool:
"""이 쇼핑몰만 중지(전체 취소가 아님) — 업데이트는 다음 쇼핑몰로 계속된다."""
return self.stop_requested and not (self.job is not None and self.job.cancel_requested)
def step(self, n: int = 1, *, items: int = 0) -> None:
self.check()
@@ -91,7 +109,8 @@ class ShopProgress(Progress):
def cancelled(self) -> None:
with self._lock:
self.state, self.status, self.message = "cancelled", "cancelled", "취소됨"
self.state, self.status = "cancelled", "cancelled"
self.message = "중지됨" if self.stopped_only else "취소됨"
self.finished_at = time.time()
def skip(self, message: str) -> None:
@@ -118,7 +137,7 @@ class ShopProgress(Progress):
"code": self.code, "name": self.name, "active": self.active, "state": self.state,
"done": self.done, "total": self.total, "unit": self.unit, "items": self.items,
"upserted": self.upserted, "status": self.status, "label": self.label, "message": self.message,
"fraction": round(self.fraction(), 4),
"stop_requested": self.stop_requested, "fraction": round(self.fraction(), 4),
"elapsed": round((self.finished_at or time.time()) - self.started_at, 1) if self.started_at else 0,
}
@@ -148,6 +167,14 @@ class SyncJob:
if not self.finished_at and not self.cancel_requested:
self.cancel_requested, self.cancelled_by = True, user
def stop_shop(self, code: str) -> bool:
"""쇼핑몰별 [중지] — 그 쇼핑몰만 멈추고 다음 쇼핑몰로. 끝난 작업·없는 쇼핑몰·저장 중·끝난 쇼핑몰은 False."""
with self._lock:
if self.finished_at:
return False
shop = next((s for s in self.shops if s.code == code), None)
return bool(shop is not None and shop.stop())
def finish(self, *, error: str = "", last_update_at: str | None = None) -> None:
with self._lock:
self.error, self.last_update_at, self.finished_at = error, last_update_at, time.time()
+25 -5
View File
@@ -115,7 +115,8 @@ def dashboard_page(
def settings_page(request: Request):
from app.main import render_template # noqa: WPS433
g = common.guard(request, admin=True)
# 모듈 권한자 누구나 들어온다 — 일반 사용자는 수수료율만(쇼핑몰 표의 다른 칸·다른 카드는 템플릿이 관리자에게만 그린다).
g = common.guard(request)
if not isinstance(g, tuple):
return g
store, user = g
@@ -227,6 +228,25 @@ def api_sync_cancel(request: Request, job_id: str) -> JSONResponse:
return JSONResponse({"job": job.snapshot()})
@router.post("/api/sync/jobs/{job_id}/shops/{code}/stop")
def api_sync_stop_shop(request: Request, job_id: str, code: str) -> JSONResponse:
"""쇼핑몰별 [중지] — 시작한 사람 또는 관리자. 그 쇼핑몰만 다음 API 호출 직전에 멈추고(저장 안 함, 기존 매출 그대로)
업데이트는 다음 쇼핑몰로 넘어간다. 차례가 안 온 쇼핑몰은 차례가 오면 건너뛴다. 저장 중·끝난 쇼핑몰은 409."""
from app.store import is_admin # noqa: WPS433
from . import jobs # noqa: WPS433
_, user = common.require_store(request)
job = jobs.get_job(job_id)
if job is None:
raise HTTPException(status_code=404, detail="진행 상황을 찾을 수 없습니다(서버가 다시 시작됐을 수 있습니다).")
if job.user and job.user != user["email"] and not is_admin(user):
raise HTTPException(status_code=403, detail="업데이트를 시작한 사람이나 관리자만 중지할 수 있습니다.")
if not job.stop_shop(code):
raise HTTPException(status_code=409, detail="이미 끝났거나 저장 중인 쇼핑몰은 중지할 수 없습니다.")
return JSONResponse({"job": job.snapshot()})
@router.get("/api/sync/current")
def api_sync_current(request: Request) -> JSONResponse:
common.require_store(request)
@@ -251,7 +271,7 @@ def api_events(request: Request, code: str, from_: str = Query(..., alias="from"
# ════════════════════════════════════════════════════════════
# JSON API — 관리자(설정)
# JSON API — 설정(수수료율은 모듈 권한자 누구나, 나머지는 관리자)
# ════════════════════════════════════════════════════════════
@router.put("/api/marketplaces/{code}")
def api_update_marketplace(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
@@ -267,7 +287,7 @@ def api_update_marketplace(request: Request, code: str, payload: dict[str, Any]
@router.post("/api/marketplaces/{code}/rates")
def api_set_rate(request: Request, code: str, payload: dict[str, Any] = Body(...)) -> JSONResponse:
store, user = common.require_store(request, admin=True)
store, user = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
_code_or_404(store, code)
raw = str(payload.get("rate_percent", "")).strip().rstrip("%").strip()
try:
@@ -288,14 +308,14 @@ def api_set_rate(request: Request, code: str, payload: dict[str, Any] = Body(...
@router.get("/api/marketplaces/{code}/rates")
def api_list_rates(request: Request, code: str) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
store, _ = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
_code_or_404(store, code)
return JSONResponse({"rates": store.list_rates(code)})
@router.delete("/api/marketplaces/{code}/rates/{rate_id}")
def api_delete_rate(request: Request, code: str, rate_id: int) -> JSONResponse:
store, _ = common.require_store(request, admin=True)
store, _ = common.require_store(request) # 수수료 설정은 모듈 권한자 누구나
_code_or_404(store, code)
if not store.delete_rate(code, rate_id):
raise HTTPException(status_code=404, detail="수수료 이력을 찾지 못했습니다.")
+7 -5
View File
@@ -102,9 +102,9 @@ class SyncService:
if progress is not None:
progress.fail(status="api_error", label=STATUS_LABELS["api_error"], message="알 수 없는 쇼핑몰입니다.")
return {**result, "status": "api_error", "message": "알 수 없는 쇼핑몰입니다."}
if progress is not None and progress.cancel_requested: # [업데이트 취소] 뒤 차례가 온 쇼핑몰
if progress is not None and progress.cancel_requested: # [업데이트 취소]·쇼핑몰 [중지] 뒤 차례가 온 쇼핑몰
progress.cancelled()
return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"}
return {**result, "cancelled": True, "status": "cancelled", "message": progress.message}
run_id = self._store.start_run(code, trigger=trigger, range_from=start, range_to=end, user=user)
if run_id is None:
if progress is not None:
@@ -140,11 +140,13 @@ class SyncService:
return {**result, "ok": True, "status": "ok", "fetched": fetched, "upserted": upserted,
"message": f"{upserted}건 반영"}
except Cancelled:
# 수집 중 취소 — 아직 아무것도 저장하지 않았다. 연결 상태(오류 표시)는 바꾸지 않는다.
self._store.finish_run(run_id, ok=False, error="업데이트 취소")
# 수집 중 취소·중지 — 아직 아무것도 저장하지 않았다. 연결 상태(오류 표시)는 바꾸지 않는다.
# 쇼핑몰 [중지]면 이 쇼핑몰만 멈추고 sync_all 이 다음 쇼핑몰로 넘어간다.
stopped = progress is not None and progress.stopped_only
self._store.finish_run(run_id, ok=False, error="쇼핑몰 중지" if stopped else "업데이트 취소")
if progress is not None:
progress.cancelled()
return {**result, "cancelled": True, "status": "cancelled", "message": "취소됨"}
return {**result, "cancelled": True, "status": "cancelled", "message": "중지됨" if stopped else "취소됨"}
except Exception as exc: # noqa: BLE001 — 한 쇼핑몰 실패가 전체를 멈추지 않게
status, message = self._failure(exc, ctx)
logger.warning("performance sync %s failed: %s %s", code, status, message)
@@ -1,7 +1,5 @@
{# 실적 모듈 탭 — 설정 탭은 관리자에게만(서버도 관리자만 허용). #}
{# 실적 모듈 탭 — 설정 탭은 모듈 권한자 모두(일반 사용자 화면은 수수료율만, 나머지는 관리자). #}
<nav class="perf-tabs" aria-label="실적 메뉴">
<a class="perf-tab{% if active_tab == 'dashboard' %} is-active{% endif %}" href="/performance/">실적</a>
{% if is_admin %}
<a class="perf-tab{% if active_tab == 'settings' %} is-active{% endif %}" href="/performance/settings">설정</a>
{% endif %}
<a class="perf-tab{% if active_tab == 'settings' %} is-active{% endif %}" href="/performance/settings">{{ '설정' if is_admin else '수수료 설정' }}</a>
</nav>
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930g" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261001b" />{% endblock %}
{%- macro won(v) -%}
{%- if v is none -%}<span class="perf-na"></span>
@@ -239,4 +239,4 @@
} | tojson }}</script>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930zb" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20261001g" defer></script>{% endblock %}
@@ -1,6 +1,6 @@
{% extends "erp_base.html" %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20260930g" />{% endblock %}
{% block head_extra %}<link rel="stylesheet" href="/static/performance.css?v=20261001b" />{% endblock %}
{%- macro when(v) -%}{{ (v or '')[:16] | replace('T', ' ') or '—' }}{%- endmacro -%}
@@ -8,7 +8,8 @@
<section class="perf perf-settings" id="perf-settings">
{% include "performance/_tabs.html" %}
{% if not key_info.ok %}
{# 일반 사용자(실적 권한)는 쇼핑몰별 수수료율만 — 사용·집계 토글·API 인증정보·연결 상태·아래 카드는 관리자만(서버 API 도 관리자만) #}
{% if is_admin and not key_info.ok %}
<div class="perf-notice is-warn">
<b>암호화 마스터 키가 없습니다.</b> {{ key_info.message }}
— 키가 없으면 API 인증정보를 저장할 수 없습니다(수수료 설정·대시보드는 사용 가능).
@@ -18,26 +19,31 @@
<div class="erp-card perf-card">
<div class="perf-card-head">
<h2 class="perf-h">쇼핑몰 설정</h2>
{% if is_admin %}
<span class="perf-muted">사용 · 매출 집계 · 수수료율은 바로 저장됩니다. API 인증정보는 [설정]에서 입력합니다.</span>
{% else %}
<span class="perf-muted">쇼핑몰별 수수료율을 설정합니다. 바로 저장되며 실적 화면의 수수료·수수료 차감 매출에 반영됩니다.</span>
{% endif %}
</div>
<div class="erp-table-wrap">
<table class="perf-table perf-set-table">
<thead>
<tr>
<th class="perf-th-label">쇼핑몰</th>
<th>사용</th>
<th>매출 집계</th>
{% if is_admin %}<th>사용</th>
<th>매출 집계</th>{% endif %}
<th>수수료율</th>
<th>API 설정</th>
<th>연결 상태</th>
{% if is_admin %}<th>API 설정</th>
<th>연결 상태</th>{% endif %}
<th>마지막 동기화</th>
<th></th>
{% if is_admin %}<th></th>{% endif %}
</tr>
</thead>
<tbody>
{% for r in rows %}
<tr data-code="{{ r.code }}" data-name="{{ r.name }}">
<th class="perf-td-label" scope="row">{{ r.name }}</th>
{% if is_admin %}
<td class="perf-center">
<label class="perf-switch" title="사용 여부">
<input type="checkbox" data-field="enabled"{% if r.enabled %} checked{% endif %} /><span></span>
@@ -48,11 +54,13 @@
<input type="checkbox" data-field="include_in_sales"{% if r.include_in_sales %} checked{% endif %} /><span></span>
</label>
</td>
{% endif %}
<td class="perf-rate-cell">
<span class="perf-rate">{% if r.rate %}{{ r.rate }}%{% else %}<span class="perf-muted">미설정</span>{% endif %}</span>
<button type="button" class="erp-btn erp-btn-ghost erp-btn-sm" data-act="rate"
data-has-history="{{ 1 if r.rate_history else 0 }}">변경{% if r.rate_history > 1 %} · 이력 {{ r.rate_history }}{% endif %}</button>
</td>
{% if is_admin %}
<td>
{% if r.shared %}<span class="perf-pill">공통 연동</span>
{% elif r.configured %}<span class="perf-pill is-ok">설정완료</span>
@@ -65,11 +73,14 @@
<i></i>{{ r.status_label }}</span>
{% if r.last_error and r.status not in ('ok', 'disabled') %}<div class="perf-err">{{ r.last_error }}</div>{% endif %}
</td>
{% endif %}
<td class="perf-muted perf-nowrap" title="마지막 시도: {{ when(r.last_sync_at) }}">{{ when(r.last_success_sync_at) }}</td>
{% if is_admin %}
<td class="perf-nowrap">
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="creds">설정</button>
<button type="button" class="erp-btn erp-btn-outline erp-btn-sm" data-act="test">연결 테스트</button>
</td>
{% endif %}
</tr>
{% endfor %}
</tbody>
@@ -77,10 +88,11 @@
</div>
<p class="perf-foot perf-muted">
수수료율은 <b>적용 시작일</b>부터 반영되고, 그 전 실적은 예전 요율로 계산됩니다(과거 실적이 바뀌지 않음).
상태에 마우스를 올리면 마지막 연결 테스트 시각과 최근 오류를 볼 수 있습니다.
{% if is_admin %}상태에 마우스를 올리면 마지막 연결 테스트 시각과 최근 오류를 볼 수 있습니다.{% endif %}
</p>
</div>
{% if is_admin %}
<div class="perf-grid2">
<div class="erp-card perf-card">
<div class="perf-card-head"><h2 class="perf-h">인증정보 암호화</h2></div>
@@ -123,12 +135,14 @@
이름·연락처·주소 같은 개인정보는 값을 보이지 않습니다.<br>
· <b>네이버</b>: 결제일 기준 상품주문 전체(상태별 합계 포함)와 날짜별 "현재 규칙 매출" — 스마트스토어센터 매출과 비교해 주세요.<br>
· <b>11번가</b>: 주문·클레임·정산 조회 주소별 동작 여부. 정산은 정산일 기준일 수 있어 매출이 있던 날부터 넉넉히(예: 3주).<br>
· <b>GS샵</b>: 매출 내역·배송비 내역(매출인식일 기준)의 항목별 합계 — 협력사 포털 매출 화면의 같은 기간 숫자와 비교해 주세요.</p>
· <b>GS샵</b>: 매출 내역·배송비 내역(매출인식일 기준)의 항목별 합계 — 협력사 포털 매출 화면의 같은 기간 숫자와 비교해 주세요.<br>
· <b>토스쇼핑</b>: 날짜별 매출·환불·순 거래액(= 저장되는 매출)과 주문 상태별·정산 항목 합계 — 토스쇼핑 파트너스의 같은 날 숫자와 비교해 주세요.</p>
<div class="perf-sample-form">
<select class="erp-input" id="perf-probe-code" aria-label="쇼핑몰">
<option value="naver">네이버 스마트스토어</option>
<option value="elevenst">11번가</option>
<option value="gsshop">GS샵</option>
<option value="toss">토스쇼핑</option>
</select>
<input class="erp-input perf-date" type="date" id="perf-probe-date" value="{{ default_sample_to }}" />
<span class="perf-muted">~</span>
@@ -174,7 +188,8 @@
</div>
</div>
</div>
{% endif %}
</section>
{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20260930zb" defer></script>{% endblock %}
{% block scripts %}<script src="/static/performance.js?v=20261001g" defer></script>{% endblock %}
@@ -379,6 +379,279 @@ def test_sync_isolation_redaction_and_dedupe():
assert r3["skipped"]
def _toss_item(order_id, op_id, ordered_at, price, *, status="PAID", qty=1, dc=0, ship=0, group=None, name="밀폐용기"):
"""토스쇼핑 주문 내역 조회 results[] 한 줄(주문상품) — 개인정보 항목 포함(저장 안 되는지 확인용)."""
return {"orderId": order_id, "orderProductId": op_id, "orderedAt": ordered_at, "orderProductStatus": status,
"productName": name, "optionName": "3개입", "quantity": qty, "price": price, "originPrice": price,
"totalDiscountPrice": dc, "tossShoppingDiscount": dc, "tossPayDiscount": 0, "tossPayPoint": 0,
"deliveryFee": ship, "deliveryFeeGroupId": group,
"ordererName": "홍길동", "ordererPhone": "010-1234-5678", "receiverName": "홍길동",
"receiverPhone": "010-1234-5678", "address": "서울시 어딘가", "detailAddress": "101호", "zipCode": "01234",
"shippingNote": "문 앞에 두세요 010-9999-8888"}
class _TossCreds(dict):
def get(self, k, default=""):
return dict.get(self, k, default)
def has(self, k):
return bool(dict.get(self, k))
def set(self, k, v):
self[k] = v
def test_toss_token_and_connection():
"""토스쇼핑: Access Key·Secret Key → OAuth2 토큰(form, scope 고정) → Bearer 로 주문 내역 조회.
HTTP 200 + resultType FAIL 도 오류, 401 이면 토큰 한 번 새로 받기. 키·토큰은 오류 문구에 없음."""
import httpx
from app.modules.performance.adapters import toss as ts
from app.modules.performance.adapters.base import AdapterContext, AdapterError
ctx = AdapterContext(code="toss", credentials=_TossCreds(api_key="ACCESS-KEY-1", api_secret="SECRET-KEY-1"))
seen = {"posts": [], "gets": []}
def post(url, data=None, timeout=None, headers=None):
seen["posts"].append((url, dict(data)))
return httpx.Response(200, json={"access_token": f"TOKEN-{len(seen['posts'])}", "expires_in": 31535999,
"token_type": "Bearer", "scope": "toss-shopping-fep:write"})
def get(url, params=None, headers=None, timeout=None):
seen["gets"].append((url, dict(params), headers["Authorization"]))
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {
"results": [_toss_item(1, 11, "2026-09-30T10:00:00", 12000)], "nextCursor": "c2"}})
orig = (httpx.post, httpx.get, ts.CALL_INTERVAL_SEC)
httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = post, get, 0
try:
msg = ts.TossAdapter().test_connection(ctx)
assert "연결 정상" in msg and "1건 이상" in msg
url, form = seen["posts"][0]
assert url == "https://oauth2.cert.toss.im/token"
assert form == {"grant_type": "client_credentials", "client_id": "ACCESS-KEY-1",
"client_secret": "SECRET-KEY-1", "scope": "toss-shopping-fep:write"}
gurl, params, auth = seen["gets"][0]
assert gurl == "https://shopping-fep.toss.im/api/v3/shopping-fep/orders/v2" and auth == "Bearer TOKEN-1"
assert params["startDate"] == params["endDate"] and params["limit"] == 1
assert ctx.credentials["access_token"] == "TOKEN-1" and int(ctx.credentials["access_token_expires_at"]) > 0
# 저장된 토큰은 다시 쓴다(매번 발급하지 않음) — 401 이면 한 번만 새로 받는다
n_posts = len(seen["posts"])
statuses = iter([401, 200])
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
next(statuses), json={"resultType": "SUCCESS", "success": {"results": [], "nextCursor": None}})
assert ts.TossAdapter()._window_items(ctx, date(2026, 9, 1), date(2026, 9, 1)) == []
assert len(seen["posts"]) == n_posts + 1 and ctx.credentials["access_token"] == f"TOKEN-{n_posts + 1}"
# HTTP 200 + resultType FAIL → API 오류
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
200, json={"resultType": "FAIL", "error": {"errorCode": "INVALID_DATE_RANGE", "reason": "조회 기간 초과"}})
try:
ts.TossAdapter()._window_items(ctx, date(2026, 9, 1), date(2026, 9, 1))
except AdapterError as exc:
assert exc.status == "api_error" and "INVALID_DATE_RANGE" in exc.message
else:
raise AssertionError("API 오류여야 합니다")
# 토큰 발급 거부 → 인증 실패(키는 문구에 없음)
httpx.post = lambda url, data=None, timeout=None, headers=None: httpx.Response(
401, json={"error": "invalid_client", "error_description": "client authentication failed"})
try:
ts.TossAdapter().test_connection(ctx)
except AuthFailed as exc:
assert "invalid_client" in exc.message and "SECRET-KEY-1" not in exc.message
assert "ACCESS-KEY-1" not in exc.message
else:
raise AssertionError("인증 실패여야 합니다")
# 주문 조회 403(IP 미등록 등) → 인증 실패 + IP 안내, 토큰은 문구에 없음
httpx.post = post
httpx.get = lambda url, params=None, headers=None, timeout=None: httpx.Response(
403, json={"resultType": "FAIL", "error": {"errorCode": "FORBIDDEN", "reason": "허용되지 않은 IP"}})
try:
ts.TossAdapter().test_connection(ctx)
except AuthFailed as exc:
assert "허용되지 않은 IP" in exc.message and "TOKEN-" not in exc.message
else:
raise AssertionError("권한 거부여야 합니다")
finally:
httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = orig
def _toss_step(step, order_id, op_id, ts, price, *, qty=1):
"""정산 건별 목록 items[] 한 줄 — op_id None = 배송비 줄."""
return {"orderId": order_id, "orderProductId": op_id, "transactionTs": ts, "originTransactionTs": "2026-08-31T16:00:00Z",
"stepType": step, "orderProductPrice": price, "stockPrice": price // max(1, qty), "quantity": qty,
"displayProductName": "밀폐용기", "orderProductStatus": "CANCELED_PAYMENT" if step == "REFUND" else "CONFIRMED_ORDER"}
def _toss_claim(cid, kind, status, order_id, op_id, price, *, refunded=None, created="2026-08-01T10:00:00", qty=1):
"""클레임 목록 items[] 한 줄 — refunded = 환불 완료 일시(없으면 미환불). 개인정보·자유 입력 항목 포함."""
return {"id": cid, "type": kind, "status": status, "isRefunded": bool(refunded), "refundedDt": refunded,
"requestReason": "단순 변심 010-5555-6666", "returnAddress": "서울시 반품동",
"order": {"id": order_id, "orderProductId": op_id, "price": price, "createdDt": created,
"ordererName": "홍길동", "ordererPhoneNumber": "010-1234-5678"},
"product": {"id": 3, "name": "밀폐용기", "quantity": qty}}
def test_toss_collect_sales():
"""토스쇼핑 매출 = 파트너스 "순 거래액" = 매출 − 환불(9/6 화면: 29,600 − 11,900 = 17,700, 9/5 주문을 9/6 취소).
매출 = 주문 단위, 주문일(한국 날짜), 주문상품 price 합(할인 전·배송비 제외, 나중에 취소·반품된 주문 포함, 결제 전 제외).
환불 = 클레임 환불 완료(취소·반품, refundedDt) + 클레임 없는 결제취소(canceledAt), 주문상품마다 한 번, 금액 = 주문상품 price.
기간 앞 90일 주문까지 불러 다른 날 주문의 환불도 잡는다. 31일 구간 + 커서. 구매자 정보는 저장 안 함."""
import httpx
from app.modules.performance.adapters import toss as ts
def item(*a, canceled=None, **kw):
it = _toss_item(*a, **kw)
if canceled:
it["canceledAt"] = canceled
return it
pages = {
("2026-08-01", None): ([item(1, 11, "2026-08-31T23:30:00+09:00", 20000, qty=2, dc=1000, ship=3000, group=7),
item(1, 12, "2026-08-31T23:30:00+09:00", 5000, ship=3000, group=7, name="뚜껑")], "p2"),
("2026-08-01", "p2"): ([item(2, 21, "2026-08-31T16:00:00Z", 9900, status="CANCELED_PAYMENT", # 9/1 01:00 KST
canceled="2026-08-31T17:30:00Z"), # 9/1 02:30 — 클레임 없음
item(3, 31, "2026-08-31T09:00:00", 4000, status="BEFORE_PAYMENT")], None),
("2026-09-01", None): ([item(4, 41, "2026-09-01T10:00:00", 15000, status="COMPLETED_RETURN"),
item(6, 61, "2026-09-02T10:00:00", 5000, status="CANCELED_PAYMENT",
canceled="2026-09-02T11:00:00")], None), # 클레임 환불은 9/5(기간 밖) → 여기선 안 뺌
# 기간 앞 90일(5/3~7/31) 조회의 마지막 구간 — 7/15 주문을 8/10 에 취소(클레임 있음)
("2026-07-04", None): ([item(5, 51, "2026-07-15T10:00:00", 7000, qty=2, status="CANCELED_PAYMENT",
canceled="2026-08-10T09:00:00")], None),
}
claims = [
_toss_claim(1, "RETURN", "COMPLETED", 4, 41, 15000, refunded="2026-09-02T09:00:00"),
_toss_claim(2, "CANCEL", "COMPLETED", 5, 51, 3500, refunded="2026-08-10T09:05:00", qty=2), # 금액은 주문 price 7,000
_toss_claim(3, "CANCEL", "COMPLETED", 6, 61, 5000, refunded="2026-09-05T10:00:00"), # 기간 밖
_toss_claim(4, "CANCEL", "COMPLETED", 8, 81, 4400, refunded="2026-08-15T10:00:00"), # 90일보다 오래된 주문
_toss_claim(5, "EXCHANGE", "COMPLETED", 1, 11, 20000, refunded="2026-09-01T10:00:00"), # 교환 → 제외
_toss_claim(6, "CANCEL", "REQUESTED", 1, 12, 5000), # 미환불 → 제외
]
calls, ccalls = [], []
def get(url, params=None, headers=None, timeout=None):
if url.endswith("/claims"):
ccalls.append(params.get("nextToken"))
page = claims[:3] if not params.get("nextToken") else claims[3:]
tok = None if params.get("nextToken") else "c2"
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": page, "nextToken": tok,
"hasNext": tok is not None}})
assert not url.endswith("/settlement-steps"), "수집은 정산 건별을 부르지 않는다"
calls.append((params["startDate"], params["endDate"], params.get("nextCursor")))
rows, cur = pages.get((params["startDate"], params.get("nextCursor")), ([], None))
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"results": rows, "nextCursor": cur}})
def post(url, data=None, timeout=None, headers=None):
return httpx.Response(200, json={"access_token": "TOKEN-T", "expires_in": 31535999})
st = FakeStore()
creds = CredentialService(st, lambda: ring())
creds.save(next(a for a in all_adapters() if a.code == "toss"), {"api_key": "ak", "api_secret": "sk"})
orig = (httpx.post, httpx.get, ts.CALL_INTERVAL_SEC)
httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = post, get, 0
try:
r = SyncService(st, creds).sync_marketplace("toss", date(2026, 8, 1), date(2026, 9, 2))
finally:
httpx.post, httpx.get, ts.CALL_INTERVAL_SEC = orig
assert r["ok"], r
assert [c for c in calls if c[0] >= "2026-08-01"] == [
("2026-08-01", "2026-08-31", None), ("2026-08-01", "2026-08-31", "p2"), ("2026-09-01", "2026-09-02", None)]
assert [(a, b) for a, b, _ in calls if a < "2026-08-01"] == [
("2026-05-03", "2026-06-02"), ("2026-06-03", "2026-07-03"), ("2026-07-04", "2026-07-31")] # 앞 90일
assert ccalls == [None, "c2"] # 클레임 목록 끝까지
ev_ = {k[2]: v for k, v in st.events.items() if k[0] == "toss"}
refunds = {k: v for k, v in ev_.items() if k.startswith("toss:R")}
assert set(ev_) - set(refunds) == {"toss:1", "toss:2", "toss:4", "toss:6"} # 결제 전(3)만 제외
assert {k: (v["amount"], v["sales_date"], v["event_type"]) for k, v in refunds.items()} == {
"toss:R21": (-9900, date(2026, 9, 1), "CANCEL"), # 클레임 없는 결제취소 → canceledAt
"toss:R41": (-15000, date(2026, 9, 2), "RETURN"), # 반품 → 클레임 refundedDt
"toss:R51": (-7000, date(2026, 8, 10), "CANCEL"), # 앞 90일 주문 — 금액은 주문 price(판매가 × 수량)
"toss:R81": (-4400, date(2026, 8, 15), "CANCEL"), # 주문 내역에 없는 오래된 주문 → 클레임 order.price
} # R61: 클레임 환불(9/5)이 기간 밖 → canceledAt(9/2)으로 넣지 않음, 교환·미환불 클레임 제외
# 환불 사건에도 원래 주문일 — 대시보드 금액 클릭 상세의 "주문일" 열(9/6 화면: 9/5 주문을 9/6 취소)
assert {k: v["order_date"] for k, v in refunds.items()} == {
"toss:R21": date(2026, 9, 1), "toss:R41": date(2026, 9, 1), "toss:R51": date(2026, 7, 15),
"toss:R81": date(2026, 8, 1)}
net = {}
for v in ev_.values():
net[v["sales_date"]] = net.get(v["sales_date"], 0) + v["amount"]
assert net == {date(2026, 8, 10): -7000, date(2026, 8, 15): -4400, date(2026, 8, 31): 25000,
date(2026, 9, 1): 9900 + 15000 - 9900, date(2026, 9, 2): 5000 - 15000}
assert ev_["toss:1"]["amount"] == 25000 and ev_["toss:1"]["discount_amount"] == 1000 # 할인 전·배송비 제외
assert ev_["toss:1"]["quantity"] == 3 and ev_["toss:1"]["product_name"] == "밀폐용기 외 1건"
assert ev_["toss:1"]["sales_date"] == date(2026, 8, 31)
assert ev_["toss:2"]["amount"] == 9900 and ev_["toss:2"]["sales_date"] == date(2026, 9, 1) # UTC → 한국 날짜
assert ev_["toss:4"]["amount"] == 15000 and ev_["toss:4"]["order_status"] == "반품완료"
assert "홍길동" not in repr(st.events) and "010-1234-5678" not in repr(st.events)
def test_toss_reconcile_hides_personal():
import time as _t
import httpx
from app.modules.performance.adapters import toss as ts
from app.modules.performance.adapters.base import AdapterContext
ctx = AdapterContext(code="toss", credentials=_TossCreds(api_key="a", api_secret="b", access_token="T",
access_token_expires_at=str(int(_t.time()) + 99999)))
rows = [_toss_item(1, 11, "2026-09-09T10:00:00", 20000, ship=3000, group=1),
_toss_item(2, 21, "2026-09-09T11:00:00", 9900, status="CANCELED_PAYMENT", ship=3000, group=2)]
steps = [_toss_step("REFUND", 2, 21, "2026-09-10T11:00:00", -9900), _toss_step("REFUND", 2, None, "2026-09-10T11:00:00", -3000)]
# 다른 날(8/20) 주문을 9/10 에 취소 — 기간 앞(90일) 주문 조회에서만 보인다
old = {**_toss_item(7, 71, "2026-08-20T10:00:00", 11900, status="CANCELED_PAYMENT"), "canceledAt": "2026-09-10T09:00:00"}
claims = [{"id": 1, "type": "RETURN", "status": "COMPLETED", "isRefunded": True, "refundedDt": "2026-09-10T12:00:00",
"requestReason": "단순 변심 010-5555-6666", "returnAddress": "서울시 반품동",
"order": {"id": 8, "orderProductId": 81, "price": 5000, "createdDt": "2026-08-25T10:00:00",
"ordererName": "홍길동", "ordererPhoneNumber": "010-1234-5678"},
"product": {"id": 3, "name": "밀폐용기", "quantity": 1}},
{"id": 2, "type": "CANCEL", "status": "REQUESTED", "isRefunded": False, "order": {"id": 9, "price": 777}}]
def get(url, params=None, headers=None, timeout=None):
if url.endswith("/settlement-steps"):
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": steps, "nextToken": None}})
if url.endswith("/claims"):
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": claims, "nextToken": None,
"hasNext": False}})
found = rows if params["startDate"] >= "2026-09-09" else [old] if params["startDate"] <= "2026-08-20" <= params["endDate"] else []
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"results": found, "nextCursor": None}})
orig = (httpx.get, ts.CALL_INTERVAL_SEC)
httpx.get, ts.CALL_INTERVAL_SEC = get, 0
try:
rec = ts.TossAdapter().reconcile(ctx, date(2026, 9, 9), to=date(2026, 9, 10))
finally:
httpx.get, ts.CALL_INTERVAL_SEC = orig
allp = rec["probes"][0]
assert allp["ok"] and allp["count"] == 2
f = {x["name"]: x for x in allp["fields"]}
assert f["price"]["sum"] == 29900
for k in ("ordererName", "ordererPhone", "address", "zipCode", "shippingNote"):
assert f[k]["personal"] and f[k]["sample"] == "", k
assert not f["productName"]["personal"] and f["productName"]["sample"] == "밀폐용기"
assert "홍길동" not in repr(rec) and "010-1234-5678" not in repr(rec) and "010-9999-8888" not in repr(rec)
# 날짜별: 매출(주문일) · 환불(환불일, 적용 규칙) · 순 거래액 — 9/10 환불 = 반품 클레임 5,000 + 클레임 없는 결제취소 11,900
assert rec["days"] == [{"date": "2026-09-09", "orders": 2, "amount": 29900, "claimed": 0, "ship": 29900},
{"date": "2026-09-10", "orders": 0, "amount": 0, "claimed": 16900, "ship": -16900}]
assert rec["day_cols"]["ship"].startswith("순 거래액")
labels = [p["label"] for p in rec["probes"]]
assert any("결제 뒤 취소·반품(매출 포함)" in x for x in labels) and any("정산 건별" in x for x in labels)
# 환불 출처별 — 적용 규칙 · 클레임 · 취소 시각 · 정산(참고), 날짜별 합계 + 건별
cand = {c["key"]: c for c in rec["refund_candidates"]}
assert rec["refund_candidates"][0]["key"] == "rule" and cand["rule"]["days"] == {"2026-09-10": 16900}
assert sorted(x["orderId"] for x in cand["rule"]["rows"]) == ["7", "8"]
assert cand["settlement"]["days"] == {"2026-09-10": 9900}
assert cand["canceled"]["days"] == {"2026-09-10": 11900} and cand["canceled"]["rows"][0]["orderId"] == "7"
assert cand["canceled"]["rows"][0]["orderDate"] == "2026-08-20" # 주문일은 따로 열로(메모 X)
assert {x["orderId"]: x["orderDate"] for x in cand["rule"]["rows"]} == {"7": "2026-08-20", "8": "2026-08-25"}
assert cand["claims"]["days"] == {"2026-09-10": 5000} and len(cand["claims"]["rows"]) == 1 # 환불 안 된 클레임 제외
cf = {x["name"]: x for x in next(p for p in rec["probes"] if p["key"] == "claims")["fields"]}
assert cf["requestReason"]["personal"] and cf["returnAddress"]["personal"] and cf["order.ordererPhoneNumber"]["personal"]
assert "010-5555-6666" not in repr(rec) and "반품동" not in repr(rec)
def test_not_implemented_and_mock():
st = FakeStore()
creds = CredentialService(st, lambda: ring())
@@ -1385,6 +1658,68 @@ def test_sync_job_cancel():
assert snapshot["cancel_requested"] and snapshot["overall"]["finished"] == 2 and snapshot["overall"]["fraction"] == 1.0
def test_sync_job_stop_shop():
"""쇼핑몰별 [중지]: 그 쇼핑몰만 다음 API 호출 직전에 멈추고(저장 안 함, "중지됨") 다음 쇼핑몰로 넘어간다.
차례가 안 온 쇼핑몰을 미리 중지하면 차례가 왔을 때 건너뛴다. 끝난 쇼핑몰·없는 쇼핑몰은 중지 못 함."""
import bcrypt
import httpx
from app.modules.performance import jobs
from app.modules.performance.adapters import naver as nv
from app.modules.performance.adapters import toss as ts
job = jobs.create_job(user="king@x", start=None, end=None)
naver_days = []
def get(url, params=None, headers=None, timeout=None):
if "commerce.naver.com" in url:
naver_days.append(params["from"][:10])
if len(naver_days) == 1:
assert job.stop_shop("gsshop") # 차례가 안 온 GS샵을 미리 중지
if len(naver_days) == 2:
assert job.stop_shop("naver") # 둘째 날을 받는 도중 네이버 중지
rows = [_naver_item("A" + naver_days[-1], "P" + naver_days[-1], naver_days[-1], 10000)]
return httpx.Response(200, json={"data": {"contents": rows, "pagination": {"hasNext": False}}})
if url.endswith("/claims"):
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"items": [], "nextToken": None}})
found = [_toss_item(1, 11, "2026-09-09T10:00:00", 12000)] if params["startDate"] == "2026-09-09" else []
return httpx.Response(200, json={"resultType": "SUCCESS", "success": {"results": found, "nextCursor": None}})
def post(url, data=None, timeout=None, headers=None):
return httpx.Response(200, json={"access_token": "T", "expires_in": 10799})
st = FakeStore()
st.markets = [m for m in st.markets if m["code"] in ("naver", "gsshop", "toss")]
creds = CredentialService(st, lambda: ring())
creds.save(next(a for a in all_adapters() if a.code == "naver"),
{"client_id": "app-id", "client_secret": bcrypt.gensalt(rounds=4).decode()})
creds.save(next(a for a in all_adapters() if a.code == "gsshop"),
{"vendor_code": "1047142", "api_key": "0123456789abcdef0123456789ABCDEF"})
creds.save(next(a for a in all_adapters() if a.code == "toss"), {"api_key": "ak", "api_secret": "sk"})
st.events[("naver", "SALE", "naver:OLD")] = {"amount": 5000, "is_sample": False, "sales_date": date(2026, 9, 10)}
orig = (httpx.post, httpx.get, nv.CALL_INTERVAL_SEC, ts.CALL_INTERVAL_SEC)
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC, ts.CALL_INTERVAL_SEC = post, get, 0, 0
try:
res = SyncService(st, creds).sync_all(start=date(2026, 9, 9), end=date(2026, 9, 12), user="king@x", job=job)
finally:
httpx.post, httpx.get, nv.CALL_INTERVAL_SEC, ts.CALL_INTERVAL_SEC = orig
job.finish()
by = {r["code"]: r for r in res}
assert naver_days == ["2026-09-09", "2026-09-10"] # 중지 뒤 네이버는 더 부르지 않음
assert by["naver"]["cancelled"] and by["naver"]["message"] == "중지됨"
assert by["gsshop"]["cancelled"] and by["gsshop"]["message"] == "중지됨" # 미리 중지 → 차례에 건너뜀
assert by["toss"]["ok"] and by["toss"]["upserted"] == 1 # 다음 쇼핑몰은 계속
assert ("naver", "SALE", "naver:OLD") in st.events and not any(k[0] == "naver" and k[2] != "naver:OLD" for k in st.events)
assert ("toss", "SALE", "toss:1") in st.events
snap = job.snapshot()
shops = {s["code"]: s for s in snap["shops"]}
assert shops["naver"]["state"] == "cancelled" and shops["naver"]["message"] == "중지됨" and shops["naver"]["stop_requested"]
assert shops["toss"]["state"] == "done" and not snap["cancel_requested"]
assert "naver" not in st.status # 연결 상태 안 바뀜
assert not job.stop_shop("toss") and not job.stop_shop("nope") # 끝난 작업·없는 쇼핑몰
if __name__ == "__main__":
os.environ.pop("APP_ENCRYPTION_KEY", None)
n = 0
+46 -11
View File
@@ -5,12 +5,23 @@
바꾸지도 알림을 받지도 않는다(기록 자체는 업무 이력으로 남긴다).
프로젝트
관리(=보기·작업 CRUD) : 관리자(is_admin) · 프로젝트 owner · 배정 멤버. 모두 `project` 모듈 권한이 있어야 한다.
관리(=보기·작업 CRUD) : 프로젝트 owner · 배정 멤버 · 슈퍼관리자. 모두 `project` 모듈 권한이 있어야 한다.
(2026-10-07 — 관리자(is_admin)도 멤버가 아닌 프로젝트는 보이지 않는다. 예외는 슈퍼관리자 한 명뿐.
멤버 배정은 Pro user 이상(2026-10-12) — 라우터의 _require_pro, 아래 등급 표.)
등급(2026-10-12, app.store.ROLES) — 수퍼관리자 > admin > pro > user
is_project_admin : 수퍼관리자·admin — 남이 만든 프로젝트·섹션도 삭제.
is_pro : 수퍼관리자·admin·pro — 새 프로젝트 만들기, 프로젝트 이름·색·아이콘·소유자 수정,
멤버 배정·제외(자기가 멤버인 프로젝트), 사이드바 순서, 남의 댓글 수정·삭제,
휴지통 보기·복구, 전체 보기, 대시보드 담당자별 합계, 전체 멤버 메뉴,
목표 표 입력·구조 변경·주차별 목표·연도 추가/삭제, 회의 완료·완료 해제·회의록 삭제.
user : 멤버인 프로젝트의 작업·섹션·서브프로젝트·작업 삭제, 회의록 작성(완료 전까지).
프로젝트 단위 권한은 등급과 상관없이 멤버(owner)여야 한다 — 위 is_pro 권한도 멤버인 프로젝트 안에서만.
작업
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(삭제는 추가로 생성자 규칙)
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(작업 삭제는 멤버 누구나, 2026-10-12)
READ : 원 소속 권한은 없지만, 이 작업(또는 상위 작업)이 연결된(멀티호밍) 프로젝트를 관리할 수 있음
→ 그 작업의 상세·하위 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다.
→ 그 작업의 상세·세부 작업 목록·댓글·첨부 보기만. 원 소속의 다른 작업·멤버는 보이지 않는다.
연결된 프로젝트 안에서의 섹션 이동(POST /links, 이미 연결된 경우)은 예전처럼 허용.
None : 권한 없음 → 403/목록에서 제외/알림·메일 대상 제외
"""
@@ -34,10 +45,34 @@ def default_user_lookup(email: str) -> dict[str, Any] | None:
return user_store.get(store.norm_str(email, lower=True))
def _is_admin(user: dict[str, Any] | None) -> bool:
from app.store import is_admin # noqa: WPS433
def _is_super(user: dict[str, Any] | None) -> bool:
"""슈퍼관리자(app.store.SUPER_ADMIN_EMAIL) — 모든 프로젝트를 보는 유일한 예외."""
from app.store import SUPER_ADMIN_EMAIL # noqa: WPS433
return is_admin(user)
return bool(user) and email_of(user) == SUPER_ADMIN_EMAIL
def role_of(user: dict[str, Any] | None) -> str:
"""등급 — 'super' · 'admin' · 'pro' · 'user'. 모르는 role 값은 user 로 본다."""
if _is_super(user):
return "super"
role = (user or {}).get("role")
return role if role in ("admin", "pro") else "user"
def is_project_admin(user: dict[str, Any] | None) -> bool:
"""수퍼관리자·admin — 만든 사람이 아니어도 프로젝트·섹션을 지운다."""
return role_of(user) in ("super", "admin")
def is_pro(user: dict[str, Any] | None) -> bool:
"""수퍼관리자·admin·pro — 프로젝트 관리·목표 입력 등 운영 권한(모듈 docstring 의 등급 표)."""
return role_of(user) in ("super", "admin", "pro")
def sees_all_projects(user: dict[str, Any] | None) -> bool:
"""멤버가 아니어도 모든 프로젝트를 보는가 — 슈퍼관리자만(모듈 권한도 있어야)."""
return can_use_module(user) and _is_super(user)
def can_use_module(user: dict[str, Any] | None) -> bool:
@@ -51,10 +86,10 @@ def email_of(user: dict[str, Any] | None) -> str:
def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) -> bool:
"""프로젝트 관리(=보기·작업 CRUD) — 관리자 또는 owner/멤버. 모듈 권한이 없으면 False."""
"""프로젝트 관리(=보기·작업 CRUD) — owner/멤버(관리자도 마찬가지), 슈퍼관리자는 전부. 모듈 권한이 없으면 False."""
if not can_use_module(user):
return False
if _is_admin(user):
if _is_super(user):
return True
try:
pid = int(project_id)
@@ -64,11 +99,11 @@ def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) ->
def visible_project_ids(st: Any, user: dict[str, Any]) -> set[int] | None:
"""관리할 수 있는 프로젝트 id 집합. 관리자는 None(=전체)."""
if _is_admin(user):
return None
"""관리할 수 있는 프로젝트 id 집합. 슈퍼관리자는 None(=전체), 그 밖(관리자 포함)은 owner·멤버인 프로젝트만."""
if not can_use_module(user):
return set()
if _is_super(user):
return None
return {
int(p["id"]) for p in st.list_projects(include_archived=True, member_email=email_of(user))
}
+1488 -186
View File
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
+397 -6
View File
@@ -6,7 +6,10 @@ DB 없이 단위 테스트 가능한 순수 함수만 둔다(malaysia.store 패
from __future__ import annotations
import json
import re
from datetime import date, timedelta
from html import escape
from html.parser import HTMLParser
from typing import Any
@@ -37,7 +40,7 @@ ACTION_ASSIGNED = "assigned"
ACTION_COMPLETED = "completed"
ACTION_STAGE_CHANGED = "stage_changed"
ACTION_REOPENED = "reopened"
ACTION_SUBTASK_MOVED = "subtask_moved" # 하위 업무를 다른 상위 업무로 옮김(보드 드래그)
ACTION_SUBTASK_MOVED = "subtask_moved" # 세부 업무를 다른 상위 업무로 옮김(보드 드래그)
# 프로젝트 색상 팔레트 — 32색(8칸 × 4줄). 앞 16색은 아사나 프로젝트 색(아사나 색상표
# 순서 그대로), 뒤 16색은 같은 칸(열)에 대응하는 진한 색 — 3줄째 = 1줄째의 진한 색,
@@ -128,6 +131,22 @@ PROJECT_ICONS: tuple[str, ...] = (
"build", # 도구
)
# 아사나 아이콘(2026-10-08) — 아사나 프로젝트 아이콘과 같은 채워진 모양. 저장 값은 "asana:" + 이름,
# 글꼴은 이 33개만 담은 채워진 Material Symbols(static/vendor/material-symbols/material-symbols-asana.woff2).
# 이름을 늘리면 그 글꼴도 다시 받아야 한다(docs/PROJECT_MODULE.md 6-12).
ASANA_ICON_PREFIX = "asana:"
PROJECT_ASANA_ICONS: tuple[str, ...] = (
"format_list_bulleted", "view_kanban", "view_timeline", "calendar_month",
"rocket_launch", "group", "monitoring", "stars",
"bug_report", "lightbulb", "language", "settings",
"book_2", "desktop_windows", "check_circle", "adjust",
"code_blocks", "campaign", "forum", "work",
"article", "landscape", "extension", "id_card",
"conversion_path", "speed", "workspace_premium", "steps",
"shopping_basket", "map", "confirmation_number", "toll",
"web",
)
# 섹션(칸반 컬럼) 색상표 — 모든 편집창이 프로젝트 색상표(32색) 하나를 쓴다.
# 섹션에서는 첫 칸(연회색 #c7c4c4, 아사나의 "색 없음")을 고르면 색 없음(NULL, 기본 회색 머리).
STAGE_COLOR_PALETTE: tuple[str, ...] = COLOR_PALETTE
@@ -285,8 +304,10 @@ def validate_color(color: Any) -> str:
def validate_project_icon(icon: Any) -> str | None:
"""프로젝트 아이콘 — PROJECT_ICONS 안의 이름만, 빈값/목록 밖은 None(첫 글자 표시)."""
"""프로젝트 아이콘 — PROJECT_ICONS 안의 이름 또는 "asana:" + PROJECT_ASANA_ICONS 이름만, 빈값/목록 밖은 None(첫 글자 표시)."""
v = norm_str(icon)
if v.startswith(ASANA_ICON_PREFIX):
return v if v[len(ASANA_ICON_PREFIX):] in PROJECT_ASANA_ICONS else None
return v if v in PROJECT_ICONS else None
@@ -356,7 +377,7 @@ def validate_time(t: Any) -> str | None:
# ════════════════════════════════════════════════════════════
# 연간 목표 (마이그레이션 013) — 사이드바 "목표" → 연도
# ════════════════════════════════════════════════════════════
GOAL_METRICS: tuple[str, ...] = ("sales", "roas") # 매출 · 로아스
GOAL_METRICS: tuple[str, ...] = ("sales", "roas") # 매출 · 로아스(단위 %)
GOAL_KINDS: tuple[str, ...] = ("target", "actual") # 목표 · 실적
# 업무 영역 줄 배경색 — 스프레드시트처럼 연한 색 16가지(글자는 항상 진한 색, 8칸×2줄).
# 처음 8색(상품·마케팅·컨텐츠·유통 기본색 포함)은 예전 목록 그대로 들어 있다.
@@ -386,17 +407,74 @@ def validate_goal_year(y: Any) -> int:
return v
class GoalMigration014Needed(RuntimeError):
"""기간(분기) 글 칸·월 칸 병합은 마이그레이션 014(goal_cell_merges) 뒤에만 된다."""
class GoalMigration017Needed(RuntimeError):
"""2·4분기 글 칸(15·16)은 마이그레이션 017(분기) 뒤에만 된다."""
class GoalCellConflict(RuntimeError):
"""셀 이동 전에 다른 창에서 원본 또는 대상 내용이 바뀜."""
class MeetingCellMigrationNeeded(RuntimeError):
"""회의록 셀 병합 메타데이터(019)가 아직 없다."""
class MeetingLocked(RuntimeError):
"""회의 완료(022)된 회의록은 고칠 수 없다(관리자가 완료 해제하면 다시)."""
class MeetingMigration022Needed(RuntimeError):
"""회의 완료(잠금)는 마이그레이션 022 뒤에만 된다."""
class MeetingMigration020Needed(RuntimeError):
"""새 주차(월요일이 아닌 시작일)·결과 글 칸·주차별 목표는 마이그레이션 020 뒤에만 된다."""
GOAL_YEAR = 0 # 업무 영역 글 칸 — 연간
# 분기 글 칸(2026-10-01 상·하반기 → 1~4분기). 칸 번호는 예전 반기 칸을 그대로 이어 쓴다 — 데이터 옮기기 없이
# 예전 상반기 글(13)은 1분기, 하반기 글(14)은 3분기에 보인다. 2분기(15)·4분기(16)는 마이그레이션 017 뒤에 저장.
GOAL_QUARTER_COL: dict[int, int] = {1: 13, 2: 15, 3: 14, 4: 16}
GOAL_COL_QUARTER: dict[int, int] = {c: q for q, c in GOAL_QUARTER_COL.items()}
GOAL_Q_NEW: tuple[int, ...] = (15, 16) # 017 이 있어야 저장되는 분기 칸
GOAL_MAX_COL = 16
def goal_quarter_of(month: int) -> int:
"""1~3월 → 1분기, 4~6월 → 2분기, 7~9월 → 3분기, 10~12월 → 4분기."""
return (int(month) - 1) // 3 + 1
def validate_goal_month(m: Any, *, allow_year: bool = False) -> int:
"""1~12월. allow_year 이면 0(연간)도 허용."""
"""1~12월. allow_year 이면 업무 영역 글 칸 — 0(연간)·13~16(분기 칸, GOAL_QUARTER_COL)도 허용."""
try:
v = int(m)
except (TypeError, ValueError):
raise ValueError("월이 올바르지 않습니다.")
if not ((0 if allow_year else 1) <= v <= 12):
if not ((0 if allow_year else 1) <= v <= (GOAL_MAX_COL if allow_year else 12)):
raise ValueError("월이 올바르지 않습니다.")
return v
def validate_goal_merge(start: Any, end: Any) -> tuple[int, int]:
"""월 칸 병합 범위(start~end 월, 2칸 이상) — 분기를 넘지 않는다."""
try:
s, e = int(start), int(end)
except (TypeError, ValueError):
raise ValueError("병합할 월이 올바르지 않습니다.")
if s > e:
s, e = e, s
if not (1 <= s and e <= 12) or s == e:
raise ValueError("병합은 1~12월 안에서 2칸 이상 골라야 합니다.")
if goal_quarter_of(s) != goal_quarter_of(e):
raise ValueError("분기(1~3·4~6·7~9·10~12월)를 넘어 병합할 수 없습니다.")
return s, e
def validate_goal_value(v: Any) -> float | None:
"""지표 숫자 — '1,234.5' 같은 쉼표·공백·% 는 떼고 읽는다. 빈값은 None(=지움)."""
s = norm_str(v).replace(",", "").replace("%", "").replace(" ", "")
@@ -437,11 +515,303 @@ def validate_goal_color(color: Any) -> str:
def validate_goal_text(body: Any) -> str:
v = str(body or "").replace("\r\n", "\n").strip()
if v.startswith(GOAL_RICH_PREFIX):
runs = goal_text_runs(v, strict=True)
if not "".join(r["text"] for r in runs).strip():
return ""
return GOAL_RICH_PREFIX + json.dumps(runs, ensure_ascii=False, separators=(",", ":"))
if len(v) > GOAL_TEXT_MAX:
raise ValueError(f"칸 하나에 {GOAL_TEXT_MAX}자까지 쓸 수 있습니다.")
return v
# 기존 TEXT 칸에 버전이 있는 텍스트 조각을 저장한다. 예전 평문은 그대로 유지한다.
GOAL_RICH_PREFIX = "pj-rich:v1:"
def goal_text_runs(body: Any, *, strict: bool = False) -> list[dict[str, Any]]:
value = str(body or "")
if not value.startswith(GOAL_RICH_PREFIX):
return [{"text": value}]
try:
raw = json.loads(value[len(GOAL_RICH_PREFIX):])
if not isinstance(raw, list) or len(raw) > GOAL_TEXT_MAX:
raise ValueError("서식 데이터가 올바르지 않습니다.")
runs = []
for item in raw:
if not isinstance(item, dict) or not isinstance(item.get("text"), str):
raise ValueError("서식 데이터가 올바르지 않습니다.")
run: dict[str, Any] = {"text": item["text"]}
for key in ("bold", "italic", "underline"):
if isinstance(item.get(key), bool):
run[key] = item[key]
if re.fullmatch(r"#[0-9a-fA-F]{6}", str(item.get("color", ""))):
run["color"] = item["color"].lower()
size = item.get("size")
if isinstance(size, int) and not isinstance(size, bool) and 10 <= size <= 32:
run["size"] = size
if run["text"]:
runs.append(run)
if sum(len(r["text"]) for r in runs) > GOAL_TEXT_MAX:
raise ValueError(f"칸 하나에 {GOAL_TEXT_MAX}자까지 쓸 수 있습니다.")
return runs
except (ValueError, TypeError) as err:
if strict:
raise ValueError("칸의 서식 데이터가 올바르지 않습니다.") from err
return [{"text": value}]
def goal_text_plain(body: Any) -> str:
return "".join(r["text"] for r in goal_text_runs(body))
def goal_text_html(body: Any, *, include_size: bool = True) -> str:
"""허용한 글자 서식만 HTML로 만든다. 사용자 텍스트는 항상 escape한다.
월간 계획 요약에서는 include_size=False로 글자 크기만 화면 기본값을 사용한다."""
out = []
for run in goal_text_runs(body):
style = []
if "bold" in run:
style.append("font-weight:" + ("700" if run["bold"] else "400"))
if "italic" in run:
style.append("font-style:" + ("italic" if run["italic"] else "normal"))
if "underline" in run:
style.append("text-decoration:" + ("underline" if run["underline"] else "none"))
if "color" in run:
style.append("color:" + run["color"])
if include_size and "size" in run:
style.append(f'font-size:{run["size"]}px')
text = escape(run["text"])
out.append(f'<span style="{";".join(style)}">{text}</span>' if style else text)
return "".join(out)
def merge_goal_texts(bodies: list[str]) -> str:
values = [v for v in bodies if goal_text_plain(v).strip()]
if not any(v.startswith(GOAL_RICH_PREFIX) for v in values):
return validate_goal_text("\n".join(values))
runs = []
for value in values:
if runs:
runs.append({"text": "\n"})
runs.extend(goal_text_runs(value))
return validate_goal_text(GOAL_RICH_PREFIX + json.dumps(runs, ensure_ascii=False))
def validate_meeting_content(body: Any) -> str:
"""회의록 편집기와 같은 서식 조각 합치기로 이동 예상값을 비교한다."""
value = validate_goal_text(body)
if not value.startswith(GOAL_RICH_PREFIX):
return value
runs: list[dict[str, Any]] = []
keys = ("bold", "italic", "underline", "color", "size")
for run in goal_text_runs(value):
if runs and all(runs[-1].get(k) == run.get(k) for k in keys):
runs[-1]["text"] += run["text"]
else:
runs.append(dict(run))
if not any(len(run) > 1 for run in runs):
return validate_goal_text("".join(run["text"] for run in runs))
return GOAL_RICH_PREFIX + json.dumps(runs, ensure_ascii=False, separators=(",", ":"))
# ── 엑셀식 사각형 병합(마이그레이션 015) ──────────────────────────────
class GoalMigration015Needed(RuntimeError):
"""세로 병합·주간 회의록은 마이그레이션 015 뒤에만 된다."""
class GoalMigration016Needed(RuntimeError):
"""항목 칸(2열) 묶음(같은 항목 칸 안에 줄 추가)은 마이그레이션 016 뒤에만 된다."""
# 업무 영역 글 칸의 화면 순서 — 연간 · 1~3월 · 1분기 · 4~6월 · 2분기 · 7~9월 · 3분기 · 10~12월 · 4분기
GOAL_COL_ORDER: tuple[int, ...] = (0, 1, 2, 3, 13, 4, 5, 6, 15, 7, 8, 9, 14, 10, 11, 12, 16)
def goal_col_group(m: int) -> str:
"""병합 가능 묶음 — 가로 병합은 같은 묶음 안에서만(연간·분기 칸은 혼자, 월은 같은 분기끼리)."""
if m == GOAL_YEAR:
return "year"
if m in GOAL_COL_QUARTER:
return f"q{GOAL_COL_QUARTER[m]}"
return f"months{goal_quarter_of(m)}"
def validate_goal_rect_cols(col_from: Any, col_to: Any) -> tuple[int, int]:
"""병합할 칸 범위(화면 순서의 양 끝 칸 번호) → (시작 칸 번호, 가로 칸 수).
가로로 여러 칸이면 같은 분기의 월 칸끼리만 — 연간·분기 칸은 세로로만 합칠 수 있다."""
try:
a, b = int(col_from), int(col_to)
except (TypeError, ValueError):
raise ValueError("병합할 칸이 올바르지 않습니다.")
if a not in GOAL_COL_ORDER or b not in GOAL_COL_ORDER:
raise ValueError("병합할 칸이 올바르지 않습니다.")
ia, ib = sorted((GOAL_COL_ORDER.index(a), GOAL_COL_ORDER.index(b)))
cols = GOAL_COL_ORDER[ia:ib + 1]
if len({goal_col_group(m) for m in cols}) > 1:
raise ValueError("연간·분기 칸은 세로로만, 월 칸은 같은 분기 안에서만 합칠 수 있습니다.")
return cols[0], len(cols)
# ── 주간 회의록(마이그레이션 015) — 월 머리를 누르면 그 달 주차별 회의록 ──────────
MEETING_STATUS: dict[str, str] = {"": "", "done": "완료", "partial": "일부", "miss": "미달"}
MEETING_TEXT_MAX = 4000
MEETING_LABEL_MAX = 50
MEETING_AMOUNT_TEXT_MAX = 100 # 정량 목표·결과 글(021, 예: "20개")
# 첫 회의록(이전 주 회의록이 없을 때)의 구역별 줄 — 사용자 회의록 양식(2026-10). 목표 표의 업무 영역 이름과 같으면
# 그 줄들로, 없는 구역은 빈 줄 하나. 다음 주부터는 지난주 회의록 줄을 그대로 이어받는다.
MEETING_TEMPLATE: dict[str, tuple[str, ...]] = {
"상품": ("상품1", "상품2", "상품3", "상품4", "상품5"),
"마케팅": ("메타", "구글", "네이버", "기타.신규"),
"컨텐츠": ("내용1", "내용2", "내용3", "내용4", "내용5"),
"유통": ("신규 인플루언서", "콜라보", "쿠팡", "네이버", "gs", "토스", "애터미", "해외", "오프라인", "기타"),
}
# 유통 줄 이름 → 실적 모듈 쇼핑몰 코드(그 주 결과를 실적에서 자동으로). 첫 단어 기준, 소문자 비교.
MEETING_MARKET_GUESS: tuple[tuple[str, str], ...] = (
("쿠팡", "coupang"), ("네이버", "naver"), ("스마트스토어", "naver"), ("gs", "gsshop"), ("토스", "toss"),
("11번가", "elevenst"), ("카페24", "cafe24"), ("자사몰", "cafe24"), ("롯데", "lotteon"), ("지마켓", "gmarket"),
("g마켓", "gmarket"), ("카카오", "kakao"), ("오늘의집", "ohouse"),
)
def guess_meeting_market(section: str, label: str) -> str:
"""유통 구역 줄 이름으로 실적 쇼핑몰 코드 추측(없으면 ""). 마케팅의 "네이버"(광고)는 연결하지 않는다."""
if norm_str(section) != "유통":
return ""
lb = norm_str(label).lower()
for word, code in MEETING_MARKET_GUESS:
if lb.startswith(word):
return code
return ""
def week_monday(d: date) -> date:
return d - timedelta(days=d.weekday())
def month_last_day(year: int, month: int) -> date:
return date(year + (month == 12), month % 12 + 1, 1) - timedelta(days=1)
def month_weeks(year: int, month: int) -> list[tuple[date, date]]:
"""그 달의 주차(시작일, 끝일) — 2026-10-07 사용자 기준. 주차는 늘 그 달 안(달을 넘지 않는다).
· 1일이 월~금이면 1주차 = 1일 ~ 그 주 일요일(월요일 시작이 아니어도 1주차)
· 1일이 토·일이면 1주차 = 1일 ~ 다음 주 일요일(토·일 + 다음 월~일)
· 그 뒤는 월~일. 말일이 월·화이면 그 하루·이틀은 앞 주차에 붙는다(마지막 주차 = 월~다음 주 월·화).
예: 2026년 10월(1일 목·31일 토) = 10/1~4 · 5~11 · 12~18 · 19~25 · 26~31.
월간 목표·누적은 늘 1일~말일."""
first = date(year, month, 1)
last = month_last_day(year, month)
wd = first.weekday()
end = first + timedelta(days=6 - wd + (7 if wd >= 5 else 0))
out = [(first, end)]
s = end + timedelta(days=1)
while s <= last:
out.append((s, min(s + timedelta(days=6), last)))
s += timedelta(days=7)
if len(out) > 1 and last.weekday() <= 1: # 말일이 월·화 — 앞 주차에 붙인다
out.pop()
out[-1] = (out[-1][0], last)
return out
def week_period(d: date) -> tuple[date, date]:
"""그 날짜가 든 주차(시작일, 끝일)."""
return next(p for p in month_weeks(d.year, d.month) if p[0] <= d <= p[1])
def prev_week_period(start: date) -> tuple[date, date]:
"""바로 앞 주차(앞 달 마지막 주차일 수 있다) — 회의록의 "지난주"."""
return week_period(start - timedelta(days=1))
def week_number(start: date) -> int:
"""주차 시작일 → 그 달 몇 주차(1부터). 주차 시작일이 아니면 그 날짜가 든 주차."""
return next(i + 1 for i, (a, b) in enumerate(month_weeks(start.year, start.month)) if a <= start <= b)
def calendar_weeks(year: int, month: int) -> list[tuple[date, date]]:
"""작은 달력용 — 그 달 날짜가 하나라도 든 줄(월요일 시작) 전부(1일이 든 줄부터 말일이 든 줄까지)."""
first, last = date(year, month, 1), month_last_day(year, month)
out, mon = [], week_monday(first)
while mon <= last:
out.append((mon, mon + timedelta(days=6)))
mon += timedelta(days=7)
return out
def validate_week_start(v: Any) -> date:
"""회의록 시작일(날짜) — 020 부터 월요일이 아닐 수 있다. 주차 시작일인지는 validate_period_start."""
try:
d = date.fromisoformat(str(v).strip()[:10])
except ValueError:
raise ValueError("주 시작일이 올바르지 않습니다.")
if not 2000 <= d.year <= 2100:
raise ValueError("주 시작일이 올바르지 않습니다.")
return d
def validate_period_start(v: Any) -> date:
"""주차 시작일만(month_weeks 의 시작일) — 새 회의록·주차별 목표."""
d = validate_week_start(v)
if week_period(d)[0] != d:
raise ValueError("주차 시작일이 아닙니다. 새로고침해 주세요.")
return d
def _korean_amount(s: str) -> float:
""""1억2천만"·"3천만"·"1.5억"·"120만"·"3천5백" → 숫자. 단위 없는 숫자는 그대로. 틀리면 ValueError."""
def small(t: str) -> float: # 만 아래 자리 — 천·백·십
val = 0.0
for unit, mul in (("천", 1_000), ("백", 100), ("십", 10)):
if unit in t:
a, t = t.split(unit, 1)
val += (float(a) if a else 1.0) * mul
return val + (float(t) if t else 0.0)
total, rest = 0.0, s
for unit, mul in (("억", 100_000_000), ("만", 10_000)):
if unit in rest:
a, rest = rest.split(unit, 1)
total += (small(a) if a else 1.0) * mul
return total + small(rest)
def validate_meeting_amount(v: Any) -> int | None:
"""금액(원) — 쉼표·공백·"원" 은 떼고, "120만"·"1.5억"·"3천만"·"1억2천만" 도 읽는다. 빈값은 None(=지움)."""
s = norm_str(v).replace(",", "").replace(" ", "").rstrip("원")
if not s:
return None
try:
f = _korean_amount(s)
except ValueError:
raise ValueError(f"금액은 숫자로 입력하세요(예: 1,200,000 · 120만 · 1.5억 · 3천만): {v}")
if f != f or abs(f) >= 1e15:
raise ValueError(f"금액 범위를 벗어났습니다: {v}")
return int(round(f))
def validate_meeting_text(v: Any, *, limit: int = MEETING_TEXT_MAX, what: str = "내용") -> str:
s = str(v or "").replace("\r\n", "\n").strip()
if len(s) > limit:
raise ValueError(f"{what}은(는) {limit}자까지 쓸 수 있습니다.")
return s
def validate_meeting_status(v: Any) -> str:
s = norm_str(v)
if s not in MEETING_STATUS:
raise ValueError("평가 값이 올바르지 않습니다.")
return s
def sales_unit_multiplier(unit: str) -> int | None:
"""목표 표의 매출 단위 글자 → 원 배수("백만원" → 1,000,000). 모르는 단위면 None(원 환산 안 함)."""
u = norm_str(unit).replace(" ", "").rstrip("원") or ""
table = {"": 1, "천": 1_000, "만": 10_000, "십만": 100_000, "백만": 1_000_000, "천만": 10_000_000, "억": 100_000_000}
return table.get(u)
def build_subject_assigned(*, project_name: str, task_title: str, assignee: str) -> str:
return f"[DBX 프로젝트] 작업 배정: {project_name} · {task_title} → {assignee}"
@@ -515,6 +885,23 @@ _DESC_ALLOWED_CLASS: dict[str, str] = {"span": _MENTION_CLASS, "ul": "pj-checkli
# 허용 태그 목록에 없어 태그는 이미 안 남지만, HTMLParser는 이 둘의 내용을
# 별도 데이터로 넘기므로 handle_data 에서 따로 걸러야 한다.
_DESC_RAW_TEXT_TAGS: frozenset[str] = frozenset({"script", "style"})
# 글자 색·크기(서식 도구, 2026-10-08) — 평범한 span 의 style 에서 이 둘만, 정해진 형식만 남긴다.
_DESC_STYLE_COLOR = re.compile(r"^(#[0-9a-f]{3}|#[0-9a-f]{6}|rgb\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}\s*\))$", re.I)
DESC_FONT_SIZES: frozenset[str] = frozenset({"12px", "18px", "22px", "28px"})
def desc_inline_style(value: str) -> str:
"""span style → "color: …; font-size: …" 중 허용된 것만(나머지 선언·url()·expression 등은 버림)."""
kept: list[str] = []
for decl in (value or "").split(";"):
if ":" not in decl:
continue
prop, val = (x.strip().lower() for x in decl.split(":", 1))
if prop == "color" and _DESC_STYLE_COLOR.match(val) and not any(k.startswith("color:") for k in kept):
kept.append(f"color: {val}")
elif prop == "font-size" and val in DESC_FONT_SIZES and not any(k.startswith("font-size:") for k in kept):
kept.append(f"font-size: {val}")
return "; ".join(kept)
def _desc_escape_text(text: str) -> str:
@@ -571,7 +958,7 @@ class _DescriptionSanitizer(HTMLParser):
# span 은 멘션 칩일 때만 속성을 갖는다 — class 가 pj-mention 이 아니면
# data-email 까지 통째로 버린다(평범한 span 으로만 남는다).
if tag == "span" and (dict(attrs).get("class") or "").strip() != _MENTION_CLASS:
allowed = frozenset()
allowed = frozenset({"style"}) # 평범한 span — 글자 색·크기만(desc_inline_style)
kept: list[str] = []
for name, value in attrs:
if name not in allowed:
@@ -587,6 +974,10 @@ class _DescriptionSanitizer(HTMLParser):
continue
if name == "data-checked" and value.strip() != "true":
continue
if name == "style":
value = desc_inline_style(value)
if not value:
continue
kept.append(f'{name}="{_desc_escape_attr(value)}"')
attr_text = (" " + " ".join(kept)) if kept else ""
self.out.append(f"<{tag}{attr_text}>")
@@ -0,0 +1,23 @@
<div class="pj-goal-format" id="pj-goal-format" role="toolbar" aria-label="선택한 글자 서식" hidden>
<div class="pj-goal-format-group pj-goal-color-picker">
<button type="button" class="pj-goal-format-btn pj-goal-color-toggle" data-goal-format="color" aria-label="글자 색상" title="글자 색상" aria-expanded="false" aria-controls="pj-goal-color-grid" disabled><span class="pj-goal-color-letter" aria-hidden="true">가<span class="pj-goal-color-preview"></span></span><svg class="pj-goal-format-chevron" viewBox="0 0 10 10" fill="none" stroke="currentColor" stroke-width="1.3" aria-hidden="true"><path d="m2 4 3 3 3-3"/></svg></button>
<div class="pj-goal-color-grid" id="pj-goal-color-grid" role="group" aria-label="글자 색상 선택" hidden>
{% for color in ('#000000', '#4B5563', '#9CA3AF', '#DC2626', '#EA580C', '#CA8A04', '#16A34A', '#0891B2', '#2563EB', '#7C3AED', '#DB2777', '#FFFFFF') %}
<button type="button" class="pj-goal-text-swatch" data-goal-color="{{ color }}" style="--swatch: {{ color }}" title="{{ color }}" aria-label="{{ color }}" aria-pressed="false" disabled></button>
{% endfor %}
</div>
</div>
<div class="pj-goal-format-group" role="group" aria-label="글자 크기">
<button type="button" class="pj-goal-format-btn" data-goal-format="size-up" aria-label="글자 크기 2px 키우기" title="글자 크기 2px 키우기" disabled><span class="pj-goal-font-letter" aria-hidden="true">가</span><svg class="pj-goal-font-arrow" viewBox="0 0 10 14" fill="none" stroke="currentColor" stroke-width="1.2" aria-hidden="true"><path d="M5 9V2M2 5l3-3 3 3"/></svg></button>
<button type="button" class="pj-goal-format-btn" data-goal-format="size-down" aria-label="글자 크기 2px 줄이기" title="글자 크기 2px 줄이기" disabled><span class="pj-goal-font-letter" aria-hidden="true">가</span><svg class="pj-goal-font-arrow" viewBox="0 0 10 14" fill="none" stroke="currentColor" stroke-width="1.2" aria-hidden="true"><path d="M5 2v7M2 6l3 3 3-3"/></svg></button>
<output class="pj-goal-size-value" data-goal-format="size" aria-label="선택한 글자 크기">14px</output>
</div>
<div class="pj-goal-format-group" role="group" aria-label="글자 모양">
{% for key, label in (('bold', '굵게'), ('italic', '기울임'), ('underline', '밑줄')) %}
<button type="button" class="pj-goal-format-btn" data-goal-format="{{ key }}" aria-label="{{ label }}" title="{{ label }}" aria-pressed="false" disabled><span class="pj-goal-font-letter" aria-hidden="true">가</span></button>
{% endfor %}
</div>
<div class="pj-goal-format-group" role="group" aria-label="서식 초기화">
<button type="button" class="pj-goal-format-btn" data-goal-format="reset" aria-label="서식 초기화" title="서식 초기화" disabled><svg class="pj-goal-reset-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m16 3 5 5a2 2 0 0 1 0 3L11 21H7l-4-4a2 2 0 0 1 0-3L13 3a2 2 0 0 1 3 0Z"/><path d="m8 9 7 7M11 21h10"/></svg></button>
</div>
</div>
@@ -34,3 +34,4 @@
title="프로젝트 관리 도움말" aria-label="프로젝트 관리 도움말">
<span class="material-symbols-outlined">help</span>
</a>
{% include "project/_options.html" %}
@@ -0,0 +1,22 @@
{# 오른쪽 회의록 전용 문서. 공통 메뉴를 다시 만들지 않고 회의록의 기존 편집 기능을 그대로 사용한다. #}
<!doctype html>
<html lang="ko" class="pj-meeting-content">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>{{ page_title or '주간 회의록' }}</title>
<link rel="stylesheet" href="/static/erp.css?v=20260615b" />
<link rel="stylesheet" href="/static/erp-dialog.css?v=20260930a" />
{% block head_extra %}{% endblock %}
<link rel="stylesheet" href="/static/project-goal-nav.css?v=20261004e" />
<script>
try { document.documentElement.dataset.pjFont = localStorage.getItem('pj_font') || 'system'; } catch (_) {}
window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};
</script>
<script src="/static/project-meeting-panel.js?v=20261004a" defer></script>
</head>
<body class="erp-body">
<main class="erp-page">{% block content %}{% endblock %}</main>
<script src="/static/erp-dialog.js?v=20260930a"></script>
</body>
</html>
@@ -0,0 +1,31 @@
<button type="button" class="pj-help-btn" id="pj-options-btn" aria-label="Project 옵션" title="Project 옵션">
<span class="material-symbols-outlined">settings</span>
</button>
<dialog class="pj-options-dialog" id="pj-options-dialog" aria-labelledby="pj-options-title">
<form id="pj-options-form">
<h2 id="pj-options-title">Project 옵션</h2>
<label for="pj-options-font">폰트</label>
<select id="pj-options-font" name="font">
<option value="system">기본 시스템 폰트</option>
<option value="pretendard">프리텐다드</option>
<option value="nanum-square">나눔 스퀘어</option>
<option value="nanum-square-neo">나눔 스퀘어 네오</option>
<option value="nanum-square-round">나눔 스퀘어 라운드</option>
</select>
<div class="pj-options-preview" id="pj-options-preview">프로젝트와 목표를 한눈에<br><b>Project · 업무 이름 · 가나다 123</b></div>
<p>이 브라우저의 모든 Project 화면에 적용됩니다.</p>
<p class="pj-options-error" id="pj-options-error" role="alert" hidden></p>
<div class="pj-options-actions">
<button type="button" class="pj-btn" id="pj-options-cancel">취소</button>
<button type="submit" class="pj-btn pj-btn-primary" id="pj-options-save">저장</button>
</div>
</form>
</dialog>
<script>
try {
var pf = localStorage.getItem("pj_font") || "system";
if (["system", "pretendard", "nanum-square", "nanum-square-neo", "nanum-square-round"].indexOf(pf) >= 0)
document.documentElement.dataset.pjFont = pf;
} catch (_) {}
</script>
<script src="/static/project-options.js?v=20261002g" defer></script>
@@ -1,6 +1,6 @@
{# ── 프로젝트 모듈 좌측 사이드바 (공용) ──────────────────────────────
수신함·내 업무·휴지통·프로젝트 화면이 함께 쓴다 — 어느 화면이든 프로젝트
목록은 똑같다(관리자: 드래그 순서 변경·✎ 수정·× 삭제·우클릭 메뉴).
목록은 똑같다(Pro user 이상: 드래그 순서 변경·✎ 수정·× 삭제·우클릭 메뉴).
변수:
mention_unread 미확인 @태그 개수 (수신함 배지)
@@ -10,16 +10,20 @@
side_active 'inbox' | 'mytasks' | 'trash' | 'goals' | '' — 개인 메뉴 활성 표시
goal_years "목표" 아래 연도 목록(router._goal_years_nav — 올해는 항상 포함)
goal_year_active 목표 화면에서 보고 있는 연도
is_admin 프로젝트 생성/수정/삭제 권한
pj_pro Pro user 이상 — 프로젝트 생성·수정·순서·전체 보기·휴지통·전체 멤버·연도 추가
pj_admin Admin 이상 — 남이 만든 프로젝트도 삭제(그 밖은 만든 사람만)
목록 동작은 project.js 의 initSideTree(첫 화면을 같은 마크업으로 다시 그림),
새 프로젝트/수정 모달은 각 화면이 include 하는 project/_side_modals.html. #}
{# 날짜 팝업(openDatePopover)이 공휴일을 빨강으로 칠할 때 쓰는 표 — 이 사이드바는
프로젝트 관리의 모든 화면에 들어가므로 여기서 한 번 넘긴다(main.py 의 Jinja 전역). #}
<script>window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
<aside class="pj-side" data-is-admin="{{ 'true' if is_admin else 'false' }}"
{# 모든 프로젝트 화면에서 같은 회의록 트리를 사용한다. #}
<link rel="stylesheet" href="/static/project-goal-nav.css?v=20261004e" />
<script src="/static/project-goal-nav.js?v=20261004d" defer></script>
<aside class="pj-side" data-is-pro="{{ 'true' if pj_pro else 'false' }}" data-is-padmin="{{ 'true' if pj_admin else 'false' }}"
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}"
data-me="{{ user.email }}">
<!-- 전체 검색 — 제목·설명·댓글, 내가 볼 수 있는 모든 프로젝트(하위 업무 포함).
<!-- 전체 검색 — 제목·설명·댓글, 내가 볼 수 있는 모든 프로젝트(세부 업무 포함).
결과를 누르면 그 업무 팝업(/project/t/{id})으로. 어디서든 "/" 키로 포커스. -->
<div class="pj-side-search">
<span class="material-symbols-outlined pj-side-search-ic">search</span>
@@ -35,14 +39,25 @@
<span class="pj-side-navbadge" id="pj-mention-badge"
{% if not mention_unread %}hidden{% endif %}>{{ mention_unread }}</span>
</a>
{# 전체 보기(2026-10-08, Pro user 이상 — 멤버인 프로젝트 범위) — 예전 프로젝트 화면 오른쪽 위 "전체 프로젝트" 토글. 지금 프로젝트(없으면 목록 첫 프로젝트)
화면을 ?scope=all 로 연다 — 볼 수 있는 모든 프로젝트의 작업. 프로젝트 화면에서는 project.js 가 새로고침 없이 바꾼다. #}
{% if pj_pro %}
{% set _all_pid = current_pid or ((nav_projects | rejectattr("status", "equalto", "completed") | list | first or {}).id or 0) %}
{% if _all_pid %}
<a class="pj-side-navlink" id="pj-side-allview" href="/project/p/{{ _all_pid }}?scope=all">
<span class="material-symbols-outlined pj-side-navic">apps</span>
<span class="pj-side-navtext">전체 보기</span>
</a>
{% endif %}
{% endif %}
<a class="pj-side-navlink {% if side_active == 'mytasks' %}is-active{% endif %}" href="/project/">
<span class="material-symbols-outlined pj-side-navic">checklist</span>
<span class="pj-side-navtext">내 작업</span>
<span class="pj-side-navbadge pj-side-navbadge-open" id="pj-myopen-badge"
{% if not my_open_total %}hidden{% endif %}>{{ my_open_total }}</span>
</a>
{# 휴지통 — 관리자만 보이고(화면·복구 API 도 관리자 전용), 지운 업무를 3개월 보관. #}
{% if is_admin %}
{# 휴지통 — Pro user 이상만 보이고(화면·복구 API 도 같음), 지운 업무를 3개월 보관. #}
{% if pj_pro %}
<a class="pj-side-navlink {% if side_active == 'trash' %}is-active{% endif %}" href="/project/trash">
<span class="material-symbols-outlined pj-side-navic">delete</span>
<span class="pj-side-navtext">휴지통</span>
@@ -50,7 +65,7 @@
{% endif %}
{# 목표 — 누르면 바로 아래에 연도가 펼쳐지고, 연도를 누르면 오른쪽에 그해 전체 목표
(/project/goals/{연도}). 펼침 상태는 localStorage(pj_goal_open), 목표 화면에서는 항상 펼침.
연도 추가는 관리자만(마이그레이션 013). #}
연도 추가는 Pro user 이상(마이그레이션 013). #}
{% set goal_open = side_active == 'goals' %}
<div class="pj-side-goal{% if goal_open %} is-open{% endif %}" id="pj-side-goal"
data-force-open="{{ 'true' if goal_open else 'false' }}">
@@ -62,10 +77,20 @@
</button>
<div class="pj-side-goal-years" id="pj-side-goal-years"{% if not goal_open %} hidden{% endif %}>
{% for y in (goal_years or []) %}
<div class="pj-side-goal-branch" data-goal-year="{{ y }}">
{# 화살표는 하위 월을 접고 펼치고, 연도 글자는 기존 목표 화면을 연다. #}
<div class="pj-side-goal-year-row">
<button type="button" class="pj-side-goal-year-toggle" aria-expanded="true"
aria-controls="pj-side-meeting-months-{{ y }}" aria-label="{{ y }}년 하위 월 접기" title="하위 월 접기">
<span class="material-symbols-outlined" aria-hidden="true">chevron_right</span>
</button>
<a class="pj-side-goal-year{% if side_active == 'goals' and y == goal_year_active %} is-active{% endif %}"
href="/project/goals/{{ y }}">{{ y }}년</a>
</div>
<div class="pj-side-meeting-months" id="pj-side-meeting-months-{{ y }}" data-current-week="{{ week if goal_month is defined else '' }}"></div>
</div>
{% endfor %}
{% if is_admin %}
{% if pj_pro %}
<button type="button" class="pj-side-goal-add" id="pj-goal-year-add"
data-next="{{ ((goal_years or [0]) | max) + 1 }}">+ 연도 추가</button>
{% endif %}
@@ -76,23 +101,23 @@
<div class="pj-side-block pj-tree-block">
<div class="pj-side-head">
<span>프로젝트</span>
{% if is_admin %}
{% if pj_pro %}
<button type="button" class="pj-icon-btn" id="pj-new-project-side" title="새 프로젝트">+</button>
{% endif %}
</div>
{% macro nav_li(p) %}
<li class="pj-tree-li" data-id="{{ p.id }}"{% if is_admin %} draggable="true"{% endif %}
<li class="pj-tree-li" data-id="{{ p.id }}"{% if pj_pro %} draggable="true"{% endif %}
data-name="{{ p.name }}" data-desc="{{ p.description or '' }}"
data-start="{{ p.start_date or '' }}" data-due="{{ p.due_date or '' }}"
data-color="{{ p.color }}" data-status="{{ p.status or 'active' }}"
data-creator="{{ p.created_by or '' }}" data-icon="{{ p.icon or '' }}">
<div class="pj-tree-row {% if p.id == current_pid %}is-active{% endif %}">
{% if is_admin %}<span class="pj-tree-handle" title="드래그로 순서 변경">⣿</span>{% endif %}
<a class="pj-tree-link" href="/project/p/{{ p.id }}"{% if is_admin %} draggable="false"{% endif %}>
<span class="pj-tree-avatar{% if p.icon %} has-icon{% endif %}" style="background: {{ p.color }}">{% if p.icon %}<span class="material-symbols-outlined pj-proj-ic">{{ p.icon }}</span>{% else %}{{ p.name[0] | upper }}{% endif %}</span>
{% if pj_pro %}<span class="pj-tree-handle" title="드래그로 순서 변경">⣿</span>{% endif %}
<a class="pj-tree-link" href="/project/p/{{ p.id }}"{% if pj_pro %} draggable="false"{% endif %}>
<span class="pj-tree-avatar{% if p.icon %} has-icon{% endif %}" style="background: {{ p.color }}">{% if p.icon %}{% set _a = p.icon.startswith("asana:") %}<span class="material-symbols-outlined pj-proj-ic{% if _a %} pj-ic-asana{% endif %}">{{ p.icon[6:] if _a else p.icon }}</span>{% else %}{{ p.name[0] | upper }}{% endif %}</span>
<span class="pj-tree-name">{{ p.name }}</span>
</a>
{% if is_admin %}
{% if pj_pro %}
<span class="pj-tree-acts">
<button type="button" class="pj-icon-btn pj-tree-edit" data-id="{{ p.id }}"
data-name="{{ p.name }}" data-desc="{{ p.description or '' }}"
@@ -121,11 +146,11 @@
{% endif %}
</div>
<!-- 전체 멤버 — 등록된 전체 직원(프로젝트 권한 보유자). 관리자 전용
(/api/all-users 도 관리자만). 아이콘 클릭 시 그 사람이 담당자인 업무를
<!-- 전체 멤버 — 등록된 전체 직원(프로젝트 권한 보유자). Pro user 이상
(/api/all-users 는 @태그 후보로 누구나 부른다). 아이콘 클릭 시 그 사람이 담당자인 업무를
팝업으로 보여준다(프로젝트/세션/마감일). 수신함·내 업무·프로젝트 화면
모두에서 보인다 — 팝업 마크업은 _member_tasks_modal.html. -->
{% if is_admin %}
{% if pj_pro %}
<div class="pj-side-block">
<div class="pj-side-head"><span>전체 멤버</span></div>
<div class="pj-allmembers-grid" id="pj-allmembers-grid">불러오는 중…</div>
@@ -1,13 +1,14 @@
{# ── 좌측 프로젝트 목록(project/_side.html)용 모달 (공용) ──────────────
"+" 새 프로젝트 / ✎ 프로젝트 수정 — 수신함·내 업무·휴지통·프로젝트 화면이
모두 include 한다(동작은 project.js 의 initSideTree). 관리자만 쓰므로
관리자에게만 그린다. 색상 원은 window.PJ_COLORS(color_palette, 32색),
모두 include 한다(동작은 project.js 의 initSideTree). Pro user 이상만 쓰므로
그들에게만 그린다. 색상 원은 window.PJ_COLORS(color_palette, 32색),
아이콘은 window.PJ_ICONS(project_icons — Material Symbols 이름). #}
<script>
window.PJ_COLORS = {{ color_palette | tojson }};
window.PJ_ICONS = {{ (project_icons or []) | tojson }};
window.PJ_ASANA_ICONS = {{ (project_asana_icons or []) | tojson }}; {# 아사나 아이콘 탭 — 값은 "asana:" + 이름 #}
</script>
{% if is_admin %}
{% if pj_pro %}
<!-- 새 프로젝트 모달 — 좌측 프로젝트 목록의 + 버튼 -->
<div class="pj-modal" id="pj-modal-project" hidden>
<div class="pj-modal-card">
@@ -21,12 +22,13 @@
<div class="pj-field-label">색상
<span class="pj-color-palette" id="pj-f-colors"></span>
</div>
<div class="pj-field-label">아이콘
<div class="pj-field-label">아이콘<span class="pj-icon-tabs"></span>
<div class="pj-icon-palette" id="pj-f-icons"></div>
</div>
<div class="pj-field-label">멤버
<div class="pj-member-picker" id="pj-f-members">불러오는 중…</div>
</div>
<p class="pj-modal-msg" id="pj-f-project-msg" role="status" hidden></p>
<div class="pj-modal-actions">
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-project">만들기</button>
@@ -49,7 +51,7 @@
<div class="pj-field-label">색상
<span class="pj-color-palette" id="pj-e-colors"></span>
</div>
<div class="pj-field-label">아이콘
<div class="pj-field-label">아이콘<span class="pj-icon-tabs"></span>
<div class="pj-icon-palette" id="pj-e-icons"></div>
</div>
<label class="pj-time-toggle">
@@ -0,0 +1,295 @@
{% extends "project/_meeting_content_base.html" if meeting_embedded else "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{%- macro won(v) -%}{% if v is not none %}{{ "{:,}".format(v) }}{% endif %}{%- endmacro -%}
{%- macro num(v) -%}{% if v is not none %}{% if v == v | int %}{{ "{:,}".format(v | int) }}{% else %}{{ "{:,.2f}".format(v) }}{% endif %}{% endif %}{%- endmacro -%}
{% block content %}
{% set h = head if head is defined and head else {} %}
{% set unk = h.unknown or [] %}
{#- 머리 숫자 — 목표 표 매출 단위(예: 백만원)로, 원이거나 모르는 단위면 원. 정확한 원 금액은 말풍선 -#}
{%- macro unitv(v) -%}{% if h.unit_mult and h.unit_mult > 1 %}{{ "{:,.1f}".format(v / h.unit_mult).rstrip('0').rstrip('.') }}<small>{{ h.sales_unit }}</small>{% else %}{{ won(v) }}<small>원</small>{% endif %}{%- endmacro -%}
{%- macro unknown_val() -%}<span class="pj-meet-unknown" title="실적 조회 실패 — 알 수 없는 값이라 0 으로 보이지 않습니다">미확인</span>{%- endmacro -%}
{# 주간 회의록 — 목표 표 월 머리를 누르면 열린다(/project/goals/{연도}/meetings/{월}?week=주차 시작일).
주차(store.month_weeks — 그 달 안, 1주차는 1일부터)마다 회의록 하나: 머리 영역 3칸(월 계획 + 숫자 한 줄 | 결정 사항·메모 | 작업 등록)
+ 구역(목표 표 업무 영역)별 줄 — 주요 업무·정량 목표 | 지난주: 전주 업무·결과(글)·전주 목표·결과(금액).
지난주 칸은 바로 앞 주차 회의록의 같은 줄(연결키). 월 누적 실적은 실적 모듈, 월 누적 목표는 목표 표 주차별 목표 합.
입력은 누구나(완료 전까지, 칸별 즉시 저장, project.js initGoalMeeting). DB: project_db 015·020. #}
<div class="pj-wrap pj-inbox-view pj-goal-view pj-meet-view" data-me="{{ (user.email if user else '') | lower }}">
<div class="pj-layout">
{% if not meeting_embedded %}{% with current_pid = 0, side_active = "goals" %}{% include "project/_side.html" %}{% endwith %}{% endif %}
<section class="pj-main">
{# 머리 — 왼쪽: 제목·이전/다음 달·인쇄·회의록 삭제·주차 탭(한 줄) + 영역 3칸(월 계획·숫자 | 결정 사항 | 작업 등록) / 오른쪽 위: 작은 달력 #}
<div class="pj-meet-headgrid">
<div class="pj-meet-headleft">
<div class="pj-meet-title">
{# 연간 목표로 — 눈에 잘 띄는 큰 버튼(예전 ← 화살표 대신) #}
<a class="pj-meet-goalbtn" href="/project/goals/{{ goal_year }}" title="{{ goal_year }}년 연간 목표로"><span class="material-symbols-outlined">flag</span><span>{{ goal_year }}년 목표</span></a>
<h2 class="pj-goal-title">{{ goal_year }}년 {{ goal_month }}월 주간 회의록</h2>
{% set pm = goal_month - 1 if goal_month > 1 else 12 %}{% set py = goal_year if goal_month > 1 else goal_year - 1 %}
{% set nm = goal_month + 1 if goal_month < 12 else 1 %}{% set ny = goal_year if goal_month < 12 else goal_year + 1 %}
<a class="pj-btn pj-btn-sm" href="/project/goals/{{ py }}/meetings/{{ pm }}">‹ {{ pm }}월</a>
<a class="pj-btn pj-btn-sm" href="/project/goals/{{ ny }}/meetings/{{ nm }}">{{ nm }}월 ›</a>
{% if meeting %}
{# 회의록은 프로젝트 권한이 있는 누구나 고친다. [회의 완료](Pro user 이상) = 수정 잠금, 완료 뒤 [완료 해제](Pro user 이상) — 마이그레이션 022 #}
<span class="pj-meet-title-acts">
<button type="button" class="pj-btn pj-btn-sm" id="pj-meet-print"><span class="material-symbols-outlined">print</span> 인쇄</button>
{% if pj_pro %}<button type="button" class="pj-btn pj-btn-sm pj-btn-danger" id="pj-meet-del">회의록 삭제</button>{% endif %}
{% if meeting.can_complete %}
{% if meeting.completed %}
<span class="pj-meet-done-badge" title="{{ meeting.completed_at }}{% if meeting.completed_by %} · {{ meeting.completed_by }}{% endif %} — 완료된 회의록은 고칠 수 없습니다"><span class="material-symbols-outlined">lock</span>회의 완료</span>
{% if pj_pro %}<button type="button" class="pj-btn pj-btn-sm" id="pj-meet-reopen" title="다시 고칠 수 있게 엽니다">완료 해제</button>{% endif %}
{% elif pj_pro %}<button type="button" class="pj-btn pj-btn-sm pj-meet-complete-btn" id="pj-meet-complete" title="이 회의록을 더 고칠 수 없게 잠급니다(Pro user 이상)"><span class="material-symbols-outlined">task_alt</span>회의 완료</button>{% endif %}
{% endif %}
</span>
{% endif %}
{# 주차 탭 — 주차는 그 달 안(1일이 월~금이면 1일~일요일, 토·일이면 1일~다음 주 일요일, 말일이 월·화면 앞 주차에 붙음). 점 = 회의록 있음 #}
<nav class="pj-meet-weeks" aria-label="주차">
{% for w in weeks %}
<a class="pj-meet-week{% if w.start == week %} is-on{% endif %}{% if w.now %} is-now{% endif %}"
href="?week={{ w.start }}" title="{{ w.n }}주차 {{ w.label }}">
{# 날짜는 짧게 — 주차는 달을 넘지 않아 끝 월 생략(10/5~11) #}
{% set ws = w.start.split('-') %}{% set we = w.end.split('-') %}
<b>{{ w.n }}주차</b><span>{{ ws[1] | int }}/{{ ws[2] | int }}~{% if we[1] != ws[1] %}{{ we[1] | int }}/{% endif %}{{ we[2] | int }}</span>
{% if w.has %}<i class="pj-meet-dot" title="회의록 있음"></i>{% endif %}
{% if w.now %}<em>이번 주</em>{% endif %}
</a>
{% endfor %}
</nav>
</div>
{# ── 머리 영역 3칸(스크롤해도 보임 — 표만 아래 .pj-meet-pane 에서 스크롤) ──
① 월 계획 + 머리 줄 오른쪽에 숫자 4개를 작게 한 줄로 ② 결정 사항·메모 ③ 작업 빠른 등록 표(project.js initMeetQuickTasks) #}
<div class="pj-meet-board">
<section class="pj-meet-area pj-meet-plan">
<div class="pj-meet-plan-head">
<span class="pj-meet-plan-title"><span class="material-symbols-outlined">event_note</span>{{ goal_month }}월 계획</span>
{% if h %}
<div class="pj-meet-kpiline">
<span class="pj-meet-kpi" title="월 목표 매출(연간 목표 표){% if h.month_target_won is not none %} = {{ won(h.month_target_won) }}원{% endif %}">
<span class="pj-meet-kpi-label">월 목표</span>
<span class="pj-meet-kpi-val">{% if h.sales_target is not none %}{{ num(h.sales_target) }}<small>{{ h.sales_unit }}</small>{% else %}<span class="pj-muted">—</span>{% endif %}</span>
</span>
<span class="pj-meet-kpi" title="월 누적 목표 매출{% if h.cum_target_won is not none %} {{ won(h.cum_target_won) }}원{% endif %} — 연간 목표 표에서 입력한 주차별 매출 목표의 1주차~{{ week_n }}주차 합계{% if not h.week_targets_set %} — 목표 표에서 주차별 목표를 입력하세요{% endif %}">
<span class="pj-meet-kpi-label">누적 목표 <small>({{ week_n }}주차)</small></span>
<span class="pj-meet-kpi-val">{% if h.cum_target_won is not none %}{{ unitv(h.cum_target_won) }}{% else %}<span class="pj-muted">—</span>{% endif %}</span>
</span>
<span class="pj-meet-kpi" title="월 누적 실적{% if h.mtd is not none %} {{ won(h.mtd) }}원{% endif %}(1일~{{ h.mtd_end[5:] | replace('-', '/') if h.mtd_end else '' }}){% if h.fresh_tip %} · {{ h.fresh_tip }}{% endif %}">
<span class="pj-meet-kpi-label">누적 실적 {% if h.mtd_end %}<small>({{ h.mtd_end[5:] | replace('-', '/') }})</small>{% endif %}</span>
<span class="pj-meet-kpi-val">{% if h.mtd is not none %}{{ unitv(h.mtd) }}{% elif 'mtd' in unk %}{{ unknown_val() }}{% else %}<span class="pj-muted">—</span>{% endif %}</span>
</span>
<span class="pj-meet-kpi" title="누적 목표 대비 달성{% if h.gap is not none %} {{ '+' if h.gap > 0 else '' }}{{ won(h.gap) }}원{% endif %} — 월 누적 실적 − 월 누적 목표 매출 (월 누적 실적 ÷ 월 누적 목표 매출)">
<span class="pj-meet-kpi-label">목표 대비</span>
{% if h.gap is not none %}<span class="pj-meet-kpi-val {{ 'is-good' if h.gap >= 0 else 'is-low' }}">{{ '+' if h.gap > 0 else '' }}{{ unitv(h.gap) }}{% if h.rate is not none %} <small class="pj-meet-kpi-rate">{{ h.rate }}%</small>{% endif %}</span>
{% elif 'mtd' in unk and h.cum_target_won is not none %}<span class="pj-meet-kpi-val">{{ unknown_val() }}</span>
{% else %}<span class="pj-meet-kpi-val"><span class="pj-muted">—</span></span>{% endif %}
</span>
</div>
{% endif %}
</div>
<div class="pj-meet-area-body">
{% if month_plan is none %}<p class="pj-meet-plan-empty">연간 목표 표가 없어 월 계획을 보여 줄 수 없습니다.</p>
{% elif month_plan %}
<div class="pj-meet-plan-grid">
{% for a in month_plan %}
<div class="pj-meet-plan-area" style="--goal-bg: {{ a.color or '#f4f5f7' }}">
<b class="pj-meet-plan-name">{{ a.name }}</b>
{% for it in a.lines %}
<div class="pj-meet-plan-item">{% if it.label %}<span class="pj-meet-plan-label">{{ it.label }}</span>{% endif %}<span class="pj-meet-plan-text">{{ it.text_html | safe }}</span>{% if it.range %}<em>{{ it.range }}</em>{% endif %}</div>
{% endfor %}
</div>
{% endfor %}
</div>
{% else %}<p class="pj-meet-plan-empty">목표 표에 {{ goal_month }}월 계획이 아직 없습니다.</p>{% endif %}
</div>
</section>
<section class="pj-meet-area pj-meet-notes">
<h3>결정사항 : 진행상황 수시 공유 및 완료 되어야 함</h3>
{% if meeting %}
{% if not meeting.completed %}<textarea id="pj-meet-notes" rows="4" placeholder="이번 회의에서 정한 것, 다음 주까지 확인할 것">{{ meeting.notes }}</textarea>
{% else %}<div class="pj-meet-ro">{{ meeting.notes or '—' }}</div>{% endif %}
{% else %}<p class="pj-meet-plan-empty">이 주차 회의록을 만들면 적을 수 있습니다.</p>{% endif %}
</section>
<section class="pj-meet-area pj-meet-quick" id="pj-meet-quick">
<h3>작업 등록 <small>제목을 쓰고 담당자·프로젝트·섹션 칸을 눌러 고른 뒤 [적용]</small></h3>
<div class="pj-meet-area-body">
<table class="pj-meet-quick-table">
<thead><tr><th>제목</th><th>담당자</th><th>프로젝트</th><th>섹션</th><th></th></tr></thead>
<tbody></tbody>
</table>
<button type="button" class="pj-meet-quick-add" data-quick="add">+ 줄 추가</button>
</div>
</section>
</div>
</div>
{# 작은 달력 — 월요일 시작 줄, 줄을 누르면 그 줄의 이 달 날짜가 든 주차 회의록(보고 있는 주차의 줄은 영역 표시). 점 = 회의록 있음. #}
<div class="pj-meet-cal" aria-label="{{ goal_month }}월 달력">
<div class="pj-meet-cal-head">{{ goal_year }}년 {{ goal_month }}월</div>
<div class="pj-meet-cal-wd"><span>월</span><span>화</span><span>수</span><span>목</span><span>금</span><span class="is-sat">토</span><span class="is-sun">일</span></div>
{% for w in cal_weeks %}
<a class="pj-meet-cal-row{% if w.start == week %} is-on{% endif %}{% if not w.own %} is-other{% endif %}" href="{{ w.href }}"
title="{{ w.title }}{% if w.has %} · 회의록 있음{% endif %}">
{% for d in w.days %}<span class="pj-meet-cal-d{% if not d.in %} is-out{% endif %}{% if d.today %} is-today{% endif %}{% if d.wd == 5 %} is-sat{% endif %}{% if d.wd == 6 or d.hol %} is-sun{% endif %}"{% if d.hol %} title="{{ d.hol }}"{% endif %}>{{ d.d }}</span>{% endfor %}
{% if w.has %}<i class="pj-meet-cal-dot"></i>{% endif %}
</a>
{% endfor %}
</div>
</div>
{% if meeting and not meeting.completed %}{% include "project/_cell_format.html" %}{% endif %}
<div class="pj-view pj-meet-pane" id="pj-meet-pane" data-week="{{ week }}" data-year="{{ goal_year }}"
data-month="{{ goal_month }}" data-pro="{{ 'true' if pj_pro else 'false' }}"
data-edit="{{ 'true' if meeting and not meeting.completed else 'false' }}">
{% if not meetings_enabled %}
<div class="pj-empty">주간 회의록이 아직 준비되지 않았습니다(DB 마이그레이션 015 필요).</div>
{% elif not meeting %}
<div class="pj-empty pj-goal-empty">
<p>{{ week_n }}주차({{ week }} ~ {{ week_end }}) 회의록이 아직 없습니다.</p>
{% if true %}
<p class="pj-goal-empty-sub">만들면 앞선 회의록의 줄(구역·항목)을 이어받아, 지난주 업무·목표·결과를 나란히 리뷰할 수 있습니다.
처음이면 {{ goal_year }}년 목표 표의 업무 영역과 기본 양식 줄로 시작합니다.</p>
<button type="button" class="pj-btn pj-btn-primary" id="pj-meet-create">{{ week_n }}주차 회의록 만들기</button>
{% endif %}
</div>
{% else %}
{% set edit = not meeting.completed %} {# 누구나 고친다 — 회의 완료(022)면 잠금 #}
{# 매출 자료 갱신 — 주차를 열면 실적 모듈 매출 업데이트(지난 주차 시작 ~ 이 주차 오늘)를 한 번 더 돌리고 숫자 칸만 다시 그린다
(project.js initMeetingSync, 같은 주는 10분에 한 번). 정상이면 아무것도 보이지 않는다(2026-10-01 요청 — 큰 상태 줄 없음).
실패·일부 실패면 이 작은 안내 + [다시 시도], 실적 권한이 없으면 부르지 않고 한 줄 설명. 마지막 갱신 성공 시각은 서버 기록(data-fresh). #}
{% if h.perf and sync_from %}<div id="pj-meet-sync" class="pj-meet-syncnote" hidden role="status" aria-live="polite"
data-from="{{ sync_from }}" data-to="{{ sync_to }}" data-can="{{ '1' if can_sync else '0' }}" data-fresh="{{ h.fresh_oldest }}">
<span class="material-symbols-outlined" aria-hidden="true">sync_problem</span><span class="pj-meet-sync-text"></span>
<button type="button" class="pj-btn pj-btn-sm" id="pj-meet-sync-btn" hidden>다시 시도</button>
</div>{% endif %}
{% if not h.perf %}<p class="pj-goal-note">실적 모듈이 연결되지 않아 실적·누적은 비어 있습니다.</p>
{% elif h.perf_state == 'error' %}<p class="pj-goal-note pj-meet-perf-warn">실적 모듈 쇼핑몰 목록을 읽지 못해 실적·누적을 <b>미확인</b>으로 표시합니다(0 원이 아님). 회의록 입력은 그대로 됩니다.</p>
{% elif h.perf_state == 'empty' %}<p class="pj-goal-note">실적 모듈에 매출 집계 쇼핑몰이 없어 실적·누적은 비어 있습니다.</p>
{% elif unk %}<p class="pj-goal-note pj-meet-perf-warn">일부 실적을 읽지 못했습니다 — <b>미확인</b> 칸은 0 원이 아니라 알 수 없는 값입니다.</p>{% endif %}
{# 참석자 — 전체 멤버에서 고른다(칩, [참석자] = 고르기 창). 저장은 이메일을 쉼표로 이어서, 예전 자유 입력 글자도 칩으로 #}
<div class="pj-meet-attend">
<span class="pj-meet-attend-label">참석자</span>
<div class="pj-meet-attend-chips" id="pj-meet-attend"{% if edit %} data-edit="1"{% endif %}>
{% for a in attendee_list %}<span class="pj-meet-chip" data-key="{{ a.key }}" data-name="{{ a.name }}" data-avatar="{{ a.avatar }}"{% if not a.email %} title="멤버가 아닌 글자(예전 입력)"{% endif %}>
{%- if a.avatar %}<img class="pj-avatar" src="{{ a.avatar }}" alt="" referrerpolicy="no-referrer">{% else %}<span class="pj-meet-chip-ini">{{ a.name[:1] }}</span>{% endif %}<span>{{ a.name }}</span>
{%- if edit %}<button type="button" class="pj-meet-chip-x" title="빼기" aria-label="{{ a.name }} 빼기">×</button>{% endif %}</span>{% endfor %}
{% if edit %}<button type="button" class="pj-meet-attend-add" id="pj-meet-attend-add"><span class="material-symbols-outlined">person_add</span>참석자</button>
{% elif not attendee_list %}<span class="pj-muted">—</span>{% endif %}
</div>
{# 회의록 보드 — 그 주차의 빈 Google 슬라이드를 독립 창으로(없으면 공유 드라이브에 만든다, project.js initMeetBoard) #}
<button type="button" class="pj-btn pj-btn-sm pj-meet-board-btn" id="pj-meet-board"
title="이 주차의 Google 슬라이드 보드를 새 창으로 엽니다(처음이면 공유 드라이브에 빈 슬라이드를 만듭니다)">
<span class="material-symbols-outlined">co_present</span>회의록 보드</button>
{# 회의록 보드 링크 복사(2026-10-08) — 같은 주차 보드 주소(없으면 만든 뒤)를 클립보드로 #}
<button type="button" class="pj-icon-btn pj-meet-board-copy" id="pj-meet-board-copy"
title="회의록 보드 링크 복사" aria-label="회의록 보드 링크 복사"><span class="material-symbols-outlined">link</span></button>
</div>
{# ── 구역별 줄 — 왼쪽: 이번주 / 오른쪽: 전주 리뷰(지난 회의록 같은 줄) ── #}
<table class="pj-meet-table" id="pj-meet-table" data-cell-merges="{{ 'true' if meeting.cell_merges else 'false' }}">
{# table-layout: fixed 는 첫 줄(묶음 머리, colspan)로 너비를 정하므로 열 너비는 colgroup 으로 #}
<colgroup>
{# is-this / is-prev — 순서 바꾸기(project.js initMeetOrder)가 이 묶음으로 열을 옮긴다 #}
<col class="pj-meet-w-sec" data-meet-col="section" /><col class="pj-meet-w-label" data-meet-col="label" /><col class="is-this" data-meet-col="content" /><col class="pj-meet-w-amt is-this" data-meet-col="target" />
<col class="is-prev" data-meet-col="prev_content" /><col class="is-prev" data-meet-col="prev_note" /><col class="pj-meet-w-amt is-prev" data-meet-col="prev_target" /><col class="pj-meet-w-amt is-prev" data-meet-col="result" />
</colgroup>
<thead>
<tr class="pj-meet-group">
{# 이번주 ↔ 지난주 리뷰 순서 바꾸기 — 보는 사람마다 브라우저에 기억(localStorage pj_meet_order:{이메일}) #}
<th colspan="2" class="pj-meet-order-cell"><button type="button" class="pj-meet-order-btn" id="pj-meet-order"
title="이번주와 지난주 리뷰의 순서 바꾸기(내 화면에 기억)"><span class="material-symbols-outlined">swap_horiz</span>순서 바꾸기</button></th>
<th colspan="2" class="is-this">이번주 ({{ week[5:] | replace('-', '/') }} ~ {{ week_end[5:] | replace('-', '/') }})</th>
{# 지난주 = 바로 앞 주차 — 줄의 지난주 칸·결과도 그 주차 회의록의 같은 줄(연결키)만 #}
<th colspan="4" class="is-prev">지난주 리뷰 ({{ prev_week[5:] | replace('-', '/') }} ~ {{ prev_week_end[5:] | replace('-', '/') }}){% if not h.prev_exists %} <span class="pj-meet-noprev">— 이 주 회의록 없음</span>{% endif %}</th>
</tr>
<tr>
<th class="pj-meet-c-sec">구분</th>
<th class="pj-meet-c-label">항목</th>
<th class="pj-meet-c-text">주요 업무</th>
<th class="pj-meet-c-amt">정량 목표</th>
<th class="pj-meet-c-text is-prev">전주 업무</th>
<th class="pj-meet-c-text is-prev">결과</th>
<th class="pj-meet-c-amt is-prev">전주 목표</th>
<th class="pj-meet-c-amt is-prev">결과</th>
</tr>
</thead>
{% for sec in meeting.sections %}
<tbody class="pj-meet-sec" data-section="{{ sec.name }}" style="--goal-bg: {{ sec.color or '#fff' }}">
{% for it in sec.rows %}
{% set p = it.prev %}
<tr data-item="{{ it.id }}" data-section="{{ sec.name }}" data-market="{{ it.marketplace_code }}" data-target-amount="{{ it.target_amount if it.target_amount is not none else '' }}"{% if p %} data-prev="{{ p.id }}" data-prev-target="{{ p.target_amount if p.target_amount is not none else '' }}"{% endif %}>
{% if loop.first %}
<th class="pj-meet-c-sec" rowspan="{{ sec.rows | length }}">{{ sec.name }}
{% if edit %}<button type="button" class="pj-meet-sec-add" data-meet-act="sec-add" title="{{ sec.name }} 구역 끝에 줄 추가">+</button>{% endif %}
</th>
{% endif %}
<th class="pj-meet-c-label">
<span class="pj-meet-label-line">
<span class="pj-meet-label"{% if edit %} data-meet-edit="label" title="눌러서 이름 수정 · 우클릭 = 줄 메뉴"{% endif %}>{{ it.label }}</span>
</span>
{% if edit %}<button type="button" class="pj-icon-btn pj-meet-more" data-meet-act="menu" title="줄 메뉴"><span class="material-symbols-outlined">more_horiz</span></button>{% endif %}
</th>
{% if not it.content_hidden %}
<td class="pj-meet-c-text" rowspan="{{ it.content_span or 1 }}" data-meet-item="{{ it.id }}">
{% if edit %}<div class="pj-meet-text pj-goal-text" contenteditable="true" role="textbox" aria-multiline="true" aria-label="{{ it.label }} 주요 업무" data-field="content" data-placeholder="주요 업무">{% if it.content_html is defined %}{{ it.content_html | safe }}{% else %}{{ it.content }}{% endif %}</div>
{% else %}<div class="pj-meet-ro">{% if it.content_html is defined %}{{ it.content_html | safe }}{% else %}{{ it.content }}{% endif %}</div>{% endif %}
</td>
{% endif %}
<td class="pj-meet-c-amt">
{# 숫자(원, 120만·1.5억도) 또는 글(예: 20개 — 021 target_text) #}
{% if edit %}<input type="text" class="pj-meet-amount" data-field="target_amount" autocomplete="off" value="{{ it.target_text or won(it.target_amount) }}" />
{% else %}{{ it.target_text or won(it.target_amount) }}{% endif %}
</td>
{% if p %}
<td class="pj-meet-c-text is-prev"><div class="pj-meet-ro">{% if p.content_html is defined %}{{ p.content_html | safe }}{% else %}{{ p.content }}{% endif %}</div></td>
{# 결과(글) — 지난 주차 줄의 result_note(020). 미적용이면 보기만 #}
<td class="pj-meet-c-text is-prev pj-meet-c-note">
{% if edit and meeting.result_notes %}<textarea class="pj-meet-rnote" rows="1" data-field="result_note" data-target="prev" aria-label="{{ it.label }} 결과" placeholder="결과">{{ p.result_note or '' }}</textarea>
{% else %}<div class="pj-meet-ro">{{ p.result_note or '' }}</div>{% endif %}
</td>
<td class="pj-meet-c-amt is-prev">{{ p.target_text or won(p.target_amount) }}</td>
<td class="pj-meet-c-amt is-prev pj-meet-c-result">
{% if edit %}<input type="text" class="pj-meet-amount" data-field="result_amount" data-target="prev" autocomplete="off" value="{{ p.result_text or won(p.result_amount) }}" placeholder="결과" />
{% else %}{{ p.result_text or won(p.result_amount) }}{% endif %}
</td>
{% else %}
<td class="pj-meet-c-text is-prev is-none" colspan="4"><span class="pj-muted">{% if h.prev_exists %}지난주 회의록에 없는 줄{% else %}지난주({{ prev_week[5:] | replace('-', '/') }}~) 회의록 없음{% endif %}</span></td>
{% endif %}
</tr>
{% endfor %}
</tbody>
{% endfor %}
</table>
{% if edit %}<p class="pj-goal-note">글자를 선택하면 색상·크기·굵게·기울임·밑줄·서식 초기화를 사용할 수 있습니다.
셀 오른쪽 경계는 너비 조절·더블클릭 자동 맞춤, 우클릭은 현재/전체 열 자동 맞춤입니다.
주요 업무 셀의 위·아래·왼쪽 테두리를 끌면 내용과 서식을 옮깁니다.
같은 구역에서 끌기·Shift+클릭으로 범위를 선택한 뒤 Del로 지우고 Ctrl+Z로 되돌립니다.
{% if meeting.cell_merges %}우클릭으로 세로 셀 병합·병합 해제를 사용할 수 있습니다.{% endif %}</p>{% endif %}
{% if edit %}
<div class="pj-goal-foot">
<button type="button" class="pj-btn" id="pj-meet-sec-new">+ 구역 추가</button>
<span class="pj-goal-note">칸을 고치면 바로 저장됩니다. 금액은 원 단위(120만·1.5억도 됨). 항목을 우클릭하거나 ⋯ 를 누르면
줄 추가·순서·삭제. 정량 목표·결과는 숫자나 글(예: 20개) 모두 됩니다. 지난주 결과는 지난 주차 회의록 줄에 저장됩니다.</span>
</div>
{% endif %}
{% endif %}
</div>
</section>
</div>
</div>
<script>window.PJ_MEET_MEMBERS = {{ (meet_members or []) | tojson }};</script>
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project-goal-text.js?v=20261003d" defer></script>
<script src="/static/project-meeting-cells.js?v=20261007a" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -11,7 +11,7 @@
{# 연간 목표 — 좌측 사이드바 "목표" → 연도. 스프레드시트처럼 한 표에
① 매출(목표·실적·달성)·로아스(목표·실적) 월별 숫자
② 업무 영역(상품·마케팅·컨텐츠·유통 …)별 연간·월별 글.
입력·구조 변경은 관리자만(칸별 즉시 저장, project.js initGoals), 나머지는 보기만.
입력·구조 변경은 Pro user 이상(칸별 즉시 저장, project.js initGoals), 나머지는 보기만.
DB: project_db 013 (goal_years·goal_metrics·goal_areas·goal_rows·goal_cells). #}
<div class="pj-wrap pj-inbox-view pj-goal-view">
<div class="pj-layout">
@@ -19,10 +19,10 @@
<section class="pj-main">
<div class="pj-section-head">
<h2>{{ goal_year }}년 목표</h2>
<h2 class="pj-goal-title">{{ goal_year }}년 목표</h2>
{% if board %}
<div class="pj-goal-head-acts">
{% if is_admin %}
{% if pj_pro %}
<label class="pj-goal-unit">매출 단위
<input type="text" id="pj-goal-unit" maxlength="20" placeholder="예: 백만원"
value="{{ board.sales_unit }}" data-year="{{ goal_year }}" />
@@ -31,19 +31,22 @@
data-year="{{ goal_year }}">연도 삭제</button>
{% else %}
{% if board.sales_unit %}<span class="pj-goal-unit-ro">매출 단위: {{ board.sales_unit }}</span>{% endif %}
<span class="pj-goal-note">목표는 관리자만 입력할 수 있습니다.</span>
<span class="pj-goal-note">목표는 Pro user 이상만 입력할 수 있습니다.</span>
{% endif %}
</div>
{% endif %}
</div>
{% if pj_pro and goals_enabled and board %}
{% include "project/_cell_format.html" %}
{% endif %}
<div class="pj-view pj-goal-pane" id="pj-goal-pane">
{% if not goals_enabled %}
<div class="pj-empty">연간 목표가 아직 준비되지 않았습니다(DB 마이그레이션 013 필요).</div>
{% elif not board %}
<div class="pj-empty pj-goal-empty">
<p>{{ goal_year }}년 목표가 아직 없습니다.</p>
{% if is_admin %}
{% if pj_pro %}
<p class="pj-goal-empty-sub">만들면 가장 가까운 이전 연도의 업무 영역 구성을 그대로 가져옵니다(처음이면 상품·마케팅·컨텐츠·유통).</p>
<button type="button" class="pj-btn pj-btn-primary" id="pj-goal-create" data-year="{{ goal_year }}">{{ goal_year }}년 목표 만들기</button>
{% endif %}
@@ -51,100 +54,130 @@
{% else %}
{% set sm = board.metrics.sales %}
{% set rm = board.metrics.roas %}
{# 월 칸은 pj-goal-m + data-h(분기 1~4) — 분기 접기(initGoals)가 이걸로 숨긴다.
분기 칸 클래스는 예전 이름 pj-goal-half-col 그대로(연간 칸처럼 굵게·회색 합계) #}
{# 매출 목표 칸(020) — 누르면 그 달 월 목표(직접 입력)·주차별 목표 입력 창, 맨 아래 차이(월 목표 − 주차 합계) #}
{% macro num_cell(metric, kind, labels, mo) -%}
<td class="pj-goal-numtd{% if mo == this_month %} is-now{% endif %}">
{%- if is_admin -%}
{%- set weekly = week_targets and metric == 'sales' and kind == 'target' -%}
<td class="pj-goal-numtd pj-goal-m{% if mo == this_month %} is-now{% endif %}{% if weekly %} is-weekly{% endif %}" data-h="{{ (mo - 1) // 3 + 1 }}">
{%- if pj_pro -%}
<input type="text" class="pj-goal-num" inputmode="decimal" autocomplete="off"
data-metric="{{ metric }}" data-kind="{{ kind }}" data-month="{{ mo }}"
{%- if weekly %} readonly data-weekly="1" title="{{ mo }}월 목표·주차별 목표 입력"{% endif %}
value="{{ labels.get(mo, '') }}" />
{%- else -%}
<span class="pj-goal-num" data-metric="{{ metric }}" data-kind="{{ kind }}" data-month="{{ mo }}">{{ labels.get(mo, '') }}</span>
<span class="pj-goal-num" data-metric="{{ metric }}" data-kind="{{ kind }}" data-month="{{ mo }}"
{%- if weekly %} data-weekly="1" tabindex="0" title="{{ mo }}월 주차별 목표 보기"{% endif %}>{{ labels.get(mo, '') }}</span>
{%- endif -%}
</td>
{%- endmacro %}
<table class="pj-goal-table" id="pj-goal-table" data-year="{{ goal_year }}"
data-admin="{{ 'true' if is_admin else 'false' }}">
data-pro="{{ 'true' if pj_pro else 'false' }}"
data-halves="{{ 'true' if board.halves else 'false' }}">
<thead>
<tr>
{# 오른쪽 끝을 끌어 이름 칸 너비 조절 — 브라우저에 기억(localStorage pj_goal_col_w) #}
<th class="pj-goal-c1"><span class="pj-goal-colresize" data-col="c1" title="끌어서 너비 조절"></span></th>
<th class="pj-goal-c2"><span class="pj-goal-colresize" data-col="c2" title="끌어서 너비 조절"></span></th>
<th class="pj-goal-year-col">연간</th>
{% for mo in months %}<th class="{% if mo == this_month %}is-now{% endif %}">{{ mo }}월</th>{% endfor %}
{# 연간·월·분기 칸도 머리 칸 오른쪽 끝을 끌어 너비 조절(data-col: y · m1~m12 · q1~q4) #}
<th class="pj-goal-year-col" data-col="y">연간<span class="pj-goal-colresize" data-col="y" title="끌어서 너비 조절"></span></th>
{% for h, hmonths, hm, hname in quarters %}
{# 월 이름을 누르면 그 달 주간 회의록(/goals/{연도}/meetings/{월}) #}
{% for mo in hmonths %}<th class="pj-goal-m{% if mo == this_month %} is-now{% endif %}" data-h="{{ h }}" data-col="m{{ mo }}"><a class="pj-goal-mlabel pj-goal-mlink" href="/project/goals/{{ goal_year }}/meetings/{{ mo }}" title="{{ mo }}월 주간 회의록">{{ mo }}월</a><span class="pj-goal-colresize" data-col="m{{ mo }}" title="끌어서 너비 조절"></span></th>{% endfor %}
{# 분기 칸 — 머리 칸 아무 곳이나 누르면 그 분기의 월 칸을 접었다 편다(localStorage pj_goal_fold_q).
아이콘은 엑셀 열 그룹처럼 네모 안 − (펼침, 누르면 접힘) / + (접힘, 누르면 펼침).
분기 색(data-h → --qc)은 머리 위 색 띠(월 가늘게·분기 두껍게)와 분기 열 옅은 음영 #}
<th class="pj-goal-half-col pj-goal-fold-th" data-h="{{ h }}" data-col="q{{ h }}">
<button type="button" class="pj-goal-fold" data-h="{{ h }}" aria-expanded="true"
data-label="{{ hmonths[0] }}~{{ hmonths[-1] }}월"
title="{{ hmonths[0] }}~{{ hmonths[-1] }}월 접기"><svg class="pj-goal-fold-ic" viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" aria-hidden="true"><rect x="1.75" y="1.75" width="12.5" height="12.5" rx="3"/><path d="M5 8h6"/><path class="pj-goal-fold-v" d="M8 5v6"/></svg></button>{{ hname }}
<span class="pj-goal-colresize" data-col="q{{ h }}" title="끌어서 너비 조절"></span>
</th>
{% endfor %}
</tr>
</thead>
{# ── 숫자 지표 ── #}
{# ── 숫자 지표 — 연간·분기 칸은 화면에서 계산(매출 합계·달성률, 로아스 매출 가중 평균), 로아스는 % 단위 ── #}
<tbody class="pj-goal-kpi">
<tr>
<th class="pj-goal-c1" rowspan="3">매출</th>
<th class="pj-goal-c2">목표</th>
<td class="pj-goal-sum" data-metric="sales" data-kind="target"></td>
{% for mo in months %}{{ num_cell("sales", "target", sm.target_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-year-col" data-metric="sales" data-kind="target" data-scope="0"></td>
{% for h, hmonths, hm, hname in quarters %}
{% for mo in hmonths %}{{ num_cell("sales", "target", sm.target_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-half-col" data-metric="sales" data-kind="target" data-scope="{{ hm }}" data-h="{{ h }}"></td>
{% endfor %}
</tr>
<tr>
<th class="pj-goal-c2">실적</th>
<td class="pj-goal-sum" data-metric="sales" data-kind="actual"></td>
{% for mo in months %}{{ num_cell("sales", "actual", sm.actual_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-year-col" data-metric="sales" data-kind="actual" data-scope="0"></td>
{% for h, hmonths, hm, hname in quarters %}
{% for mo in hmonths %}{{ num_cell("sales", "actual", sm.actual_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-half-col" data-metric="sales" data-kind="actual" data-scope="{{ hm }}" data-h="{{ h }}"></td>
{% endfor %}
</tr>
<tr class="pj-goal-rate-row">
<th class="pj-goal-c2">달성</th>
<td class="pj-goal-rate" data-month="0"></td>
{% for mo in months %}<td class="pj-goal-rate{% if mo == this_month %} is-now{% endif %}" data-month="{{ mo }}"></td>{% endfor %}
<td class="pj-goal-rate pj-goal-year-col" data-month="0"></td>
{% for h, hmonths, hm, hname in quarters %}
{% for mo in hmonths %}<td class="pj-goal-rate pj-goal-m{% if mo == this_month %} is-now{% endif %}" data-h="{{ h }}" data-month="{{ mo }}"></td>{% endfor %}
<td class="pj-goal-rate pj-goal-half-col" data-month="{{ hm }}" data-h="{{ h }}"></td>
{% endfor %}
</tr>
<tr>
<th class="pj-goal-c1" rowspan="2">로아스</th>
<th class="pj-goal-c2">목표</th>
<td class="pj-goal-sum pj-goal-sum-na"></td>
{% for mo in months %}{{ num_cell("roas", "target", rm.target_label, mo) }}{% endfor %}
{# 로아스 연간·분기 = 월 매출로 가중한 평균(광고비 = 매출 ÷ 로아스로 환산) — project.js recompute #}
<td class="pj-goal-sum pj-goal-year-col" data-metric="roas" data-kind="target" data-scope="0"></td>
{% for h, hmonths, hm, hname in quarters %}
{% for mo in hmonths %}{{ num_cell("roas", "target", rm.target_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-half-col" data-metric="roas" data-kind="target" data-scope="{{ hm }}" data-h="{{ h }}"></td>
{% endfor %}
</tr>
<tr>
<th class="pj-goal-c2">실적</th>
<td class="pj-goal-sum pj-goal-sum-na"></td>
{% for mo in months %}{{ num_cell("roas", "actual", rm.actual_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-year-col" data-metric="roas" data-kind="actual" data-scope="0"></td>
{% for h, hmonths, hm, hname in quarters %}
{% for mo in hmonths %}{{ num_cell("roas", "actual", rm.actual_label, mo) }}{% endfor %}
<td class="pj-goal-sum pj-goal-half-col" data-metric="roas" data-kind="actual" data-scope="{{ hm }}" data-h="{{ h }}"></td>
{% endfor %}
</tr>
</tbody>
{# ── 업무 영역 — 영역마다 tbody 하나, 배경은 영역 색 ── #}
{# ── 업무 영역 — 영역마다 tbody 하나, 배경은 영역 색. 이름은 눌러서 그 자리에서 수정(Pro user 이상) ── #}
{% for area in board.areas %}
<tbody class="pj-goal-area" data-area-id="{{ area.id }}" style="--goal-bg: {{ area.color or '#fff' }}">
<tbody class="pj-goal-area" data-area-id="{{ area.id }}" data-color="{{ area.color }}" style="--goal-bg: {{ area.color or '#fff' }}">
{% for row in area.rows %}
<tr data-row-id="{{ row.id }}">
{% if loop.first %}
<th class="pj-goal-c1 pj-goal-area-name" rowspan="{{ area.rows | length }}">
<span class="pj-goal-area-text">{{ area.name }}</span>
{% if is_admin %}
<span class="pj-goal-tools">
<button type="button" class="pj-icon-btn" data-goal-act="area-rename" data-name="{{ area.name }}" title="이름 바꾸기">✎</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-color" data-color="{{ area.color }}" title="색 바꾸기"><span class="material-symbols-outlined">palette</span></button>
<button type="button" class="pj-icon-btn" data-goal-act="area-up" title="위로">↑</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-down" title="아래로">↓</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-add" title="줄 추가">+</button>
<button type="button" class="pj-icon-btn" data-goal-act="area-del" data-name="{{ area.name }}" title="영역 삭제">×</button>
</span>
{% endif %}
{# 구역 메뉴(색·위로·아래로·줄 추가·영역 삭제) — 우클릭 또는 ⋮ 버튼(키보드 Tab → Enter/Space, 터치 탭). project.js areaMenuItems #}
<span class="pj-goal-area-text"{% if pj_pro %} data-goal-edit="area" tabindex="0" role="button" title="눌러서 이름 수정(Enter) · 우클릭·⋮ = 메뉴"{% endif %}>{{ area.name }}</span>
{% if pj_pro %}<button type="button" class="pj-goal-menu-btn" data-goal-menu="area" aria-haspopup="menu" aria-expanded="false"
aria-label="{{ area.name }} 구역 메뉴" title="구역 메뉴"><span class="material-symbols-outlined" aria-hidden="true">more_vert</span></button>{% endif %}
</th>
{% endif %}
<th class="pj-goal-c2 pj-goal-row-label">
<span class="pj-goal-row-text">{{ row.label }}</span>
{% if is_admin %}
<span class="pj-goal-tools">
<button type="button" class="pj-icon-btn" data-goal-act="row-rename" data-label="{{ row.label }}" title="줄 이름 바꾸기">✎</button>
{% if area.rows | length > 1 %}
<button type="button" class="pj-icon-btn" data-goal-act="row-up" title="위로">↑</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-down" title="아래로">↓</button>
<button type="button" class="pj-icon-btn" data-goal-act="row-del" data-label="{{ row.label }}" title="줄 삭제">×</button>
{% endif %}
</span>
{% endif %}
{# 항목 칸(2열) — 같은 항목 칸으로 묶인 줄(016 label_cont)은 묶음 첫 줄이 rowspan 으로 덮는다 #}
{% if not row.label_cont %}
<th class="pj-goal-c2 pj-goal-row-label"{% if (row.label_span or 1) > 1 %} rowspan="{{ row.label_span }}"{% endif %} data-label-span="{{ row.label_span or 1 }}">
<span class="pj-goal-row-text"{% if pj_pro %} data-goal-edit="row" tabindex="0" role="button" title="눌러서 줄 이름 수정(Enter) · 우클릭·⋮ = 메뉴"{% endif %}>{{ row.label }}</span>
{% if pj_pro %}<button type="button" class="pj-goal-menu-btn" data-goal-menu="row" aria-haspopup="menu" aria-expanded="false"
aria-label="{{ (row.label or '이름 없는') }} 줄 메뉴" title="줄 메뉴"><span class="material-symbols-outlined" aria-hidden="true">more_vert</span></button>{% endif %}
</th>
{% for mo in [0] + months %}
<td class="pj-goal-texttd{% if mo == 0 %} pj-goal-year-col{% endif %}{% if mo == this_month %} is-now{% endif %}">
{%- if is_admin -%}
<textarea class="pj-goal-text" rows="1" data-row="{{ row.id }}" data-month="{{ mo }}"
placeholder="{{ '연간 목표' if mo == 0 else '' }}">{{ row.cells.get(mo, '') }}</textarea>
{% endif %}
{# 칸 배치는 router._goal_area_layout — 엑셀식 사각형 병합(colspan·rowspan), 가려진 칸은 없다 #}
{% for c in row.layout %}
{% set editable = pj_pro and (c.kind != 'quarter' or (board.halves and (c.m not in (15, 16) or board.quarters))) %}
{% set merged = c.span > 1 or c.rspan > 1 %}
<td class="pj-goal-texttd {{ 'pj-goal-m' if c.kind == 'month' else ('pj-goal-year-col' if c.kind == 'year' else 'pj-goal-half-col') }}{% if merged %} is-merged{% endif %}{% if c.now %} is-now{% endif %}"
{% if c.kind in ('month', 'quarter') %}data-h="{{ c.h }}" {% endif %}data-month="{{ c.m }}" data-span="{{ c.span }}" data-rspan="{{ c.rspan }}"
{%- if c.span > 1 %} colspan="{{ c.span }}" style="--span: {{ c.span }}"{% endif %}{% if c.rspan > 1 %} rowspan="{{ c.rspan }}"{% endif %}>
{%- if editable -%}
<div class="pj-goal-text" contenteditable="true" role="textbox" aria-multiline="true" aria-label="목표 내용"
data-row="{{ row.id }}" data-month="{{ c.m }}"
data-placeholder="{{ '연간 목표' if c.m == 0 else ((c.h ~ '분기 목표') if c.kind == 'quarter' else '') }}">{{ c.html|safe }}</div>
{%- else -%}
<div class="pj-goal-text-ro">{{ row.cells.get(mo, '') }}</div>
<div class="pj-goal-text-ro">{{ c.html|safe }}</div>
{%- endif -%}
</td>
{% endfor %}
@@ -153,10 +186,13 @@
</tbody>
{% endfor %}
</table>
{% if is_admin %}
{% if pj_pro %}
<div class="pj-goal-foot">
<button type="button" class="pj-btn" id="pj-goal-area-add">+ 업무 영역 추가</button>
<span class="pj-goal-note">칸을 고치면 바로 저장됩니다. 숫자 칸을 비우면 지워집니다.</span>
<span class="pj-goal-note">칸을 고치면 바로 저장됩니다. 글자를 드래그해 선택하면 선택한 셀 상단에서 12색 견본·크기 2px 증감·굵게·기울임·밑줄·서식 초기화를 사용할 수 있습니다. 모든 행의 셀 오른쪽 경계를 끌어 열 너비를 조절하고, 더블클릭하면 그 열의 가장 긴 문단에 맞춥니다. 숫자 칸을 비우면 지워집니다. 구역·항목 칸을 우클릭하거나 칸의 ⋮ 버튼(키보드 Tab·Enter, 터치)을 누르면 색·순서·줄 추가·삭제 메뉴가 나옵니다.
셀 우클릭 → 현재 열·전체 열 너비 자동 맞춤(접힌 열 포함).
{%- if board.halves %} 칸을 마우스로 끌어 여러 칸을 고른 뒤 우클릭 → 셀 병합, 병합된 칸은 우클릭 → 병합 해제(글은 왼쪽 위 칸에 남음).{% endif %}
월 이름을 누르면 그 달 주간 회의록이 열립니다.</span>
</div>
{% endif %}
{% endif %}
@@ -166,8 +202,10 @@
</div>
{% if goal_area_colors %}<script>window.PJ_GOAL_COLORS = {{ goal_area_colors | tojson }};</script>{% endif %}
{% if week_targets %}<script>window.PJ_GOAL_WEEKS = {{ week_targets | tojson }}; window.PJ_GOAL_UNIT = {{ (board.sales_unit if board else '') | tojson }};</script>{% endif %}
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
<script src="/static/project-goal-text.js?v=20261003d" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
+319 -105
View File
@@ -1,8 +1,8 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project-help.css?v=20260926v" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/project-help.css?v=20261003a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -11,7 +11,7 @@
{% block content %}
{# ── 프로젝트 관리 도움말 — 처음 쓰는 사람을 위한 기능 안내(정적 페이지, DB 불필요).
기능이 바뀌면 이 페이지도 같이 고친다(docs/PROJECT_MODULE.md 와 짝). ── #}
<div class="pjh">
<div class="pjh" id="top">
<nav class="pjh-toc" aria-label="도움말 목차">
<p class="pjh-toc-title">목차</p>
<ol>
@@ -21,9 +21,9 @@
<li><a href="#project">프로젝트 만들기·고치기</a></li>
<li><a href="#views">보기 전환과 필터</a></li>
<li><a href="#board">보드 — 섹션과 작업 카드</a></li>
<li><a href="#card-subtasks">카드에서 하위 작업 다루기</a></li>
<li><a href="#card-subtasks">카드에서 세부 작업 다루기</a></li>
<li><a href="#task">작업 편집 창</a></li>
<li><a href="#subtasks">작업 창의 하위 작업</a></li>
<li><a href="#subtasks">작업 창의 세부 작업</a></li>
<li><a href="#dates">날짜 고르기</a></li>
<li><a href="#list">목록 보기</a></li>
<li><a href="#calendar">캘린더 보기</a></li>
@@ -33,25 +33,42 @@
<li><a href="#comments">댓글과 @태그</a></li>
<li><a href="#inbox">수신함과 알림</a></li>
<li><a href="#search">전체 검색과 공유 링크</a></li>
<li><a href="#trash">휴지통 (관리자)</a></li>
<li><a href="#trash">휴지통 (Pro user 이상)</a></li>
<li><a href="#goals">연간 목표</a></li>
<li><a href="#meetings">주간 회의록</a></li>
<li><a href="#tips">단축키와 자주 묻는 질문</a></li>
</ol>
</nav>
<div class="pjh-body">
<div class="pjh-search" id="pjh-search" hidden>
<form id="pjh-search-form" role="search" aria-label="도움말 검색">
<label for="pjh-query">도움말 검색</label>
<div class="pjh-search-field">
<input type="search" id="pjh-query" name="q" placeholder="예: 회의록, 셀 병합, 매출 갱신" autocomplete="off"
aria-describedby="pjh-search-hint pjh-search-status" aria-controls="pjh-results" />
<button type="submit">검색</button>
<button type="button" id="pjh-search-clear" hidden>지우기</button>
</div>
<p class="pjh-search-hint" id="pjh-search-hint">한 글자부터 제목·본문을 검색합니다. 결과를 누르면 해당 설명으로 바로 이동합니다. 여러 단어는 띄어 쓰세요.</p>
</form>
<p class="pjh-search-status" id="pjh-search-status" role="status" aria-live="polite" aria-atomic="true"></p>
<ol class="pjh-results" id="pjh-results" aria-label="도움말 검색 결과" hidden></ol>
</div>
<!-- 머리말 + 빠른 시작 -->
<header class="pjh-hero" id="top">
<header class="pjh-hero">
<h1>프로젝트 관리 도움말</h1>
<p>프로젝트 관리는 <b>아사나(Asana) 방식</b>으로 팀의 일을 정리하는 도구입니다.
프로젝트 안에 할 일(작업)을 만들고, 담당자와 마감일을 정하고, 댓글로 이야기하며 끝까지 챙깁니다.
처음이라면 아래 다섯 단계만 따라 해도 바로 쓸 수 있어요.</p>
<div class="pjh-quick">
<div class="pjh-quick-step"><b>1단계</b>왼쪽 목록에서 <b style="display:inline;color:inherit">프로젝트</b>를 누릅니다.</div>
<div class="pjh-quick-step"><b>2단계</b>보드에서 <span class="pjh-ui">+ 작업 추가</span>로 할 일을 만듭니다.</div>
<div class="pjh-quick-step"><b>2단계</b>보드에서 <span class="pjh-ui">+ 메인 작업 추가</span>로 할 일을 만듭니다.</div>
<div class="pjh-quick-step"><b>3단계</b>카드의 사람·달력 아이콘으로 담당자와 마감일을 정합니다.</div>
<div class="pjh-quick-step"><b>4단계</b>카드를 눌러 설명을 쓰고, 댓글에 <kbd>@</kbd>로 동료를 부릅니다.</div>
<div class="pjh-quick-step"><b>5단계</b>일을 마치면 <span class="pjh-ui">✓ 완료로 표시</span>를 누릅니다.</div>
</div>
<p class="pjh-quick-links">계획과 회의를 준비한다면 <a href="#goals">연간 목표</a> · <a href="#meetings">주간 회의록</a> 설명부터 읽어 보세요.</p>
</header>
<!-- 1. 용어 -->
@@ -63,7 +80,7 @@
<tr><td>프로젝트</td><td>함께 진행하는 일의 큰 묶음입니다. 예) “마케팅”, “신상품 출시”. 색상과 아이콘으로 구분합니다.</td></tr>
<tr><td>섹션</td><td>프로젝트 안의 단계나 분류입니다. 보드에서 세로 칸 하나가 섹션입니다. 예) “할 일 · 진행 중 · 검토 · 완료”.</td></tr>
<tr><td>작업</td><td>실제 할 일 하나입니다. 보드의 카드 한 장이 작업 하나입니다.</td></tr>
<tr><td>하위 작업</td><td>작업을 더 잘게 나눈 할 일입니다. 작업 안에 목록으로 붙습니다. 원래 작업은 <b>상위 작업</b>이라고 부릅니다.</td></tr>
<tr><td>세부 작업</td><td>작업을 더 잘게 나눈 할 일입니다. 작업 안에 목록으로 붙습니다. 원래 작업은 <b>상위 작업</b>이라고 부릅니다.</td></tr>
<tr><td>담당자</td><td>그 작업을 책임지고 하는 사람 한 명입니다.</td></tr>
<tr><td>협업자</td><td>작업의 진행 소식(완료·댓글)을 함께 받는 사람들입니다. 만든 사람·담당자·댓글 쓴 사람·@태그된 사람은 자동으로 들어갑니다.</td></tr>
<tr><td>마감일 / 시작일</td><td>언제까지 끝낼지(마감일), 언제 시작하는지(시작일, 선택)입니다.</td></tr>
@@ -78,32 +95,32 @@
<section class="pjh-sec" id="layout">
<h2><span class="pjh-num">2</span>화면 구성</h2>
<div class="pjh-map" aria-hidden="true">
<div class="pjh-map-top"><span><b>위쪽 바</b>화면 이름</span><span>🔔 알림 · 내 이름 · 로그아웃 · <b style="display:inline">?</b> 도움말</span></div>
<div class="pjh-map-side"><b>왼쪽 사이드바</b>전체 검색<br>수신함 · 내 작업 · 휴지통 · 목표<br>프로젝트 목록<br>완료 프로젝트<br>전체 멤버</div>
<div class="pjh-map-main"><b>가운데 작업 영역</b>왼쪽 위: 프로젝트 제목 · 멤버<br>그 아래: 보기 탭(보드 · 목록 · 캘린더 · 타임라인 · 대시보드)<br>오른쪽 위: 범위(이 프로젝트 / 전체 프로젝트)<br>필터 바<br>작업들</div>
<div class="pjh-map-top"><span><b>위쪽 바</b>화면 이름</span><span>🔔 알림 · 내 이름 · 로그아웃 · <b style="display:inline">?</b> 도움말 · 옵션</span></div>
<div class="pjh-map-side"><b>왼쪽 사이드바</b>전체 검색<br>수신함 · 전체 보기(Pro user 이상) · 내 작업 · 휴지통 · 목표<br>프로젝트 목록<br>완료 프로젝트<br>전체 멤버</div>
<div class="pjh-map-main"><b>가운데 작업 영역</b>왼쪽 위: 프로젝트 제목 · 멤버<br>그 아래: 보기 탭(보드 · 목록 · 캘린더 · 타임라인 · 대시보드)<br>필터 바<br>작업들</div>
</div>
<h3>왼쪽 사이드바</h3>
<ul>
<li><b>전체 검색</b> — 내가 볼 수 있는 모든 작업을 제목·설명·댓글로 찾습니다. (<a href="#search">18장</a>)</li>
<li><b>수신함</b> — 나를 태그한 작업과 알림. 숫자 배지는 아직 확인하지 않은 @태그 수입니다. (<a href="#inbox">17장</a>)</li>
<li><b>내 작업</b> — 내가 담당자인 작업 모음. 숫자 배지는 아직 끝나지 않은 작업 수입니다. (<a href="#mytasks">15장</a>)</li>
<li><b>휴지통</b> — 지운 작업을 3개월 보관합니다. 관리자에게만 보입니다. (<a href="#trash">19장</a>)</li>
<li><b>목표</b> — 누르면 바로 아래에 연도가 펼쳐집니다. 연도를 누르면 오른쪽에 그해 전체 목표가 한 표로 나옵니다 —
맨 위에 <b>매출</b>(목표·실적·달성률)과 <b>로아스</b>(목표·실적)를 달마다, 그 아래에 <b>업무 영역</b>(상품·마케팅·컨텐츠·유통 등)별로
연간·월별 계획을 적습니다. 매출의 <b>연간</b> 칸은 월 합계, <b>달성</b>은 실적÷목표(100% 이상 초록)로 저절로 계산됩니다.
<b>입력은 관리자만</b> 할 수 있고(칸을 고치면 바로 저장), 다른 직원은 보기만 합니다. 관리자는 <b>+ 연도 추가</b>로 새해 목표를
만들고(이전 연도의 업무 영역 구성을 그대로 가져옴), 영역 이름 칸에 마우스를 올려 이름·색·순서·줄 추가·삭제를 합니다.</li>
<li><b>휴지통</b> — 지운 작업을 3개월 보관합니다. Pro user 이상에게만 보입니다. (<a href="#trash">19장</a>)</li>
<li>왼쪽 메뉴의 오른쪽 경계를 끌면 너비를 최소 170px까지 줄일 수 있습니다. 경계에 키보드 포커스를 놓고 좌우 방향키로도 조절할 수 있으며 너비는 내 브라우저에 기억됩니다. 전체 멤버는 메뉴 너비에 맞춰 4열 또는 3열로 자동 배치됩니다.</li>
<li><b>목표</b> — 연도를 골라 매출·로아스와 업무 영역별 연간·분기·월 계획을 봅니다. (<a href="#goals">연간 목표 설명</a>)</li>
<li><b>주간 회의록</b> — 목표 표의 월 이름을 눌러 이번주 계획과 지난주 리뷰를 함께 봅니다. (<a href="#meetings">주간 회의록 설명</a>)</li>
<li><b>프로젝트</b> — 내가 멤버인 프로젝트 목록입니다. 누르면 그 프로젝트 화면으로 갑니다. 완료한 프로젝트는 아래 <b>완료 프로젝트</b>에 흐리게 모입니다.</li>
<li><b>전체 멤버</b> — 관리자에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.</li>
<li><b>전체 멤버</b> — Pro user 이상에게만 보입니다. 사람 아이콘을 누르면 그 사람이 맡은 모든 작업을 한눈에 봅니다.</li>
</ul>
<h3>위쪽 바</h3>
<ul>
<li><span class="pjh-ui"><span class="material-symbols-outlined">notifications</span></span> 종 아이콘 — 읽지 않은 알림 수가 표시되고, 누르면 수신함으로 갑니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">fit_screen</span></span> 화면 배율 — 누르면(파랗게 켜짐) 화면 전체를 75%로 줄입니다. 2880×1620 모니터를 Windows 배율 200%로 쓰면 화면이 꽉 차 보이는데, 이때 켜면 1920×1080 모니터와 같은 모습이 됩니다. 브라우저마다 기억합니다. 메뉴·말풍선 같은 작은 팝업은 원래 크기로 뜹니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">help</span></span> 물음표 — 지금 보고 있는 이 도움말을 새 탭으로 엽니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">settings</span></span> 도움말 오른쪽의 옵션 — 폰트를 고르고 미리 본 뒤 <span class="pjh-ui">저장</span>을 누르면 Project 화면에 적용되고 창이 닫힙니다.
기본 시스템 폰트·프리텐다드·나눔 스퀘어·나눔 스퀘어 네오·나눔 스퀘어 라운드 중 선택할 수 있습니다. 설정은 이 브라우저의 모든 Project 화면에서 기억합니다. <span class="pjh-ui">취소</span>는 변경을 적용하지 않고 닫습니다.</li>
</ul>
<h3>프로젝트 제목</h3>
<p>가운데 위 프로젝트 제목에 마우스를 올리면 테두리가 생깁니다. 누르면 그 자리에서 이름을 고칩니다 — <kbd>Enter</kbd>나 바깥을 누르면 저장, <kbd>Esc</kbd>는 취소. (그 프로젝트 멤버·관리자만)</p>
<p>가운데 위 프로젝트 제목에 마우스를 올리면 테두리가 생깁니다. 누르면 그 자리에서 이름을 고칩니다 — <kbd>Enter</kbd>나 바깥을 누르면 저장, <kbd>Esc</kbd>는 취소. (그 프로젝트 멤버인 Pro user 이상만)</p>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>여러 사람이 동시에 써도 걱정 없습니다. 다른 사람이 바꾼 내용은 <b>약 8초 안에</b> 내 화면에 자동으로 반영됩니다(새로고침하지 않아도 됩니다). 내가 입력 중인 창은 건드리지 않습니다.</div></div>
</section>
@@ -111,26 +128,52 @@
<!-- 3. 권한 -->
<section class="pjh-sec" id="roles">
<h2><span class="pjh-num">3</span>누가 무엇을 할 수 있나요</h2>
<p class="pjh-lead">프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.</p>
<p class="pjh-lead">프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.
등급은 <b>수퍼관리자 · Admin · Pro user · User</b> 네 가지이며(관리자 페이지에서 지정, 수퍼관리자는 한 명으로 고정), 등급과 상관없이
<b>그 프로젝트의 멤버·소유자만</b> 프로젝트를 볼 수 있습니다(수퍼관리자만 예외).</p>
<h3>프로젝트</h3>
<table class="pjh-table">
<tr><th>할 수 있는 일</th><th>누가</th></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버</b>(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트 멤버 누구나 만들고 고칠 수 있습니다.</td></tr>
<tr><td>작업·섹션·프로젝트 삭제</td><td><b>만든 사람만</b> 지울 수 있습니다(최고 관리자는 예외).</td></tr>
<tr><td>댓글 고치기·지우기</td><td>댓글을 쓴 사람(또는 관리자)만.</td></tr>
<tr><td>새 프로젝트, 프로젝트 수정·순서 바꾸기</td><td>관리자 (<span class="pjh-ui">+</span> · <span class="pjh-ui">✎</span> · <span class="pjh-ui">⣿</span> 버튼이 관리자에게만 보입니다)</td></tr>
<tr><td>멤버 배정·제외, 프로젝트 소유자 바꾸기</td><td>관리자</td></tr>
<tr><td>다른 프로젝트에서 연결돼 온 작업</td><td>원래 프로젝트 멤버가 아니면 <b>읽기만</b> — 내용·댓글·첨부는 보이지만 고치거나 댓글을 달 수 없습니다(연결된 보드 안에서 섹션 옮기기는 됩니다).</td></tr>
<tr><td>멤버에서 빠졌을 때</td><td>그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고, 예전 링크로도 열리지 않습니다. 새 알림도 오지 않습니다.</td></tr>
<tr><td>휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트</td><td>관리자</td></tr>
<tr><td>목표 보기</td><td>누구나 · <b>목표 입력·연도 추가·업무 영역 편집</b>은 관리자</td></tr>
<tr><th>할 수 있는 일</th><th>Admin</th><th>Pro user</th><th>User</th></tr>
<tr><td>프로젝트 보기, 작업·섹션 만들기·고치기·옮기기</td><td>O</td><td>O</td><td>O</td></tr>
<tr><td>작업 삭제(휴지통으로)</td><td>O</td><td>O</td><td>O</td></tr>
<tr><td>섹션 삭제</td><td>O</td><td>만든 사람만</td><td>만든 사람만</td></tr>
<tr><td>서브프로젝트 만들기</td><td>O</td><td>O</td><td>O</td></tr>
<tr><td>새 프로젝트 만들기 (<span class="pjh-ui">+</span>)</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>프로젝트 이름·색·아이콘 수정 (<span class="pjh-ui">✎</span>·제목 바로 고치기)</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>프로젝트 소유자 바꾸기</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>프로젝트 삭제</td><td>O</td><td>만든 사람만</td><td>만든 사람만</td></tr>
<tr><td>멤버 배정·제외</td><td>O</td><td>O (자기가 멤버인 프로젝트)</td><td>X</td></tr>
<tr><td>사이드바 프로젝트 순서 바꾸기 (<span class="pjh-ui">⣿</span>)</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>댓글 고치기·지우기</td><td>O</td><td>남의 댓글도</td><td>본인 댓글만</td></tr>
<tr><td>휴지통 보기·복구</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>전체 보기(모든 프로젝트 작업 함께 보기)</td><td>O</td><td>O (멤버인 프로젝트 범위)</td><td>X</td></tr>
<tr><td>대시보드 “담당자별 작업 합계”</td><td>O</td><td>O</td><td>X (안 보임)</td></tr>
<tr><td>사이드바 “전체 멤버”</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>수신함·내 작업·PC 알림</td><td>O</td><td>O</td><td>O (자기 것)</td></tr>
</table>
<p>만든 사람 기록이 없는 옛 섹션·프로젝트는 Admin 이상만 지울 수 있습니다. 다른 프로젝트에서 연결돼 온 작업은 원래 프로젝트 멤버가 아니면
<b>읽기만</b> 됩니다(연결된 보드 안에서 섹션 옮기기는 됩니다). 멤버에서 빠지면 그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고,
예전 링크로도 열리지 않습니다.</p>
<h3>목표·주간 회의록</h3>
<table class="pjh-table">
<tr><th>할 수 있는 일</th><th>Admin</th><th>Pro user</th><th>User</th></tr>
<tr><td>연간 목표 표 보기</td><td>O</td><td>O</td><td>O</td></tr>
<tr><td>목표 표 입력·구조 변경(매출·로아스, 영역·줄, 칸 병합·이동)</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>주차별 매출 목표·월 전체 목표 입력</td><td>O</td><td>O</td><td>X (값 보기만)</td></tr>
<tr><td>연도 추가·삭제</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>회의록 만들기·글 수정·줄 추가·삭제·칸 병합</td><td>O</td><td>O</td><td>O (완료 전까지)</td></tr>
<tr><td>지난주 결과 입력</td><td>O</td><td>O</td><td>O (다음 주 회의록이 열려 있는 동안)</td></tr>
<tr><td>회의 완료·완료 해제(완료하면 수정 잠금)</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>회의록 삭제</td><td>O</td><td>O</td><td>X</td></tr>
<tr><td>회의록 보드 열기·링크 복사</td><td>O</td><td>O</td><td>O</td></tr>
<tr><td>회의록 “작업 등록 표”로 작업 만들기</td><td>내가 멤버인 프로젝트에만</td><td>내가 멤버인 프로젝트에만</td><td>내가 멤버인 프로젝트에만</td></tr>
</table>
</section>
<!-- 4. 프로젝트 -->
<section class="pjh-sec" id="project">
<h2><span class="pjh-num">4</span>프로젝트 만들기·고치기</h2>
<h3>새 프로젝트 만들기 (관리자)</h3>
<h3>새 프로젝트 만들기 (Pro user 이상)</h3>
<ol class="pjh-steps">
<li>왼쪽 사이드바 <b>프로젝트</b> 제목 옆의 <span class="pjh-ui">+</span>를 누릅니다.</li>
<li><b>이름</b>(필수)과 <b>설명</b>을 적습니다.</li>
@@ -138,9 +181,13 @@
<li><b>색상</b>(32가지)과 <b>아이콘</b>을 고릅니다. 아이콘 첫 칸 <span class="pjh-ui">Aa</span>를 고르면 아이콘 대신 이름 첫 글자가 나옵니다.</li>
<li>함께할 <b>멤버</b>에 체크하고 <span class="pjh-ui">만들기</span>를 누릅니다. 만든 사람은 자동으로 프로젝트 주인이 됩니다.</li>
</ol>
<p>프로젝트는 만들어졌는데 일부 멤버를 배정하지 못하면 창이 닫히지 않고 <b>배정하지 못한 멤버</b>가 빨갛게 표시됩니다.
<span class="pjh-ui">실패한 멤버 다시 배정</span>을 누르면 그 멤버만 다시 배정합니다(프로젝트를 또 만들지 않습니다).
창을 닫으면 만든 프로젝트로 넘어가며, 남은 멤버는 프로젝트 화면에서 배정하면 됩니다.
다른 사람을 소유자로 정해 만들면 만든 사람은 일반 멤버로 함께 들어갑니다(나중에 멤버에서 뺄 수 있습니다).</p>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span>
<div>새 프로젝트는 섹션 없이 빈 보드로 시작합니다. 보드의 <span class="pjh-ui">+ 섹션 추가</span>로 “할 일 · 진행 중 · 완료”처럼 단계를 먼저 만들어 두면 편합니다. (<a href="#board">6장</a>)</div></div>
<h3>프로젝트 수정 (관리자)</h3>
<h3>프로젝트 수정 (Pro user 이상)</h3>
<p>사이드바의 프로젝트 이름에 마우스를 올리면 오른쪽에 <span class="pjh-ui">✎</span>(수정)과 <span class="pjh-ui">×</span>(삭제)가 나옵니다.
이름에서 <b>마우스 오른쪽 버튼</b>을 눌러도 <span class="pjh-ui">열기 · 수정 · 삭제</span> 메뉴가 나옵니다.</p>
<ul>
@@ -148,16 +195,17 @@
<li><b>프로젝트 완료</b>에 체크하면 목록 맨 아래 “완료 프로젝트”로 옮겨지고 흐리게 보입니다.</li>
<li>색이 밝으면(연노랑·하늘색 등) 글자와 아이콘이 자동으로 어둡게 바뀌어 잘 보입니다.</li>
</ul>
<h3>순서 바꾸기 (관리자)</h3>
<p>프로젝트 이름에 마우스를 올리면 왼쪽에 손잡이 <span class="pjh-ui">⣿</span>가 나옵니다. 잡고 위아래로 끌어 놓으면 순서가 저장됩니다.</p>
<h3>순서 바꾸기 (Pro user 이상)</h3>
<p>프로젝트 이름에 마우스를 올리면 왼쪽에 손잡이 <span class="pjh-ui">⣿</span>가 나옵니다. 잡고 위아래로 끌어 놓으면 순서가 저장됩니다.
순서는 모두가 같이 보는 순서이고, 내가 멤버인 프로젝트만 옮길 수 있습니다.</p>
<h3>프로젝트 삭제</h3>
<p><span class="pjh-ui">×</span> 또는 우클릭 <span class="pjh-ui">삭제</span>. <b>프로젝트를 만든 사람만</b> 지울 수 있고, 안의 작업도 모두 함께 지워집니다.</p>
<p><span class="pjh-ui">×</span> 또는 우클릭 <span class="pjh-ui">삭제</span>. <b>프로젝트를 만든 사람</b>(또는 Admin 이상)만 지울 수 있고, 안의 작업도 모두 함께 지워집니다.</p>
<div class="pjh-warn"><span class="material-symbols-outlined">warning</span>
<div>프로젝트 삭제는 되돌릴 수 없습니다. 끝난 프로젝트는 지우기보다 <b>프로젝트 완료</b>로 표시하는 것을 권합니다.</div></div>
<h3>멤버 배정 (관리자)</h3>
<h3>멤버 배정 (Pro user 이상)</h3>
<p>프로젝트 화면 제목 오른쪽에 멤버 사진이 겹쳐서 보입니다.</p>
<ul>
<li><span class="pjh-ui">+</span> — 멤버를 추가합니다(프로젝트 관리 권한이 있는 직원 중에서 고릅니다).</li>
<li><span class="pjh-ui">+</span> — 멤버 배정·제외 창이 열립니다. 지금 멤버는 체크된 채로 나오며, <b>체크하면 배정, 체크를 풀면 제외</b>됩니다(제외는 확인 후). 후보는 프로젝트 관리 권한이 있는 직원이고, 소유자는 뺄 수 없습니다.</li>
<li>사진에 마우스 → 이름이 보입니다. <b>클릭</b> → 그 사람이 이 프로젝트에서 맡은 작업 목록이 뜹니다.</li>
<li>사진에서 <b>우클릭</b> → <span class="pjh-ui">제외</span>로 멤버에서 뺍니다.</li>
</ul>
@@ -177,8 +225,10 @@
<tr><td>대시보드</td><td>완료·미완료·지연 숫자와 차트로 진행 상황을 볼 때. (<a href="#dashboard">14장</a>)</td></tr>
</table>
<h3>범위: 이 프로젝트 / 전체 프로젝트</h3>
<p>화면 오른쪽 위 토글입니다. <b>이 프로젝트</b>는 지금 프로젝트만, <b>전체 프로젝트</b>는 내가 볼 수 있는 모든 프로젝트의 작업을 함께 보여줍니다.
전체 프로젝트일 때는 위 제목이 <b>전체 프로젝트</b>로 바뀌고, 카드 위에는 어느 프로젝트 작업인지 이름이 붙습니다.</p>
<p>프로젝트 화면은 지금 프로젝트만 보여줍니다. Pro user 이상은 왼쪽 메뉴 수신함 아래 <b>전체 보기</b>를 누르면 내가 볼 수 있는 모든 프로젝트의 작업을 함께 봅니다
(왼쪽 프로젝트 목록에서 프로젝트를 누르면 다시 그 프로젝트만).
전체 프로젝트일 때는 위 제목이 <b>전체 프로젝트</b>로 바뀌고, 카드 위에는 어느 프로젝트 작업인지 이름이 붙습니다.
다른 프로젝트에서 연결돼 와 <b>읽기만 되는 작업</b>도 한 번씩 함께 보입니다.</p>
<h3>필터 바</h3>
<p>탭 아래 한 줄로 작업을 거르고 정렬합니다. 다섯 가지 보기 모두에 똑같이 적용되고, 프로젝트마다 이 브라우저에 기억됩니다.</p>
<ul>
@@ -200,12 +250,13 @@
<p class="pjh-lead">보드는 섹션(세로 칸)이 옆으로 늘어선 화면입니다. 섹션이 많으면 가로로 스크롤되고, 한 섹션에 카드가 많으면 그 섹션 안에서만 세로로 스크롤됩니다.</p>
<h3>섹션 다루기</h3>
<ul>
<li><b>그룹 축소</b> — 섹션 머리의 왼쪽 화살표를 누르면 카드가 숨겨지고 제목·작업 수가 세로로 표시됩니다. 반대 방향 화살표를 누르면 펼쳐집니다. 축소 상태는 내 브라우저에 기억됩니다.</li>
<li><b>섹션 추가</b> — 마지막 섹션 바로 오른쪽의 <span class="pjh-ui">+ 섹션 추가</span>.</li>
<li><b>이름 바꾸기</b> — 섹션 이름을 누르면 그 자리에서 고칩니다. <kbd>Enter</kbd> 저장, <kbd>Esc</kbd> 취소.</li>
<li><b>순서 바꾸기</b> — 섹션 머리(이름 줄)를 잡고 좌우로 끌어 놓습니다.</li>
<li><b>… 메뉴</b>(머리 오른쪽 <span class="pjh-ui">…</span> 또는 머리 우클릭):
<ul>
<li><span class="pjh-ui">작업 추가</span> · <span class="pjh-ui">이름 변경</span></li>
<li><span class="pjh-ui">메인 작업 추가</span> · <span class="pjh-ui">이름 변경</span></li>
<li><span class="pjh-ui">섹션 편집</span> — 색상과 <b>기본 담당자</b>를 정합니다. 색상 첫 칸(연회색)은 “색 없음”입니다.</li>
<li><span class="pjh-ui">섹션 작업 모두 완료</span> — 그 섹션의 미완료 작업을 한 번에 완료합니다.</li>
<li><span class="pjh-ui">완료 섹션으로 지정</span> — 이 섹션으로 옮긴 카드는 <b>자동으로 완료</b>되고, 밖으로 빼면 다시 미완료가 됩니다. 완료 섹션은 흐리게, 보드 끝에 놓입니다.</li>
@@ -217,8 +268,10 @@
<div><b>기본 담당자</b>를 정해 두면, 그 섹션에 담당자 없는 작업을 새로 만들거나 옮겨 올 때 그 사람이 자동으로 담당자가 됩니다. 예) “검토” 섹션의 기본 담당자 = 팀장.</div></div>
<h3>작업 카드 다루기</h3>
<ul>
<li><b>작업 추가</b> — 섹션 머리의 <span class="pjh-ui">+</span> 또는 섹션 맨 아래 <span class="pjh-ui">+ 작업 추가</span>. 오른쪽에 작업 편집 창이 열립니다.</li>
<li><b>상단 메인 작업 추가</b> — 섹션 머리의 <span class="pjh-ui">+</span>는 오른쪽에서 작업 상세창을 엽니다. 제목·설명·담당자·우선순위·마감일을 설정할 수 있습니다.</li>
<li><b>하단 메인 작업 추가</b> — 섹션 맨 아래 <span class="pjh-ui">+ 메인 작업 추가</span>는 보드 안에 간단한 입력 카드를 엽니다. <b>작업 이름·담당자·마감일</b>을 정한 뒤 <kbd>Enter</kbd>를 누르거나 카드 밖을 클릭하면 저장됩니다. Enter로 저장하면 다음 작업을 계속 입력할 수 있고, <kbd>Esc</kbd>로 취소할 수 있습니다.</li>
<li><b>열기</b> — 카드를 누르면 오른쪽에 작업 편집 창이 열립니다. (<a href="#task">8장</a>)</li>
<li><b>완료 체크</b> — 카드 제목 왼쪽의 원형 체크 버튼을 누르면 완료됩니다. 완료된 작업은 <b>녹색 원 안 흰 체크</b>와 흐린 회색 제목으로 표시되며 취소선은 없습니다. 다시 누르면 완료를 취소합니다. 읽기 전용 작업은 상태만 표시합니다.</li>
<li><b>담당자·마감일 바로 바꾸기</b> — 카드의 사람 아이콘이나 날짜를 누르면 그 자리에서 바꿉니다. 비어 있으면 카드에 마우스를 올렸을 때 점선 원 아이콘이 나타납니다.</li>
<li><b>옮기기</b> — 카드를 끌어 다른 섹션에 놓으면 섹션이 바뀌고, 같은 섹션 안에서 위아래로 놓으면 순서가 바뀝니다.</li>
<li><b>우클릭 메뉴</b> — <span class="pjh-ui">열기 · 작업 링크 복사 · 완료로 표시 · 삭제</span></li>
@@ -233,23 +286,24 @@
</table>
</section>
<!-- 7. 카드의 하위 작업 -->
<!-- 7. 카드의 세부 작업 -->
<section class="pjh-sec" id="card-subtasks">
<h2><span class="pjh-num">7</span>카드에서 하위 작업 다루기</h2>
<p class="pjh-lead">하위 작업이 있는 카드에는 <span class="pjh-ui">3 ⤷ ▾</span> 처럼 개수 버튼이 붙습니다. 누르면 카드 아래로 하위 작업 목록이 펼쳐집니다.</p>
<h2><span class="pjh-num">7</span>카드에서 세부 작업 다루기</h2>
<p class="pjh-lead">세부 작업이 있는 카드에는 <span class="pjh-ui">3 ⤷ ▾</span> 처럼 개수 버튼이 붙습니다. 누르면 카드 아래로 세부 작업 목록이 펼쳐집니다.</p>
<ul>
<li><b>완료</b> — 줄 왼쪽 <span class="pjh-ui">✓</span>를 누릅니다.</li>
<li><b>마감일·담당자</b> — 줄 오른쪽 날짜나 사람 아이콘을 누르면 그 자리에서 바꿉니다.</li>
<li><b>열기</b> — 줄을 누르면 그 하위 작업이 작업처럼 편집 창으로 열립니다.</li>
<li><b>우클릭</b> — <span class="pjh-ui">열기 · 상위 작업 열기 · 완료로 표시 · 하위 작업 삭제</span></li>
<li><b>다른 작업으로 옮기기</b> — 하위 작업 한 줄을 끌어서 <b>다른 카드</b>에 놓으면 그 작업의 하위 작업이 됩니다(놓을 수 있는 카드는 보라색 테두리가 생깁니다). 같은 프로젝트 안에서만 옮길 수 있습니다.</li>
<li><b>열기</b> — 줄을 누르면 그 세부 작업이 작업처럼 편집 창으로 열립니다.</li>
<li><b>우클릭</b> — <span class="pjh-ui">열기 · 상위 작업 열기 · 완료로 표시 · 세부 작업 삭제</span></li>
<li><b>순서 바꾸기</b> — 펼친 세부 작업 한 줄을 끌어 같은 카드 안의 원하는 위치에 놓습니다. 보라색 선이 삽입 위치를 보여 주며, 변경한 순서는 저장됩니다.</li>
<li><b>다른 작업으로 옮기기</b> — 세부 작업 한 줄을 끌어서 <b>다른 카드</b>에 놓으면 그 작업의 세부 작업이 됩니다(놓을 수 있는 카드는 보라색 테두리가 생깁니다). 같은 프로젝트 안에서만 옮길 수 있습니다.</li>
</ul>
<h3>+ 하위 작업 추가</h3>
<h3>+ 세부 작업 추가</h3>
<ol class="pjh-steps">
<li>펼친 목록 맨 아래 <span class="pjh-ui">+ 하위 작업 추가</span>를 누릅니다.</li>
<li>펼친 목록 맨 아래 <span class="pjh-ui">+ 세부 작업 추가</span>를 누릅니다.</li>
<li>새 줄의 “작업 이름 입력” 칸에 이름을 씁니다.</li>
<li>필요하면 달력 아이콘으로 마감일, 사람 아이콘으로 담당자를 고릅니다.</li>
<li><kbd>Enter</kbd>를 누르면 만들어지고, 빈 줄이 다시 열려 다음 하위 작업을 이어서 쓸 수 있습니다.</li>
<li><kbd>Enter</kbd>를 누르면 만들어지고, 빈 줄이 다시 열려 다음 세부 작업을 이어서 쓸 수 있습니다.</li>
<li>이름을 쓴 채 <b>다른 곳을 누르면</b> <kbd>Enter</kbd>와 같이 만들어지고 줄이 닫힙니다.</li>
<li>만들지 않고 닫으려면 <kbd>Esc</kbd>를 누르거나, 빈 채로 다른 곳을 누릅니다.</li>
</ol>
@@ -264,11 +318,11 @@
<tr><th>버튼</th><th>하는 일</th></tr>
<tr><td><span class="pjh-ui"><span class="material-symbols-outlined">link</span>공유</span></td><td>이 작업의 주소를 복사합니다. 메신저로 보내면 받은 멤버가 바로 이 작업을 엽니다.</td></tr>
<tr><td><span class="pjh-ui">✓ 완료로 표시</span></td><td>작업을 완료합니다. 다시 누르면 <span class="pjh-ui">↩ 완료 취소</span>.</td></tr>
<tr><td><span class="pjh-ui">삭제</span></td><td>작업을 지웁니다(만든 사람만). 하위 작업이 있으면 함께 지울지 한 번 더 묻습니다. 지운 작업은 휴지통에 3개월 보관됩니다.</td></tr>
<tr><td><span class="pjh-ui">삭제</span></td><td>작업을 지웁니다(만든 사람만). 세부 작업이 있으면 함께 지울지 한 번 더 묻습니다. 지운 작업은 휴지통에 3개월 보관됩니다.</td></tr>
<tr><td><span class="pjh-ui">저장됨</span></td><td>저장 버튼이 없습니다 — 고치는 즉시 저장되고, 버튼 줄 오른쪽에 <span class="pjh-ui">저장 중…</span> → <span class="pjh-ui">✓ 저장됨</span>이 잠깐 보입니다. 저장이 안 되면 <span class="pjh-ui">저장 실패 · 다시 시도</span>(눌러서 다시 저장)가 뜨고, 이 상태로 창을 닫거나 다른 작업을 열면 한 번 더 저장해 본 뒤 <b>버리고 넘어갈지 / 계속 편집할지</b> 묻습니다 — 모른 채 내용이 사라지지 않습니다. 이미지를 올리는 중이면 다 올라갈 때까지 기다렸다가 넘어갑니다.</td></tr>
</table>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div><b>실시간 저장</b> — 제목은 칸을 벗어나거나 <kbd>Enter</kbd>, 설명은 입력을 멈추고 1초쯤 뒤(또는 칸을 벗어날 때), 담당자·섹션·우선순위·마감일은 바꾸는 즉시 저장됩니다. 새 작업은 <b>제목을 쓰는 순간</b> 만들어집니다(제목 없이 닫으면 만들어지지 않습니다). 협업자 · 하위 작업 · 첨부 파일 · 다른 프로젝트 추가 · 댓글도 누르는 즉시 저장됩니다.</div></div>
<div><b>실시간 저장</b> — 제목은 칸을 벗어나거나 <kbd>Enter</kbd>, 설명은 입력을 멈추고 1초쯤 뒤(또는 칸을 벗어날 때), 담당자·섹션·우선순위·마감일은 바꾸는 즉시 저장됩니다. 새 작업은 <b>제목을 쓰는 순간</b> 만들어집니다(제목 없이 닫으면 만들어지지 않습니다). 협업자 · 세부 작업 · 첨부 파일 · 다른 프로젝트 추가 · 댓글도 누르는 즉시 저장됩니다.</div></div>
<h3>제목과 기본 정보</h3>
<ul>
<li><b>제목</b> — 맨 위 큰 글씨를 눌러 바로 고칩니다.</li>
@@ -293,36 +347,36 @@
<li><b>@태그</b> — <kbd>@</kbd>를 누르면 사람 목록이 뜹니다. 고른 사람의 수신함에 이 작업이 쌓입니다.</li>
</ul>
<h3>첨부 파일</h3>
<p><span class="pjh-ui">파일 추가</span>로 파일을 올립니다(한 파일 최대 20MB). 파일 이름을 누르면 내려받고, <span class="pjh-ui">×</span>로 지웁니다.</p>
<p><span class="pjh-ui">파일 추가</span>로 파일을 올립니다(한 파일 최대 20MB). 파일 이름 옆에 이미지·엑셀·텍스트·PPT·문서·PDF 형식별 아이콘이 표시됩니다. 파일 이름을 누르면 내려받고, <span class="pjh-ui">×</span>로 지웁니다.</p>
<h3>프로젝트 (다른 프로젝트에 추가)</h3>
<p>작업 하나를 <b>여러 프로젝트의 보드에 동시에</b> 보이게 합니다. 예) 신상품 프로젝트의 작업을 디자인 프로젝트 보드에도 올리기.</p>
<p>작업 하나를 <b>여러 프로젝트의 보드에 동시에</b> 보이게 합니다. 예) 신상품 프로젝트의 작업을 디자인 프로젝트 보드에도 올리기. 협업자 아래의 프로젝트 줄에 연결 목록·프로젝트 선택·섹션 선택·추가 버튼이 한 줄로 표시됩니다. 창이 좁으면 이 줄을 좌우로 스크롤할 수 있습니다.</p>
<ol class="pjh-steps">
<li>“프로젝트” 칸에서 프로젝트를 고릅니다.</li>
<li>그 프로젝트에서 들어갈 섹션을 고릅니다.</li>
<li><span class="pjh-ui">다른 프로젝트에 추가</span>를 누릅니다. 빼려면 이름 옆 <span class="pjh-ui">×</span>(연결 해제).</li>
</ol>
<p>작업은 하나라서 어느 보드에서 고쳐도 모두 같이 바뀝니다.</p>
<p>작업은 하나라서 원래 프로젝트에서 고친 내용이 연결된 보드에도 반영됩니다. 원래 프로젝트의 멤버가 아니면 연결된 작업의 내용·댓글·첨부는 읽기만 할 수 있습니다. 연결된 보드 안에서 섹션을 옮기는 것은 가능합니다.</p>
<h3>댓글</h3>
<p>작업 창 맨 아래에 항상 고정된 댓글 칸에 쓰고 <kbd>Enter</kbd>(스크롤해도 그 자리에 있습니다). 칸 오른쪽 <span class="pjh-ui">☺</span>는 이모티콘, <span class="pjh-ui">@</span>는 멤버 태그입니다. 답글은 원 댓글 아래 들여 쓰여 <span class="pjh-ui">↳</span> 표시와 함께 보입니다. 내가 쓴 댓글은 <span class="pjh-ui">✎</span>로 고치고 <span class="pjh-ui">×</span>로 지웁니다. 댓글 속 웹 주소는 링크가 됩니다. 댓글에 붙인 파일은 그 댓글 아래에 보이고(파일만 보낸 댓글도), 첨부 파일 목록에는 <span class="pjh-ui">댓글</span> 표시가 붙습니다.</p>
<p>댓글 대화창에서 파일을 보낼 때 보낼 수 없는 파일(빈 파일, 20MB 초과)이 있으면 댓글을 만들지 않고 그 파일만 빨갛게 표시합니다 — 빼고 다시 보내세요. 인터넷이 끊겨도 쓴 내용과 파일은 그대로 남아 다시 보낼 수 있고, 같은 댓글이 두 번 올라가지 않습니다. @태그는 이 작업을 볼 수 있는 사람만 고를 수 있습니다. 한글을 입력하는 중(조합 중)의 <kbd>Enter</kbd>는 글자 확정만 하고 보내지 않습니다.</p>
</section>
<!-- 9. 작업 창의 하위 작업 -->
<!-- 9. 작업 창의 세부 작업 -->
<section class="pjh-sec" id="subtasks">
<h2><span class="pjh-num">9</span>작업 창의 하위 작업</h2>
<p class="pjh-lead">작업 편집 창 가운데 “하위 작업” 목록입니다. 한 줄에 하나씩, 아사나처럼 다룹니다.</p>
<h2><span class="pjh-num">9</span>작업 창의 세부 작업</h2>
<p class="pjh-lead">작업 편집 창 가운데 “세부 작업” 목록입니다. 한 줄에 하나씩, 아사나처럼 다룹니다.</p>
<ul>
<li><b>추가</b> — 목록 아래 입력칸에 이름을 쓰고, 필요하면 담당자·마감일을 고른 뒤 <span class="pjh-ui">추가</span> 또는 <kbd>Enter</kbd>.</li>
<li><b>순서 바꾸기</b> — 줄에 마우스를 올리면 왼쪽에 <span class="pjh-ui">⠿</span> 손잡이가 나옵니다. 잡고 위아래로 끌어 놓습니다.</li>
<li><b>완료</b> — <span class="pjh-ui">✓</span>를 누릅니다. 완료한 줄은 취소선이 그어집니다.</li>
<li><b>이름 고치기</b> — 이름 글자를 눌러 바로 고칩니다(칸은 이름 길이만큼만 차지합니다).</li>
<li><b>마감일·담당자</b> — 날짜 글자나 사람 아이콘을 누릅니다. 비어 있으면 줄에 마우스를 올렸을 때 점선 아이콘이 나옵니다.</li>
<li><b>열기</b> — 줄의 빈 곳이나 오른쪽 <span class="pjh-ui">›</span>를 누르면 그 하위 작업이 편집 창으로 열립니다.</li>
<li><b>하위 작업의 하위 작업</b> — 그 하위 작업 안에도 하위 작업이 있으면 이름 옆에 <span class="pjh-ui">N ⤷</span> 아이콘이 붙습니다(보드 카드의 펼친 목록도 같음).</li>
<li><b>삭제</b> — 줄에서 우클릭 → <span class="pjh-ui">하위 작업 삭제</span>.</li>
<li><b>열기</b> — 줄의 빈 곳이나 오른쪽 <span class="pjh-ui">›</span>를 누르면 그 세부 작업이 편집 창으로 열립니다.</li>
<li><b>세부 작업의 세부 작업</b> — 그 세부 작업 안에도 세부 작업이 있으면 이름 옆에 <span class="pjh-ui">N ⤷</span> 아이콘이 붙습니다(보드 카드의 펼친 목록도 같음).</li>
<li><b>삭제</b> — 줄에서 우클릭 → <span class="pjh-ui">세부 작업 삭제</span>.</li>
</ul>
<h3>하위 작업을 열었을 때</h3>
<p>하위 작업도 작업과 똑같이 설명 · 담당자 · 마감일 · 협업자 · 첨부 파일 · 댓글을 모두 쓸 수 있습니다. 제목 위에 <span class="pjh-ui">↰ 상위 작업 이름</span>이 보이고, 누르면 상위 작업으로 돌아갑니다. 하위 작업에는 섹션이 없어서 섹션 칸은 나오지 않습니다.</p>
<h3>세부 작업을 열었을 때</h3>
<p>세부 작업도 작업과 똑같이 설명 · 담당자 · 마감일 · 협업자 · 첨부 파일 · 댓글을 모두 쓸 수 있습니다. 제목 위에 <span class="pjh-ui">↰ 상위 작업 이름</span>이 보이고, 누르면 상위 작업으로 돌아갑니다. 세부 작업에는 섹션이 없어서 섹션 칸은 나오지 않습니다.</p>
</section>
<!-- 10. 날짜 -->
@@ -337,7 +391,7 @@
<li>창 바깥을 누르거나 <kbd>Esc</kbd>로 닫습니다.</li>
</ul>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>보드 카드와 하위 작업 줄에서는 날짜를 누르는 즉시 저장됩니다. 작업 편집 창의 마감일도 고르는 즉시 저장됩니다.</div></div>
<div>보드 카드와 세부 작업 줄에서는 날짜를 누르는 즉시 저장됩니다. 작업 편집 창의 마감일도 고르는 즉시 저장됩니다.</div></div>
</section>
<!-- 11. 목록 -->
@@ -368,9 +422,9 @@
<h2><span class="pjh-num">13</span>타임라인 보기</h2>
<ul>
<li>기간이 있는(시작일 또는 마감일이 있는) 작업이 가로 막대로 나옵니다. <b>이 프로젝트</b>는 섹션별 줄, <b>전체 프로젝트</b>는 프로젝트별 줄이며 프로젝트 전체 기간이 옅은 배경으로 깔립니다.</li>
<li>작업은 아사나처럼 <b>카드</b>로 보입니다 — 담당자 사진 · 제목 · 하위 작업이 있으면 <span class="pjh-ui">N ⤷</span> · 댓글이 있으면 <span class="pjh-ui">💬 N</span>(누르면 댓글 대화창), 아래 줄에 “마감일: 9월 23일”처럼 날짜. 기간이 있는 작업은 기간만큼 막대로 늘어납니다.</li>
<li>카드에 하위 작업이 있으면 <span class="pjh-ui">N ⤷</span>(마우스를 올리면 “하위 작업 N개”), 설명이 있으면 줄글 아이콘이 붙습니다. 하위 작업은 작업 편집 창에서 봅니다.</li>
<li>줄 색은 <b>섹션 편집에서 정한 섹션 색</b>입니다(색이 없는 섹션은 프로젝트 색). 왼쪽 섹션 이름 앞에도 같은 색 네모가 붙습니다. 주말은 세로줄이 옅은 회색입니다.</li>
<li>작업은 아사나처럼 <b>카드</b>로 보입니다 — 담당자 사진 · 제목 · 세부 작업이 있으면 <span class="pjh-ui">N ⤷</span> · 댓글이 있으면 <span class="pjh-ui">💬 N</span>(누르면 댓글 대화창), 아래 줄에 “마감일: 9월 23일”처럼 날짜. 기간이 있는 작업은 기간만큼 막대로 늘어납니다.</li>
<li>카드에 세부 작업이 있으면 <span class="pjh-ui">N ⤷</span>(마우스를 올리면 “세부 작업 N개”), 설명이 있으면 줄글 아이콘이 붙습니다. 세부 작업은 작업 편집 창에서 봅니다.</li>
<li>줄 색은 <b>프로젝트 색</b>입니다(섹션별 색 지정은 없앴습니다 — 보드의 섹션 머리는 모두 같은 연회색). 주말은 세로줄이 옅은 회색입니다.</li>
<li>카드(막대)를 <b>바로 끌면</b> 하루 단위로 기간 전체가 이동하고(하루짜리 작업은 마감일이 옮겨집니다), 기간 막대의 <b>양 끝을 끌면</b> 시작일이나 마감일만 바뀝니다. 먼저 눌러 선택하지 않아도 됩니다.</li>
<li>처음 열면 하루 칸이 날짜 글자(“30일 (수)”) 폭만큼이라 한 화면에 여러 날이 보입니다. <kbd>Ctrl</kbd> + 마우스 휠로 확대·축소(하루 칸이 날짜 글자 폭이 되면 더 줄어들지 않습니다), 빈 곳을 끌면 좌우로 이동합니다(보던 구간은 기억). <span class="pjh-ui">오늘</span>로 오늘 날짜로 돌아옵니다.</li>
<li>아래 날짜 줄은 캘린더와 같은 색입니다 — <span style="color:#1d4ed8;font-weight:700">토요일은 파랑</span>, <span style="color:#c22b10;font-weight:700">일요일·국경일·대체공휴일은 빨강</span>. 공휴일은 날짜 밑에 이름(예: 추석, 대체휴일)이 나오고, 마우스를 올리면 전체 이름이 보입니다.</li>
@@ -385,7 +439,7 @@
<li>위쪽 숫자 카드 4개: <b>완료된 작업 합계 · 미완료 작업 합계 · 마감일이 지난 작업 합계 · 작업 합계</b></li>
<li><b>미완료 작업 합계(섹션별)</b> — 섹션마다 남은 일이 몇 개인지 막대로 보여줍니다. 막대에 마우스를 올리면 숫자가 나옵니다.</li>
<li><b>작업 합계(완료 상태별)</b> — 완료와 미완료 비율을 도넛 차트로 보여줍니다.</li>
<li><b>예정된 작업 합계(담당자별)</b> — 사람별로 일정이 잡힌 미완료 작업 수(상위 10명). <b>관리자에게만</b> 보입니다.</li>
<li><b>담당자별 작업 합계(메인·세부 작업, 완료)</b> — 이 범위에서 사람별로 배정된 작업 <b>전부</b>(마감일이 없어도, 필터와 관계없이)를 사람마다 <b>메인 작업·세부 작업 세로 막대</b>로 보여 줍니다(막대 하나 = 그 작업 전체, 초록으로 찬 높이 = 완료율, 위 숫자 = 완료/전체와 %, 이름 아래 = 전체 완료율). 막대를 누르면 오른쪽에서 그 사람의 업무 목록(미완료·완료)이 나오고, 항목을 누르면 작업 편집 창이 열립니다. 편집 창을 닫으면 숫자와 목록이 다시 계산됩니다. 세부 작업은 세부 작업에 지정된 담당자 기준입니다. <b>Pro user 이상에게만</b> 보입니다.</li>
<li>범위(이 프로젝트/전체 프로젝트)와 필터 바 설정을 그대로 따라 계산합니다.</li>
</ul>
</section>
@@ -399,7 +453,7 @@
<li>찾기(제목·설명·프로젝트), 마감(마감 지남·오늘·이번 주·마감일 없음), 우선순위로 거를 수 있습니다.</li>
<li>칸 제목을 누르면 정렬합니다.</li>
<li>줄을 누르면 그 작업의 프로젝트 화면으로 가서 작업 편집 창이 바로 열립니다. 우클릭하면 작업 메뉴가 나옵니다.</li>
<li>내가 담당자인 하위 작업은 상위 작업 이름 아래에 들여 쓴 줄로 나옵니다.</li>
<li>내가 담당자인 세부 작업은 상위 작업 이름 아래에 들여 쓴 줄로 나옵니다.</li>
</ul>
</section>
@@ -409,7 +463,7 @@
<h3>댓글 대화창</h3>
<p>카드·목록·캘린더·내 작업에 보이는 <span class="pjh-ui">💬 N</span>을 <b>한 번 누르면</b> 메신저처럼 생긴 댓글 대화창이 열립니다.</p>
<ul>
<li>입력칸에 쓰고 <span class="pjh-ui">전송</span> 또는 <kbd>Enter</kbd>.</li>
<li>입력칸에 쓰고 <span class="pjh-ui">전송</span> 또는 <kbd>Enter</kbd>. <kbd>Shift</kbd>+<kbd>Enter</kbd>로 줄바꿈합니다. 입력칸은 높이 70px로 고정되며 긴 글은 칸 안에서 스크롤됩니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">attach_file</span></span>로 파일을 붙이거나, 캡처한 이미지를 <kbd>Ctrl</kbd>+<kbd>V</kbd>로 붙여 넣습니다. 이미지는 작은 그림으로 보입니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">add_reaction</span></span>를 누르면 이모티콘 창이 열립니다. 종류별 탭으로 넘기거나 <b>검색</b>(예: 축하, 감사, 완료)으로 찾고, 누르면 커서 자리에 들어갑니다. 자주 쓴 이모티콘은 맨 위에 모입니다. 작업 팝업 아래 댓글 입력칸에도 같은 버튼이 있습니다.</li>
<li>웹 주소를 붙여 넣으면 링크가 되고, 누르면 새 탭에서 열립니다.</li>
@@ -436,7 +490,10 @@
<h3>수신함 화면</h3>
<ul>
<li><b>나를 태그한 작업</b> — 누가 나를 @태그했는지와 함께 보입니다. <span class="pjh-ui">태그 모두 확인</span>으로 한 번에 확인 처리합니다.</li>
<li><b>알림</b> — 작업 배정 · 작업 완료 · 새 댓글 · 마감 알림이 쌓입니다. 항목을 누르면 읽음이 되고, <span class="pjh-ui">확인</span>을 누르면 수신함에 머문 채 <b>오른쪽에 그 작업 창</b>이 열립니다(나를 태그한 작업도 같음). 창 맨 위 <span class="pjh-ui">프로젝트로 이동</span>을 누르면 그 작업이 있는 프로젝트 화면으로 갑니다. 창을 닫으면(→| 또는 <kbd>Esc</kbd>) 다시 수신함입니다. <kbd>Ctrl</kbd>+클릭하면 새 탭에서 프로젝트 화면으로 엽니다.</li>
<li><b>알림</b> — 작업 배정 · 작업 완료 · 새 댓글 · 마감 알림이 쌓입니다. 수신함에는 <b>아직 확인하지 않은 것만</b> 나옵니다. 줄을 누르면 수신함에 머문 채 <b>오른쪽에 그 작업 창</b>이 열리고(나를 태그한 작업도 같음), 작업 창이 열린 채 다른 줄을 누르면 작업 창이 그 작업으로 바뀝니다. 한 번 확인한 줄은 다른 줄을 고르거나 창을 닫으면 수신함에서 빠집니다(같은 작업의 태그·알림 줄은 함께). 열지 않고 빼려면 오른쪽 클릭 → <span class="pjh-ui">확인(목록에서 빼기)</span>. 창 맨 위 <span class="pjh-ui">프로젝트로 이동</span>을 누르면 그 작업이 있는 프로젝트 화면으로 갑니다. 창을 닫으면(→| 또는 <kbd>Esc</kbd>) 다시 수신함입니다. <kbd>Ctrl</kbd>+클릭하면 새 탭에서 프로젝트 화면으로 엽니다.
작업 창에서 저장 중이거나 저장하지 못한 내용이 있으면, 다른 줄로 바꾸거나 닫기 전에 저장이 끝나길 기다리고 다시 저장해 봅니다. 그래도 안 되면 <span class="pjh-ui">버리고 넘어가기 / 계속 편집</span>을 묻습니다(작업 창을 직접 닫을 때와 같음).
확인(읽음) 처리가 서버에 저장되지 않은 줄은 굵게 남아 있어 다시 누를 수 있습니다.
다른 프로젝트에서 연결돼 와 읽기만 되는 작업의 알림은, 내가 볼 수 있는 연결된 프로젝트 화면으로 열립니다(웹 팝업·PC 알림도 같음).</li>
<li><span class="pjh-ui">알림 모두 읽음</span>으로 한 번에 읽음 처리합니다. 읽지 않은 알림에서 우클릭 → <span class="pjh-ui">읽음으로 표시</span>도 됩니다.</li>
</ul>
<h3>어떤 알림이 누구에게 가나요?</h3>
@@ -456,70 +513,227 @@
<h3>전체 검색</h3>
<ul>
<li>왼쪽 사이드바 맨 위 검색창. 어느 화면에서든 <kbd>/</kbd> 키를 누르면 바로 검색창으로 갑니다.</li>
<li><b>2글자 이상</b> 입력하면 내가 볼 수 있는 모든 프로젝트의 작업(하위 작업 포함)을 <b>제목 · 설명 · 댓글</b>에서 찾습니다.</li>
<li><b>2글자 이상</b> 입력하면 내가 볼 수 있는 모든 프로젝트의 작업(세부 작업 포함)을 <b>제목 · 설명 · 댓글</b>에서 찾습니다.</li>
<li>결과를 누르면 그 작업이 열립니다.</li>
</ul>
<h3>공유 링크</h3>
<ul>
<li>작업 편집 창의 <span class="pjh-ui">공유</span> 또는 우클릭 <span class="pjh-ui">작업 링크 복사</span>로 주소를 복사합니다.</li>
<li>받은 사람이 주소를 열면(로그인 전이면 로그인 후) 그 작업이 바로 열립니다. 하위 작업 링크는 하위 작업 자체가 열립니다.</li>
<li>그 프로젝트의 <b>멤버만</b> 열 수 있어 밖으로 새지 않습니다.</li>
<li>받은 사람이 주소를 열면(로그인 전이면 로그인 후) 그 작업이 바로 열립니다. 세부 작업 링크는 세부 작업 자체가 열립니다.</li>
<li>현재 그 작업을 볼 수 있는 멤버·소유자가 열 수 있습니다. 연결된 프로젝트 멤버는 읽기 전용으로 보며, 멤버에서 제외되면 예전 링크로도 열 수 없습니다.</li>
</ul>
</section>
<!-- 19. 휴지통 -->
<section class="pjh-sec" id="trash">
<h2><span class="pjh-num">19</span>휴지통 (관리자)</h2>
<h2><span class="pjh-num">19</span>휴지통 (Pro user 이상)</h2>
<ul>
<li>지운 작업은 바로 사라지지 않고 <b>3개월 동안</b> 휴지통에 보관됩니다. 하위 작업 · 댓글 · 협업자 · 첨부 파일도 함께 보관됩니다.</li>
<li>관리자는 왼쪽 사이드바 <b>휴지통</b>에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다.</li>
<li>지운 작업은 바로 사라지지 않고 <b>3개월 동안</b> 휴지통에 보관됩니다. 세부 작업 · 댓글 · 협업자 · 첨부 파일도 함께 보관됩니다.</li>
<li>Pro user 이상은 왼쪽 사이드바 <b>휴지통</b>에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다. 자기가 멤버인 프로젝트의 작업만 보입니다.</li>
<li><span class="pjh-ui">복구</span>를 누르면 원래 프로젝트 · 섹션 자리로 그대로 돌아옵니다. 복구된 줄의 <span class="pjh-ui">복구됨 · 열기</span>로 바로 열어 볼 수 있습니다.</li>
<li>3개월이 지나면 영구 삭제됩니다.</li>
</ul>
<div class="pjh-note"><span class="material-symbols-outlined">info</span>
<div>하위 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.</div></div>
<div>세부 작업만 따로 지웠는데 상위 작업도 지워진 상태라면, 상위 작업을 먼저 복구해야 합니다.</div></div>
</section>
<!-- 20. 단축키와 FAQ -->
<!-- 20. 연간 목표 -->
<section class="pjh-sec" id="goals">
<h2><span class="pjh-num">20</span>연간 목표</h2>
<p class="pjh-lead">한 해의 매출 목표·실적과 업무 계획을 한 표에서 관리합니다. 숫자는 위쪽 지표에, 실행 계획은 아래쪽 업무 영역에 적습니다. 프로젝트 관리 권한이 있는 직원은 볼 수 있고, 입력·구조 변경은 Pro user 이상만 할 수 있습니다.</p>
<h3 id="goals-start">목표 열기와 연도 만들기</h3>
<ol class="pjh-steps">
<li>왼쪽 사이드바 <span class="pjh-ui">목표</span>를 눌러 연도 목록을 펼친 뒤 원하는 연도를 누릅니다. 올해는 목표가 아직 없어도 목록에 보입니다.</li>
<li>Pro user 이상은 빈 연도 화면에서 <span class="pjh-ui">해당 연도 목표 만들기</span>, 또는 사이드바의 <span class="pjh-ui">+ 연도 추가</span>로 새 표를 만듭니다.</li>
<li>가장 가까운 이전 연도의 업무 영역·줄 구성을 가져옵니다. 이전 연도가 없으면 다음 연도의 구성을 사용하고, 처음이면 상품·마케팅·컨텐츠·유통으로 시작합니다. 이전 숫자와 계획 글은 복사하지 않습니다.</li>
<li>위쪽 <span class="pjh-ui">매출 단위</span>를 확인한 뒤 월별 숫자와 계획을 입력합니다.</li>
</ol>
<h3 id="goals-metrics">매출·로아스 입력과 달성률 계산</h3>
<table class="pjh-table">
<tr><th>칸</th><th>입력·계산 방법</th></tr>
<tr><td>매출 목표</td><td>월 칸을 누르면 그 달 입력 창이 열립니다. 맨 위 <b>월 전체 목표</b>를 직접 넣고, 아래에 <b>주차별 목표</b>(매출 단위)를 넣은 뒤 <span class="pjh-ui">저장</span>합니다. 월 목표는 주차 합계와 따로 저장되고, 맨 아래에 <b>주차 합계</b>와 <b>차이(월 목표 − 주차 합계)</b>가 나옵니다 — +면 아직 주차에 못 나눈 금액, −면 주차 합계가 월 목표를 넘은 것입니다. 주차는 <a href="#meetings-week">주간 회의록 주차</a>와 같습니다.</td></tr>
<tr><td>매출 실적</td><td>Pro user 이상이 월별 숫자를 직접 입력합니다. 목표 표의 실적은 회의록의 자동 매출과 별도로 관리하므로 실적 모듈에서 자동으로 채워지지 않습니다.</td></tr>
<tr><td>매출 단위</td><td>예를 들어 단위가 <b>백만원</b>이면 30은 30,000,000원입니다. 단위를 바꿔도 이미 적은 숫자는 자동 환산되지 않으므로 숫자와 단위를 함께 확인하세요.</td></tr>
<tr><td>연간·분기 매출</td><td>해당 기간에 입력한 월 숫자의 합계입니다. 합계 칸에 따로 입력하지 않습니다.</td></tr>
<tr><td>달성</td><td>실적 ÷ 목표 × 100입니다. 월별로 계산하며, 연간·분기는 <b>기간 전체 목표 합계</b> 대비 입력된 실적 합계로 계산합니다. 목표가 없거나 0이면 달성률을 표시하지 않습니다. 100% 이상은 초록으로 표시됩니다.</td></tr>
<tr><td>로아스(ROAS)</td><td>광고비 대비 매출 비율을 <b>% 단위</b>로 적습니다. 예: 300은 300%입니다. 연간·분기는 월 매출과 ROAS로 환산한 광고비를 합쳐 계산하고, 필요한 월 매출이 빠져 있으면 입력된 ROAS의 단순 평균을 사용합니다.</td></tr>
</table>
<p>숫자는 <kbd>Enter</kbd> 또는 칸을 떠날 때 저장됩니다. 숫자 칸을 비우면 값을 지우며, <kbd>Esc</kbd>를 누르면 마지막 저장값으로 돌아갑니다.</p>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span><div>1~3월 목표가 각각 100이고 1월 실적만 50이면 1분기 달성은 50 ÷ 300 = 약 16.7%입니다. 아직 실적을 넣지 않은 달의 목표도 분기 목표 합계에 포함됩니다.</div></div>
<h3 id="goals-plan">업무 영역·항목·연간·분기·월 계획</h3>
<p>업무 영역은 상품·마케팅처럼 큰 분류, 항목은 그 안의 세부 주제입니다. 한 항목의 연간 칸에는 큰 방향, 분기 칸에는 중간 목표, 월 칸에는 구체적인 실행 계획을 적으면 주간 회의에서 확인하기 쉽습니다.</p>
<ul>
<li><span class="pjh-ui">+ 업무 영역 추가</span>를 누르면 새 영역이 생기고 이름을 바로 고칠 수 있습니다.</li>
<li>영역·항목 이름을 클릭해 고칩니다. <kbd>Enter</kbd>는 저장, <kbd>Esc</kbd>는 취소입니다.</li>
<li>이름 칸을 우클릭하거나 <span class="pjh-ui">⋮</span>를 누르면 영역 색·위아래 순서·줄 추가·삭제 메뉴가 나옵니다. 항목 메뉴에서는 해당 줄 위·아래에 줄을 추가할 수 있습니다. 영역의 마지막 줄은 지울 수 없습니다.</li>
<li>연간 글 칸에서 우클릭해 줄을 추가하면 같은 항목 이름 아래에 여러 줄로 나눠 계획을 적을 수 있습니다.</li>
<li>키보드는 <kbd>Tab</kbd>으로 이름이나 ⋮ 버튼에 이동해 <kbd>Enter</kbd>로 열고, 메뉴에서 <kbd>↑</kbd><kbd>↓</kbd>·<kbd>Enter</kbd>로 선택합니다. <kbd>Esc</kbd>로 닫습니다. 터치 화면에서는 ⋮를 누릅니다.</li>
</ul>
<h3 id="goals-format">글자 서식 바꾸기</h3>
<p>글 칸에서 글자를 드래그해 선택하면 해당 셀 상단에 서식 도구가 나타납니다. <b>선택한 글자에만</b> 12색 견본·크기·굵게·기울임·밑줄을 적용합니다. 크기 버튼은 2px씩 조절하며 범위는 10~32px입니다.</p>
<p>굵게·기울임·밑줄은 다시 누르면 해제됩니다. <span class="pjh-ui">서식 초기화</span>는 선택한 글자의 서식만 되돌리고 내용은 유지합니다. 글과 서식은 입력을 약 0.8초 멈추거나 칸을 떠날 때 자동 저장됩니다.</p>
<h3 id="goals-table">분기 접기·열 너비·행 높이</h3>
<ul>
<li>열은 연간 → 1~3월 → 1분기 → 4~6월 → 2분기 → 7~9월 → 3분기 → 10~12월 → 4분기 순서입니다. <b>분기 머리 칸</b>을 누르면 해당 월 3개가 부드럽게 접히거나 펼쳐집니다. 숫자와 글은 펼침이 끝난 뒤 나타납니다. 네모 안 <b>−</b>는 접기, <b>+</b>는 펼치기입니다.</li>
<li>어느 행에서든 셀의 <b>오른쪽 경계</b>를 끌어 열 너비를 조절합니다. 경계를 더블클릭하면 가장 긴 문단에 맞춥니다. 직접 넣은 줄바꿈·글자 크기·굵기도 반영합니다.</li>
<li>셀 우클릭의 <span class="pjh-ui">현재 열 너비 자동 맞춤</span>·<span class="pjh-ui">전체 열 너비 자동 맞춤</span>도 사용할 수 있습니다. 전체 맞춤은 접힌 월 열까지 포함합니다. 병합 칸은 다른 열을 유지하며 오른쪽 끝 열 너비를 조절합니다.</li>
<li>접힘·열 너비는 내 브라우저에 기억됩니다. 행 높이는 가장 높은 글 칸에 맞춰 늘고, 글이 줄면 함께 줄어듭니다. 1열(업무 영역)·2열(항목 이름)은 병합된 칸도 항상 세로 가운데 정렬이며, 목표 내용은 상단 정렬입니다.</li>
<li>가로 스크롤에서는 구분·항목·연간 칸이, 세로 스크롤에서는 머리와 매출·로아스 지표가 고정됩니다.</li>
<li><b>월 이름</b>을 누르면 그 달의 <a href="#meetings">주간 회의록</a>으로 이동합니다.</li>
</ul>
<h3 id="goals-merge">셀 병합·병합 해제</h3>
<ol class="pjh-steps">
<li>Pro user 이상은 업무 영역의 글 칸을 마우스로 끌어 여러 칸을 선택한 뒤 우클릭 → <span class="pjh-ui">셀 병합</span>을 누릅니다.</li>
<li>가로 병합은 <b>같은 분기의 월 칸끼리</b> 가능합니다. 연간·분기 칸은 세로로만 병합합니다. 선택한 칸들의 글은 순서대로 첫 칸에 모입니다.</li>
<li>병합된 칸을 우클릭 → <span class="pjh-ui">병합 해제</span>하면 다시 나뉩니다. 글은 왼쪽 위 칸에 남습니다.</li>
</ol>
<h3 id="goals-save">저장 실패와 연도 삭제</h3>
<p>저장 성공 시 칸 테두리가 잠깐 초록으로 바뀝니다. 실패하면 빨간 테두리와 안내가 나오며 입력값은 유지됩니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 저장 안 된 값이 있으면 영역·줄 추가, 병합을 진행하기 전에 저장을 시도하고, 실패하면 해당 작업을 멈춥니다.</p>
<p>저장되지 않은 초안은 내 브라우저에도 잠시 보관합니다. 다음에 같은 화면을 열면 복원하지만, 그 사이 다른 사람이 같은 칸을 바꿨으면 자동으로 덮어쓰지 않습니다. 저장 안 된 상태로 페이지를 떠나려 하면 브라우저가 확인합니다.</p>
<p>Pro user 이상의 <span class="pjh-ui">연도 삭제</span>는 그 연도의 숫자·업무 영역·계획 글을 삭제합니다. 확인창에 연도를 직접 입력해야 진행되며 되돌릴 수 없습니다.</p>
</section>
<!-- 21. 주간 회의록 -->
<section class="pjh-sec" id="meetings">
<h2><span class="pjh-num">21</span>주간 회의록</h2>
<p class="pjh-lead">월 목표를 기준으로 지난주 결과를 리뷰하고 이번주 주요 업무와 금액 목표를 정하는 화면입니다. 연간 목표의 월 계획, 실적 모듈의 매출, 주별 결정 사항을 함께 확인합니다. 프로젝트 관리 권한이 있는 직원은 <b>누구나 회의록을 만들고 고칠 수 있습니다</b>. Pro user 이상이 <span class="pjh-ui">회의 완료</span>를 누르면 그 회의록은 아무도 고칠 수 없게 잠기고(🔒 회의 완료 표시), Pro user 이상은 <span class="pjh-ui">완료 해제</span>로 다시 열 수 있습니다. 회의록 삭제도 Pro user 이상만 합니다.</p>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span><div>지난주 리뷰의 <b>결과</b>(글·금액)는 다음 주 회의에서 적는 값이라, 지난주 회의록이 완료돼 있어도 이번 주 회의록이 열려 있으면 적을 수 있습니다. 이번 주 회의록까지 완료하면 함께 잠깁니다. 다음 주차 회의록이 아직 없으면 그 주 회의록이 열려 있는 동안만 결과를 고칠 수 있습니다.</div></div>
<h3 id="meetings-week">회의록 열기와 주차 기준</h3>
<p>왼쪽 연도 앞 화살표를 누르면 해당 연도의 하위 월 전체를 접거나 펼칠 수 있습니다. 연도 글자를 누르면 연간 목표를 엽니다. 연도와 월의 접기·펼치기 선택은 이 브라우저에 기억됩니다.</p>
<ol class="pjh-steps">
<li>왼쪽 <span class="pjh-ui">목표</span>에서 연도를 선택하고 표 머리의 <b>월 이름</b>을 누릅니다.</li>
<li>이미 만든 회의록은 왼쪽 목표 연도 아래의 <b>월 폴더</b>에서도 열 수 있습니다. 폴더 아이콘과 월 이름을 눌러 접거나 펼치고, 주차·날짜 항목을 누르면 오른쪽 회의록만 바뀝니다. 왼쪽 메뉴와 스크롤 위치는 유지됩니다. 입력한 칸은 이동 전에 저장하며, 저장에 실패하면 현재 회의록을 유지합니다. 접기·펼치기는 이 브라우저에 기억됩니다.</li>
<li>위쪽 주차 탭 또는 오른쪽 작은 달력의 한 줄을 눌러 주차를 고릅니다. 달력 줄을 누르면 그 줄의 이 달 날짜가 든 주차가 열립니다. 점은 회의록이 있는 주차, <span class="pjh-ui">이번 주</span>는 현재 주차입니다. 이전·다음 달 버튼으로 달을 바꿉니다.</li>
<li>주차는 <b>그 달 안에서만</b> 나눕니다. 기본은 월요일~일요일입니다.
<ul>
<li>1일이 월~금요일이면 1일부터 그 주 일요일까지가 1주차입니다. 예: 2026년 10월 1주차는 10/1(목)~10/4.</li>
<li>1일이 토·일요일이면 1일부터 다음 주 일요일까지가 1주차입니다. 예: 2026년 8월 1주차는 8/1(토)~8/9.</li>
<li>말일이 월·화요일이면 그 하루·이틀은 앞 주차에 붙습니다. 예: 2026년 8월 마지막 주차는 8/24~8/31(월).</li>
</ul>
</li>
<li><span class="pjh-ui">해당 연도 목표</span> 버튼은 연간 목표 표로 돌아갑니다.</li>
</ol>
<h3 id="meetings-create">회의록 만들기와 이어받는 항목</h3>
<p>선택한 주에 회의록이 없으면 <span class="pjh-ui">해당 주차 회의록 만들기</span>가 보입니다(누구나 만들 수 있습니다). 화면을 열기만 해서는 회의록이 만들어지지 않습니다.</p>
<ul>
<li>줄이 있는 가장 가까운 앞선 회의록에서 <b>구역·항목 이름·색·순서</b>를 이어받습니다. 앞선 회의록이 없으면 가장 가까운 다음 회의록의 구성을 가져옵니다.</li>
<li>어느 쪽에도 회의록이 없으면 해당 연도 목표 표의 업무 영역과 기본 양식으로 시작합니다.</li>
<li>주요 업무·금액·메모는 새로 적습니다. 구성을 이어받는 것과 <b>지난주 리뷰</b>는 다릅니다. 리뷰에는 바로 앞 주차의 같은 항목만 표시됩니다.</li>
</ul>
<h3 id="meetings-month-plan">이 달 계획 확인</h3>
<p>제목 아래 <span class="pjh-ui">해당 월 계획</span>은 연간 목표 표에 적은 월 계획을 업무 영역별로 보여 줍니다. 굵게·기울임·밑줄·글자 색상과 줄바꿈·들여쓰기를 유지하고, 글자 크기는 월 계획의 기본 크기로 표시합니다. 빈 계획은 생략하고, 병합 칸은 해당 월을 포함하는 계획을 한 번 표시합니다. 여기서는 읽기만 하므로 수정하려면 연간 목표 표로 돌아갑니다.</p>
<h3 id="meetings-kpis">위쪽 3칸 — 월 계획·숫자, 결정 사항, 작업 등록</h3>
<p>제목 아래 세 칸은 표를 스크롤해도 그대로 보입니다. 왼쪽은 <b>월 계획</b>이고 그 머리 줄 오른쪽에 숫자 4개(월 목표 · 누적 목표 · 누적 실적 · 목표 대비)가 작게 한 줄로 나옵니다(목표 표 매출 단위, 예: 백만원 — 숫자에 마우스를 올리면 원 단위 금액과 뜻). 가운데는 <b>결정사항</b>(진행상황 수시 공유 및 완료 되어야 할 것), 오른쪽은 <b>작업 등록</b> 표입니다.</p>
<ol class="pjh-steps">
<li><b>작업 등록</b> — 제목 칸에 작업 이름을 씁니다. 담당자·프로젝트·섹션 칸을 누르면 고를 수 있는 목록이 나옵니다.</li>
<li>프로젝트는 내가 멤버인 프로젝트만 나오고, 고르면 첫 섹션이 자동으로 들어갑니다. 담당자는 그 프로젝트의 멤버·소유자 중에서 고릅니다(프로젝트를 먼저 고르면 정확합니다).</li>
<li>맨 오른쪽 <span class="pjh-ui">적용</span>을 누르면 그 프로젝트에 작업이 만들어지고, 줄에 <b>등록됨</b> 링크가 생깁니다. 줄은 이 브라우저에 남아 있어 새로고침해도 사라지지 않습니다. <span class="pjh-ui">+ 줄 추가</span>로 줄을 늘립니다.</li>
<li>등록된 줄의 휴지통 아이콘을 누르면 확인 후 <b>그 프로젝트의 작업도 함께 삭제</b>됩니다(휴지통에 3개월 보관). 적용 전 줄의 <span class="pjh-ui">×</span>는 줄만 지웁니다. 작업 삭제는 만든 사람만 할 수 있습니다.</li>
</ol>
<table class="pjh-table">
<tr><th>지표</th><th>뜻과 출처</th></tr>
<tr><td>월 목표 매출</td><td>연간 목표 표의 해당 월 매출 목표(= 주차별 목표 합계)입니다. 매출 단위가 원·천원·만원·십만원·백만원·천만원·억원이면 원으로 환산해 함께 보여 줍니다.</td></tr>
<tr><td>월 누적 목표 매출</td><td>연간 목표 표에서 입력한 <b>주차별 목표의 1주차~선택한 주차 합계</b>(원)입니다. 주차별 목표가 없으면 비어 있고, 목표 표로 가는 안내가 나옵니다.</td></tr>
<tr><td>월 누적 실적</td><td>실적 모듈의 매출 집계 쇼핑몰 매출을 <b>그 달 1일부터 오늘까지</b> 합칩니다. 지난 주차를 보면 그 주차 마지막 날까지입니다.</td></tr>
<tr><td>누적 목표 대비 달성</td><td>월 누적 실적 − 월 누적 목표 매출 금액(넘으면 +, 모자라면 −)과 월 누적 실적 ÷ 월 누적 목표 매출 %입니다. 100% 이상은 초록입니다.</td></tr>
</table>
<div class="pjh-tip"><span class="material-symbols-outlined">lightbulb</span><div>주차별 목표가 1주차 2천만, 2주차 3천만이고 2주차까지의 실적이 4천5백만원이면 누적 목표 대비 달성은 −5,000,000원(90%)입니다.</div></div>
<h3 id="meetings-edit">주요 업무·정량 목표·참석자·메모 입력</h3>
<ol class="pjh-steps">
<li>줄별 <b>정량 목표</b>에 각 항목의 이번 주차 목표를 적습니다. 금액(원 단위)뿐 아니라 <code>20개</code>처럼 글도 됩니다. 전체 매출 목표는 연간 목표 표의 주차별 목표에서 정합니다.</li>
<li>각 항목의 <b>주요 업무</b>에 실행할 일과 일정을 적습니다.</li>
<li><span class="pjh-ui">참석자</span>를 눌러 프로젝트 관리 권한이 있는 등록 직원 중 선택합니다. 찾기·전원 선택·모두 해제를 사용할 수 있으며, 칩의 <span class="pjh-ui">×</span>로 참석자를 뺍니다.</li>
<li>참석자 오른쪽 <span class="pjh-ui">회의록 보드</span>를 누르면 그 주차의 Google 슬라이드가 새 창으로 열립니다. 처음 누르면 회의록 보드 공유 드라이브에 빈 슬라이드(제목 틀 없음)를 <b>"10월 2주차 (10/5~10/11)"</b> 같은 이름으로 만들고, 다음부터는 같은 파일을 엽니다. 직원 누구나 열 수 있으며, 슬라이드 편집 권한은 공유 드라이브 권한을 따릅니다. 창이 안 뜨면 브라우저의 팝업 허용을 확인하세요.</li>
<li>위쪽 가운데 <b>결정사항</b>에 회의 결론과 진행상황을 수시로 공유하고 완료되어야 할 일을 적습니다.</li>
</ol>
<p>금액은 <code>1,200,000</code>·<code>120만</code>·<code>1.5억</code>·<code>3천만</code>·<code>1억2천만</code>처럼 입력할 수 있습니다. <kbd>Enter</kbd> 또는 칸을 떠날 때 원 단위로 저장되고, 빈칸은 값을 지웁니다. 숫자로 읽히지 않는 값(예: <code>20개</code>)은 적은 글 그대로 저장됩니다. 글·메모는 입력을 약 0.8초 멈추거나 칸을 떠날 때, 참석자는 바꾸는 즉시 저장됩니다.</p>
<p>목표·주간 회의록 표에서 입력한 글·숫자·이름이 칸보다 길면 열 너비가 자동으로 늘어납니다. 글 셀에서는 <kbd>Enter</kbd>를 한 번 누르면 바로 다음 줄로 이동합니다. 지운 뒤 너비를 줄이려면 열 너비 자동 맞춤을 사용하세요.</p>
<p>주요 업무 셀에서는 목표 표의 셀 편집 도구를 함께 사용할 수 있습니다.</p>
<ul>
<li><b>글자 서식</b> — 글자 일부를 선택하고 위쪽 도구에서 색·크기·굵게·기울임·밑줄을 바꿉니다. 초기화 버튼은 선택한 글자의 서식을 지웁니다.</li>
<li><b>열 너비</b> — 회의록을 열 때마다 <b>전체 열 너비 자동 맞춤</b>으로 시작합니다. 오른쪽 경계를 끌어 조절하고, 경계를 더블클릭하거나 우클릭 메뉴에서 현재 열·전체 열 너비를 내용에 맞춥니다. 직접 바꾼 너비는 그 화면에서만 유지되고 다시 열면 자동 맞춤으로 돌아갑니다.</li>
<li><b>세로 정렬</b> — 1열(구역)·2열(항목)은 긴 행이나 병합된 구역도 항상 세로 가운데 정렬합니다. 할 일·리뷰 내용은 상단 정렬입니다.</li>
<li><b>범위 선택·지우기</b> — 같은 구역의 이번주 글 셀을 드래그하거나 첫 셀을 누른 뒤 <kbd>Shift</kbd>+클릭으로 선택합니다. 우클릭의 내용 지우기 또는 <kbd>Delete</kbd>로 지우고, <kbd>Ctrl</kbd>+<kbd>Z</kbd>로 되돌립니다.</li>
<li><b>내용 이동</b> — 셀 테두리를 다른 이번주 글 셀로 끌면 내용과 서식이 함께 이동합니다. 대상에 글이 있으면 덮어쓰기를 확인합니다. 이동 중에는 두 셀의 저장을 기다립니다.</li>
<li><b>병합·해제</b> — 같은 구역의 글 셀을 여러 줄 선택하고 우클릭의 셀 병합을 누릅니다. 해제해도 합친 글은 첫 셀에 남습니다. 병합된 줄을 이동·삭제하거나 그 사이에 줄을 추가하려면 먼저 병합을 해제하세요.</li>
</ul>
<h3 id="meetings-review">지난주 리뷰·결과·정량 목표</h3>
<p>지난주 리뷰는 <b>바로 앞 주차의 같은 항목</b>에서 가져옵니다(앞 주차가 앞 달 마지막 주차일 수 있습니다). 이름 변경·순서 이동·회의록 생성 순서와 관계없이 이어진 같은 줄을 찾습니다. 그 주차 회의록이 없으면 “회의록 없음”, 회의록은 있지만 항목이 없으면 “지난주 회의록에 없는 줄”로 표시합니다. 몇 주 전 기록을 지난주로 대신 보여 주지 않습니다.</p>
<ul>
<li><b>전주 업무</b> — 지난 주차에 적은 주요 업무를 그대로 보여 줍니다(읽기 전용).</li>
<li><b>결과</b>(글) — 지난 주차 업무를 어떻게 했는지 적습니다(누구나).</li>
<li><b>전주 목표</b> — 지난 주차 회의록에서 그 줄에 적은 정량 목표입니다.</li>
<li><b>결과</b>(오른쪽 끝) — 지난 주차 결과를 직접 입력합니다(누구나, 다음 주 회의록이 열려 있는 동안). 금액도, <code>18개</code> 같은 글도 됩니다(실적 모듈에서 자동 입력되지 않습니다).</li>
<li><b>저장 위치</b> — 이번 화면에서 입력한 지난주 결과(글·금액)는 <b>지난 주차 회의록의 줄</b>에 저장됩니다. 주요 업무·정량 목표는 이번 주차 회의록에 저장됩니다.</li>
<li><span class="pjh-ui">순서 바꾸기</span>는 이번주와 지난주 리뷰의 좌우 배치만 바꿉니다. 선택은 로그인한 사람별로 내 브라우저에 기억됩니다.</li>
</ul>
<h3 id="meetings-markets">매출 갱신·실적 표시</h3>
<p>실적 모듈 매출은 위쪽 숫자 칸(월 누적 실적·누적 목표 대비 달성)에만 쓰입니다. 줄(쿠팡·네이버 등)마다의 이번주 실적·지난주 결과는 자동으로 표시·입력되지 않으며, 지난주 결과는 직접 입력합니다.</p>
<p>실적 갱신 권한이 있으면 주차를 열 때 지난주부터 선택한 주의 오늘까지 매출을 자동 갱신합니다. 같은 주의 자동 갱신은 브라우저에서 10분 간격으로 제한하며, 성공 시에는 별도 큰 안내 없이 숫자가 바뀝니다. 실패·일부 쇼핑몰 실패 시 작은 안내와 <span class="pjh-ui">다시 시도</span>가 나옵니다. 마지막 갱신 성공 시각은 실적 모듈 기록이며 숫자에 마우스를 올려 확인할 수 있습니다.</p>
<table class="pjh-table">
<tr><th>표시·상태</th><th>확인할 내용</th></tr>
<tr><td>미확인</td><td>조회에 실패해 값을 알 수 없습니다. <b>0원과 다릅니다.</b> 이에 의존하는 누적 목표 대비 달성도 계산하지 않습니다. 안내의 다시 시도를 사용하거나 실적 연결 상태를 확인하세요.</td></tr>
<tr><td>0원</td><td>매출 조회는 성공했지만 해당 기간에 저장된 실적이 없거나 합계가 0원입니다. 필요하면 실적 화면에서 매출 자료를 갱신하세요.</td></tr>
<tr><td>실적 미연결·집계 대상 없음</td><td>자동 실적·누적이 비어 있습니다. 회의록 계획·메모는 계속 입력할 수 있습니다.</td></tr>
<tr><td>실적 갱신 권한 없음</td><td>새 매출을 요청하지 않고 저장된 실적을 보여 줍니다. 회의록 조회 권한과 매출 갱신 권한은 별개입니다.</td></tr>
</table>
<h3 id="meetings-rows">구역·줄 추가·순서·삭제</h3>
<ul>
<li>구역 이름 옆 <span class="pjh-ui">+</span>는 그 구역 끝에 줄을 추가합니다. 표 아래 <span class="pjh-ui">+ 구역 추가</span>로 새 구역을 만듭니다.</li>
<li>항목 이름을 클릭하면 그 자리에서 고칩니다. 우클릭 또는 ⋯ 메뉴에서 <span class="pjh-ui">위에 줄 추가 · 아래에 줄 추가 · 위로 · 아래로 · 줄 삭제</span>를 사용합니다. 순서 이동은 같은 구역 안에서 합니다.</li>
<li>줄을 삭제하면 주요 업무·정량 목표도 함께 삭제됩니다. 새 줄은 지난주에 이어진 항목이 없으면 지난주 리뷰가 비어 있습니다.</li>
</ul>
<h3 id="meetings-save">저장 확인·인쇄·회의록 삭제</h3>
<p>저장 실패 시 칸이 빨갛게 표시되며 입력값은 남습니다. 다시 입력하거나 칸을 떠나면 재시도합니다. 자동 실적을 갱신해도 다른 칸의 작성 중인 글은 유지됩니다. 저장이 안 된 상태에서는 줄 추가·순서 이동 같은 작업에 앞서 저장을 다시 시도합니다. 실패하면 구조 변경을 멈춥니다. 초안 복원과 페이지 떠남 보호는 <a href="#goals-save">목표의 저장 안내</a>와 같습니다.</p>
<p><span class="pjh-ui">인쇄</span>는 브라우저 인쇄창을 엽니다. 인쇄용 화면에서는 사이드바·작은 달력·편집 도구를 숨깁니다. 브라우저의 PDF 저장도 사용할 수 있습니다.</p>
<p>Pro user 이상의 <span class="pjh-ui">회의록 삭제</span>는 선택한 한 주의 회의록과 줄을 삭제합니다. 다음주 화면의 지난주 리뷰도 비게 됩니다. 같은 주를 다시 만들면 항목 구성은 이어질 수 있지만 삭제한 글과 금액은 복구되지 않습니다.</p>
</section>
<!-- 22. 단축키와 FAQ -->
<section class="pjh-sec" id="tips">
<h2><span class="pjh-num">20</span>단축키와 자주 묻는 질문</h2>
<h2><span class="pjh-num">22</span>단축키와 자주 묻는 질문</h2>
<h3>단축키</h3>
<table class="pjh-table">
<tr><th>키</th><th>하는 일</th></tr>
<tr><td><kbd>/</kbd></td><td>전체 검색창으로 이동(입력 중이 아닐 때)</td></tr>
<tr><td><kbd>/</kbd></td><td>작업 화면에서는 전체 검색창, 이 도움말에서는 도움말 검색창으로 이동(입력 중이 아닐 때)</td></tr>
<tr><td><kbd>Esc</kbd></td><td>작업 편집 창 · 날짜 창 · 메뉴 닫기, 입력 취소</td></tr>
<tr><td><kbd>Enter</kbd></td><td>하위 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정</td></tr>
<tr><td><kbd>Enter</kbd></td><td>세부 작업 추가, 섹션 이름 저장, 댓글 전송, 날짜 직접 입력 확정</td></tr>
<tr><td><kbd>Ctrl</kbd> + 휠</td><td>타임라인 확대·축소</td></tr>
<tr><td>마우스 오른쪽 버튼</td><td>작업 · 하위 작업 · 섹션 · 프로젝트에서 바로가기 메뉴</td></tr>
<tr><td>마우스 오른쪽 버튼</td><td>작업 · 세부 작업 · 섹션 · 프로젝트에서 바로가기 메뉴</td></tr>
</table>
<h3>자주 묻는 질문</h3>
<p><b>Q. 프로젝트가 목록에 안 보여요.</b><br>그 프로젝트의 멤버가 아니면 보이지 않습니다. 관리자에게 멤버 배정을 부탁하세요.</p>
<p><b>Q. 삭제 버튼을 눌렀는데 “삭제는 만든 사람만 할 수 있습니다”라고 나와요.</b><br>작업·섹션·프로젝트는 만든 사람만 지울 수 있습니다. 만든 사람이나 최고 관리자에게 부탁하세요.</p>
<p><b>Q. 작업을 잘못 지웠어요.</b><br>3개월 안이라면 관리자가 휴지통에서 복구할 수 있습니다.</p>
<p><b>Q. 프로젝트가 목록에 안 보여요.</b><br>그 프로젝트의 멤버가 아니면 보이지 않습니다. 그 프로젝트의 Pro user 이상 멤버나 관리자에게 멤버 배정을 부탁하세요.</p>
<p><b>Q. 삭제 버튼을 눌렀는데 “삭제는 만든 사람만 할 수 있습니다”라고 나와요.</b><br>섹션·프로젝트는 만든 사람(또는 Admin 이상)만 지울 수 있습니다. 작업은 멤버 누구나 휴지통으로 지울 수 있습니다.</p>
<p><b>Q. 작업을 잘못 지웠어요.</b><br>3개월 안이라면 Pro user 이상이 휴지통에서 복구할 수 있습니다.</p>
<p><b>Q. 카드 순서를 끌어도 안 바뀌어요.</b><br>필터를 쓰고 있거나 정렬이 “기본”이 아니면 순서를 바꿀 수 없습니다. 필터 바의 <span class="pjh-ui">초기화</span>를 누른 뒤 다시 해 보세요.</p>
<p><b>Q. 다른 사람이 바꾼 내용이 안 보여요.</b><br>보통 8초 안에 자동으로 반영됩니다. 오래 걸리면 새로고침(<kbd>F5</kbd>)하세요.</p>
<p><b>Q. 하위 작업을 다른 프로젝트 작업으로 옮길 수 있나요?</b><br>하위 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.</p>
<p><b>Q. 세부 작업을 다른 프로젝트 작업으로 옮길 수 있나요?</b><br>세부 작업은 같은 프로젝트 안의 작업으로만 옮길 수 있습니다.</p>
<p><b>Q. 작업을 두 프로젝트에 같이 두고 싶어요.</b><br>작업 편집 창의 “프로젝트” 칸에서 <span class="pjh-ui">다른 프로젝트에 추가</span>를 쓰세요. (<a href="#task">8장</a>)</p>
<p><b>Q. 목표 표의 실적과 회의록 매출이 달라요.</b><br>목표 표의 월 실적은 직접 입력한 숫자이고, 회의록 매출은 실적 모듈 자료입니다. 매출 단위와 집계 기간도 확인하세요. (<a href="#goals-metrics">숫자 지표</a> · <a href="#meetings-kpis">회의록 지표</a>)</p>
<p><b>Q. 지난주 회의록이 있는데 리뷰가 비어 있어요.</b><br>화면의 지난주 날짜와 항목을 확인하세요. 바로 앞 주차 회의록의 이어진 같은 항목만 표시합니다. 따로 추가한 줄은 이름이 같아도 다른 항목일 수 있습니다. (<a href="#meetings-review">지난주 리뷰</a>)</p>
<p><b>Q. 도움말에서 필요한 설명을 빠르게 찾고 싶어요.</b><br>이 페이지 위쪽 검색창에 단어를 입력하고 결과를 누르세요. 제목·본문의 일치 단어가 강조되고 해당 소제목으로 이동합니다. <kbd>Enter</kbd>는 첫 결과로 이동, <kbd>Esc</kbd>나 <span class="pjh-ui">지우기</span>는 검색을 초기화합니다.</p>
</section>
</div>
</div>
<a class="pjh-top" href="#top" title="맨 위로" aria-label="맨 위로"><span class="material-symbols-outlined">arrow_upward</span></a>
<script>
// 목차 — 지금 읽고 있는 장을 강조한다(스크롤 위치 기준).
(function () {
var links = Array.prototype.slice.call(document.querySelectorAll(".pjh-toc a"));
var secs = links.map(function (a) { return document.querySelector(a.getAttribute("href")); });
if (!("IntersectionObserver" in window)) return;
var io = new IntersectionObserver(function (entries) {
entries.forEach(function (en) {
if (!en.isIntersecting) return;
var i = secs.indexOf(en.target);
links.forEach(function (a, k) { a.classList.toggle("is-active", k === i); });
});
}, { rootMargin: "-10% 0px -75% 0px" });
secs.forEach(function (s) { if (s) io.observe(s); });
})();
</script>
<script src="/static/project-help.js?v=20261003a" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -18,15 +18,18 @@
<div class="pj-section-head">
<h2>수신함</h2>
<div style="display:flex; gap:8px;">
{# PC 알림 프로그램(023) — 연결·내려받기 화면은 수신함 안에서 들어간다 #}
<a class="pj-btn pj-inbox-notifier" href="/project/notifier" title="브라우저가 뒤에 있어도 PC 화면에 알림 띄우기">
<span class="material-symbols-outlined">desktop_windows</span>PC 알림</a>
<button type="button" class="pj-btn" id="pj-mentions-readall">태그 모두 확인</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-readall">알림 모두 읽음</button>
</div>
</div>
<div class="pj-view pj-inbox-pane">
<!-- 아사나 Inbox 처럼 "나를 태그(@)한 업무"를 맨 위에 리스트로 보여준다.
"확인"을 누르면 수신함에 머문 채 오른쪽에 그 작업 창이 열린다
(프로젝트 화면을 ?task=&embed=1 로 iframe 에 — project.js initInboxTaskPanel). -->
<!-- 아사나 Inbox 처럼 "나를 태그(@)한 업무"를 맨 위에 리스트로 보여준다. 확인 안 한 태그·읽지 않은 알림만.
줄을 누르면 수신함에 머문 채 오른쪽에 그 작업 창이 열리고(project.js initInboxTaskPanel),
확인한 줄은 다른 줄을 고르거나 창을 닫으면 목록에서 빠진다. -->
<div class="pj-inbox-section">
<h3 class="pj-inbox-h3">
나를 태그한 작업
@@ -38,8 +41,9 @@
{% else %}
<ul class="pj-inbox pj-mention-list" id="pj-mention-tasks">
{% for t in mentioned_tasks %}
<li class="pj-inbox-item pj-mention-item {% if t.unread_mentions %}is-unread{% endif %}"
data-task-id="{{ t.id }}" data-project="{{ t.project_id }}">
<li class="pj-inbox-item pj-mention-item {% if t.unread_mentions %}is-unread{% endif %}" tabindex="0" role="button"
data-task-id="{{ t.id }}" data-project="{{ t.project_id }}"
data-href="/project/t/{{ t.id }}" title="누르면 오른쪽에 작업 창">
<span class="material-symbols-outlined pj-inbox-icon">alternate_email</span>
<div class="pj-inbox-body">
<div class="pj-inbox-title {% if t.completed_at %}is-done{% endif %}">{{ t.title }}</div>
@@ -50,8 +54,6 @@
{% if t.mention_actor %} · {% set nm = t.mention_actor.split('@')[0] %}{{ nm[:1]|upper }}{{ nm[1:] }}님이 태그{% endif %}
</div>
</div>
<a class="pj-btn pj-inbox-go" href="/project/p/{{ t.project_id }}?task={{ t.id }}"
data-task-id="{{ t.id }}">확인</a>
</li>
{% endfor %}
</ul>
@@ -65,9 +67,10 @@
{% else %}
<ul class="pj-inbox" id="pj-inbox">
{% for n in notifications %}
<li class="pj-inbox-item {% if not n.is_read %}is-unread{% endif %}"
<li class="pj-inbox-item {% if not n.is_read %}is-unread{% endif %}" tabindex="0" role="button"
data-id="{{ n.id }}"
{% if n.task_id %}data-project="{{ n.project_id }}"{% endif %}>
{% if n.task_id %}data-project="{{ n.project_id }}" data-task-id="{{ n.task_id }}"{% endif %}
{% if n.task_id %}data-href="/project/t/{{ n.task_id }}"{% elif n.project_id %}data-href="/project/p/{{ n.project_id }}"{% endif %}>
<span class="material-symbols-outlined pj-inbox-icon">
{% if n.type == 'assigned' %}assignment_ind
{% elif n.type == 'completed' %}task_alt
@@ -85,12 +88,6 @@
{% if n.actor_email %}{% set nm = n.actor_email.split('@')[0] %}{{ nm[:1]|upper }}{{ nm[1:] }} · {% endif %}{{ n.created_at[:16].replace('T',' ') }}
</div>
</div>
{% if n.project_id %}
{# 작업 알림은 "확인" → 수신함에 머문 채 오른쪽에 작업 창(project.js initInboxTaskPanel) #}
<a class="pj-btn pj-inbox-go"
href="/project/p/{{ n.project_id }}{% if n.task_id %}?task={{ n.task_id }}{% endif %}"
{% if n.task_id %}data-task-id="{{ n.task_id }}"{% endif %}>확인</a>
{% endif %}
</li>
{% endfor %}
</ul>
@@ -104,5 +101,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -17,7 +17,7 @@
{% block content %}
{# 프로젝트 모듈의 첫 화면 = 내 업무. 예전 프로젝트 홈(카드 그리드)은 없앴다. #}
<div class="pj-wrap pj-mytasks-view" data-me="{{ user.email }}"
data-is-admin="{{ 'true' if is_admin else 'false' }}"
data-is-pro="{{ 'true' if pj_pro else 'false' }}" data-is-padmin="{{ 'true' if pj_admin else 'false' }}"
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}">
<div class="pj-layout">
{% with current_pid = 0, side_active = "mytasks" %}{% include "project/_side.html" %}{% endwith %}
@@ -84,7 +84,7 @@
<span class="material-symbols-outlined">attach_file</span>
<input type="file" id="pj-cm-file-input" multiple hidden />
</label>
<input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" autocomplete="off" />
<textarea id="pj-cm-input" class="pj-composer-ta" rows="1" placeholder="댓글 입력… (Shift+Enter 줄바꿈, 이미지는 붙여넣기 가능)" autocomplete="off"></textarea>
<button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button>
</div>
</div>
@@ -100,5 +100,5 @@
"today": {{ today | tojson }}
}
</script>
<script src="/static/project.js?v=20260930g" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
@@ -0,0 +1,112 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %}
{# PC 알림 프로그램(023) — 트레이 프로그램(desktop/notifier) 내려받기, 연결 승인(?code=), 연결된 PC 해제.
토큰은 프로그램이 받아 PC 에 암호화 저장(Windows DPAPI). 이 화면은 토큰 원문을 보지 않는다. #}
<div class="pj-wrap pj-inbox-view pj-notifier-view">
<div class="pj-layout">
{% with current_pid = 0, side_active = "inbox" %}{% include "project/_side.html" %}{% endwith %}
<section class="pj-main">
<div class="pj-section-head"><h2><a class="pj-notifier-back" href="/project/inbox">수신함</a> › PC 알림 프로그램</h2></div>
<div class="pj-view pj-inbox-pane pj-notifier-pane">
{% if not notifier_enabled %}
<div class="pj-empty">PC 알림 연결이 아직 준비되지 않았습니다(DB 마이그레이션 023 필요).</div>
{% else %}
{% if code %}
<div class="pj-notifier-card is-link" id="pj-notifier-link" data-code="{{ code }}">
{% if link and not link.approved_at %}
<h3>이 PC 를 내 알림에 연결할까요?</h3>
<p>PC 이름 <b>{{ link.device_name or '-' }}</b> · 연결 코드 <b class="pj-notifier-code">{{ link.code }}</b></p>
<p class="pj-notifier-note">알림 프로그램 창에 보이는 코드와 같을 때만 연결하세요. 연결하면 그 PC 에
<b>{{ user.name or user.email }}</b> 님의 태그·작업 배정 알림이 뜹니다.</p>
<button type="button" class="pj-btn pj-btn-primary" id="pj-notifier-approve">연결</button>
{% elif link %}
<h3>이미 연결을 승인했습니다</h3>
<p class="pj-notifier-note">알림 프로그램이 곧 연결을 마칩니다. 이 창은 닫아도 됩니다.</p>
{% else %}
<h3>연결 코드가 없거나 만료되었습니다</h3>
<p class="pj-notifier-note">연결 코드는 10분 동안만 쓸 수 있습니다. 알림 프로그램에서 [연결]을 다시 누르세요.</p>
{% endif %}
</div>
{% endif %}
<div class="pj-notifier-card">
<h3>설치</h3>
<ol class="pj-notifier-steps">
<li>{% if download_ready %}<a class="pj-btn pj-btn-primary pj-btn-sm" href="/project/notifier/download">DBXNotifier.exe 내려받기</a>
{% else %}관리자에게 <b>DBXNotifier.exe</b> 파일을 받으세요.{% endif %}
설치 없이 파일 하나로 실행됩니다(Windows 10·11).</li>
<li>실행하면 화면 오른쪽 아래 트레이에 종 아이콘이 생기고 연결 창이 열립니다. [브라우저에서 연결]을 누르세요.</li>
<li>열린 이 화면에서 코드를 확인하고 [연결]을 누르면 끝입니다. 트레이 아이콘 메뉴에서 [Windows 시작 시 실행]을 켜 두세요.</li>
</ol>
<p class="pj-notifier-note">나를 태그하거나 작업이 배정되면 다른 프로그램을 쓰고 있어도 화면 아래 가운데에 큰 알림 창이 뜹니다.
[열기]를 누르면 브라우저에서 그 작업이 열립니다.</p>
</div>
<div class="pj-notifier-card">
<h3>연결된 PC</h3>
{% if devices %}
<table class="pj-table pj-notifier-table">
<thead><tr><th>PC 이름</th><th>연결한 때</th><th>마지막 확인</th><th></th></tr></thead>
<tbody>
{% for d in devices %}
<tr>
<td>{{ d.device_name or '-' }}</td>
<td>{{ (d.created_at or '')[:16] | replace('T', ' ') }}</td>
<td>{{ (d.last_seen_at or '-')[:16] | replace('T', ' ') }}</td>
<td class="pj-trash-act"><button type="button" class="pj-btn pj-btn-sm pj-notifier-revoke"
data-id="{{ d.id }}" data-name="{{ d.device_name }}">연결 해제</button></td>
</tr>
{% endfor %}
</tbody>
</table>
{% else %}
<p class="pj-notifier-note">연결된 PC 가 없습니다.</p>
{% endif %}
</div>
{% endif %}
</div>
</section>
</div>
</div>
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script>
(function () {
async function post(url, body) {
const res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body || {}) });
const data = await res.json().catch(function () { return {}; });
if (!res.ok) throw new Error(data.detail || ("HTTP " + res.status));
return data;
}
const approve = document.getElementById("pj-notifier-approve");
if (approve) approve.addEventListener("click", async function () {
approve.disabled = true;
try {
await post("/project/api/notifier/link/approve", { code: document.getElementById("pj-notifier-link").dataset.code });
location.replace("/project/notifier?code=" + encodeURIComponent(document.getElementById("pj-notifier-link").dataset.code));
} catch (e) { approve.disabled = false; alert("연결 실패: " + e.message); }
});
document.querySelectorAll(".pj-notifier-revoke").forEach(function (b) {
b.addEventListener("click", async function () {
if (!confirm((b.dataset.name || "이 PC") + " 의 알림 연결을 해제할까요?")) return;
b.disabled = true;
try { await post("/project/api/notifier/devices/" + b.dataset.id + "/revoke"); location.reload(); }
catch (e) { b.disabled = false; alert("해제 실패: " + e.message); }
});
});
})();
</script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<!-- 구글 머티리얼 심볼(담당자 아이콘 등) — self-host -->
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<!-- 타임라인 vis-timeline — self-host -->
@@ -27,7 +27,7 @@
<div class="pj-wrap pj-project-view"
data-project-id="{{ project.id }}"
data-can-manage="{{ 'true' if can_manage else 'false' }}"
data-is-admin="{{ 'true' if is_admin else 'false' }}"
data-is-pro="{{ 'true' if pj_pro else 'false' }}" data-is-padmin="{{ 'true' if pj_admin else 'false' }}"
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}"
data-me="{{ user.email }}">
@@ -43,13 +43,13 @@
<div class="pj-head-left">
<!-- 프로젝트 제목 + 이 프로젝트의 멤버 아이콘.
마우스를 올리면 이름(data-tip → initHoverTips), 클릭하면 그 사람이
이 프로젝트에서 맡은 업무 팝업, 우클릭(관리자)하면 제외. 목록은
이 프로젝트에서 맡은 업무 팝업, 우클릭(Pro user 이상)하면 제외. 목록은
renderMemberList 가 같은 마크업으로 다시 그린다.
"전체 프로젝트" 스코프에선 제목이 "전체 프로젝트"로 바뀌고 멤버는 숨긴다
(.pj-title-wrap.is-all-scope). -->
<div class="pj-title-wrap" id="pj-title-wrap">
<h1 class="pj-project-title">
<span class="pj-project-title-pill" style="--pj-color: {{ project.color or '#4573d2' }}"><span class="material-symbols-outlined pj-pill-ic">{{ project.icon or 'folder' }}</span><span class="pj-pill-name">{{ project.name }}</span></span>
<span class="pj-project-title-pill" style="--pj-color: {{ project.color or '#4573d2' }}">{% set _pic = project.icon or 'folder' %}{% set _a = _pic.startswith('asana:') %}<span class="material-symbols-outlined pj-pill-ic{% if _a %} pj-ic-asana{% endif %}">{{ _pic[6:] if _a else _pic }}</span><span class="pj-pill-name">{{ project.name }}</span></span>
</h1>
<h1 class="pj-project-title pj-all-title">
<span class="pj-project-title-all"><span class="material-symbols-outlined pj-pill-ic">apps</span><span class="pj-pill-name">전체 프로젝트</span></span>
@@ -66,8 +66,8 @@
</span>
{% endfor %}
</div>
{% if is_admin %}
<button type="button" class="pj-title-addmember" id="pj-add-member" title="멤버 배정">+</button>
{% if pj_pro %}
<button type="button" class="pj-title-addmember" id="pj-add-member" title="멤버 배정·제외">+</button>
{% endif %}
</div>
<div class="pj-view-tabs pj-view-tabs-line" id="pj-view-tabs">
@@ -80,7 +80,8 @@
</div>
<!-- 아사나처럼 기본은 "이 프로젝트"만 보여준다. 전체 프로젝트 보기는
예전처럼 접근 가능한 모든 프로젝트를 합쳐서 보여주는 모드. -->
<div class="pj-view-tabs" id="pj-scope-toggle">
{# 2026-10-08 — 토글은 숨기고 왼쪽 메뉴 "전체 보기"(Pro user 이상, ?scope=all)로 바꿈. 상태 보관용으로만 남김 #}
<div class="pj-view-tabs" id="pj-scope-toggle" style="display:none">
<button type="button" class="pj-tab is-active" data-scope="project">이 프로젝트</button>
<button type="button" class="pj-tab" data-scope="all">전체 프로젝트</button>
</div>
@@ -213,9 +214,6 @@
<h3 id="pj-stage-modal-title">새 섹션</h3>
<input type="hidden" id="pj-stg-id" />
<label>이름<input type="text" id="pj-stg-name" placeholder="섹션 이름" autocomplete="off" /></label>
<label>색상
<span class="pj-color-palette" id="pj-stg-colors"></span>
</label>
<div class="pj-field-label">기본 담당자
<div class="pj-member-picker" id="pj-stg-assignee"></div>
<span class="pj-modal-hint pj-stg-assignee-hint">이 섹션에 작업을 새로 만들거나 카드를 옮겨오면, 담당자가 비어 있는 작업만 이 사람에게 자동 배정됩니다.</span>
@@ -259,7 +257,7 @@
<!-- 아사나처럼 큰 제목은 이 무테 입력칸 하나뿐이다(위의 작은 안내줄은
없앴다 — 버튼 줄 바로 아래 공간을 아낀다). -->
<input type="hidden" id="pj-t-id" />
<!-- 하위 업무를 열었을 때만 — 아사나처럼 제목 위에 상위 업무 경로. 누르면 상위 업무로. -->
<!-- 세부 업무를 열었을 때만 — 아사나처럼 제목 위에 상위 업무 경로. 누르면 상위 업무로. -->
<button type="button" class="pj-t-parent" id="pj-t-parent" hidden title="상위 작업 열기">
<span class="material-symbols-outlined">subdirectory_arrow_left</span>
<span class="pj-t-parent-title" id="pj-t-parent-title"></span>
@@ -330,6 +328,18 @@
</div>
<button type="button" class="pj-follow-toggle" id="pj-follow-toggle">협업자로 참여</button>
</div>
<!-- 프로젝트 연결 — 협업자 아래에서 목록·선택·추가를 한 줄로 표시. -->
<div class="pj-meta-row2 pj-projects-row" id="pj-links-block" hidden>
<span class="pj-meta-cell-label pj-projects-label">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm" aria-hidden="true">link</span> 프로젝트
</span>
<div class="pj-link-chips" id="pj-link-chips"></div>
<div class="pj-link-form" id="pj-link-form">
<select id="pj-link-project" aria-label="연결할 프로젝트"><option value="">프로젝트 선택…</option></select>
<select id="pj-link-stage" aria-label="연결할 섹션"><option value="">섹션 선택…</option></select>
<button type="button" class="pj-btn pj-btn-primary" id="pj-link-save">다른 프로젝트에 추가</button>
</div>
</div>
</div>
</div>
@@ -346,6 +356,9 @@
<button type="button" class="pj-desc-fmtbtn" data-cmd="italic" title="기울임 (Ctrl+I)"><span class="material-symbols-outlined">format_italic</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="underline" title="밑줄 (Ctrl+U)"><span class="material-symbols-outlined">format_underlined</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="strikeThrough" title="취소선 (Ctrl+Shift+X)"><span class="material-symbols-outlined">format_strikethrough</span></button>
{# 글자 색·크기(2026-10-08) — 누르면 고르는 창(body 에 붙음). 저장 때 서버가 span 의 color·font-size 만 남긴다 #}
<button type="button" class="pj-desc-fmtbtn" data-cmd="textColor" title="글자 색"><span class="material-symbols-outlined">format_color_text</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="textSize" title="글자 크기"><span class="material-symbols-outlined">format_size</span></button>
<span class="pj-desc-fmtsep"></span>
<button type="button" class="pj-desc-fmtbtn" data-cmd="insertUnorderedList" title="글머리 기호 목록"><span class="material-symbols-outlined">format_list_bulleted</span></button>
<button type="button" class="pj-desc-fmtbtn" data-cmd="insertOrderedList" title="번호 매기기 목록"><span class="material-symbols-outlined">format_list_numbered</span></button>
@@ -362,46 +375,30 @@
</div>
</div>
<!-- 하위 업무 — 설명 바로 아래 줄에서 팝업 너비 전체를 쓴다.
<!-- 세부 업무 — 설명 바로 아래 줄에서 팝업 너비 전체를 쓴다.
기존 업무 편집 시에만. -->
<div class="pj-task-extra pj-subtask-full" id="pj-subtask-block" hidden>
<div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">checklist</span> 하위 작업
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">checklist</span> 세부 작업
</div>
<ul class="pj-subtask-list" id="pj-subtask-list"></ul>
<div class="pj-subtask-form">
<input type="text" id="pj-subtask-input" placeholder="하위 작업 제목…" autocomplete="off" />
<input type="text" id="pj-subtask-input" placeholder="세부 작업 제목…" autocomplete="off" />
<select id="pj-subtask-add-assignee"><option value="">담당자 없음</option></select>
<input type="date" id="pj-subtask-add-due" />
<button type="button" class="pj-btn pj-btn-primary" id="pj-subtask-add">추가</button>
</div>
</div>
<!-- 첨부파일 | 연결된 프로젝트 — 나란히 2열(팝업 너비 전체를 나눠 쓴다).
기존 업무 편집 시에만. -->
<div class="pj-side-2col">
<div class="pj-task-extra" id="pj-attach-block" hidden>
<div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">attach_file</span> 첨부 파일
<label class="pj-upload-btn">
파일 추가<input type="file" id="pj-attach-input" hidden />
</label>
</div>
<ul class="pj-attach-list" id="pj-attach-list"></ul>
</div>
<!-- 연결된 프로젝트 — 멀티호밍(아사나식). -->
<div class="pj-task-extra" id="pj-links-block" hidden>
<div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">link</span> 프로젝트
</div>
<div class="pj-link-chips" id="pj-link-chips"></div>
<div class="pj-link-form" id="pj-link-form">
<select id="pj-link-project"><option value="">프로젝트 선택…</option></select>
<select id="pj-link-stage"><option value="">섹션 선택…</option></select>
<button type="button" class="pj-btn pj-btn-primary" id="pj-link-save">다른 프로젝트에 추가</button>
</div>
<!-- 첨부파일 — 팝업 너비 전체, 기존 업무 편집 시에만. -->
<div class="pj-task-extra" id="pj-attach-block" hidden>
<div class="pj-extra-head">
<span class="material-symbols-outlined pj-gicon pj-gicon-sm">attach_file</span> 첨부 파일
<label class="pj-upload-btn">
파일 추가<input type="file" id="pj-attach-input" hidden />
</label>
</div>
<ul class="pj-attach-list" id="pj-attach-list"></ul>
</div>
<!-- 댓글(활동) — 팝업 너비 전체를 쓰는 맨 아래 줄. 길어지면 자체
@@ -420,7 +417,7 @@
바깥이라 끝까지 내려도 마지막 내용은 이 칸 바로 위에서 멈추고 가리지 않는다. -->
<div class="pj-comment-dock" id="pj-comment-dock" hidden>
<div class="pj-comment-form">
<input type="text" id="pj-comment-input" placeholder="댓글을 추가하거나 @로 멤버를 태그하세요" autocomplete="off" />
<textarea id="pj-comment-input" class="pj-composer-ta" rows="1" placeholder="댓글을 추가하거나 @로 멤버를 태그하세요 (Shift+Enter 줄바꿈)" autocomplete="off"></textarea>
<button type="button" class="pj-btn pj-btn-primary" id="pj-comment-send">등록</button>
</div>
</div>
@@ -428,25 +425,20 @@
</div>
</div>
{% if is_admin %}
{% if pj_pro %}
<!-- 멤버 배정 모달 — 등록된 사용자(프로젝트 권한 보유)를 자동 목록화 -->
<div class="pj-modal" id="pj-modal-member" hidden>
<div class="pj-modal-card">
<h3>멤버 배정</h3>
<p class="pj-modal-hint">관리자 페이지에서 <b>프로젝트 관리</b> 권한을 켠 직원이 후보로 나옵니다. 여러 명을 한 번에 선택할 수 있습니다.</p>
<h3>멤버 배정 · 제외</h3>
<p class="pj-modal-hint">체크하면 배정, 체크를 풀면 제외됩니다(지금 멤버는 체크된 채로 나옵니다). 후보는 관리자 페이지에서
<b>프로젝트 관리</b> 권한을 켠 직원입니다. 배정된 멤버는 모두 이 프로젝트를 보고 수정할 수 있고, 소유자는 뺄 수 없습니다.</p>
<div class="pj-field-label">직원
<div class="pj-member-picker" id="pj-m-users">불러오는 중…</div>
</div>
<label>역할
<select id="pj-m-role">
<option value="member" selected>멤버</option>
<option value="manager">관리(서브·작업 관리)</option>
</select>
</label>
<div class="pj-modal-actions">
<span style="flex:1"></span>
<button type="button" class="pj-btn" data-close>취소</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-member">배정</button>
<button type="button" class="pj-btn pj-btn-primary" id="pj-save-member">저장</button>
</div>
</div>
</div>
@@ -466,7 +458,7 @@
<span class="material-symbols-outlined">attach_file</span>
<input type="file" id="pj-cm-file-input" multiple hidden />
</label>
<input type="text" id="pj-cm-input" placeholder="댓글 입력… (이미지는 붙여넣기 가능)" autocomplete="off" />
<textarea id="pj-cm-input" class="pj-composer-ta" rows="1" placeholder="댓글 입력… (Shift+Enter 줄바꿈, 이미지는 붙여넣기 가능)" autocomplete="off"></textarea>
<button type="button" class="pj-btn pj-btn-primary" id="pj-cm-send">전송</button>
</div>
</div>
@@ -496,5 +488,5 @@
</script>
<script src="/static/vendor/vis-timeline/vis-timeline-graph2d.min.js"></script>
<script src="/static/project.js?v=20260930g" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
@@ -1,14 +1,14 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20260930g" />
<link rel="stylesheet" href="/static/project.css?v=20261012a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
{% block topbar_after_logout %}{% include "project/_help_btn.html" %}{% endblock %}
{% block content %}
{# 휴지통 — 관리자 전용. 지운 업무(하위 업무·댓글·팔로워·첨부 포함)를 3개월
{# 휴지통 — Pro user 이상. 지운 업무(세부 업무·댓글·팔로워·첨부 포함)를 3개월
보관하고, [복구] 로 원래 id 그대로 되살린다(project_db 010). #}
<div class="pj-wrap pj-inbox-view pj-trash-view">
<div class="pj-layout">
@@ -17,7 +17,7 @@
<section class="pj-main">
<div class="pj-section-head">
<h2>휴지통</h2>
<span class="pj-trash-note">삭제한 작업은 3개월 동안 보관된 뒤 영구 삭제됩니다. 복구는 관리자만 할 수 있습니다.</span>
<span class="pj-trash-note">삭제한 작업은 3개월 동안 보관된 뒤 영구 삭제됩니다. 복구는 Pro user 이상만 할 수 있습니다.</span>
</div>
<div class="pj-view pj-inbox-pane">
{% if not trash_enabled %}
@@ -45,7 +45,7 @@
<td class="pj-trash-title">{{ it.title }}</td>
<td>{{ it.project_name or '-' }}</td>
<td class="pj-trash-meta">
{% if it.task_count > 1 %}하위 작업 {{ it.task_count - 1 }}{% endif %}
{% if it.task_count > 1 %}세부 작업 {{ it.task_count - 1 }}{% endif %}
{% if it.comment_count %}{% if it.task_count > 1 %} · {% endif %}댓글 {{ it.comment_count }}{% endif %}
{% if it.attachment_count %} · 첨부 파일 {{ it.attachment_count }}{% endif %}
{% if it.task_count <= 1 and not it.comment_count and not it.attachment_count %}-{% endif %}
@@ -70,5 +70,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20260930g" defer></script>
<script src="/static/project.js?v=20261012b" defer></script>
{% endblock %}
+1368
View File
File diff suppressed because it is too large Load Diff
+1295
View File
File diff suppressed because it is too large Load Diff
+80 -10
View File
@@ -59,29 +59,86 @@
var state = { option: null, variants: [], displayTypes: {}, orphans: [], imageBase: "" };
// 모달은 페이지에 하나라 여러 상품이 같은 body 를 쓴다. 이 상품으로 연 "회차"(modal.gen)가
// 바뀌었거나(닫힘·다른 상품) 더 나중에 보낸 조회가 있으면, 늦게 도착한 응답은 버린다.
// (A 상품 응답이 B 상품 창에 그려지거나, 먼저 보낸 조회가 나중 조회를 덮는 것을 막는다.)
var myGen = -1;
var loadSeq = 0;
function alive() { return modal.isOpen() && modal.gen === myGen; }
openBtn.addEventListener("click", function () {
var nameEl = document.getElementById("cf24-name-text");
modal.open((nameEl ? nameEl.textContent : "") + " (상품번호 " + no + ")");
myGen = modal.gen;
load();
});
function load() {
var seq = ++loadSeq;
var gen = myGen;
body.innerHTML = '<p class="cf24-muted">카페24에서 불러오는 중…</p>';
return apiJson("GET", "/cafe24/products/" + no + "/options")
.then(function (data) {
if (seq !== loadSeq || gen !== modal.gen || !modal.isOpen()) return false;
state.option = data.option;
state.variants = data.variants || [];
state.displayTypes = data.display_types || {};
state.imageBase = data.image_base || "";
render();
return true;
})
.catch(function (err) {
if (seq !== loadSeq || gen !== modal.gen || !modal.isOpen()) return false;
body.innerHTML = '<p class="cf24-err">옵션을 불러오지 못했습니다: ' + esc(err.message) +
'</p><button type="button" class="erp-btn erp-btn-outline" id="cf24-opt-retry">다시 시도</button>';
body.querySelector("#cf24-opt-retry").addEventListener("click", load);
return false;
});
}
// 다시 불러오되, 아직 카페24에 저장되지 못한 품목 입력(자체코드·추가금액·진열/판매)은 옵션값
// 이름으로 짝지어 되살린다. 품목코드가 늦게 나타나거나 일부 행 저장이 실패했을 때 입력을
// 잃지 않게 한다(실패 뒤 자동으로 새로 읽어 입력을 지우던 문제).
function reloadKeeping(keep, errors) {
return load().then(function (ok) {
if (!ok) return 0;
var tbody = body.querySelector("#cf24-u-body");
if (!tbody) return 0;
var restored = 0;
Array.prototype.forEach.call(tbody.children, function (tr) {
var nameEl = tr.querySelector('[name="option_text"]');
var k = nameEl && keep[norm(nameEl.value)];
if (!k) return;
var changed = false;
[["custom_variant_code", k.custom], ["additional_amount", k.amount]].forEach(function (pair) {
var el = tr.querySelector('[name="' + pair[0] + '"]');
if (el && pair[1] != null && el.value !== pair[1]) {
el.value = pair[1];
el.dispatchEvent(new Event("input"));
changed = true;
}
});
["display", "selling"].forEach(function (flag) {
var btn = tr.querySelector('.cf24-v-toggle[data-flag="' + flag + '"]');
if (btn && k[flag] != null && btn.dataset.on !== k[flag]) { paintToggle(btn, k[flag] === "1", false); changed = true; }
});
var why = errors && errors[norm(nameEl.value)];
if (why) { tr.classList.add("is-error"); tr.title = "저장 실패: " + why; }
if (changed || why) restored++;
});
return restored;
});
}
function rowValues(tr) {
return {
custom: tr.querySelector('[name="custom_variant_code"]').value,
amount: tr.querySelector('[name="additional_amount"]').value,
display: tr.querySelector('.cf24-v-toggle[data-flag="display"]').dataset.on,
selling: tr.querySelector('.cf24-v-toggle[data-flag="selling"]').dataset.on
};
}
/* ── 공통 조각 ── */
function typeSelect(current, name) {
var out = '<select name="' + name + '">';
@@ -236,25 +293,34 @@
통합 목록 — 옵션값 1 : 품목 1
═══════════════════════════════════════════════════════════ */
// 행 = 품목 목록 순서. index 는 options 응답 안 위치(옵션 PUT 짝맞춤용).
// 품목이 없는 옵션값은 state.orphans 로 따로 모은다(행으로 그리지 않는다).
// 품목과 옵션값은 **옵션값 번호(value_no)** 로 먼저 짝짓고, 없을 때만 이름으로 짝짓는다.
// (옵션값 이름을 바꾼 직후 카페24 품목 조회가 예전 이름을 돌려줘도 정상 품목이 숨지 않게.
// 서버가 품목코드별 쓰기 기록으로 표기를 바로잡고 value_no 를 붙여 준다.)
// 방금 추가해 품목이 아직 안 보이는 옵션값(pending)은 "품목 생성 대기" 행으로 그린다.
// 그 밖에 품목이 없는 옵션값은 state.orphans 로 따로 모은다(행으로 그리지 않는다).
function unifiedRows() {
var opt = state.option;
state.orphans = [];
if (!opt || !opt.has_option) return [];
var group = opt.options[0];
var byText = {};
group.option_value.forEach(function (v, vi) { byText[v.option_text] = { index: vi, value: v, variant: null }; });
var entries = group.option_value.map(function (v, vi) { return { index: vi, value: v, variant: null }; });
var byNo = {}, byText = {};
entries.forEach(function (r) {
if (r.value.value_no != null && r.value.value_no !== "") byNo[String(r.value.value_no)] = r;
if (!byText[r.value.option_text]) byText[r.value.option_text] = r;
});
var rows = [];
state.variants.forEach(function (variant) {
if (!variant.options.length) return;
var r = byText[variant.options[0].value];
var r = (variant.value_no != null && byNo[String(variant.value_no)]) || byText[variant.options[0].value];
if (!r || r.variant) return;
r.variant = variant;
rows.push(r);
});
group.option_value.forEach(function (v) {
var r = byText[v.option_text];
if (rows.indexOf(r) < 0) state.orphans.push(r);
entries.forEach(function (r) {
if (r.variant) return;
if (r.value.pending) { r.await = true; rows.push(r); }
else state.orphans.push(r);
});
return rows;
}
@@ -266,8 +332,10 @@
var thumbSrc = [v.option_image_file, v.option_link_image,
state.option && state.option.has_option ? variantImageFor(state.option.options[0].option_name, v.option_text) : ""];
var code = variant ? variant.variant_code : "";
var awaiting = !!r.await && !code;
// data-index: options 응답 안 위치(옵션 PUT 짝맞춤용, 새 행은 빈 값) / data-pos: 처음 그린 순서(순서 변경 판정용)
return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '">' +
// data-await: 옵션값은 카페24에 있으나 품목코드가 아직 조회되지 않음 — 입력은 받고, 저장 때 코드를 다시 찾는다.
return '<tr class="cf24-u-row' + (isNewRow ? " is-new" : "") + (awaiting ? " is-await" : "") + '" data-index="' + (isNewRow ? "" : r.index) + '" data-pos="' + (position == null ? "" : position) + '" data-code="' + esc(code) + '"' + (awaiting ? ' data-await="1"' : "") + '>' +
'<td class="cf24-u-drag">' + (canDrag ? '<span class="cf24-drag-handle" draggable="true" title="드래그하여 순서 변경">⋮⋮</span>' : "") + "</td>" +
'<td class="cf24-u-thumb"><span class="cf24-opt-thumb-slot">' + thumbHtml(thumbSrc, v.option_image_file ? "옵션 버튼 이미지" : v.option_link_image ? "옵션 연결 이미지" : "품목 이미지") + "</span>" +
'<input type="hidden" name="option_image_file" value="' + esc(v.option_image_file || "") + '" />' +
@@ -276,12 +344,14 @@
'<td class="cf24-u-name"><input type="text" name="option_text" value="' + esc(v.option_text) + '" placeholder="옵션값 이름" /></td>' +
'<td class="cf24-v-syscode">' + (code
? '<button type="button" class="cf24-v-copy" data-copy-text="' + esc(code) + '" title="클릭하면 품목코드를 복사합니다">' + esc(code) + "</button>"
: '<span class="cf24-muted">저장 시 부여</span>') + "</td>" +
: awaiting
? '<span class="cf24-muted" title="카페24가 품목을 만드는 중이거나 조회가 늦습니다. 입력해 두면 저장할 때 코드를 다시 찾아 반영합니다.">품목 생성 대기</span>'
: '<span class="cf24-muted">저장 시 부여</span>') + "</td>" +
'<td class="cf24-v-code"><input type="text" name="custom_variant_code" maxlength="40" value="' + esc(variant ? variant.custom_variant_code : "") + '" /></td>' +
'<td class="cf24-v-amount"><input type="text" name="additional_amount" inputmode="numeric" value="' + esc(amountPlain(variant ? variant.additional_amount : "0")) + '" /></td>' +
'<td class="cf24-v-flag">' + toggleBtn("display", variant ? !!variant.display : true) + "</td>" +
'<td class="cf24-v-flag">' + toggleBtn("selling", variant ? !!variant.selling : true) + "</td>" +
'<td class="cf24-u-del"><button type="button" class="cf24-u-remove" title="' + (isNewRow ? "행 삭제" : "품목 삭제 (카페24에 바로 반영)") + '">✕</button></td>' +
'<td class="cf24-u-del">' + (awaiting ? "" : '<button type="button" class="cf24-u-remove" title="' + (isNewRow ? "행 삭제" : "품목 삭제 (카페24에 바로 반영)") + '">✕</button>') + "</td>" +
"</tr>";
}
+22 -6
View File
@@ -534,6 +534,7 @@
flex-wrap: wrap;
}
.cpg-prod-manual-row .erp-field { flex: 1 1 160px; min-width: 0; }
.cpg-prod-manual-row .cpg-weight-field { flex: 0 1 120px; }
.cpg-prod-manual-row .erp-input { min-width: 0; width: 100%; }
/* 상자 그림 안 박스 호수 라벨 (예: 2호) */
@@ -1009,16 +1010,21 @@ body.cpg-dragging { cursor: grabbing; user-select: none; }
text-overflow: ellipsis;
vertical-align: middle;
}
/* 열 폭: 제품명 160 / 제품코드 96 / 상태 72 / 동작 104 고정,
쿠팡상품코드는 남는 폭을 흡수 → 다른 열이 지정 폭 그대로 유지된다. */
/* 열 폭: 제품명 160 / 제품코드 96 / (포장무게 84) / 상태 72 / 동작 104 고정,
쿠팡상품코드는 남는 폭을 흡수 → 다른 열이 지정 폭 그대로 유지된다.
상태·동작은 끝에서부터 센다(포장무게 열이 있든 없든 — 마이그레이션 007 전이면 없음). */
.cpg-prod-right .erp-table th:nth-child(1),
.cpg-prod-right .erp-table td:nth-child(1) { width: 160px; }
.cpg-prod-right .erp-table th:nth-child(2),
.cpg-prod-right .erp-table td:nth-child(2) { width: 96px; }
.cpg-prod-right .erp-table th:nth-child(4),
.cpg-prod-right .erp-table td:nth-child(4) { width: 72px; }
.cpg-prod-right .erp-table th:nth-child(5),
.cpg-prod-right .erp-table td:nth-child(5) { width: 104px; }
.cpg-prod-right .erp-table th.cpg-weight-col,
.cpg-prod-right .erp-table td.cpg-weight-col { width: 84px; text-align: right; font-variant-numeric: tabular-nums; }
.cpg-prod-right .erp-table th.cpg-weight-col .cpg-sort { margin-left: auto; }
.cpg-weight-unit { margin-left: 2px; font-size: 11px; color: var(--erp-muted, #8a8f98); }
.cpg-prod-right .erp-table th:nth-last-child(2),
.cpg-prod-right .erp-table td:nth-last-child(2) { width: 72px; }
.cpg-prod-right .erp-table th:nth-last-child(1),
.cpg-prod-right .erp-table td:nth-last-child(1) { width: 104px; }
/* 제품코드·쿠팡상품코드는 mono 라 조금 더 좁게 */
.cpg-prod-right .erp-table td:nth-child(2),
.cpg-prod-right .erp-table td:nth-child(3) { font-size: 12px; }
@@ -1339,6 +1345,16 @@ a.cpg-boxno-dl:hover { background: #1a5c38; border-color: #1a5c38; font-weight:
.cpg-boxno-c-name { width: auto; }
.cpg-boxno-c-code { width: 100px; }
.cpg-boxno-c-qty { width: 62px; }
.cpg-boxno-c-weight { width: 92px; }
/* 상자 무게 합계(g) — 상자 단위 한 칸(rowspan), 오른쪽 정렬 숫자. 무게 없는 제품이 있으면 작은 표시 */
.cpg-boxno-weight {
text-align: right; vertical-align: middle; font-variant-numeric: tabular-nums; font-weight: 600;
border-left: 1px solid var(--color-cloud-gray);
}
.cpg-boxno-weight .cpg-weight-unit { font-weight: 400; }
.cpg-boxno-wmiss {
display: block; margin-top: 1px; font-size: 10.5px; font-weight: 600; color: #b45309; white-space: nowrap;
}
.cpg-boxno-cell {
text-align: center; font-weight: 700;
font-family: var(--font-geist-mono);
+12
View File
@@ -157,6 +157,7 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; }
.perf-modal { position: fixed; inset: 0; z-index: 1000; background: rgba(0, 0, 0, .35); display: flex; align-items: center; justify-content: center; padding: 20px; }
.perf-modal-card { background: #fff; border-radius: 14px; width: min(1100px, 100%); max-height: 88vh; display: flex; flex-direction: column; box-shadow: 0 20px 60px rgba(0, 0, 0, .25); }
.perf-modal-card.is-narrow { width: min(560px, 100%); }
.perf-modal-card.is-wide { width: min(1640px, 100%); } /* 주문 내역 — 열이 많아 넓게 */
.perf-modal-head { display: flex; align-items: center; justify-content: space-between; gap: 10px; padding: 14px 16px; border-bottom: 1px solid var(--perf-line); }
.perf-modal-head h3 { margin: 0; font-size: 15px; font-weight: 600; }
.perf-modal-body { padding: 12px 16px; overflow: auto; }
@@ -229,6 +230,8 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; }
.perf-ev-table thead th { background: var(--perf-soft, #fafafa); box-shadow: 0 1px 0 var(--perf-line, #e5e5e5); }
/* 취소 행 — 행 전체를 기울임 + 취소선 + 회색 */
.perf-ev-table tr.is-cancel td { font-style: italic; text-decoration: line-through; color: #9a9a9a; }
/* 상품명만 줄바꿈 — 긴 상품명 때문에 표가 창보다 넓어져 가로 스크롤이 생기지 않게(나머지 열은 한 줄) */
.perf-ev-table .perf-ev-name { white-space: normal; min-width: 220px; overflow-wrap: anywhere; }
/* ── 매출 업데이트 진행 창 — 쇼핑몰별·전체 진행 막대(runSyncWithProgress) ── */
.perf-prog-card { width: min(640px, 100%); }
@@ -262,6 +265,15 @@ td.is-link:hover { background: #eef2ff; text-decoration: underline; }
@media (max-width: 560px) { .perf-prog-row { grid-template-columns: 1fr 44px; } .perf-prog-name { grid-column: 1 / -1; } .perf-prog-text { grid-column: 1 / -1; } }
/* [업데이트 취소] — 창 아래 왼쪽, 빨간 글자. 끝나면 숨김 */
/* 쇼핑몰별 [중지] — 이름 옆 작은 버튼(이 쇼핑몰만 멈추고 다음 쇼핑몰로) */
.perf-prog-name { display: flex; align-items: center; gap: 6px; }
.perf-prog-name > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.perf-prog-stop {
flex: none; margin-left: auto; padding: 1px 8px; border: 1px solid var(--perf-line); border-radius: 999px;
background: #fff; color: var(--perf-down); font-size: 11.5px; font-weight: 600; line-height: 1.6; cursor: pointer;
}
.perf-prog-stop:hover { border-color: var(--perf-down); background: #fff5f5; }
.perf-prog-stop:disabled { opacity: .6; cursor: default; }
.perf-prog-cancel { margin-right: auto; color: var(--perf-down); border-color: currentColor; }
.perf-prog-cancel[hidden] { display: none; }
.perf-prog-cancel:disabled { opacity: .6; cursor: default; }
+71 -17
View File
@@ -54,7 +54,8 @@
function openModal(title, opts) {
opts = opts || {};
const back = el("div", { class: "perf-modal" });
const card = el("div", { class: "perf-modal-card" + (opts.narrow ? " is-narrow" : ""), role: "dialog", "aria-modal": "true" });
const card = el("div", { class: "perf-modal-card" + (opts.narrow ? " is-narrow" : opts.wide ? " is-wide" : ""),
role: "dialog", "aria-modal": "true" });
const head = el("div", { class: "perf-modal-head" });
head.appendChild(el("h3", { text: title }));
const x = el("button", { type: "button", class: "perf-modal-x", "aria-label": "닫기" }, "×");
@@ -85,10 +86,10 @@
sec = Math.max(0, Math.round(sec || 0));
return Math.floor(sec / 60) + ":" + String(sec % 60).padStart(2, "0");
}
function progressRow(name, fraction, text, cls) {
function progressRow(name, fraction, text, cls, action) {
const pct = Math.round((fraction || 0) * 100);
return '<div class="perf-prog-row' + (cls ? " " + cls : "") + '">' +
'<div class="perf-prog-name">' + esc(name) + "</div>" +
'<div class="perf-prog-name"><span>' + esc(name) + "</span>" + (action || "") + "</div>" +
'<div class="perf-prog-bar" role="progressbar" aria-valuemin="0" aria-valuemax="100" aria-valuenow="' + pct + '">' +
'<span style="width:' + pct + '%"></span></div>' +
'<div class="perf-prog-pct">' + pct + "%</div>" +
@@ -101,8 +102,10 @@
if (s.state === "done") t += " · " + fmt(s.upserted) + "건 반영";
if (s.state === "error") t += " · " + (s.label ? s.label + " — " : "") + (s.message || "");
if (s.state === "skipped") t += " · " + (s.message || "");
if (s.state === "cancelled") t += " · 저장하지 않음(기존 매출 그대로)";
if (s.state === "cancelled") t = (s.message === "중지됨" ? "중지됨" : t) + " · 저장하지 않음(기존 매출 그대로)";
if (s.state === "running" && s.cancel_pending) t += " · 취소하는 중…";
else if (s.state === "running" && s.stop_requested) t += " · 중지하는 중…";
if (s.state === "waiting" && s.stop_requested) t += " · 중지 — 차례가 오면 건너뜀";
let html = esc(t);
if (s.elapsed && s.state !== "waiting") html += ' <span class="perf-muted">(' + fmtSec(s.elapsed) + ")</span>";
return html;
@@ -118,7 +121,12 @@
const cls = s.state === "error" ? "is-error" : s.state === "done" ? "is-done" :
(s.state === "skipped" || s.state === "cancelled") ? "is-skip" : "";
if (job.cancel_requested) s.cancel_pending = true;
return progressRow(s.name, s.fraction, shopText(s), cls);
// 쇼핑몰별 [중지] — 이 쇼핑몰만 멈추고 다음 쇼핑몰로(대기·수집 중일 때만, 저장 중엔 못 멈춤)
const stoppable = !job.finished && !job.cancel_requested && !s.stop_requested &&
(s.state === "waiting" || s.state === "running");
const stopBtn = stoppable ? '<button type="button" class="perf-prog-stop" data-stop="' + esc(s.code) + '" title="' +
esc(s.name) + ' 업데이트만 멈추고 다음 쇼핑몰로 넘어갑니다(이 쇼핑몰은 저장하지 않음)">중지</button>' : "";
return progressRow(s.name, s.fraction, shopText(s), cls, stopBtn);
}).join("");
html += progressRow("전체", o.fraction,
esc((job.cancel_requested ? (job.finished ? "업데이트 취소됨 · " : "취소하는 중 · ") : "") +
@@ -147,6 +155,23 @@
m.foot.appendChild(cancelBtn);
m.foot.appendChild(closeBtn);
let jobId = null;
// 쇼핑몰별 [중지] — 진행 창은 0.8초마다 다시 그려지므로 위임으로 받는다
m.body.addEventListener("click", async function (e) {
const b = e.target.closest("[data-stop]");
if (!b || !jobId) return;
b.disabled = true;
b.textContent = "중지하는 중…";
try {
const r = await api("POST", "/performance/api/sync/jobs/" + encodeURIComponent(jobId) + "/shops/" +
encodeURIComponent(b.dataset.stop) + "/stop");
last = r.job;
renderSyncJob(m.body, r.job, false);
} catch (err) {
b.disabled = false;
b.textContent = "중지";
alertMsg("중지 실패: " + err.message);
}
});
cancelBtn.addEventListener("click", async function () {
if (!jobId) return;
if (!(await confirmMsg("매출 업데이트를 취소할까요?\n수집 중인 쇼핑몰은 저장하지 않고 멈추고, 이미 끝난 쇼핑몰 결과는 그대로 남습니다."))) return;
@@ -199,7 +224,7 @@
function jobResults(job) {
return (job && job.shops || []).map(function (s) {
return { code: s.code, name: s.name, ok: s.state === "done", skipped: s.state === "skipped",
cancelled: s.state === "cancelled",
cancelled: s.state === "cancelled", stopped: s.state === "cancelled" && s.message === "중지됨",
upserted: s.upserted, status: s.status, label: s.label, message: s.message, finished: s.state !== "waiting" && s.state !== "running" && s.state !== "saving" };
});
}
@@ -263,11 +288,12 @@
const running = job && !job.finished;
// 실패(빨강)는 인증 실패·API 오류처럼 손봐야 하는 것만. 인증정보를 아직 안 넣은 쇼핑몰(미설정)과
// 수집을 아직 만들지 않은 쇼핑몰(연동 준비 중)은 회색 한 줄로 이름만.
const ok = [], bad = [], pending = [], unset = [], busy = [], cancelled = [];
const ok = [], bad = [], pending = [], unset = [], busy = [], cancelled = [], stopped = [];
let changed = 0;
(res.results || []).forEach(function (r) {
const name = (data.names || {})[r.code] || r.name || r.code;
if (r.cancelled) cancelled.push(name);
if (r.stopped) stopped.push(name);
else if (r.cancelled) cancelled.push(name);
else if (r.skipped) busy.push(name);
else if (r.ok) { ok.push(name + " " + fmt(r.upserted) + "건"); changed += r.upserted; }
else if (r.status === "not_implemented") pending.push(name);
@@ -278,6 +304,7 @@
if (ok.length) parts.push("<b>반영</b> " + esc(ok.join(", ")));
if (bad.length) parts.push("<b>실패</b> " + esc(bad.join(", ")));
if (busy.length) parts.push("<b>이미 진행 중</b> " + esc(busy.join(", ")));
if (stopped.length) parts.push("<b>중지됨</b>(기존 매출 그대로) " + esc(stopped.join(", ")));
if (cancelled.length) parts.push("<b>취소됨</b>(기존 매출 그대로) " + esc(cancelled.join(", ")));
if (pending.length) parts.push('<span class="perf-muted">연동 준비 중: ' + esc(pending.join(", ")) + "</span>");
if (unset.length) parts.push('<span class="perf-muted">인증정보 미설정: ' + esc(unset.join(", ")) + "</span>");
@@ -309,7 +336,7 @@
async function openEvents(code, from, to) {
const name = (data.names || {})[code] || code;
const title = name + " · " + (from === to ? from : from + " ~ " + to) + " 주문 내역";
const m = openModal(title);
const m = openModal(title, { wide: true }); // 넓은 창 + 상품명 줄바꿈 → 가로 스크롤 없이
m.body.innerHTML = '<p class="perf-muted">불러오는 중…</p>';
try {
const res = await api("GET", "/performance/api/events?code=" + encodeURIComponent(code) +
@@ -325,7 +352,7 @@
"<td>" + esc(r.sales_date) + "</td><td>" + esc(KIND[r.event_type] || r.event_type) +
(r.is_sample ? ' <span class="perf-pill">테스트</span>' : "") + "</td>" +
"<td>" + esc(r.external_order_id) + "</td>" +
"<td>" + esc(r.product_name) + (r.option_name ? " <span class='perf-muted'>" + esc(r.option_name) + "</span>" : "") + "</td>" +
'<td class="perf-ev-name">' + esc(r.product_name) + (r.option_name ? " <span class='perf-muted'>" + esc(r.option_name) + "</span>" : "") + "</td>" +
'<td class="perf-num">' + esc(r.quantity) + "</td>" +
'<td class="perf-num">' + fmt(r.amount) + "</td>" +
"<td>" + esc(r.order_date || "") + "</td><td>" + esc(r.payment_date || "") + "</td>" +
@@ -334,7 +361,7 @@
m.body.innerHTML =
'<div class="perf-ev-wrap"><table class="perf-table perf-ev-table"><thead><tr>' +
'<th class="perf-th-label">매출일</th><th class="perf-th-label">구분</th><th class="perf-th-label">주문번호</th>' +
'<th class="perf-th-label">상품명</th><th>수량</th><th>금액</th><th class="perf-th-label">주문일</th>' +
'<th class="perf-th-label perf-ev-name">상품명</th><th>수량</th><th>금액</th><th class="perf-th-label">주문일</th>' +
'<th class="perf-th-label">결제일</th><th class="perf-th-label">상태</th></tr></thead><tbody>' + body +
'</tbody><tfoot><tr class="perf-row-total"><th class="perf-td-label" colspan="5">결제 ' + fmt(sales) +
" / 취소·반품 " + fmt(minus) + '</th><td class="perf-num">' + fmt(sum) + '</td><td colspan="3"></td></tr></tfoot></table></div>' +
@@ -960,7 +987,7 @@
}
});
// ── 쇼핑몰 원본 데이터 확인(네이버·11번가) — 조회 주소별 동작 여부·항목 합계, 네이버는 날짜별 현재 규칙 매출 ──
// ── 쇼핑몰 원본 데이터 확인(네이버·11번가·GS샵·토스쇼핑) — 조회 주소별 동작 여부·항목 합계, 네이버는 날짜별 현재 규칙 매출 ──
const probe = document.getElementById("perf-probe");
if (probe) probe.addEventListener("click", async function () {
const day = document.getElementById("perf-probe-date").value;
@@ -970,7 +997,7 @@
const codeSel = document.getElementById("perf-probe-code");
const code = codeSel ? codeSel.value : "elevenst";
const loading = { naver: "네이버에서 불러오는 중… (하루씩, 기간이 길면 수십 초)",
gsshop: "GS샵에서 불러오는 중… (10일 단위)" }[code] || "11번가에서 불러오는 중… (주소 10개 × 7일 단위, 기간이 길면 1분 이상)";
gsshop: "GS샵에서 불러오는 중… (10일 단위)", toss: "토스쇼핑에서 불러오는 중… (31일 단위)" }[code] || "11번가에서 불러오는 중… (주소 10개 × 7일 단위, 기간이 길면 1분 이상)";
out.innerHTML = '<p class="perf-muted">' + loading + "</p>";
try {
const to = document.getElementById("perf-probe-to").value || day;
@@ -993,10 +1020,11 @@
(f.sum == null ? "" : fmt(f.sum)) + "</td><td>" + (f.personal ? '<span class="perf-muted">개인정보(숨김)</span>' : esc(f.sample)) + "</td></tr>";
}).join("") + "</tbody></table>";
}).join("");
// 날짜별 현재 규칙 매출(네이버) — 쇼핑몰 관리자 화면 매출과 나란히 비교
// 날짜별 현재 규칙 매출(네이버·토스쇼핑) — 쇼핑몰 관리자 화면 매출과 나란히 비교
const days = (r.days || []).length ? '<h4 class="perf-h" style="margin:14px 0 6px">날짜별 현재 규칙 매출</h4>' +
(r.rule ? '<p class="perf-muted">규칙: ' + esc(r.rule) + "</p>" : "") +
'<table class="perf-table"><thead><tr><th class="perf-th-label">날짜</th><th>주문 수</th><th>매출</th>' +
'<table class="perf-table"><thead><tr><th class="perf-th-label">날짜</th><th>주문 수</th><th>' +
esc((r.day_cols || {}).amount || "매출") + "</th>" +
"<th>" + esc((r.day_cols || {}).claimed || "그중 결제 뒤 취소·반품(참고)") + "</th><th>" +
esc((r.day_cols || {}).ship || "배송비(참고, 매출 제외)") + "</th></tr></thead><tbody>" +
r.days.map(function (d) {
@@ -1007,7 +1035,33 @@
["orders", "amount", "claimed", "ship"].map(function (k) {
return '<td class="perf-num"><b>' + fmt(r.days.reduce(function (a, d) { return a + (d[k] || 0); }, 0)) + "</b></td>";
}).join("") + "</tr></tbody></table>" : "";
out.innerHTML = summary + days + (details || '<p class="perf-muted" style="margin-top:8px">그 기간에 조회된 주문이 없습니다. 쇼핑몰 관리자 화면에서 매출이 있던 날로 다시 해 보세요.</p>');
// 환불 출처별(토스쇼핑) — 출처별 날짜 합계를 나란히, 아래에 건별 목록(주문번호·금액·메모)
const rc = r.refund_candidates || [];
const candDays = (r.days || []).map(function (d) { return d.date; });
const cands = rc.length ? '<h4 class="perf-h" style="margin:14px 0 6px">환불 출처별 비교 — 첫 열(적용 규칙)이 저장되는 환불</h4>' +
'<table class="perf-table"><thead><tr><th class="perf-th-label">날짜</th>' +
rc.map(function (c) { return "<th>" + esc(c.label) + "</th>"; }).join("") + "</tr></thead><tbody>" +
candDays.map(function (dt) {
return '<tr><td class="perf-td-label">' + esc(dt) + "</td>" + rc.map(function (c) {
return '<td class="perf-num">' + (c.error ? "" : fmt((c.days || {})[dt] || 0)) + "</td>";
}).join("") + "</tr>";
}).join("") + '<tr><td class="perf-td-label"><b>합계</b></td>' + rc.map(function (c) {
if (c.error) return '<td><span class="perf-pill is-bad">실패</span> <span class="perf-muted" style="white-space:normal">' + esc(c.error) + "</span></td>";
const t = Object.keys(c.days || {}).reduce(function (a, k) { return a + c.days[k]; }, 0);
return '<td class="perf-num"><b>' + fmt(t) + "</b></td>";
}).join("") + "</tr></tbody></table>" +
rc.filter(function (c) { return !c.error && (c.rows || []).length; }).map(function (c) {
return '<p class="perf-muted" style="margin:10px 0 4px">' + esc(c.label) + " — " + fmt(c.rows.length) + "건</p>" +
'<table class="perf-table"><thead><tr><th class="perf-th-label">환불일</th><th class="perf-th-label">주문일</th>' +
'<th class="perf-th-label">주문번호</th>' +
'<th class="perf-th-label">주문상품</th><th>금액</th><th class="perf-th-label">메모</th></tr></thead><tbody>' +
c.rows.map(function (x) {
return '<tr><td class="perf-td-label">' + esc(x.date) + "</td><td>" + esc(x.orderDate || "") + "</td><td>" +
esc(x.orderId) + "</td><td>" + esc(x.orderProductId) +
'</td><td class="perf-num">' + fmt(x.amount) + '</td><td class="perf-muted">' + esc(x.note) + "</td></tr>";
}).join("") + "</tbody></table>";
}).join("") : "";
out.innerHTML = summary + days + cands + (details ||'<p class="perf-muted" style="margin-top:8px">그 기간에 조회된 주문이 없습니다. 쇼핑몰 관리자 화면에서 매출이 있던 날로 다시 해 보세요.</p>');
} catch (err) {
out.innerHTML = '<p class="perf-notice is-warn">' + esc(err.message) + "</p>";
} finally { probe.disabled = false; }
@@ -1033,7 +1087,7 @@
if (job && !job.finished) rest.push("(아직 진행 중 — 창을 닫았습니다. 끝나면 대시보드에 반영됩니다)");
(res.results || []).forEach(function (r) {
const name = names[r.code] || r.name || r.code;
if (r.cancelled) rest.push(name + "(취소됨)");
if (r.cancelled) rest.push(name + (r.stopped ? "(중지됨)" : "(취소됨)"));
else if (r.ok) ok.push(name + " " + fmt(r.upserted) + "건");
else if (r.skipped) rest.push(name + "(이미 진행 중)");
else if (r.status === "not_implemented" || r.status === "not_configured") rest.push(name);
+10
View File
@@ -0,0 +1,10 @@
@font-face { font-family: "Pretendard Variable"; src: url("vendor/project-fonts/PretendardVariable.woff2") format("woff2"); font-weight: 100 900; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquare"; src: url("vendor/project-fonts/NanumSquareR.woff") format("woff"); font-weight: 100 599; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquare"; src: url("vendor/project-fonts/NanumSquareB.woff") format("woff"); font-weight: 600 749; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquare"; src: url("vendor/project-fonts/NanumSquareEB.woff") format("woff"); font-weight: 750 900; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareNeo"; src: url("vendor/project-fonts/NanumSquareNeoR.woff") format("woff"); font-weight: 100 599; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareNeo"; src: url("vendor/project-fonts/NanumSquareNeoB.woff") format("woff"); font-weight: 600 749; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareNeo"; src: url("vendor/project-fonts/NanumSquareNeoEB.woff") format("woff"); font-weight: 750 900; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareRound"; src: url("vendor/project-fonts/NanumSquareRoundR.woff2") format("woff2"); font-weight: 100 599; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareRound"; src: url("vendor/project-fonts/NanumSquareRoundB.woff2") format("woff2"); font-weight: 600 749; font-style: normal; font-display: swap; }
@font-face { font-family: "NanumSquareRound"; src: url("vendor/project-fonts/NanumSquareRoundEB.woff2") format("woff2"); font-weight: 750 900; font-style: normal; font-display: swap; }
+53
View File
@@ -0,0 +1,53 @@
/* 목표 연도 아래 월 폴더와 주간 회의록 — 좁은 왼쪽 메뉴에서도 글자는 한 줄로 표시한다. */
/* 기존 37px 들여쓰기를 2px로 줄여 연도 트리 전체를 왼쪽으로 35px 옮긴다. */
.pj-side-goal-years { padding-left: 2px; }
.pj-side-goal-branch { min-width: 0; }
.pj-side-goal-year-row { display: flex; align-items: center; min-width: 0; }
.pj-side-goal-year-row .pj-side-goal-year { flex: 1; min-width: 0; }
/* 연도 이동 링크와 접기 버튼은 따로 눌러 사용할 수 있다. */
.pj-side-goal-year-toggle { display: flex; align-items: center; justify-content: center; flex: none; width: 24px; height: 30px; padding: 0; border: 0; border-radius: 6px; background: transparent; color: var(--pj-ink-soft); cursor: pointer; }
.pj-side-goal-year-toggle:hover { background: #f1f2f4; }
.pj-side-goal-year-toggle:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: -2px; }
.pj-side-goal-year-toggle .material-symbols-outlined { font-size: 18px; }
.pj-side-goal-year-toggle[aria-expanded="true"] .material-symbols-outlined { transform: rotate(90deg); }
.pj-side-meeting-months { padding-left: 8px; }
.pj-side-meeting-months[hidden] { display: none; }
.pj-side-meeting-month { min-width: 0; }
.pj-side-meeting-month > summary {
display: flex; align-items: center; gap: 5px; padding: 5px 4px;
border-radius: 6px; cursor: pointer; color: var(--pj-ink-soft); list-style: none;
font-size: 13px; line-height: 20px;
}
.pj-side-meeting-month > summary::-webkit-details-marker { display: none; }
.pj-side-meeting-month > summary:hover { background: #f1f2f4; }
.pj-side-meeting-month > summary:focus-visible,
.pj-side-meeting-week:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: -2px; }
.pj-side-meeting-caret { flex: none; font-size: 16px; }
.pj-side-meeting-month[open] .pj-side-meeting-caret { transform: rotate(90deg); }
.pj-side-meeting-folder { flex: none; font-size: 18px; color: var(--pj-accent); }
.pj-side-meeting-folder-open { display: none; }
.pj-side-meeting-month[open] .pj-side-meeting-folder-closed { display: none; }
.pj-side-meeting-month[open] .pj-side-meeting-folder-open { display: inline-block; }
.pj-side-meeting-weeks { margin: 0 0 4px 12px; padding-left: 8px; border-left: 1px solid var(--pj-border); }
.pj-side-meeting-week {
display: block; min-width: 0; padding: 5px 4px; border-radius: 6px;
color: var(--pj-ink); text-decoration: none; font-size: 12px; line-height: 18px;
overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
}
.pj-side-meeting-week:hover { background: #f1f2f4; }
.pj-side-meeting-week.is-active { background: var(--pj-accent-tint); color: var(--pj-accent-dark); }
.pj-side-meeting-retry { font: inherit; font-size: 12px; color: var(--pj-ink-soft); border: 0; background: transparent; cursor: pointer; padding: 5px 8px; }
/* 왼쪽 메뉴와 별개로 오른쪽 회의록 문서만 바뀌는 영역. */
.pj-meeting-panel-host { position: relative; max-width: none !important; overflow: hidden; }
.pj-meeting-panel-frame { display: block; width: 100%; height: 100%; min-height: 0; flex: 1; border: 0; background: #fff; }
.pj-meeting-panel-frame.is-loading { position: absolute; inset: 0; visibility: hidden; }
.pj-meeting-panel-status { position: absolute; top: 4px; right: 8px; z-index: 2; padding: 6px 10px; border-radius: 6px; background: #f4f5f7; color: var(--pj-ink-soft); font-size: 12px; }
.pj-meeting-panel-status.is-error { color: #b42318; background: #fff1f0; }
html.pj-meeting-content, html.pj-meeting-content body { height: 100%; overflow: hidden; }
html.pj-meeting-content .erp-page { height: 100%; margin: 0; padding: 0; display: flex; box-sizing: border-box; }
html.pj-meeting-content .pj-wrap { width: 100%; min-height: 0; display: flex; flex-direction: column; padding: 0; }
html.pj-meeting-content .pj-layout { display: flex; flex-direction: column; height: 100%; min-height: 0; }
@media (max-width: 800px) {
.pj-meeting-panel-host { height: 80vh; min-height: 400px; }
}
+251
View File
@@ -0,0 +1,251 @@
/* 생성된 회의록만 읽어서 목표 연도 아래에 월별 폴더를 만든다. */
(function () {
"use strict";
function init() {
const branches = Array.from(document.querySelectorAll(".pj-side-goal-branch"));
if (!branches.length) return;
let loading = false, retry = null;
const navigation = initMeetingNavigation();
// 연도 접기는 월 폴더를 지우지 않고 숨겨서 각 월의 펼침 상태도 그대로 남긴다.
branches.forEach(function (branch) {
const button = branch.querySelector(".pj-side-goal-year-toggle");
const list = branch.querySelector(".pj-side-meeting-months");
if (!button || !list) return;
const key = "pj_goal_year_open:" + branch.dataset.goalYear;
function setOpen(open) {
list.hidden = !open;
button.setAttribute("aria-expanded", String(open));
const action = open ? "하위 월 접기" : "하위 월 펼치기";
button.setAttribute("aria-label", branch.dataset.goalYear + "년 " + action);
button.title = action;
}
let saved = null;
try { saved = localStorage.getItem(key); } catch (_) {}
setOpen(saved !== "0");
button.addEventListener("click", function () {
const open = list.hidden;
setOpen(open);
try { localStorage.setItem(key, open ? "1" : "0"); } catch (_) {}
});
});
// 문자열을 HTML로 해석하지 않고 넣어 회의록 메뉴의 글자를 그대로 표시한다.
function icon(name, cls) {
const span = document.createElement("span");
span.className = "material-symbols-outlined " + cls;
span.setAttribute("aria-hidden", "true");
span.textContent = name;
return span;
}
function render(branch, months) {
const list = branch.querySelector(".pj-side-meeting-months");
const current = list.dataset.currentWeek;
list.replaceChildren();
months.forEach(function (month) {
const folder = document.createElement("details");
folder.className = "pj-side-meeting-month";
const key = "pj_goal_month_open:" + branch.dataset.goalYear + ":" + month.month;
let saved = null;
try { saved = localStorage.getItem(key); } catch (_) {}
folder.open = saved == null ? month.weeks.some(function (w) { return w.start === current; }) : saved === "1";
const summary = document.createElement("summary");
summary.append(icon("chevron_right", "pj-side-meeting-caret"),
icon("folder", "pj-side-meeting-folder pj-side-meeting-folder-closed"),
icon("folder_open", "pj-side-meeting-folder pj-side-meeting-folder-open"),
document.createTextNode(month.month + "월"));
summary.setAttribute("aria-label", month.month + "월 주간 회의록");
folder.append(summary);
const weeks = document.createElement("div");
weeks.className = "pj-side-meeting-weeks";
month.weeks.forEach(function (week) {
const link = document.createElement("a");
link.className = "pj-side-meeting-week";
link.href = week.href;
link.textContent = week.label;
link.title = week.label;
link.addEventListener("click", function (event) {
// Ctrl/⌘ 클릭과 새 탭 열기는 일반 링크의 동작을 유지한다.
if (event.defaultPrevented || event.button || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
if (!navigation) return;
event.preventDefault();
navigation.open(link.href);
});
if (week.start === current) {
link.classList.add("is-active");
link.setAttribute("aria-current", "page");
}
weeks.append(link);
});
folder.append(weeks);
list.append(folder);
// 접기·펼치기 선택은 같은 브라우저에서 다음 화면에도 유지한다.
folder.addEventListener("toggle", function () {
try { localStorage.setItem(key, folder.open ? "1" : "0"); } catch (_) {}
});
});
}
async function load() {
if (loading) return;
loading = true;
if (retry) retry.disabled = true;
try {
const response = await fetch("/project/api/goals/meeting-nav", { credentials: "same-origin" });
if (!response.ok) throw new Error("회의록 조회 실패");
const data = await response.json();
branches.forEach(function (branch) {
const year = (data.years || []).find(function (y) { return String(y.year) === branch.dataset.goalYear; });
render(branch, year ? year.months : []);
});
if (navigation) navigation.markCurrent();
if (retry) { retry.remove(); retry = null; }
} catch (_) {
// 목록 조회가 실패해도 기존 목표·프로젝트 메뉴는 계속 사용할 수 있다.
if (!retry) {
retry = document.createElement("button");
retry.type = "button";
retry.className = "pj-side-meeting-retry";
retry.textContent = "회의록 목록 다시 불러오기";
retry.addEventListener("click", load);
branches[branches.length - 1].after(retry);
}
retry.disabled = false;
} finally { loading = false; }
}
load();
}
// 왼쪽 메뉴는 그대로 두고 오른쪽 문서만 교체한다. 회의록 편집 이벤트·타이머는 문서와 함께 정리된다.
function initMeetingNavigation() {
const layout = document.querySelector(".pj-layout");
const original = layout && layout.querySelector(".pj-main");
if (!original) return null;
const root = layout.closest(".pj-wrap"), originalClasses = root.className;
const originalUrl = location.pathname + location.search;
const originalTitle = document.title;
const originalYears = new Set(Array.from(document.querySelectorAll(".pj-side-goal-year.is-active")));
let host = null, frame = null, pending = null, sequence = 0, current = originalUrl;
function meetingUrl(value) {
const url = new URL(value, location.href);
if (url.origin !== location.origin || !/^\/project\/goals\/\d{4}\/meetings\/\d{1,2}$/.test(url.pathname)) return null;
url.searchParams.delete("content");
return url;
}
function markCurrent() {
const url = meetingUrl(current), week = url && url.searchParams.get("week");
document.querySelectorAll(".pj-side-meeting-week").forEach(function (link) {
const selected = url && link.pathname === url.pathname && new URL(link.href).searchParams.get("week") === week;
link.classList.toggle("is-active", !!selected);
if (selected) link.setAttribute("aria-current", "page"); else link.removeAttribute("aria-current");
});
document.querySelectorAll(".pj-side-goal-year").forEach(function (link) {
link.classList.toggle("is-active", url ? url.pathname.startsWith(link.pathname + "/") : originalYears.has(link));
});
}
function ensureHost() {
if (host) return;
host = document.createElement("section");
host.className = "pj-main pj-meeting-panel-host";
original.replaceWith(host);
root.classList.add("pj-goal-view", "pj-inbox-view", "pj-meet-view");
}
function status(message, failed) {
if (!host) return;
let box = host.querySelector(".pj-meeting-panel-status");
if (!box) { box = document.createElement("div"); box.className = "pj-meeting-panel-status"; box.setAttribute("role", "status"); host.append(box); }
box.textContent = message;
box.classList.toggle("is-error", !!failed);
}
function clearStatus() { const box = host && host.querySelector(".pj-meeting-panel-status"); if (box) box.remove(); }
function syncFont() {
if (!frame) return;
const font = document.documentElement.dataset.pjFont || "system";
if (frame.contentDocument.documentElement.dataset.pjFont !== font) {
frame.contentDocument.documentElement.dataset.pjFont = font;
frame.contentWindow.dispatchEvent(new frame.contentWindow.Event("resize"));
}
}
async function saveCurrent() {
const view = frame ? frame.contentWindow : window;
if (view.PJFlushForNavigation) await view.PJFlushForNavigation();
}
async function open(value, options) {
options = options || {};
const url = meetingUrl(value);
if (!url) return;
const target = url.pathname + url.search;
if (frame && target === current && !pending) return;
const turn = ++sequence;
try {
if (!options.initial) await saveCurrent();
if (turn !== sequence) return;
ensureHost();
if (pending) { pending.remove(); pending = null; }
status("회의록을 불러오는 중…", false);
const next = document.createElement("iframe");
next.className = "pj-meeting-panel-frame is-loading";
next.title = "주간 회의록";
pending = next;
next.addEventListener("load", function () {
if (next !== frame && turn !== sequence) { next.remove(); return; }
try {
if (!next.contentDocument.documentElement.classList.contains("pj-meeting-content")) throw new Error("회의록을 불러오지 못했습니다. 주차를 다시 눌러 주세요.");
const actual = meetingUrl(next.contentWindow.location.href);
const pane = next.contentDocument.getElementById("pj-meet-pane");
if (pane && pane.dataset.week) actual.searchParams.set("week", pane.dataset.week);
// 줄 추가·삭제 등으로 현재 회의록 자체가 새로고침되어도 패널을 제거하지 않는다.
if (next === frame) {
if (!pending) {
current = actual.pathname + actual.search;
clearStatus(); markCurrent(); history.replaceState({ pjMeeting: true }, "", current);
}
syncFont(); return;
}
current = actual.pathname + actual.search;
if (frame) frame.remove();
frame = next; pending = null;
next.classList.remove("is-loading");
syncFont(); clearStatus(); markCurrent();
document.title = next.contentDocument.title;
if (options.history !== false) history[options.initial ? "replaceState" : "pushState"]({ pjMeeting: true }, "", current);
} catch (error) {
if (next !== frame) { next.remove(); if (pending === next) pending = null; }
status(error.message, true);
if (options.history === false) history.replaceState(null, "", current);
}
});
url.searchParams.set("content", "1");
next.src = url.href;
host.append(next);
} catch (error) {
if (turn !== sequence) return;
if (host) status("이동하지 못했습니다. " + error.message, true);
else if (window.erpAlert) window.erpAlert(error.message);
if (options.history === false) history.replaceState(null, "", current);
}
}
window.addEventListener("message", function (event) {
if (!frame || event.origin !== location.origin || event.source !== frame.contentWindow) return;
if (event.data && event.data.type === "pj-meeting-navigate") open(event.data.href);
});
window.addEventListener("resize", syncFont);
window.addEventListener("popstate", async function () {
const url = location.pathname + location.search;
if (meetingUrl(url)) { open(url, { history: false }); return; }
if (url === originalUrl && host) {
try {
await saveCurrent(); sequence++;
if (pending) pending.remove();
if (frame) frame.remove();
host.replaceWith(original); host = frame = pending = null;
root.className = originalClasses; current = originalUrl; document.title = originalTitle; markCurrent();
} catch (error) { status(error.message, true); history.replaceState(null, "", current); }
}
});
// 첫 회의록도 편집 코드가 붙기 전에 오른쪽 전용 문서로 분리해 중복 초기화를 막는다.
if (meetingUrl(originalUrl)) open(originalUrl, { initial: true });
return { open: open, markCurrent: markCurrent };
}
if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", init);
else init();
})();
+293
View File
@@ -0,0 +1,293 @@
/* 목표 셀의 선택한 글자 서식. 서버와 같은 버전 있는 텍스트 조각을 사용한다. */
(function () {
"use strict";
const PREFIX = "pj-rich:v1:";
const STYLE_KEYS = ["bold", "italic", "underline", "color", "size"];
const TOGGLES = ["bold", "italic", "underline"];
function styles(node, inherited) {
const s = Object.assign({}, inherited);
if (node.nodeType !== 1) return s;
const css = node.style;
if (node.tagName === "B" || node.tagName === "STRONG") s.bold = true;
if (css.fontWeight) s.bold = css.fontWeight === "bold" || Number(css.fontWeight) >= 600;
if (node.tagName === "I" || node.tagName === "EM") s.italic = true;
if (css.fontStyle) s.italic = css.fontStyle === "italic" || css.fontStyle === "oblique";
if (node.tagName === "U") s.underline = true;
const decoration = css.textDecorationLine || css.textDecoration;
if (decoration) s.underline = decoration.includes("underline");
const size = parseInt(css.fontSize, 10);
if (size >= 10 && size <= 32) s.size = size;
if (css.color) {
const rgb = css.color.match(/^rgb\((\d+),\s*(\d+),\s*(\d+)\)$/);
const hex = rgb ? "#" + rgb.slice(1).map(function (v) { return Number(v).toString(16).padStart(2, "0"); }).join("") : css.color;
if (/^#[\da-f]{6}$/i.test(hex)) s.color = hex.toLowerCase();
}
return s;
}
function readRuns(editor) {
const runs = [];
function add(text, style) { if (text) runs.push(Object.assign({ text: text }, style)); }
function walk(node, inherited) {
if (node.nodeType === 3) { add(node.nodeValue, inherited); return; }
if (node.nodeType !== 1) return;
if (node.hasAttribute("data-pj-caret-line")) return;
if (node.tagName === "BR") { add("\n", inherited); return; }
if (/^(SCRIPT|STYLE|IMG|IFRAME)$/.test(node.tagName)) return;
const style = styles(node, inherited);
const block = /^(DIV|P)$/.test(node.tagName);
if (block && runs.length && !runs[runs.length - 1].text.endsWith("\n")) add("\n", inherited);
Array.from(node.childNodes).forEach(function (child) { walk(child, style); });
}
Array.from(editor.childNodes).forEach(function (child) { walk(child, {}); });
return compact(runs);
}
function compact(runs) {
const out = [];
runs.forEach(function (run) {
if (!run.text) return;
const prev = out[out.length - 1];
if (prev && STYLE_KEYS.every(function (key) { return prev[key] === run[key]; })) prev.text += run.text;
else out.push(Object.assign({}, run));
});
return out;
}
function encode(runs) {
runs = compact(runs);
return runs.some(function (r) { return Object.keys(r).length > 1; }) ? PREFIX + JSON.stringify(runs) : runs.map(function (r) { return r.text; }).join("");
}
function decode(value) {
if (value.startsWith(PREFIX)) {
try { const runs = JSON.parse(value.slice(PREFIX.length)); if (Array.isArray(runs)) return runs; } catch (_) {}
}
return [{ text: value }];
}
function paint(editor, runs) {
editor.replaceChildren();
runs.forEach(function (r) {
if (typeof r.text !== "string") return;
editor.appendChild(nodeForRun(r));
});
caretLine(editor);
}
function nodeForRun(r) {
const span = document.createElement("span");
r.text.split("\n").forEach(function (line, i) {
if (i) span.appendChild(document.createElement("br"));
if (line) span.appendChild(document.createTextNode(line));
});
if (typeof r.bold === "boolean") span.style.fontWeight = r.bold ? "700" : "400";
if (typeof r.italic === "boolean") span.style.fontStyle = r.italic ? "italic" : "normal";
if (typeof r.underline === "boolean") span.style.textDecoration = r.underline ? "underline" : "none";
if (/^#[\da-f]{6}$/i.test(r.color || "")) span.style.color = r.color;
if (Number.isInteger(r.size) && r.size >= 10 && r.size <= 32) span.style.fontSize = r.size + "px";
if (!span.style.cssText && r.text.includes("\n")) span.style.lineHeight = "inherit";
return span.style.cssText || r.text.includes("\n") ? span : document.createTextNode(r.text);
}
function caretLine(editor) {
// 마지막 개행 뒤의 빈 줄도 화면에 만들되 저장할 글에는 넣지 않는다.
const runs = readRuns(editor), last = runs[runs.length - 1];
let marker = editor.querySelector("[data-pj-caret-line]");
if (last && last.text.endsWith("\n")) {
if (!marker) {
marker = document.createElement("br"); marker.setAttribute("data-pj-caret-line", "");
const holder = document.createElement("span"); holder.appendChild(marker); editor.appendChild(holder);
}
marker.parentElement.style.fontSize = last.size ? last.size + "px" : "";
marker.parentElement.style.lineHeight = last.size ? "normal" : getComputedStyle(editor).lineHeight;
} else if (marker) {
const holder = marker.parentElement; marker.remove();
if (holder !== editor && !holder.childNodes.length) holder.remove();
}
}
function restore(editor, start, end) {
const walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT | NodeFilter.SHOW_ELEMENT);
const points = [], range = document.createRange();
let node, offset = 0;
while ((node = walker.nextNode())) {
const length = node.nodeType === 3 ? node.length : node.tagName === "BR" && !node.hasAttribute("data-pj-caret-line") ? 1 : 0;
if (length) { points.push({ node: node, start: offset, end: offset + length }); offset += length; }
}
function point(n) { return points.find(function (p) { return n <= p.end; }) || points[points.length - 1]; }
const a = point(start), b = point(end);
if (!a || !b) { range.selectNodeContents(editor); range.collapse(false); }
else {
function pointAt(p, n) {
return p.node.nodeType === 3 ? [p.node, Math.max(0, n - p.start)] :
[p.node.parentNode, Array.from(p.node.parentNode.childNodes).indexOf(p.node) + (n > p.start ? 1 : 0)];
}
range.setStart(...pointAt(a, start)); range.setEnd(...pointAt(b, end));
}
const selection = window.getSelection(); selection.removeAllRanges(); selection.addRange(range);
return range;
}
function attach(editor) {
// 기존 자동 저장·병합·초안 복구와 같은 value 인터페이스를 제공한다.
Object.defineProperty(editor, "value", { configurable: true,
get: function () { return encode(readRuns(editor)); },
set: function (v) { paint(editor, decode(String(v || ""))); },
});
editor.addEventListener("keydown", function (e) {
if (e.isComposing || e.keyCode === 229) return;
if (e.key === "Enter") { e.preventDefault(); insert(editor, "\n"); }
});
editor.addEventListener("beforeinput", function (e) {
if (!e.isComposing && (e.inputType === "insertParagraph" || e.inputType === "insertLineBreak")) {
e.preventDefault(); insert(editor, "\n");
}
});
editor.addEventListener("input", function (e) { if (!e.isComposing) caretLine(editor); });
editor.addEventListener("compositionend", function () { caretLine(editor); });
editor.addEventListener("paste", function (e) {
e.preventDefault(); insert(editor, e.clipboardData.getData("text/plain"));
});
paint(editor, readRuns(editor));
}
function insert(editor, text) {
if (!text) return;
const sel = window.getSelection();
if (!sel.rangeCount || !editor.contains(sel.getRangeAt(0).commonAncestorContainer)) return;
const range = sel.getRangeAt(0), pre = document.createRange();
pre.selectNodeContents(editor); pre.setEnd(range.startContainer, range.startOffset);
const offset = readRuns(pre.cloneContents()).reduce((n, r) => n + r.text.length, 0); let pos = 0, style = {};
for (const run of readRuns(editor)) {
pos += run.text.length;
if (pos >= offset) { STYLE_KEYS.forEach(k => { if (run[k] !== undefined) style[k] = run[k]; }); break; }
}
range.deleteContents();
const node = nodeForRun(Object.assign({ text: text }, style)); range.insertNode(node);
const caret = node.nodeType === 3 ? node : node.lastChild;
if (caret.nodeType === 3) range.setStart(caret, caret.length); else range.setStartAfter(caret);
range.collapse(true); sel.removeAllRanges(); sel.addRange(range);
editor.dispatchEvent(new Event("input", { bubbles: true }));
}
function init(table, toolbar) {
if (!toolbar) return;
let saved = null;
// body 에 두어 표 스크롤과 화면 zoom 에 잘리지 않는 선택 셀 위 팝업으로 표시한다.
document.body.appendChild(toolbar);
const colorButton = toolbar.querySelector("[data-goal-format='color']");
const colorGrid = toolbar.querySelector(".pj-goal-color-grid");
function closeColors() { colorGrid.hidden = true; colorButton.setAttribute("aria-expanded", "false"); }
function showColor(value) {
colorButton.querySelector(".pj-goal-color-preview").style.backgroundColor = value;
colorGrid.querySelectorAll("[data-goal-color]").forEach(function (btn) {
btn.setAttribute("aria-pressed", String(btn.dataset.goalColor.toLowerCase() === value.toLowerCase()));
});
}
function place() {
if (!saved || !saved.editor.isConnected) { clear(); return; }
const sel = window.getSelection();
if (!sel.rangeCount || sel.isCollapsed || !saved.editor.contains(sel.getRangeAt(0).commonAncestorContainer)) return;
const cell = saved.editor.closest("td");
if (!cell) { clear(); return; }
// 같은 셀의 어느 줄을 선택해도 셀 상단·가운데를 기준으로 같은 위치에 둔다.
const rect = cell.getBoundingClientRect();
const paneRect = table.parentElement.getBoundingClientRect();
if (rect.bottom < paneRect.top || rect.top > paneRect.bottom || rect.right < paneRect.left || rect.left > paneRect.right) {
toolbar.hidden = true; closeColors(); return;
}
toolbar.hidden = false;
const w = toolbar.offsetWidth, h = toolbar.offsetHeight;
toolbar.style.left = Math.max(8, Math.min(rect.left + rect.width / 2 - w / 2, window.innerWidth - w - 8)) + "px";
toolbar.style.top = Math.max(8, rect.top - h - 8) + "px";
colorGrid.classList.toggle("is-below", rect.top - h - 88 < 8);
}
function clear() {
saved = null;
toolbar.hidden = true; closeColors();
toolbar.querySelectorAll("button, input, select").forEach(function (el) { el.disabled = true; });
}
function capture() {
// 서식 도구에 포커스를 옮길 때는 직전 글자 선택을 유지한다.
if (toolbar.contains(document.activeElement)) return;
const sel = window.getSelection();
if (!sel.rangeCount || sel.isCollapsed) { clear(); return; }
const range = sel.getRangeAt(0);
const root = range.startContainer.nodeType === 1 ? range.startContainer : range.startContainer.parentElement;
const editor = root.closest(".pj-goal-text[contenteditable='true']");
if (!editor || !table.contains(editor) || !editor.contains(range.endContainer)) { clear(); return; }
const pre = document.createRange(); pre.selectNodeContents(editor); pre.setEnd(range.startContainer, range.startOffset);
const start = readRuns(pre.cloneContents()).reduce((n, r) => n + r.text.length, 0);
saved = { editor: editor, start: start, end: start + readRuns(range.cloneContents()).reduce((n, r) => n + r.text.length, 0) };
toolbar.querySelectorAll("button, input, select").forEach(function (el) { el.disabled = false; });
let pos = 0;
const chosen = readRuns(editor).filter(function (run) {
const end = pos + run.text.length, intersects = end > saved.start && pos < saved.end;
pos = end; return intersects;
});
function uniform(key, fallback) {
const value = chosen[0] && chosen[0][key];
return chosen.every(function (r) { return r[key] === value; }) && value !== undefined ? value : fallback;
}
TOGGLES.forEach(function (key) {
const all = chosen.every(function (r) { return r[key] === true; });
const some = chosen.some(function (r) { return r[key] === true; });
toolbar.querySelector("[data-goal-format='" + key + "']").setAttribute("aria-pressed", all ? "true" : some ? "mixed" : "false");
});
showColor(uniform("color", "#000000"));
const sizes = chosen.map(function (r) { return r.size || 14; });
toolbar.querySelector("[data-goal-format='size']").textContent = sizes.every(function (n) { return n === sizes[0]; }) ? sizes[0] + "px" : "혼합";
toolbar.querySelector("[data-goal-format='size-up']").disabled = sizes.every(function (n) { return n >= 32; });
toolbar.querySelector("[data-goal-format='size-down']").disabled = sizes.every(function (n) { return n <= 10; });
toolbar.hidden = false;
place();
}
document.addEventListener("selectionchange", capture);
table.addEventListener("mouseup", capture);
table.addEventListener("keyup", capture);
toolbar.addEventListener("mousedown", function (e) { if (e.target.closest("button")) e.preventDefault(); });
function apply(key, value) {
if (!saved || !saved.editor.isConnected) return;
const editor = saved.editor, out = []; let pos = 0;
readRuns(editor).forEach(function (run) {
const end = pos + run.text.length;
const a = Math.max(pos, saved.start), b = Math.min(end, saved.end);
if (b <= a) out.push(run);
else {
if (a > pos) out.push(Object.assign({}, run, { text: run.text.slice(0, a - pos) }));
const middle = Object.assign({}, run, { text: run.text.slice(a - pos, b - pos) });
if (key === "reset") STYLE_KEYS.forEach(function (style) { delete middle[style]; });
else if (key === "size-delta") middle.size = Math.max(10, Math.min(32, (middle.size || 14) + value));
else middle[key] = value;
out.push(middle);
if (b < end) out.push(Object.assign({}, run, { text: run.text.slice(b - pos) }));
}
pos = end;
});
paint(editor, compact(out)); editor.focus(); restore(editor, saved.start, saved.end);
editor.dispatchEvent(new Event("input", { bubbles: true }));
capture();
}
colorButton.addEventListener("click", function () {
colorGrid.hidden = !colorGrid.hidden;
colorButton.setAttribute("aria-expanded", String(!colorGrid.hidden));
});
colorGrid.addEventListener("click", function (e) {
const btn = e.target.closest("[data-goal-color]");
if (!btn) return;
apply("color", btn.dataset.goalColor.toLowerCase()); closeColors();
});
TOGGLES.forEach(function (key) {
const btn = toolbar.querySelector("[data-goal-format='" + key + "']");
btn.addEventListener("click", function () { apply(key, btn.getAttribute("aria-pressed") !== "true"); });
});
toolbar.querySelector("[data-goal-format='size-up']").addEventListener("click", function () { apply("size-delta", 2); });
toolbar.querySelector("[data-goal-format='size-down']").addEventListener("click", function () { apply("size-delta", -2); });
toolbar.querySelector("[data-goal-format='reset']").addEventListener("click", function () { apply("reset"); });
document.addEventListener("mousedown", function (e) {
if (toolbar.contains(e.target) || (saved && saved.editor.contains(e.target))) return;
clear();
}, true);
toolbar.addEventListener("keydown", function (e) {
if (e.key !== "Escape") return;
e.preventDefault(); e.stopPropagation();
if (!colorGrid.hidden) { closeColors(); colorButton.focus(); }
else { if (saved) saved.editor.focus(); clear(); }
});
window.addEventListener("resize", place);
window.addEventListener("scroll", function (e) { if (!toolbar.contains(e.target)) place(); }, true);
new MutationObserver(function () { if (saved && !saved.editor.isConnected) clear(); }).observe(table, { childList: true, subtree: true });
clear();
}
window.PJGoalText = { attach: attach, init: init, readRuns: readRuns, paint: paint, encode: encode };
})();
+59 -15
View File
@@ -2,11 +2,11 @@
왼쪽 목차(스크롤을 따라 현재 위치 강조) + 오른쪽 본문 카드. 처음 쓰는 사람이
읽기 쉽게 — 단계는 번호 동그라미, 화면의 버튼·메뉴 이름은 .pjh-ui 칩으로 표시. */
.pjh {
--pjh-ink: #1e1f21; --pjh-soft: #6d6e6f; --pjh-line: #e8eaee;
--pjh-ink: var(--pj-ink); --pjh-soft: var(--pj-ink-soft); --pjh-line: #e8eaee;
--pjh-accent: var(--pj-accent, #7b68ee); --pjh-tint: var(--pj-accent-tint, #f1eeff);
display: grid; grid-template-columns: 230px minmax(0, 1fr); gap: 28px;
max-width: 1180px; margin: 0 auto; padding: 4px 0 60px; color: var(--pjh-ink);
font-size: 14.5px; line-height: 1.7;
font-size: var(--pj-text-size); line-height: var(--pj-text-leading);
}
@media (max-width: 1000px) {
.pjh { grid-template-columns: minmax(0, 1fr); }
@@ -15,26 +15,26 @@
/* 목차 */
.pjh-toc { position: sticky; top: 12px; align-self: start; max-height: calc(100vh - 110px); overflow-y: auto; }
.pjh-toc-title { font-size: 12px; font-weight: 800; color: var(--pjh-soft); letter-spacing: .04em; margin: 0 0 8px 10px; }
.pjh-toc-title { font-size: 12px; font-weight: 500; color: var(--pjh-soft); letter-spacing: normal; margin: 0 0 8px 10px; }
.pjh-toc ol { list-style: none; margin: 0; padding: 0; counter-reset: toc; }
.pjh-toc li { counter-increment: toc; }
.pjh-toc a {
display: flex; gap: 8px; padding: 5px 10px; border-radius: 8px; color: #3d4046;
text-decoration: none; font-size: 13.5px; line-height: 1.45;
text-decoration: none; font-size: var(--pj-text-size); line-height: var(--pj-text-leading);
}
.pjh-toc a::before { content: counter(toc) "."; color: #9aa1a9; min-width: 18px; }
.pjh-toc a:hover { background: #f1f2f4; }
.pjh-toc a.is-active { background: var(--pjh-tint); color: var(--pjh-accent); font-weight: 700; }
.pjh-toc a.is-active { background: var(--pjh-tint); color: var(--pjh-accent); font-weight: 500; }
/* 머리말 */
.pjh-hero {
background: linear-gradient(135deg, #f4f1ff 0%, #eef5ff 100%); border: 1px solid #e4defd;
border-radius: 16px; padding: 26px 30px; margin-bottom: 18px;
}
.pjh-hero h1 { margin: 0 0 6px; font-size: 24px; font-weight: 800; }
.pjh-hero h1 { margin: 0 0 6px; font-size: var(--pj-title-size); line-height: var(--pj-title-leading); font-weight: 500; }
.pjh-hero p { margin: 0; color: #3d4046; }
.pjh-quick { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 10px; margin-top: 18px; }
.pjh-quick-step { background: #fff; border: 1px solid #e4defd; border-radius: 12px; padding: 12px 14px; font-size: 13.5px; line-height: 1.5; }
.pjh-quick-step { background: #fff; border: 1px solid #e4defd; border-radius: 12px; padding: 12px 14px; font-size: var(--pj-text-size); line-height: var(--pj-text-leading); }
.pjh-quick-step b { display: block; color: var(--pjh-accent); font-size: 12px; margin-bottom: 2px; }
/* 본문 카드 */
@@ -42,12 +42,12 @@
background: #fff; border: 1px solid var(--pjh-line); border-radius: 14px;
padding: 24px 30px; margin-bottom: 18px; scroll-margin-top: 16px;
}
.pjh-sec h2 { display: flex; align-items: center; gap: 10px; margin: 0 0 12px; font-size: 20px; font-weight: 800; }
.pjh-sec h2 { display: flex; align-items: center; gap: 10px; margin: 0 0 12px; font-size: var(--pj-heading-size); line-height: var(--pj-heading-leading); font-weight: 500; }
.pjh-sec h2 .pjh-num {
display: inline-flex; align-items: center; justify-content: center; width: 30px; height: 30px;
border-radius: 9px; background: var(--pjh-tint); color: var(--pjh-accent); font-size: 15px; flex: none;
}
.pjh-sec h3 { margin: 22px 0 6px; font-size: 16px; font-weight: 800; }
.pjh-sec h3 { margin: 22px 0 6px; font-size: var(--pj-section-size); line-height: var(--pj-section-leading); font-weight: 500; }
.pjh-sec h3:first-of-type { margin-top: 8px; }
.pjh-sec p { margin: 6px 0; }
.pjh-sec ul { margin: 6px 0; padding-left: 20px; }
@@ -59,14 +59,14 @@
.pjh-steps li { counter-increment: step; position: relative; padding: 2px 0 6px 36px; margin: 0; }
.pjh-steps li::before {
content: counter(step); position: absolute; left: 0; top: 3px; width: 24px; height: 24px;
border-radius: 50%; background: var(--pjh-accent); color: #fff; font-size: 12.5px; font-weight: 800;
border-radius: 50%; background: var(--pjh-accent); color: #fff; font-size: 12.5px; font-weight: 500;
display: flex; align-items: center; justify-content: center;
}
/* 화면 요소 이름(버튼·메뉴) 칩, 키보드 키 */
.pjh-ui {
display: inline-flex; align-items: center; gap: 3px; padding: 0 7px; border-radius: 6px;
background: #f1f2f4; border: 1px solid #e2e4e8; font-size: 13px; font-weight: 700; line-height: 22px;
background: #f1f2f4; border: 1px solid #e2e4e8; font-size: 13px; font-weight: 500; line-height: 22px;
white-space: nowrap; vertical-align: 1px;
}
.pjh-ui .material-symbols-outlined { font-size: 16px; }
@@ -79,7 +79,7 @@
/* 팁·주의 */
.pjh-tip, .pjh-note, .pjh-warn {
display: flex; gap: 10px; border-radius: 10px; padding: 10px 14px; margin: 10px 0; font-size: 13.5px; line-height: 1.6;
display: flex; gap: 10px; border-radius: 10px; padding: 10px 14px; margin: 10px 0; font-size: var(--pj-text-size); line-height: var(--pj-text-leading);
}
.pjh-tip { background: #f2faf5; border: 1px solid #cfe9da; }
.pjh-note { background: #f3f6ff; border: 1px solid #d6e0fb; }
@@ -91,10 +91,10 @@
.pjh-warn > .material-symbols-outlined { font-size: 20px; flex: none; margin-top: 1px; }
/* 표 */
.pjh-table { width: 100%; border-collapse: collapse; margin: 8px 0; font-size: 13.5px; line-height: 1.55; }
.pjh-table { width: 100%; border-collapse: collapse; margin: 8px 0; font-size: var(--pj-text-size); line-height: var(--pj-text-leading); }
.pjh-table th, .pjh-table td { border-bottom: 1px solid var(--pjh-line); padding: 8px 10px; text-align: left; vertical-align: top; }
.pjh-table th { background: #f7f8fa; font-weight: 800; color: #3d4046; white-space: nowrap; }
.pjh-table td:first-child { font-weight: 700; white-space: nowrap; }
.pjh-table th { background: #f7f8fa; font-weight: 500; color: #3d4046; white-space: nowrap; }
.pjh-table td:first-child { font-weight: 500; white-space: nowrap; }
/* 화면 구성 그림(아주 단순한 모형) */
.pjh-map {
@@ -114,3 +114,47 @@
background: var(--pjh-accent); color: #fff; box-shadow: 0 6px 18px rgba(123, 104, 238, .35);
}
.pjh-top:hover { filter: brightness(1.08); }
/* 검색 — 결과는 소제목 단위로 이동하며 본문은 계속 읽을 수 있다. */
.erp-page:has(> .pjh) { box-sizing: border-box; }
.pjh-body { min-width: 0; }
.pjh [hidden] { display: none !important; }
.pjh-search { background: #fff; border: 1px solid var(--pjh-line); border-radius: 14px; padding: 18px 22px; margin-bottom: 18px; }
.pjh-search label { display: block; font-weight: 600; margin-bottom: 8px; }
.pjh-search-field { display: flex; gap: 8px; }
.pjh-search-field input { flex: 1; min-width: 0; border: 1px solid #cfd3d9; border-radius: 8px; padding: 10px 12px; font: inherit; }
.pjh-search-field button { border: 1px solid #d7d0f7; border-radius: 8px; background: var(--pjh-tint); color: #493790; padding: 8px 12px; font: inherit; cursor: pointer; }
.pjh-search-field button:hover { background: #e8e1ff; }
.pjh-search-hint, .pjh-search-status { font-size: 13px; margin: 8px 0 0; color: var(--pjh-soft); }
.pjh-search-status:empty { display: none; }
.pjh-results { list-style: none; margin: 12px 0 0; padding: 0; max-height: 340px; overflow-y: auto; }
.pjh-results li + li { border-top: 1px solid var(--pjh-line); }
.pjh-results a { display: block; padding: 10px; color: var(--pjh-ink); text-decoration: none; border-radius: 8px; }
.pjh-results a:hover { background: #f7f5ff; }
.pjh-results strong, .pjh-results span { display: block; overflow-wrap: anywhere; }
.pjh-results strong { color: #493790; font-weight: 600; }
.pjh-results span { margin-top: 4px; font-size: 13px; }
.pjh mark.pjh-match { background: #fff0a6; color: #423309; border-radius: 2px; padding: 0; }
.pjh-quick-links { margin-top: 16px !important; }
.pjh-sec h3 { scroll-margin-top: 20px; }
.pjh :focus-visible { outline: 2px solid var(--pjh-accent); outline-offset: 3px; }
.pjh-sec { overflow-wrap: anywhere; }
@media (max-width: 600px) {
.erp-app:has(.pjh) .erp-topbar { flex-wrap: wrap; height: auto; padding: 8px 12px; gap: 8px; }
.erp-app:has(.pjh) .erp-topbar-left { flex-basis: 100%; }
.erp-app:has(.pjh) .erp-topbar-right { width: 100%; gap: 6px; }
.erp-app:has(.pjh) .erp-user-chip { margin-right: auto; }
.erp-app:has(.pjh) .erp-user-email { display: none; }
.pjh { gap: 12px; }
.pjh-hero, .pjh-sec { padding: 18px 16px; }
.pjh-search { padding: 16px; }
.pjh-search-field { flex-wrap: wrap; }
.pjh-search-field input { flex-basis: 100%; }
.pjh-table td:first-child, .pjh-table th { white-space: normal; }
.pjh-table th, .pjh-table td { padding: 7px 5px; }
.pjh-map { grid-template-columns: minmax(0, 1fr); grid-template-rows: auto; }
.pjh-map-top { flex-wrap: wrap; gap: 6px; }
.pjh-map-side, .pjh-map-main { grid-row: auto; }
.pjh-top { right: 12px; bottom: 12px; }
}
+205
View File
@@ -0,0 +1,205 @@
/* 도움말의 제목·본문에서 검색하고 해당 소제목으로 이동한다. DB/API 불필요. */
(function () {
"use strict";
const root = document.querySelector(".pjh");
if (!root) return;
const input = document.getElementById("pjh-query");
const form = document.getElementById("pjh-search-form");
const results = document.getElementById("pjh-results");
const status = document.getElementById("pjh-search-status");
const clear = document.getElementById("pjh-search-clear");
const chapters = Array.from(root.querySelectorAll(".pjh-sec"));
const index = [];
let composing = false;
function plain(node) {
const copy = node.cloneNode(true);
copy.querySelectorAll(".pjh-num, .material-symbols-outlined").forEach(function (n) { n.remove(); });
return copy.textContent.replace(/\s+/g, " ").trim();
}
// 본문 자체에서 색인을 만든다. 도움말을 고치면 검색 결과도 함께 바뀐다.
chapters.forEach(function (chapter) {
const title = plain(chapter.querySelector("h2"));
let block = { chapter: chapter, title: title, heading: chapter.querySelector("h2"), nodes: [], order: index.length };
block.heading.id = block.heading.id || chapter.id + "-intro";
let ordinal = 0;
function finish() {
block.text = block.nodes.map(plain).join(" ");
block.search = (block.title + " " + block.text).toLowerCase();
index.push(block);
}
Array.from(chapter.children).forEach(function (node) {
if (node.tagName === "H2") return;
if (node.tagName === "H3") {
finish();
ordinal++;
node.id = node.id || chapter.id + "-" + ordinal;
block = { chapter: chapter, title: title + " › " + plain(node), heading: node, nodes: [], order: index.length };
} else block.nodes.push(node);
});
finish();
});
function words(query) {
return Array.from(new Set(query.trim().toLowerCase().split(/\s+/).filter(Boolean)));
}
// 검색어는 HTML이나 정규식으로 해석하지 않는다.
function marked(text, terms) {
const fragment = document.createDocumentFragment();
const lower = text.toLowerCase();
let pos = 0;
while (pos < text.length) {
let start = -1, length = 0;
terms.forEach(function (term) {
const found = lower.indexOf(term, pos);
if (found !== -1 && (start === -1 || found < start || (found === start && term.length > length))) {
start = found; length = term.length;
}
});
if (start === -1) { fragment.appendChild(document.createTextNode(text.slice(pos))); break; }
fragment.appendChild(document.createTextNode(text.slice(pos, start)));
const mark = document.createElement("mark");
mark.className = "pjh-match";
mark.textContent = text.slice(start, start + length);
fragment.appendChild(mark);
pos = start + length;
}
return fragment;
}
function highlight(terms) {
chapters.forEach(function (chapter) {
chapter.querySelectorAll("mark.pjh-match").forEach(function (mark) {
mark.replaceWith(document.createTextNode(mark.textContent));
});
chapter.normalize();
if (!terms.length) return;
const walker = document.createTreeWalker(chapter, NodeFilter.SHOW_TEXT);
const nodes = [];
let node;
while ((node = walker.nextNode())) {
if (!node.parentElement.closest(".material-symbols-outlined, .pjh-num") &&
terms.some(function (term) { return node.nodeValue.toLowerCase().includes(term); })) nodes.push(node);
}
nodes.forEach(function (n) { n.replaceWith(marked(n.nodeValue, terms)); });
});
}
function snippet(text, terms) {
const lower = text.toLowerCase();
const hits = terms.map(function (term) { return lower.indexOf(term); }).filter(function (n) { return n >= 0; });
const start = hits.length ? Math.max(0, Math.min.apply(null, hits) - 35) : 0;
return (start ? "…" : "") + text.slice(start, start + 155) + (text.length > start + 155 ? "…" : "");
}
function saveQuery(query) {
const url = new URL(window.location.href);
if (query.trim()) url.searchParams.set("q", query.trim());
else url.searchParams.delete("q");
window.history.replaceState(null, "", url);
}
function search(updateUrl) {
const query = input.value.slice(0, 160);
const terms = words(query);
results.replaceChildren();
clear.hidden = !query;
results.hidden = !terms.length;
highlight(terms);
if (updateUrl) saveQuery(query);
if (!terms.length) { status.textContent = ""; return; }
const matches = index.filter(function (entry) {
return terms.every(function (term) { return entry.search.includes(term); });
});
// 제목에 모든 단어가 있으면 먼저, 나머지는 문서 순서대로.
matches.sort(function (a, b) {
function score(entry) { return terms.every(function (term) { return entry.title.toLowerCase().includes(term); }) ? 1 : 0; }
return score(b) - score(a) || a.order - b.order;
});
status.textContent = matches.length
? "검색 결과 " + matches.length + "개 · 결과를 누르거나 Enter로 첫 설명에 이동하세요."
: "검색 결과가 없습니다. 다른 단어를 쓰거나 검색어를 줄여 보세요.";
matches.forEach(function (entry) {
const li = document.createElement("li");
const link = document.createElement("a");
link.href = "#" + entry.heading.id;
const title = document.createElement("strong");
title.appendChild(marked(entry.title, terms));
const preview = document.createElement("span");
preview.appendChild(marked(snippet(entry.text, terms), terms));
link.append(title, preview);
li.appendChild(link);
results.appendChild(li);
});
}
const tocLinks = Array.from(root.querySelectorAll(".pjh-toc a"));
function activate(chapter) {
tocLinks.forEach(function (link) {
const active = link.getAttribute("href") === "#" + chapter.id;
link.classList.toggle("is-active", active);
if (active) link.setAttribute("aria-current", "location");
else link.removeAttribute("aria-current");
});
}
function jump(id) {
const target = document.getElementById(id);
if (!target || !root.contains(target)) return;
target.setAttribute("tabindex", "-1");
target.focus({ preventScroll: true });
target.scrollIntoView({ block: "start" });
const chapter = target.closest(".pjh-sec");
if (chapter) activate(chapter);
}
root.addEventListener("click", function (event) {
const link = event.target.closest('a[href^="#"]');
if (!link || event.button !== 0 || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
const id = link.getAttribute("href").slice(1);
if (!document.getElementById(id)) return;
event.preventDefault();
if (window.location.hash !== "#" + id) window.history.pushState(null, "", "#" + id);
jump(id);
});
input.maxLength = 160;
input.addEventListener("compositionstart", function () { composing = true; });
input.addEventListener("compositionend", function () { composing = false; search(true); });
input.addEventListener("input", function () { if (!composing) search(true); });
form.addEventListener("submit", function (event) {
event.preventDefault();
if (composing) return;
search(true);
const first = results.querySelector("a");
if (first) first.click();
});
function reset() { input.value = ""; search(true); input.focus(); }
clear.addEventListener("click", reset);
input.addEventListener("keydown", function (event) {
if (composing || event.isComposing || event.keyCode === 229) return;
if (event.key === "Escape") { event.preventDefault(); reset(); }
});
document.addEventListener("keydown", function (event) {
if (event.key !== "/" || event.isComposing || event.ctrlKey || event.metaKey || event.altKey ||
event.target.closest("input, textarea, select, [contenteditable='true']")) return;
event.preventDefault();
input.focus();
input.scrollIntoView({ block: "center" });
});
function restore() {
input.value = (new URL(window.location.href).searchParams.get("q") || "").slice(0, 160);
search(false);
if (window.location.hash) jump(window.location.hash.slice(1));
}
window.addEventListener("popstate", restore);
window.addEventListener("hashchange", function () { if (window.location.hash) jump(window.location.hash.slice(1)); });
document.getElementById("pjh-search").hidden = false;
restore();
if ("IntersectionObserver" in window) {
const observer = new IntersectionObserver(function (entries) {
entries.forEach(function (entry) { if (entry.isIntersecting) activate(entry.target); });
}, { rootMargin: "-10% 0px -75% 0px" });
chapters.forEach(function (chapter) { observer.observe(chapter); });
}
})();
+305
View File
@@ -0,0 +1,305 @@
/* 주간 회의록 셀 편집. 글자 서식은 목표와 같은 PJGoalText/자동 저장을 사용한다. */
(function () {
"use strict";
function init(opts) {
const table = opts.table, pane = opts.pane, admin = opts.admin;
const KEY = "pj_meet_col_w", widths = {}, defaults = {};
const cols = Array.from(table.querySelectorAll("colgroup col"));
let saver = null, selected = [], anchor = null, rangeDrag = null, moveDrag = null;
let busy = false, undo = null, suppressClick = 0;
const editableCell = n => {
const td = n && n.closest && n.closest("td[data-meet-item]");
return td && table.contains(td) && td.querySelector(".pj-meet-text") ? td : null;
};
const editorOf = td => td.querySelector(".pj-meet-text");
const keyOf = td => (td.dataset.meetCols || "").split(",").filter(Boolean).at(-1);
const minWidth = key => key === "section" ? 48 : key === "label" ? 96 : 40;
cols.forEach(function (col) {
const key = col.dataset.meetCol;
defaults[key] = Math.max(minWidth(key), Math.round(col.getBoundingClientRect().width / opts.zoom()) || 160);
widths[key] = defaults[key];
});
try {
const saved = JSON.parse(localStorage.getItem(KEY) || "{}");
Object.keys(widths).forEach(k => { if (Number.isFinite(saved[k]) && saved[k] > 0) widths[k] = Math.max(minWidth(k), saved[k]); });
} catch (_) {}
function applyWidths() {
cols.forEach(col => { col.style.width = widths[col.dataset.meetCol] + "px"; });
table.style.width = cols.reduce((sum, col) => sum + widths[col.dataset.meetCol], 0) + "px";
table.style.minWidth = table.style.width;
}
function saveWidths() {
try { localStorage.setItem(KEY, JSON.stringify(widths)); } catch (_) {}
}
function handles() {
const keys = Array.from(table.querySelectorAll("colgroup col")).map(col => col.dataset.meetCol), occupied = [];
Array.from(table.rows).forEach(function (tr, r) {
occupied[r] = occupied[r] || [];
let c = 0;
Array.from(tr.cells).forEach(function (td) {
while (occupied[r][c]) c++;
const end = c + td.colSpan - 1;
for (let rr = r; rr < r + td.rowSpan; rr++) {
occupied[rr] = occupied[rr] || [];
for (let cc = c; cc <= end; cc++) occupied[rr][cc] = true;
}
td.dataset.meetCols = keys.slice(c, end + 1).join(",");
const handle = td.querySelector(".pj-meet-colresize") || document.createElement("span");
handle.className = "pj-meet-colresize"; handle.dataset.col = keys[end];
handle.title = "끌어서 너비 조절 · 더블클릭하면 내용에 맞춤";
if (!handle.parentNode) td.appendChild(handle);
if (admin && editableCell(td)) ["top", "bottom", "left"].forEach(function (edge) {
if (td.querySelector('.pj-goal-move-edge[data-edge="' + edge + '"]')) return;
const h = document.createElement("span"); h.className = "pj-goal-move-edge"; h.dataset.edge = edge;
h.title = "테두리를 끌어 내용과 서식 이동"; td.appendChild(h);
});
c = end + 1;
});
});
}
handles(); applyWidths();
let widthTouched = false; // 사람이 너비를 바꾸면 늦은 자동 맞춤(글꼴 로딩 뒤)이 덮지 않게
const orderButton = document.getElementById("pj-meet-order");
if (orderButton) new MutationObserver(handles).observe(table, { attributes: true, attributeFilter: ["class"] });
function measure(td) {
const probe = document.createElement("div"), copy = td.cloneNode(true);
const t = table.cloneNode(false), section = td.parentElement.parentElement.cloneNode(false), row = td.parentElement.cloneNode(false);
probe.style.cssText = "position:fixed;visibility:hidden;pointer-events:none;width:max-content;left:0;top:0";
probe.setAttribute("aria-hidden", "true");
t.style.cssText = "width:max-content;table-layout:auto";
copy.querySelectorAll(".pj-meet-colresize,.pj-goal-move-edge,.pj-meet-more,.pj-meet-sec-add").forEach(n => n.remove());
copy.querySelectorAll("input,textarea,select").forEach(function (n) {
const text = document.createElement("span"); text.textContent = n.value; n.replaceWith(text);
});
[t, section, row, copy].concat(Array.from(copy.querySelectorAll("*"))).forEach(function (n) {
n.removeAttribute("id"); n.removeAttribute("contenteditable"); n.removeAttribute("data-placeholder");
const styles = { position: "static", width: "max-content", "min-width": "0", "max-width": "none", height: "auto",
overflow: "visible", "white-space": "pre", "overflow-wrap": "normal", "word-break": "normal" };
Object.keys(styles).forEach(k => n.style.setProperty(k, styles[k], "important"));
});
copy.style.display = "block"; row.appendChild(copy); section.appendChild(row); t.appendChild(section); probe.appendChild(t); pane.appendChild(probe);
try { return Math.ceil(copy.getBoundingClientRect().width / opts.zoom()) + 2; }
finally { probe.remove(); }
}
function fit(key) {
widthTouched = true;
let width = minWidth(key);
table.querySelectorAll("[data-meet-cols]").forEach(function (td) {
const keys = td.dataset.meetCols.split(",");
if (!keys.includes(key)) return;
width = Math.max(width, measure(td) - keys.reduce((s, k) => s + (k === key ? 0 : widths[k]), 0));
});
widths[key] = width; applyWidths(); saveWidths();
}
function fitAll() {
const cells = Array.from(table.querySelectorAll("[data-meet-cols]")).map(td => ({ keys: td.dataset.meetCols.split(","), width: measure(td) }));
Object.keys(widths).forEach(k => { widths[k] = minWidth(k); });
cells.filter(c => c.keys.length === 1).forEach(c => { widths[c.keys[0]] = Math.max(widths[c.keys[0]], c.width); });
cells.filter(c => c.keys.length > 1).forEach(function (c) {
const last = c.keys.at(-1), rest = c.keys.slice(0, -1).reduce((s, k) => s + widths[k], 0);
widths[last] = Math.max(widths[last], c.width - rest);
});
applyWidths(); saveWidths();
}
// 회의록을 열 때는 늘 전체 열 너비 자동 맞춤으로 시작한다(2026-10-07 요청 — 예전 저장 너비보다 우선).
// 글꼴이 늦게 로드되면 글자 폭이 바뀌므로, 그 사이 사람이 너비를 바꾸지 않았으면 한 번 더 맞춘다.
fitAll();
if (document.fonts && document.fonts.status !== "loaded") {
document.fonts.ready.then(function () { if (!widthTouched && table.isConnected) fitAll(); });
}
function widthItems(td) {
const key = keyOf(td);
return key ? [
{ label: "현재 열 너비 자동 맞춤", icon: opts.icon("fit_width"), onClick: () => fit(key) },
{ label: "전체 열 너비 자동 맞춤", icon: opts.icon("width"), onClick: fitAll },
] : [];
}
const growingCells = new Set();
let growFrame = 0;
function queueCellGrowth(e) {
const field = e.target.closest("input, textarea, [contenteditable='true']");
const td = field && field.closest("td, th");
if (!admin || !td || !table.contains(td)) return;
growingCells.add(td);
if (growFrame) return;
growFrame = requestAnimationFrame(function () {
growFrame = 0; let changed = false;
growingCells.forEach(function (cell) {
if (!table.contains(cell)) return;
const keys = (cell.dataset.meetCols || "").split(",").filter(Boolean), key = keys.at(-1);
if (!key) return;
const width = measure(cell) - keys.slice(0, -1).reduce((sum, k) => sum + widths[k], 0);
if (width > widths[key]) { widths[key] = width; changed = true; }
});
growingCells.clear();
if (changed) { applyWidths(); saveWidths(); }
});
}
table.addEventListener("input", queueCellGrowth);
table.addEventListener("compositionend", queueCellGrowth);
table.addEventListener("dblclick", function (e) {
const h = e.target.closest(".pj-meet-colresize");
if (h) { e.preventDefault(); e.stopPropagation(); fit(h.dataset.col); }
});
table.addEventListener("mousedown", function (e) {
const h = e.target.closest(".pj-meet-colresize");
if (!h || e.button !== 0) return;
e.preventDefault(); e.stopPropagation();
const key = h.dataset.col, x = e.clientX, before = widths[key];
widthTouched = true;
function move(ev) { widths[key] = Math.max(minWidth(key), Math.min(600, before + (ev.clientX - x) / opts.zoom())); applyWidths(); }
function stop() { document.removeEventListener("mousemove", move); document.removeEventListener("mouseup", stop); window.removeEventListener("blur", stop); saveWidths(); }
document.addEventListener("mousemove", move); document.addEventListener("mouseup", stop); window.addEventListener("blur", stop);
});
function paintSelection() {
table.querySelectorAll(".is-merge-sel,.is-goal-active").forEach(td => td.classList.remove("is-merge-sel", "is-goal-active"));
selected.forEach(td => td.classList.add("is-merge-sel"));
if (selected.length === 1) selected[0].classList.add("is-goal-active");
}
function select(a, b) {
if (!a || !b || a.closest("tbody") !== b.closest("tbody")) return;
const rows = Array.from(a.closest("tbody").rows);
const cells = Array.from(a.closest("tbody").querySelectorAll("td[data-meet-item]"));
let start = Math.min(rows.indexOf(a.parentElement), rows.indexOf(b.parentElement));
let end = Math.max(rows.indexOf(a.parentElement) + a.rowSpan - 1, rows.indexOf(b.parentElement) + b.rowSpan - 1);
cells.forEach(function (td) {
const i = rows.indexOf(td.parentElement);
if (i <= end && i + td.rowSpan - 1 >= start) { start = Math.min(start, i); end = Math.max(end, i + td.rowSpan - 1); }
});
selected = cells.filter(td => { const i = rows.indexOf(td.parentElement); return i <= end && i + td.rowSpan - 1 >= start; });
paintSelection();
}
function clearSelection() { selected = []; paintSelection(); }
async function locked(fields, work) {
if (busy || !saver) return;
busy = true;
const attrs = fields.map(e => e.getAttribute("contenteditable"));
fields.forEach(e => { e.setAttribute("contenteditable", "false"); e.closest("td").classList.add("is-goal-move-saving"); });
try { await saver.flush(); return await work(); }
catch (err) { opts.toast("셀 편집 실패: " + err.message + " — 입력 내용은 화면에 유지됩니다.", "error"); }
finally {
fields.forEach((e, i) => { e.setAttribute("contenteditable", attrs[i]); e.closest("td").classList.remove("is-goal-move-saving"); });
busy = false;
}
}
function moveCell(a, b) {
if (a === b) return;
const source = editorOf(a), target = editorOf(b);
return locked([source, target], async function () {
const sourceBody = source.value, targetBody = target.value;
if (!sourceBody) return;
if (targetBody && !await opts.confirm("대상 셀의 내용을 덮어쓸까요? 내용과 서식이 함께 이동합니다.", { okText: "덮어쓰기", cancelText: "취소" })) return;
const result = await opts.api("POST", "/project/api/goals/meeting-cells/move", {
source_item: a.dataset.meetItem, target_item: b.dataset.meetItem, source_body: sourceBody, target_body: targetBody,
});
saver.replace(source, ""); saver.replace(target, result.body); clearSelection(); select(b, b);
opts.toast("내용과 서식을 이동했습니다.");
});
}
function clearCells(cells) {
const fields = cells.map(editorOf).filter(e => e && e.value);
return locked(fields, async function () {
undo = fields.map(e => [e, e.value]);
fields.forEach(e => { e.value = ""; });
await Promise.all(fields.map(e => saver.save(e)));
opts.toast("내용을 지웠습니다 — Ctrl+Z로 되돌리기");
});
}
function undoClear() {
const previous = (undo || []).filter(([e]) => e.isConnected); undo = null;
return locked(previous.map(([e]) => e), async function () {
previous.forEach(([e, value]) => { e.value = value; });
await Promise.all(previous.map(([e]) => saver.save(e)));
});
}
function mergeCells(cells) {
const all = Array.from(table.querySelectorAll(".pj-meet-text"));
return locked(all, async function () {
await opts.api("POST", "/project/api/goals/meeting-cells/merge", { item_from: cells[0].dataset.meetItem, item_to: cells.at(-1).dataset.meetItem });
saver.reload();
});
}
function unmergeCells(cells) {
return locked(Array.from(table.querySelectorAll(".pj-meet-text")), async function () {
for (const td of cells) await opts.api("DELETE", "/project/api/goals/meeting-items/" + td.dataset.meetItem + "/cell-merge");
saver.reload();
});
}
function cancelMove() {
moveDrag = null;
table.querySelectorAll(".is-goal-move-target").forEach(td => td.classList.remove("is-goal-move-target"));
document.documentElement.classList.remove("pj-goal-moving");
}
if (admin) {
table.addEventListener("mousedown", function (e) {
if (e.defaultPrevented || e.button !== 0 || busy) return;
const td = editableCell(e.target); if (!td) return;
if (e.target.closest(".pj-goal-move-edge")) {
e.preventDefault(); e.stopPropagation(); rangeDrag = null;
moveDrag = { source: td, target: null }; document.documentElement.classList.add("pj-goal-moving"); return;
}
if (e.shiftKey && anchor && anchor !== td && anchor.closest("tbody") === td.closest("tbody")) {
e.preventDefault(); select(anchor, td); if (document.activeElement) document.activeElement.blur(); return;
}
anchor = td; select(td, td); rangeDrag = { start: td };
});
table.addEventListener("mouseover", function (e) {
if (!rangeDrag || moveDrag) return;
const td = editableCell(e.target);
if (!td || td === rangeDrag.start || td.closest("tbody") !== rangeDrag.start.closest("tbody")) return;
document.documentElement.classList.add("pj-goal-selecting");
if (document.activeElement) document.activeElement.blur();
window.getSelection().removeAllRanges(); select(rangeDrag.start, td);
});
document.addEventListener("mousemove", function (e) {
if (!moveDrag) return;
const td = editableCell(document.elementFromPoint(e.clientX, e.clientY));
table.querySelectorAll(".is-goal-move-target").forEach(c => c.classList.remove("is-goal-move-target"));
moveDrag.target = td && td !== moveDrag.source ? td : null;
if (moveDrag.target) moveDrag.target.classList.add("is-goal-move-target");
});
document.addEventListener("mouseup", function () {
rangeDrag = null; document.documentElement.classList.remove("pj-goal-selecting");
if (!moveDrag) return;
const { source, target } = moveDrag; cancelMove(); suppressClick = Date.now() + 300;
if (target) moveCell(source, target);
});
table.addEventListener("click", function (e) { if (busy || (Date.now() < suppressClick && editableCell(e.target))) { e.preventDefault(); e.stopImmediatePropagation(); } }, true);
document.addEventListener("keydown", function (e) {
if (e.key === "Escape") { cancelMove(); rangeDrag = null; clearSelection(); document.documentElement.classList.remove("pj-goal-selecting"); }
const active = document.activeElement;
if (busy || (active && (active.isContentEditable || active.matches("textarea,input,select")))) return;
if (e.key === "Delete" && selected.length) { e.preventDefault(); clearCells(selected.slice()); }
else if ((e.ctrlKey || e.metaKey) && !e.shiftKey && e.key.toLowerCase() === "z" && undo) { e.preventDefault(); undoClear(); }
});
window.addEventListener("blur", function () { cancelMove(); rangeDrag = null; document.documentElement.classList.remove("pj-goal-selecting"); });
document.addEventListener("mousedown", function (e) { if (!editableCell(e.target) && !e.target.closest(".pj-ctxmenu,.pj-goal-format")) clearSelection(); }, true);
}
table.addEventListener("contextmenu", function (e) {
if (busy) { e.preventDefault(); e.stopImmediatePropagation(); return; }
const td = e.target.closest("td,th"); if (!td || !table.contains(td)) return;
if (admin && td.matches("th.pj-meet-c-label")) return; // 기존 줄 메뉴에 너비 항목을 붙인다.
const cell = admin && editableCell(td), items = [];
if (cell) {
if (!selected.includes(cell)) select(cell, cell);
const cells = selected.slice(), merged = cells.filter(c => c.rowSpan > 1);
if (table.dataset.cellMerges === "true" && cells.length > 1) items.push({ label: "셀 병합 (세로)", icon: opts.icon("cell_merge"), onClick: () => mergeCells(cells) });
if (merged.length) items.push({ label: "병합 해제", icon: opts.icon("call_split"), onClick: () => unmergeCells(merged) });
if (cells.some(c => editorOf(c).value)) items.push({ label: "내용 지우기 (Del)", icon: opts.icon("ink_eraser"), onClick: () => clearCells(cells) });
if (saver) {
items.push(null,
{ label: "위에 줄 추가", icon: opts.icon("add_row_above"), onClick: () => saver.addRow(cell.closest("tbody").dataset.section, cell.dataset.meetItem, "above") },
{ label: "아래에 줄 추가", icon: opts.icon("add_row_below"), onClick: () => {
const rows = Array.from(cell.closest("tbody").rows), bottom = rows[rows.indexOf(cell.parentElement) + cell.rowSpan - 1];
saver.addRow(cell.closest("tbody").dataset.section, bottom.dataset.item, "below");
} });
}
}
if (items.length) items.push(null);
items.push(...widthItems(td));
if (items.length) { e.preventDefault(); opts.menu(e.clientX, e.clientY, items); }
});
return { bindSaver: s => { saver = s; }, widthItems: widthItems };
}
window.PJMeetingCells = { init: init };
})();
+19
View File
@@ -0,0 +1,19 @@
/* 오른쪽 회의록 안의 주차·달 이동도 왼쪽 메뉴를 유지하도록 부모 화면에 전달한다. */
(function () {
"use strict";
if (window.parent === window) return;
document.addEventListener("click", function (event) {
const link = event.target.closest("a[href]");
if (!link || event.defaultPrevented || event.button || event.ctrlKey || event.metaKey || event.shiftKey || event.altKey) return;
const url = new URL(link.href, location.href);
if (url.origin !== location.origin) return;
if (/^\/project\/goals\/\d{4}\/meetings\/\d{1,2}$/.test(url.pathname)) {
event.preventDefault();
url.searchParams.delete("content");
window.parent.postMessage({ type: "pj-meeting-navigate", href: url.href }, location.origin);
} else if (/^\/project\/goals\/\d{4}$/.test(url.pathname)) {
// 연간 목표로 돌아갈 때는 중첩 메뉴가 생기지 않도록 바깥 화면에서 연다.
link.target = "_top";
}
});
})();
+40
View File
@@ -0,0 +1,40 @@
(function () {
"use strict";
const button = document.getElementById("pj-options-btn"), dialog = document.getElementById("pj-options-dialog");
if (!button || !dialog || button.dataset.bound) return;
button.dataset.bound = "1";
const names = { system: null, pretendard: "Pretendard Variable", "nanum-square": "NanumSquare",
"nanum-square-neo": "NanumSquareNeo", "nanum-square-round": "NanumSquareRound" };
const select = document.getElementById("pj-options-font"), preview = document.getElementById("pj-options-preview");
const error = document.getElementById("pj-options-error"), save = document.getElementById("pj-options-save");
const cancel = document.getElementById("pj-options-cancel");
function current() { const v = document.documentElement.dataset.pjFont; return Object.hasOwn(names, v) ? v : "system"; }
function paint() {
const font = names[select.value];
preview.style.fontFamily = font ? '"' + font + '", sans-serif' : "var(--pj-system-font)";
}
button.addEventListener("click", function () {
select.value = current(); error.hidden = true; paint(); dialog.showModal(); select.focus();
});
select.addEventListener("change", paint);
cancel.addEventListener("click", function () { if (!save.disabled) dialog.close(); });
dialog.addEventListener("cancel", function (e) { if (save.disabled) e.preventDefault(); });
dialog.addEventListener("close", function () { button.focus(); });
document.getElementById("pj-options-form").addEventListener("submit", async function (e) {
e.preventDefault(); if (save.disabled) return;
const value = select.value, font = names[value];
if (!Object.hasOwn(names, value)) return;
save.disabled = select.disabled = cancel.disabled = true; error.hidden = true;
try {
if (font && document.fonts) {
const loaded = await Promise.all([document.fonts.load('400 14px "' + font + '"', "가나다 Project"), document.fonts.load('700 14px "' + font + '"', "가나다 Project")]);
if (loaded.some(function (list) { return !list.length; })) throw new Error("폰트를 불러오지 못했습니다. 다시 시도해 주세요.");
}
localStorage.setItem("pj_font", value);
document.documentElement.dataset.pjFont = value;
window.dispatchEvent(new Event("resize"));
dialog.close();
} catch (err) { error.textContent = "설정을 저장하지 못했습니다. " + err.message; error.hidden = false; }
finally { save.disabled = select.disabled = cancel.disabled = false; }
});
})();
+1039 -144
View File
File diff suppressed because it is too large Load Diff
+3551 -478
View File
File diff suppressed because it is too large Load Diff
+34 -3
View File
@@ -87,8 +87,9 @@ a { color: inherit; text-decoration: none; }
.brand-logo-mark svg { color: #fff; }
/* 로그인 왼쪽 위 로고 — 가로 100px, 세로는 비율대로 */
.brand-logo-img {
width: auto;
width: 100px;
height: auto;
}
@@ -705,13 +706,43 @@ a { color: inherit; text-decoration: none; }
color: rgba(255, 255, 255, .9);
letter-spacing: 4px;
text-transform: none;
top: 28%;
right: 7%;
top: 30%;
right: 26%;
z-index: 2;
animation: kingFloat 13s ease-in-out infinite, kingSparkle 2.4s ease-in-out infinite;
white-space: nowrap;
user-select: none;
}
/* King 주위를 도는 사용자 아이디 — 위치·크기·투명도는 login.html 스크립트가 매 프레임 정한다 */
.shape-orbit {
top: 0;
left: 0;
font-size: 24px; /* King(30px)의 80% — 앞쪽에서 이 크기, 뒤쪽은 스크립트가 75%까지 줄인다 */
font-weight: 700;
letter-spacing: 2px;
color: rgba(255, 255, 255, .88);
white-space: nowrap;
user-select: none;
will-change: transform, opacity;
/* King 과 같은 반짝임(빛 번짐만 — 투명도는 앞뒤 깊이로 스크립트가 정함). 시작 시점은 사람마다 무작위 */
animation: orbitSparkle 2.4s ease-in-out infinite;
}
@keyframes orbitSparkle {
0%, 100% {
text-shadow:
0 0 8px rgba(255, 255, 255, .6),
0 0 18px rgba(99, 179, 237, .5);
}
50% {
text-shadow:
0 0 16px rgba(255, 255, 255, 1),
0 0 36px rgba(99, 179, 237, 1),
0 0 56px rgba(147, 197, 253, .9),
0 0 80px rgba(59, 130, 246, .6);
}
}
@keyframes shapeFloat1 {
0%, 100% { transform: translate(0, 0); }
25% { transform: translate(-22px, 32px); }
Binary file not shown.
+98
View File
@@ -0,0 +1,98 @@
NanumSquare — Copyright 2016 NAVER Corporation. Font designed by Sandoll Communications Inc.
NanumSquareNeo — Copyright 2022 NAVER Corp. Font Designed by Sandoll Inc.
NanumSquareRound — Copyright 2017 NAVER Corporation. Font designed by Sandoll Communications Inc.
Original copyright notices embedded in the unmodified fonts are reproduced in the accompanying *.LICENSE.txt files.
This Font Software is licensed under the SIL Open Font License, Version 1.1.
This license is copied below, and is also available with a FAQ at:
http://scripts.sil.org/OFL
## SIL OPEN FONT LICENSE
Version 1.1 - 26 February 2007
## PREAMBLE
The goals of the Open Font License (OFL) are to stimulate worldwide
development of collaborative font projects, to support the font creation
efforts of academic and linguistic communities, and to provide a free and
open framework in which fonts may be shared and improved in partnership
with others.
The OFL allows the licensed fonts to be used, studied, modified and
redistributed freely as long as they are not sold by themselves. The
fonts, including any derivative works, can be bundled, embedded,
redistributed and/or sold with any software provided that any reserved
names are not used by derivative works. The fonts and derivatives,
however, cannot be released under any other type of license. The
requirement for fonts to remain under this license does not apply
to any document created using the fonts or their derivatives.
## DEFINITIONS
"Font Software" refers to the set of files released by the Copyright
Holder(s) under this license and clearly marked as such. This may
include source files, build scripts and documentation.
"Reserved Font Name" refers to any names specified as such after the
copyright statement(s).
"Original Version" refers to the collection of Font Software components as
distributed by the Copyright Holder(s).
"Modified Version" refers to any derivative made by adding to, deleting,
or substituting -- in part or in whole -- any of the components of the
Original Version, by changing formats or by porting the Font Software to a
new environment.
"Author" refers to any designer, engineer, programmer, technical
writer or other person who contributed to the Font Software.
## PERMISSION & CONDITIONS
Permission is hereby granted, free of charge, to any person obtaining
a copy of the Font Software, to use, study, copy, merge, embed, modify,
redistribute, and sell modified and unmodified copies of the Font
Software, subject to the following conditions:
1) Neither the Font Software nor any of its individual components,
in Original or Modified Versions, may be sold by itself.
2) Original or Modified Versions of the Font Software may be bundled,
redistributed and/or sold with any software, provided that each copy
contains the above copyright notice and this license. These can be
included either as stand-alone text files, human-readable headers or
in the appropriate machine-readable metadata fields within text or
binary files as long as those fields can be easily viewed by the user.
3) No Modified Version of the Font Software may use the Reserved Font
Name(s) unless explicit written permission is granted by the corresponding
Copyright Holder. This restriction only applies to the primary font name as
presented to the users.
4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
Software shall not be used to promote, endorse or advertise any
Modified Version, except to acknowledge the contribution(s) of the
Copyright Holder(s) and the Author(s) or with their explicit written
permission.
5) The Font Software, modified or unmodified, in part or in whole,
must be distributed entirely under this license, and must not be
distributed under any other license. The requirement for fonts to
remain under this license does not apply to any document created
using the Font Software.
##TERMINATION
This license becomes null and void if any of the above conditions are
not met.
##DISCLAIMER
THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
OTHER DEALINGS IN THE FONT SOFTWARE.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1 @@
Copyright © 2022 NAVER Corp. All rights reserved. Font Designed by Sandoll Inc.
Binary file not shown.
@@ -0,0 +1,5 @@
Copyright ®œ 2016 NAVER Corporation. All rights reserved. Font designed by Sandoll Communications Inc.
NAVER Corporation
www.navercorp.com
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -0,0 +1,5 @@
Copyright ®œ 2017 NAVER Corporation. All rights reserved. Font designed by Sandoll Communications Inc.
NAVER Corporation
http://www.navercorp.com

Some files were not shown because too many files have changed in this diff Show More