메뉴
Per-tab editState on opened workspace documents: preview (read-only) vs edit (inputs). Use when adding DocumentWorkspacePage fields, tab session state, or opened_documents snapshot columns.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Runs and extends Fantasia Archive tests: Vitest unit tests vs Playwright component and E2E tests, including rebuild-before-Playwright rules and file naming. Use when writing tests, debugging CI, or when the user mentions Vitest, Playwright, component tests, or e2e.
Maintains the English in-app changelog at i18n/en-US/documents/changeLog.md in strict sync with package.json version, without any automatic version bumping. Changelog text must be user- or release-relevant only—never internal QA, Git meta (commits/pushes), or “updated changelog”. Prefer editing the log in the same commit as the work, before push. Use after substantive app, UX, or user-facing docs changes, or when the user asks for release notes.
Default post-edit verification for Fantasia Archive agents: ESLint on touched paths, full vue-tsc, stylelint on touched styles, and yarn vitest run only on specs connected to the edit batch. Full yarn testbatch:verify is reserved for final cleanup, git commit, and explicit user requests. Use after substantive code edits before reporting work done.
Sets up and runs Fantasia Archive locally using Yarn, Node.js 22.22 or newer, and Quasar Electron mode. Use when installing dependencies, choosing dev vs production build commands, or when the user mentions environment setup, CLI, or first run.
Works on Fantasia Archive Electron main process: app lifecycle, window management, platform tweaks, native integrations, and ipcMain registration (register*Ipc + electron-ipc-bridge channel names). Use when editing electron-main.ts, src-electron/mainScripts/, or main-side tests.
Extends or fixes renderer-facing Electron APIs exposed through the preload script and contextBridge. Use when adding IPC-like surface area, typing window.faContentBridgeAPIs, editing src-electron/contentBridgeAPIs, or extending shared IPC channel names in electron-ipc-bridge.ts.
| name | fantasia-document-workspace-edit-state |
| description | Per-tab editState on opened workspace documents: preview (read-only) vs edit (inputs). Use when adding DocumentWorkspacePage fields, tab session state, or opened_documents snapshot columns. |
Opened document tabs distinguish preview mode (browsing, read-only) from edit mode (editing). Default = preview (editState: false).
Users should see document content without accidental edits until they explicitly enter edit mode (toggle UI future work).
| Piece | Location |
|---|---|
| Tab field | I_faOpenedDocumentTab.editState — types/I_faOpenedDocumentsDomain.ts |
| Default constant | FA_OPENED_DOCUMENT_DEFAULT_EDIT_STATE (false) |
| New tab seed | createFaOpenedDocumentTabFromOpenMeta in faOpenedDocumentsStoreActions.ts |
| Persist | faOpenedDocumentsSnapshotSchema — editState per tab; Zod .default(false) for legacy JSON |
| Store | S_FaOpenedDocuments — session + debounced SQLite write |
src/scripts/openedDocuments/functions/openedDocumentEditStateDomain.ts
Use these in managers / store wiring; inject into page composable factories (level-1 functions/ cannot value-import project modules).
documentShowsPreview → read-only blocks (h4 title for name today)
documentShowsEditFields → q-input and future editors
Both derive from active route tab editState via createUseDocumentWorkspacePage.
<section v-if="documentShowsPreview" data-test-locator="documentWorkspacePage-<field>-preview">
<!-- read-only value -->
</section>
<q-input
v-if="documentShowsEditFields"
data-test-locator="documentWorkspacePage-<field>-input"
...
/>
Replace <field> with stable test slug. Keep preview and edit locators distinct.
openedDocumentEditStateDomain.vitest.test.ts — flags + display name + normalizecreateUseDocumentWorkspacePage.vitest.test.ts — preview vs edit visibilityeditState: false unless testing edit branchProjectDocumentControlBar fixed strip projectDocumentControlBar__wrapper / __right:
| Button | Icon | Visible when | Color |
|---|---|---|---|
| Edit | mdi-file-document-edit | Preview + document route + active tab | primary-bright outline |
| Save without exiting edit mode | mdi-content-save-edit | Edit mode | primary-bright if clean, teal-14 if hasUnsavedChanges |
| Save | mdi-content-save | Edit mode | same as save-without-exit |
Store: enterDocumentEditMode, saveDocumentDisplayName(documentId, { keepEditMode }) — save uses projectContent.updateDocument, queues S_FaProjectHierarchyTree.refreshDocumentsInTree (tree session reloads sibling bucket + re-applies expand state), exits preview when keepEditMode: false.
editState for now)