Commit @9e8c4cea4806d08c896f3956c32015de3920d75c

4dee05f

9e8c4ce

frontend/src/App.tsx

--- frontend/src/App.tsx

+++ frontend/src/App.tsx


 import OrgOverview from './components/OrgOverview'
 import ProjectsPage from './components/ProjectsPage'
 import SeedUpload from './components/SeedUpload'
+import SharedFiles from './components/SharedFiles'
 import Sidebar from './components/Sidebar'
 import SystemPage from './components/SystemPage'
 import { CodeProvider } from './codes/CodeProvider'

 // 화면 4개: Dashboard(전체 기관 현황 - 좌측 기관 목록 없이 전폭으로 쓴다),
 // 기관관리(시안 레이아웃의 기관 상세), 채널관리(명부 시드 + 담당자 배정 + 채널 생성),
 // 담당자관리(담당자 3종 CRUD - 담당자 정보가 입력되는 유일한 화면).
-type Page = 'dashboard' | 'orgs' | 'channels' | 'contacts' | 'projects' | 'system'
+type Page = 'dashboard' | 'orgs' | 'channels' | 'contacts' | 'projects' | 'files' | 'system'
 
 const PAGE_TITLE: Record<Page, string> = {
   dashboard: 'Dashboard',

   channels: '채널관리',
   contacts: '담당자관리',
   projects: '사업관리',
+  files: '자료실',
   system: '시스템관리',
 }
 

             key === 'channels' ||
             key === 'contacts' ||
             key === 'projects' ||
+            key === 'files' ||
             key === 'system'
           ) {
             setPage(key)

         </header>
 
         <div className="flex min-h-0 flex-1">
-          {page !== 'contacts' && page !== 'dashboard' && page !== 'system' && page !== 'projects' && (
+          {page !== 'contacts' && page !== 'dashboard' && page !== 'system'
+            && page !== 'projects' && page !== 'files' && (
             <div
               className={`flex shrink-0 flex-col border-r border-gray-200 transition-all duration-200 ${
                 listCollapsed ? 'w-14' : 'w-80'

                   setPage('orgs')
                 }}
               />
+            ) : page === 'files' ? (
+              <SharedFiles />
             ) : page === 'system' ? (
               <SystemPage onChanged={() => void reload()} />
             ) : page === 'contacts' ? (

4dee05f

9e8c4ce

frontend/src/api/client.ts

--- frontend/src/api/client.ts

+++ frontend/src/api/client.ts

...	...	@@ -171,6 +171,58 @@
171	171	return request<CodeMap>('/api/meta/codes')
172	172	}
173	173
	174	+/** 자료실에 올려둔 공용 서식(요구사항 [26]). 기관에 딸리지 않는다. */
	175	+export interface SharedFile {
	176	+ id: number
	177	+ fileName: string
	178	+ description: string \| null
	179	+ byteSize: number
	180	+ uploadedBy: string
	181	+ uploadedAt: number
	182	+}
	183	+
	184	+export function getSharedFiles(): Promise<SharedFile[]> {
	185	+ return request<SharedFile[]>('/api/shared-files')
	186	+}
	187	+
	188	+export async function addSharedFile(file: File, description: string): Promise<SharedFile[]> {
	189	+ const form = new FormData()
	190	+ form.append('file', file)
	191	+ if (description) {
	192	+ form.append('description', new Blob([description], { type: 'text/plain' }))
	193	+ }
	194	+ const res = await fetch('/api/shared-files', {
	195	+ method: 'POST',
	196	+ headers: { 'X-XSRF-TOKEN': csrfToken() },
	197	+ credentials: 'same-origin',
	198	+ body: form,
	199	+ })
	200	+ if (!res.ok) {
	201	+ throw new ApiError(res.status, `자료 업로드 실패 (${res.status}): ${await res.text()}`)
	202	+ }
	203	+ return res.json() as Promise<SharedFile[]>
	204	+}
	205	+
	206	+export function updateSharedFileDescription(id: number, description: string): Promise<SharedFile[]> {
	207	+ return request<SharedFile[]>(`/api/shared-files/${id}`, {
	208	+ method: 'PUT',
	209	+ headers: { 'Content-Type': 'application/json' },
	210	+ body: JSON.stringify({ description }),
	211	+ })
	212	+}
	213	+
	214	+export async function deleteSharedFile(id: number): Promise<void> {
	215	+ await fetch(`/api/shared-files/${id}`, {
	216	+ method: 'DELETE',
	217	+ headers: { 'X-XSRF-TOKEN': csrfToken() },
	218	+ credentials: 'same-origin',
	219	+ })
	220	+}
	221	+
	222	+export function sharedFileDownloadUrl(id: number): string {
	223	+ return `/api/shared-files/${id}`
	224	+}
	225	+
174	226	/** RE 메모 한 건. 요구사항 [4]대로 메모 1개가 RE 1개다. */
175	227	export interface ReMemo {
176	228	id: number

9e8c4ce

frontend/src/components/SharedFiles.tsx (added)

+++ frontend/src/components/SharedFiles.tsx

...	...	@@ -0,0 +1,213 @@
	1	+import { useEffect, useRef, useState } from 'react'
	2	+import {
	3	+ addSharedFile,
	4	+ deleteSharedFile,
	5	+ getSharedFiles,
	6	+ sharedFileDownloadUrl,
	7	+ updateSharedFileDescription,
	8	+ type SharedFile,
	9	+} from '../api/client'
	10	+
	11	+/**
	12	+ * 자료실 — 공용 양식 보관소(요구사항 [26]).
	13	+ *
	14	+ * 기관에 딸리지 않는 서식을 여기 올려 두고, 어느 기관 일을 하든 내려받아 씁니다.
	15	+ * 기관별 자료는 기관관리 > 자료 탭에 그대로 있습니다.
	16	+ */
	17	+function formatSize(bytes: number): string {
	18	+ if (bytes < 1024) {
	19	+ return `${bytes} B`
	20	+ }
	21	+ if (bytes < 1024 * 1024) {
	22	+ return `${(bytes / 1024).toFixed(1)} KB`
	23	+ }
	24	+ return `${(bytes / 1024 / 1024).toFixed(1)} MB`
	25	+}
	26	+
	27	+function formatDate(ms: number): string {
	28	+ const d = new Date(ms)
	29	+ const pad = (n: number) => String(n).padStart(2, '0')
	30	+ return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
	31	+}
	32	+
	33	+export default function SharedFiles() {
	34	+ const [files, setFiles] = useState<SharedFile[]>([])
	35	+ const [loading, setLoading] = useState(true)
	36	+ const [error, setError] = useState<string \| null>(null)
	37	+ const [busy, setBusy] = useState(false)
	38	+ const [description, setDescription] = useState('')
	39	+ const [editingId, setEditingId] = useState<number \| null>(null)
	40	+ const [editingText, setEditingText] = useState('')
	41	+ const inputRef = useRef<HTMLInputElement>(null)
	42	+
	43	+ async function load() {
	44	+ setLoading(true)
	45	+ try {
	46	+ setFiles(await getSharedFiles())
	47	+ setError(null)
	48	+ } catch (e) {
	49	+ setError((e as Error).message)
	50	+ } finally {
	51	+ setLoading(false)
	52	+ }
	53	+ }
	54	+
	55	+ useEffect(() => {
	56	+ void load()
	57	+ }, [])
	58	+
	59	+ async function handleUpload(file: File) {
	60	+ setBusy(true)
	61	+ setError(null)
	62	+ try {
	63	+ setFiles(await addSharedFile(file, description.trim()))
	64	+ setDescription('')
	65	+ } catch (e) {
	66	+ setError((e as Error).message)
	67	+ } finally {
	68	+ setBusy(false)
	69	+ }
	70	+ }
	71	+
	72	+ async function handleDelete(file: SharedFile) {
	73	+ if (!window.confirm(`「${file.fileName}」을(를) 지울까요?`)) {
	74	+ return
	75	+ }
	76	+ setBusy(true)
	77	+ try {
	78	+ await deleteSharedFile(file.id)
	79	+ await load()
	80	+ } finally {
	81	+ setBusy(false)
	82	+ }
	83	+ }
	84	+
	85	+ async function saveDescription(file: SharedFile) {
	86	+ setBusy(true)
	87	+ try {
	88	+ setFiles(await updateSharedFileDescription(file.id, editingText.trim()))
	89	+ setEditingId(null)
	90	+ } catch (e) {
	91	+ setError((e as Error).message)
	92	+ } finally {
	93	+ setBusy(false)
	94	+ }
	95	+ }
	96	+
	97	+ return (
	98	+ <div className="p-8">
	99	+ <h2 className="text-sm font-semibold">자료실</h2>
	100	+ <p className="mt-1 text-xs text-gray-500">
	101	+ 기관에 딸리지 않는 공용 서식을 올려 둡니다. 기관별 자료는 기관관리 > 자료 탭에 있습니다.
	102	+ </p>
	103	+
	104	+ <div className="mt-4 flex flex-wrap items-center gap-2 rounded-lg border border-gray-200 p-3">
	105	+ <input
	106	+ type="text"
	107	+ aria-label="자료 설명"
	108	+ value={description}
	109	+ onChange={(e) => setDescription(e.target.value)}
	110	+ placeholder="설명(선택)"
	111	+ className="w-72 rounded-md border border-gray-300 px-2 py-1.5 text-sm"
	112	+ />
	113	+ <input
	114	+ ref={inputRef}
	115	+ type="file"
	116	+ className="hidden"
	117	+ onChange={(e) => {
	118	+ const file = e.target.files?.[0]
	119	+ if (file) void handleUpload(file)
	120	+ e.target.value = ''
	121	+ }}
	122	+ />
	123	+ <button
	124	+ type="button"
	125	+ disabled={busy}
	126	+ onClick={() => inputRef.current?.click()}
	127	+ className="rounded-md bg-blue-600 px-3 py-1.5 text-sm text-white disabled:bg-gray-300"
	128	+ >
	129	+ 자료 올리기
	130	+ </button>
	131	+ </div>
	132	+
	133	+ {error && <p className="mt-2 text-sm text-red-600">{error}</p>}
	134	+
	135	+ {loading ? (
	136	+ <p className="mt-4 text-sm text-gray-500">불러오는 중…</p>
	137	+ ) : files.length === 0 ? (
	138	+ <p className="mt-6 text-sm text-gray-500">올려둔 자료가 없습니다.</p>
	139	+ ) : (
	140	+ <table data-testid="shared-file-table" className="mt-4 w-full text-sm">
	141	+ <thead className="border-b border-gray-200 text-left text-xs text-gray-500">
	142	+ <tr>
	143	+ <th className="px-3 py-2 font-medium">파일명</th>
	144	+ <th className="px-3 py-2 font-medium">설명</th>
	145	+ <th className="whitespace-nowrap px-3 py-2 font-medium">크기</th>
	146	+ <th className="whitespace-nowrap px-3 py-2 font-medium">올린 사람</th>
	147	+ <th className="whitespace-nowrap px-3 py-2 font-medium">올린 날짜</th>
	148	+ <th className="px-3 py-2" />
	149	+ </tr>
	150	+ </thead>
	151	+ <tbody>
	152	+ {files.map((file) => (
	153	+ <tr key={file.id} className="border-b border-gray-100 last:border-b-0">
	154	+ <td className="px-3 py-2">
	155	+ <a
	156	+ href={sharedFileDownloadUrl(file.id)}
	157	+ className="font-medium text-blue-700 hover:underline"
	158	+ >
	159	+ {file.fileName}
	160	+ </a>
	161	+ </td>
	162	+ <td className="px-3 py-2 text-gray-600">
	163	+ {editingId === file.id ? (
	164	+ <div className="flex items-center gap-1.5">
	165	+ <input
	166	+ aria-label="설명 수정"
	167	+ value={editingText}
	168	+ onChange={(e) => setEditingText(e.target.value)}
	169	+ className="w-56 rounded-md border border-gray-300 px-2 py-1 text-sm"
	170	+ />
	171	+ <button
	172	+ type="button"
	173	+ disabled={busy}
	174	+ onClick={() => void saveDescription(file)}
	175	+ className="rounded-md border border-gray-300 px-2 py-0.5 text-xs"
	176	+ >
	177	+ 저장
	178	+ </button>
	179	+ </div>
	180	+ ) : (
	181	+ <button
	182	+ type="button"
	183	+ onClick={() => {
	184	+ setEditingId(file.id)
	185	+ setEditingText(file.description ?? '')
	186	+ }}
	187	+ className="text-left hover:underline"
	188	+ >
	189	+ {file.description ?? <span className="text-gray-300">설명 없음</span>}
	190	+ </button>
	191	+ )}
	192	+ </td>
	193	+ <td className="whitespace-nowrap px-3 py-2 text-gray-500">{formatSize(file.byteSize)}</td>
	194	+ <td className="whitespace-nowrap px-3 py-2 text-gray-500">{file.uploadedBy}</td>
	195	+ <td className="whitespace-nowrap px-3 py-2 text-gray-500">{formatDate(file.uploadedAt)}</td>
	196	+ <td className="px-3 py-2 text-right">
	197	+ <button
	198	+ type="button"
	199	+ disabled={busy}
	200	+ onClick={() => void handleDelete(file)}
	201	+ className="rounded-md border border-gray-300 px-2 py-0.5 text-xs text-red-600 hover:bg-red-50"
	202	+ >
	203	+ 삭제
	204	+ </button>
	205	+ </td>
	206	+ </tr>
	207	+ ))}
	208	+ </tbody>
	209	+ </table>
	210	+ )}
	211	+ </div>
	212	+ )
	213	+}

4dee05f

9e8c4ce

frontend/src/components/Sidebar.test.tsx

--- frontend/src/components/Sidebar.test.tsx

+++ frontend/src/components/Sidebar.test.tsx


     expect(onSelect).toHaveBeenCalledWith('channels')
   })
 
+  // 자료실은 요구사항 [26]으로 열렸다. 아직 준비 중인 메뉴는 권리확인·권리처리·Mattermost다.
   it('미구현 메뉴는 비활성으로 표시되고 링크가 아니다', () => {
     render(<Sidebar />)
 
-    const files = screen.getByText('자료실')
-    expect(files).toHaveAttribute('aria-disabled', 'true')
-    expect(files).toHaveAttribute('title', '준비 중')
-    expect(screen.queryByRole('link', { name: '자료실' })).toBeNull()
+    const mattermost = screen.getByText('Mattermost')
+    expect(mattermost).toHaveAttribute('aria-disabled', 'true')
+    expect(mattermost).toHaveAttribute('title', '준비 중')
+    expect(screen.queryByRole('link', { name: 'Mattermost' })).toBeNull()
+  })
+
+  it('자료실은 구현되어 링크로 열린다', () => {
+    const onSelect = vi.fn()
+    render(<Sidebar onSelect={onSelect} />)
+
+    fireEvent.click(screen.getByRole('link', { name: '자료실' }))
+
+    expect(onSelect).toHaveBeenCalledWith('files')
   })
 
   it('Dashboard는 구현되어 링크로 열린다', () => {

     expect(screen.getByText('IH')).toBeTruthy()
 
     expect(screen.getByRole('link', { name: '기관관리' })).toHaveAttribute('title', '기관관리')
-    expect(screen.getByTitle('자료실 (준비 중)')).toBeTruthy()
+    expect(screen.getByTitle('Mattermost (준비 중)')).toBeTruthy()
   })
 
   it('접기 버튼을 누르면 onToggle이 호출된다', () => {

4dee05f

9e8c4ce

frontend/src/components/Sidebar.tsx

--- frontend/src/components/Sidebar.tsx

+++ frontend/src/components/Sidebar.tsx


   },
   {
     key: 'files',
+    // 요구사항 [26]: 공용 양식 보관소. 기관에 딸리지 않는 서식을 여기 올려 둔다.
     label: '자료실',
-    enabled: false,
+    enabled: true,
     icon: (
       <svg className={ICON_CLASS} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2">
         <path d="M3 7h18v4H3zM5 11v9a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-9M10 15h4" />

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/config/AdminProperties.java

--- src/main/java/kr/itn/itnhub/config/AdminProperties.java

+++ src/main/java/kr/itn/itnhub/config/AdminProperties.java


 
 import org.springframework.boot.context.properties.ConfigurationProperties;
 
+/**
+ * @param displayName 업무메모·연락이력·보고서의 작성자로 찍히는 이름(요구사항 [22]).
+ *                    예전에는 로그인 아이디(admin)가 그대로 찍혔다. 비워 두면 아이디를 쓴다.
+ */
 @ConfigurationProperties(prefix = "app.admin")
-public record AdminProperties(String username, String password) {
+public record AdminProperties(String username, String password, String displayName) {
+
+    /** 화면에 보일 이름. 설정이 없으면 로그인 아이디로 떨어진다. */
+    public String displayNameOrUsername() {
+        return (displayName == null || displayName.isBlank()) ? username : displayName;
+    }
 
     // record 기본 toString()은 password를 그대로 노출한다. 로그에 실수로 찍혀도
     // 원문이 남지 않도록 마스킹한다.
     @Override
     public String toString() {
-        return "AdminProperties[username=%s, password=****]".formatted(username);
+        return "AdminProperties[username=%s, password=****, displayName=%s]"
+                .formatted(username, displayName);
     }
 }

9e8c4ce

src/main/java/kr/itn/itnhub/config/CurrentUser.java (added)

+++ src/main/java/kr/itn/itnhub/config/CurrentUser.java

...	...	@@ -0,0 +1,35 @@
	1	+package kr.itn.itnhub.config;
	2	+
	3	+import org.springframework.stereotype.Component;
	4	+
	5	+import java.security.Principal;
	6	+
	7	+/**
	8	+ * 기록에 남길 "작성자 이름"을 한 곳에서 정한다(요구사항 [22]).
	9	+ *
	10	+ * <p>예전에는 각 컨트롤러가 {@code principal.getName()}을 그대로 써서 업무메모·연락이력·
	11	+ * 보고서에 로그인 아이디(admin)가 찍혔다. 지금은 설정에 넣어둔 표시 이름을 쓴다.</p>
	12	+ *
	13	+ * <p>나중에 담당자별 계정이 생기면 여기만 고쳐서 각자의 이름이 찍히게 하면 된다.</p>
	14	+ */
	15	+@Component
	16	+public class CurrentUser {
	17	+
	18	+ private final AdminProperties admin;
	19	+
	20	+ public CurrentUser(AdminProperties admin) {
	21	+ this.admin = admin;
	22	+ }
	23	+
	24	+ /** 기록에 남길 이름. 로그인한 사람이 관리자면 설정된 표시 이름을 쓴다. */
	25	+ public String displayName(Principal principal) {
	26	+ if (principal == null) {
	27	+ return admin.displayNameOrUsername();
	28	+ }
	29	+ if (principal.getName().equals(admin.username())) {
	30	+ return admin.displayNameOrUsername();
	31	+ }
	32	+ // 관리자 외 계정이 생기면 그 계정의 아이디를 그대로 쓴다.
	33	+ return principal.getName();
	34	+ }
	35	+}

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/feed/ChannelFeedService.java

--- src/main/java/kr/itn/itnhub/feed/ChannelFeedService.java

+++ src/main/java/kr/itn/itnhub/feed/ChannelFeedService.java


     private final OrganizationMapper orgMapper;
     private final MattermostClient mattermost;
     private final MattermostProperties mattermostProps;
+    private final kr.itn.itnhub.stage.StageService stageService;
 
     public ChannelFeedService(OrganizationMapper orgMapper, MattermostClient mattermost,
-                               MattermostProperties mattermostProps) {
+                               MattermostProperties mattermostProps,
+                               kr.itn.itnhub.stage.StageService stageService) {
         this.orgMapper = orgMapper;
         this.mattermost = mattermost;
         this.mattermostProps = mattermostProps;
+        this.stageService = stageService;
     }
 
     public List<PostView> posts(Long orgId, String channel) {

         String postId = mattermost.createPost(channelId, message, fileIds);
         PostView post = fetchPost(channelId, postId, message);
 
+        // 요구사항 [18]: 채널에 자료가 올라가면 ②목록접수로 저절로 넘어간다.
+        // 파일이 실린 게시글만 계기로 본다 - 그냥 대화만 오간 것은 자료 접수가 아니다.
+        if (!fileIds.isEmpty()) {
+            stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.LIST_RECEIVED,
+                    kr.itn.itnhub.stage.AutoStage.REASON_LIST_RECEIVED);
+        }
+
         if (!notice) {
             return new SendResult(post, null);
         }

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/memo/WorkMemoController.java

--- src/main/java/kr/itn/itnhub/memo/WorkMemoController.java

+++ src/main/java/kr/itn/itnhub/memo/WorkMemoController.java


 public class WorkMemoController {
 
     private final WorkMemoService memoService;
+    private final kr.itn.itnhub.config.CurrentUser currentUser;
 
-    public WorkMemoController(WorkMemoService memoService) {
+    public WorkMemoController(WorkMemoService memoService,
+                              kr.itn.itnhub.config.CurrentUser currentUser) {
         this.memoService = memoService;
+        this.currentUser = currentUser;
     }
 
     @GetMapping("/api/orgs/{id}/memos")

         return memoService.list(id);
     }
 
-    /** 작성자는 본문에서 받지 않고 로그인 사용자(principal)를 서버가 직접 기록한다. */
+    /**
+     * 작성자는 본문에서 받지 않고 로그인 사용자를 서버가 직접 기록한다.
+     * 요구사항 [22]로 아이디가 아니라 표시 이름이 찍힌다.
+     */
     @PostMapping("/api/orgs/{id}/memos")
     public WorkMemo create(@PathVariable Long id, @Valid @RequestBody MemoRequest request,
                            Principal principal) {
-        return memoService.create(id, request, principal.getName());
+        return memoService.create(id, request, currentUser.displayName(principal));
     }
 
     @PutMapping("/api/orgs/{id}/memos/{memoId}")

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/process/ProcessImportService.java

--- src/main/java/kr/itn/itnhub/process/ProcessImportService.java

+++ src/main/java/kr/itn/itnhub/process/ProcessImportService.java


     private final ProcessParser parser;
     private final ProcessItemMapper mapper;
     private final OrganizationMapper orgMapper;
+    private final kr.itn.itnhub.stage.StageService stageService;
     private final TransactionTemplate transactionTemplate;
 
     public ProcessImportService(ProcessParser parser, ProcessItemMapper mapper, OrganizationMapper orgMapper,
+                                 kr.itn.itnhub.stage.StageService stageService,
                                  PlatformTransactionManager transactionManager) {
         this.parser = parser;
         this.mapper = mapper;
         this.orgMapper = orgMapper;
+        this.stageService = stageService;
         this.transactionTemplate = new TransactionTemplate(transactionManager);
     }
 

             throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);
         }
         List<ProcessRow> rows = parser.parse(xlsx);
-        return transactionTemplate.execute(status -> importRows(orgId, rows));
+        ProcessImportReport report = transactionTemplate.execute(status -> importRows(orgId, rows));
+
+        // 요구사항 [18]: 권리처리 자료가 올라오면 ⑧법률검토(권리처리)로 저절로 넘어간다.
+        // 이미 그보다 앞서 있으면 아무 일도 하지 않는다.
+        if (report != null && report.total() > 0) {
+            stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.PROCESS_STARTED,
+                    kr.itn.itnhub.stage.AutoStage.REASON_PROCESS_STARTED);
+        }
+        return report;
     }
 
     private ProcessImportReport importRows(Long orgId, List<ProcessRow> rows) {

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/project/ProjectController.java

--- src/main/java/kr/itn/itnhub/project/ProjectController.java

+++ src/main/java/kr/itn/itnhub/project/ProjectController.java


 public class ProjectController {
 
     private final ProjectService projectService;
+    private final kr.itn.itnhub.config.CurrentUser currentUser;
 
-    public ProjectController(ProjectService projectService) {
+    public ProjectController(ProjectService projectService,
+                             kr.itn.itnhub.config.CurrentUser currentUser) {
         this.projectService = projectService;
+        this.currentUser = currentUser;
     }
 
     @GetMapping("/api/projects")

     public List<ContactLog> addLog(@PathVariable("id") Long orgId,
                                    @Valid @RequestBody ContactLogRequest request,
                                    Principal principal) {
-        return projectService.addLog(orgId, request, principal.getName());
+        return projectService.addLog(orgId, request, currentUser.displayName(principal));
     }
 
     @PutMapping("/api/orgs/{id}/contact-logs/{logId}")

                                      Principal principal) throws IOException {
         String name = file.getOriginalFilename() == null ? "report" : file.getOriginalFilename();
         return projectService.addReport(orgId, name, file.getContentType(), file.getBytes(),
-                principal.getName());
+                currentUser.displayName(principal));
     }
 
     /** 한글 파일명이 깨지지 않게 ChannelFeedController.download와 같은 RFC 5987 인코딩을 쓴다. */

                                          Principal principal) throws IOException {
         String name = file.getOriginalFilename() == null ? "report" : file.getOriginalFilename();
         return projectService.replaceReport(orgId, reportId, name, file.getContentType(),
-                file.getBytes(), principal.getName());
+                file.getBytes(), currentUser.displayName(principal));
     }
 
     @ResponseStatus(HttpStatus.NO_CONTENT)

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/provision/ChannelProvisionService.java

--- src/main/java/kr/itn/itnhub/provision/ChannelProvisionService.java

+++ src/main/java/kr/itn/itnhub/provision/ChannelProvisionService.java


             }
             if (filled(current.getChannelIdMj()) && filled(current.getChannelIdLaw())) {
                 mapper.updateStage(orgId, 1);
-                stageHistoryMapper.insert(orgId, 1);
+                // 이것도 프로그램이 저절로 넣는 단계다(요구사항 [19]: 이력에 자동/수동 구분).
+                stageHistoryMapper.insert(orgId, 1, true, "채널 생성");
             }
         } catch (RuntimeException e) {
             log.warn("진행단계 자동 시작 실패 org={}", orgId, e);

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/review/ReviewImportService.java

--- src/main/java/kr/itn/itnhub/review/ReviewImportService.java

+++ src/main/java/kr/itn/itnhub/review/ReviewImportService.java


     private final ReviewParser parser;
     private final ReviewItemMapper mapper;
     private final OrganizationMapper orgMapper;
+    private final kr.itn.itnhub.stage.StageService stageService;
     private final TransactionTemplate transactionTemplate;
 
     public ReviewImportService(ReviewParser parser, ReviewItemMapper mapper, OrganizationMapper orgMapper,
+                                kr.itn.itnhub.stage.StageService stageService,
                                 PlatformTransactionManager transactionManager) {
         this.parser = parser;
         this.mapper = mapper;
         this.orgMapper = orgMapper;
+        this.stageService = stageService;
         this.transactionTemplate = new TransactionTemplate(transactionManager);
     }
 

             throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);
         }
         List<ReviewRow> rows = parser.parse(xlsx);
-        return transactionTemplate.execute(status -> importRows(orgId, rows));
+        ReviewImportReport report = transactionTemplate.execute(status -> importRows(orgId, rows));
+
+        // 요구사항 [18]: 권리확인 자료가 올라오면 ⑤법률검토(권리확인)로 저절로 넘어간다.
+        // 이미 그보다 앞서 있으면 아무 일도 하지 않는다.
+        if (report != null && report.total() > 0) {
+            stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.REVIEW_STARTED,
+                    kr.itn.itnhub.stage.AutoStage.REASON_REVIEW_STARTED);
+        }
+        return report;
     }
 
     private ReviewImportReport importRows(Long orgId, List<ReviewRow> rows) {

9e8c4ce

src/main/java/kr/itn/itnhub/shared/SharedFile.java (added)

+++ src/main/java/kr/itn/itnhub/shared/SharedFile.java

...	...	@@ -0,0 +1,15 @@
	1	+package kr.itn.itnhub.shared;
	2	+
	3	+/**
	4	+ * 자료실에 올려둔 공용 서식 한 건(요구사항 [26]: 공용 양식 보관소).
	5	+ *
	6	+ * <p>기관에 딸리지 않는다. 어느 기관 일을 하든 여기서 내려받아 쓴다.</p>
	7	+ */
	8	+public record SharedFile(
	9	+ Long id,
	10	+ String fileName,
	11	+ String description,
	12	+ long byteSize,
	13	+ String uploadedBy,
	14	+ Long uploadedAt) {
	15	+}

9e8c4ce

src/main/java/kr/itn/itnhub/shared/SharedFileController.java (added)

+++ src/main/java/kr/itn/itnhub/shared/SharedFileController.java

...	...	@@ -0,0 +1,86 @@
	1	+package kr.itn.itnhub.shared;
	2	+
	3	+import kr.itn.itnhub.config.CurrentUser;
	4	+import org.springframework.http.HttpHeaders;
	5	+import org.springframework.http.HttpStatus;
	6	+import org.springframework.http.MediaType;
	7	+import org.springframework.http.ResponseEntity;
	8	+import org.springframework.web.bind.annotation.DeleteMapping;
	9	+import org.springframework.web.bind.annotation.ExceptionHandler;
	10	+import org.springframework.web.bind.annotation.GetMapping;
	11	+import org.springframework.web.bind.annotation.PathVariable;
	12	+import org.springframework.web.bind.annotation.PostMapping;
	13	+import org.springframework.web.bind.annotation.PutMapping;
	14	+import org.springframework.web.bind.annotation.RequestBody;
	15	+import org.springframework.web.bind.annotation.RequestPart;
	16	+import org.springframework.web.bind.annotation.ResponseStatus;
	17	+import org.springframework.web.bind.annotation.RestController;
	18	+import org.springframework.web.multipart.MultipartFile;
	19	+
	20	+import java.io.IOException;
	21	+import java.net.URLEncoder;
	22	+import java.nio.charset.StandardCharsets;
	23	+import java.security.Principal;
	24	+import java.util.List;
	25	+import java.util.Map;
	26	+
	27	+/** 자료실. 기관에 딸리지 않는 공용 서식을 올려두고 내려받는다(요구사항 [26]). */
	28	+@RestController
	29	+public class SharedFileController {
	30	+
	31	+ private final SharedFileService service;
	32	+ private final CurrentUser currentUser;
	33	+
	34	+ public SharedFileController(SharedFileService service, CurrentUser currentUser) {
	35	+ this.service = service;
	36	+ this.currentUser = currentUser;
	37	+ }
	38	+
	39	+ @GetMapping("/api/shared-files")
	40	+ public List<SharedFile> list() {
	41	+ return service.list();
	42	+ }
	43	+
	44	+ @PostMapping("/api/shared-files")
	45	+ public List<SharedFile> add(@RequestPart("file") MultipartFile file,
	46	+ @RequestPart(value = "description", required = false) String description,
	47	+ Principal principal) throws IOException {
	48	+ String name = file.getOriginalFilename() == null ? "file" : file.getOriginalFilename();
	49	+ return service.add(name, description, file.getContentType(), file.getBytes(),
	50	+ currentUser.displayName(principal));
	51	+ }
	52	+
	53	+ @PutMapping("/api/shared-files/{id}")
	54	+ public List<SharedFile> updateDescription(@PathVariable Long id,
	55	+ @RequestBody Map<String, String> body) {
	56	+ return service.updateDescription(id, body.get("description"));
	57	+ }
	58	+
	59	+ /** 한글 파일명이 깨지지 않게 보고서 다운로드와 같은 RFC 5987 인코딩을 쓴다. */
	60	+ @GetMapping("/api/shared-files/{id}")
	61	+ public ResponseEntity<byte[]> download(@PathVariable Long id) {
	62	+ SharedFileMapper.Content found = service.content(id);
	63	+ String encodedName = URLEncoder.encode(found.fileName(), StandardCharsets.UTF_8)
	64	+ .replace("+", "%20");
	65	+ MediaType type = found.contentType() == null \|\| found.contentType().isBlank()
	66	+ ? MediaType.APPLICATION_OCTET_STREAM
	67	+ : MediaType.parseMediaType(found.contentType());
	68	+
	69	+ return ResponseEntity.ok()
	70	+ .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + encodedName)
	71	+ .contentType(type)
	72	+ .body(found.content());
	73	+ }
	74	+
	75	+ @ResponseStatus(HttpStatus.NO_CONTENT)
	76	+ @DeleteMapping("/api/shared-files/{id}")
	77	+ public void delete(@PathVariable Long id) {
	78	+ service.delete(id);
	79	+ }
	80	+
	81	+ @ResponseStatus(HttpStatus.BAD_REQUEST)
	82	+ @ExceptionHandler(IllegalArgumentException.class)
	83	+ public Map<String, String> handleBadRequest(IllegalArgumentException e) {
	84	+ return Map.of("message", e.getMessage());
	85	+ }
	86	+}

9e8c4ce

src/main/java/kr/itn/itnhub/shared/SharedFileMapper.java (added)

+++ src/main/java/kr/itn/itnhub/shared/SharedFileMapper.java

...	...	@@ -0,0 +1,27 @@
	1	+package kr.itn.itnhub.shared;
	2	+
	3	+import org.apache.ibatis.annotations.Mapper;
	4	+import org.apache.ibatis.annotations.Param;
	5	+
	6	+import java.util.List;
	7	+
	8	+@Mapper
	9	+public interface SharedFileMapper {
	10	+
	11	+ List<SharedFile> findAll();
	12	+
	13	+ int insert(@Param("fileName") String fileName, @Param("description") String description,
	14	+ @Param("contentType") String contentType, @Param("byteSize") long byteSize,
	15	+ @Param("content") byte[] content, @Param("uploadedBy") String uploadedBy);
	16	+
	17	+ /** 설명만 고친다. 파일을 바꾸려면 새로 올리고 지운다. */
	18	+ int updateDescription(@Param("id") Long id, @Param("description") String description);
	19	+
	20	+ Content findContent(@Param("id") Long id);
	21	+
	22	+ int delete(@Param("id") Long id);
	23	+
	24	+ /** 다운로드용. 파일 내용까지 읽는다. */
	25	+ record Content(String fileName, String contentType, byte[] content) {
	26	+ }
	27	+}

9e8c4ce

src/main/java/kr/itn/itnhub/shared/SharedFileService.java (added)

+++ src/main/java/kr/itn/itnhub/shared/SharedFileService.java

...	...	@@ -0,0 +1,60 @@
	1	+package kr.itn.itnhub.shared;
	2	+
	3	+import kr.itn.itnhub.org.OrgNotFoundException;
	4	+import org.springframework.stereotype.Service;
	5	+import org.springframework.transaction.annotation.Transactional;
	6	+
	7	+import java.util.List;
	8	+
	9	+/** 자료실(요구사항 [26]: 공용 양식 보관소)이 쓰는 서비스. */
	10	+@Service
	11	+public class SharedFileService {
	12	+
	13	+ private final SharedFileMapper mapper;
	14	+
	15	+ public SharedFileService(SharedFileMapper mapper) {
	16	+ this.mapper = mapper;
	17	+ }
	18	+
	19	+ public List<SharedFile> list() {
	20	+ return mapper.findAll();
	21	+ }
	22	+
	23	+ @Transactional
	24	+ public List<SharedFile> add(String fileName, String description, String contentType,
	25	+ byte[] content, String uploadedBy) {
	26	+ if (content == null \|\| content.length == 0) {
	27	+ throw new IllegalArgumentException("빈 파일은 올릴 수 없습니다.");
	28	+ }
	29	+ mapper.insert(fileName, blankToNull(description), contentType, content.length,
	30	+ content, uploadedBy);
	31	+ return mapper.findAll();
	32	+ }
	33	+
	34	+ @Transactional
	35	+ public List<SharedFile> updateDescription(Long id, String description) {
	36	+ if (mapper.updateDescription(id, blankToNull(description)) == 0) {
	37	+ throw new OrgNotFoundException("자료를 찾을 수 없습니다: " + id);
	38	+ }
	39	+ return mapper.findAll();
	40	+ }
	41	+
	42	+ public SharedFileMapper.Content content(Long id) {
	43	+ SharedFileMapper.Content found = mapper.findContent(id);
	44	+ if (found == null) {
	45	+ throw new OrgNotFoundException("자료를 찾을 수 없습니다: " + id);
	46	+ }
	47	+ return found;
	48	+ }
	49	+
	50	+ @Transactional
	51	+ public void delete(Long id) {
	52	+ if (mapper.delete(id) == 0) {
	53	+ throw new OrgNotFoundException("자료를 찾을 수 없습니다: " + id);
	54	+ }
	55	+ }
	56	+
	57	+ private String blankToNull(String value) {
	58	+ return (value == null \|\| value.isBlank()) ? null : value.trim();
	59	+ }
	60	+}

9e8c4ce

src/main/java/kr/itn/itnhub/stage/AutoStage.java (added)

+++ src/main/java/kr/itn/itnhub/stage/AutoStage.java

...	...	@@ -0,0 +1,25 @@
	1	+package kr.itn.itnhub.stage;
	2	+
	3	+/**
	4	+ * 자료가 올라온 것을 계기로 저절로 넘어가는 단계(요구사항 [18]).
	5	+ *
	6	+ * <p>기능확인 자료의 지시를 이 시스템의 실제 흐름에 맞춰 옮긴 것이다.
	7	+ * 어느 자료가 어느 단계에 해당하는지는 답변 문서에 적어 확인 요청해 두었다.</p>
	8	+ */
	9	+public final class AutoStage {
	10	+
	11	+ private AutoStage() {
	12	+ }
	13	+
	14	+ /** ②목록접수 — 기관 채널에 첫 자료가 올라갔을 때. */
	15	+ public static final int LIST_RECEIVED = 2;
	16	+ public static final String REASON_LIST_RECEIVED = "채널에 자료 업로드";
	17	+
	18	+ /** ⑤법률검토(권리확인) — 권리확인 자료가 올라갔을 때. */
	19	+ public static final int REVIEW_STARTED = 5;
	20	+ public static final String REASON_REVIEW_STARTED = "권리확인 자료 업로드";
	21	+
	22	+ /** ⑧법률검토(권리처리) — 권리처리 자료가 올라갔을 때. */
	23	+ public static final int PROCESS_STARTED = 8;
	24	+ public static final String REASON_PROCESS_STARTED = "권리처리 자료 업로드";
	25	+}

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/stage/StageHistoryMapper.java

--- src/main/java/kr/itn/itnhub/stage/StageHistoryMapper.java

+++ src/main/java/kr/itn/itnhub/stage/StageHistoryMapper.java


     /** 최신순. */
     List<StageHistoryRow> findByOrg(@Param("orgId") Long orgId);
 
-    int insert(@Param("orgId") Long orgId, @Param("stage") int stage);
+    int insert(@Param("orgId") Long orgId, @Param("stage") int stage,
+               @Param("auto") boolean auto, @Param("reason") String reason);
 
     /** 채널 초기화용. 단계가 null로 돌아가므로 이력을 남겨두면 어긋난다. */
     int deleteByOrg(@Param("orgId") Long orgId);

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/stage/StageHistoryRow.java

--- src/main/java/kr/itn/itnhub/stage/StageHistoryRow.java

+++ src/main/java/kr/itn/itnhub/stage/StageHistoryRow.java


 
     private int stage;
     private long changedAt;
+    /** 프로그램이 저절로 넘긴 것인지(요구사항 [19]: 이력에 자동/수동 구분 표시). */
+    private boolean auto;
+    /** 자동으로 넘어간 이유. 사람이 눌렀으면 null. */
+    private String reason;
 
     public int getStage() { return stage; }
     public void setStage(int stage) { this.stage = stage; }
 
     public long getChangedAt() { return changedAt; }
     public void setChangedAt(long changedAt) { this.changedAt = changedAt; }
+
+    public boolean isAuto() { return auto; }
+    public void setAuto(boolean auto) { this.auto = auto; }
+
+    public String getReason() { return reason; }
+    public void setReason(String reason) { this.reason = reason; }
 }

4dee05f

9e8c4ce

src/main/java/kr/itn/itnhub/stage/StageService.java

--- src/main/java/kr/itn/itnhub/stage/StageService.java

+++ src/main/java/kr/itn/itnhub/stage/StageService.java


         }
 
         orgMapper.updateStage(orgId, stage);
-        historyMapper.insert(orgId, stage);
+        // 사람이 눌러서 넘긴 것이다(요구사항 [19]: 이력에 자동/수동 구분).
+        historyMapper.insert(orgId, stage, false, null);
 
         return OrgResponse.of(orgMapper.findById(orgId));
     }
 
+    /**
+     * 자료가 올라온 것을 계기로 단계를 저절로 넘긴다(요구사항 [18]).
+     *
+     * <p>앞으로만 간다. 이미 목표 단계에 있거나 그보다 앞서 있으면 아무 일도 하지 않는다 -
+     * 자료를 다시 올렸다고 단계가 뒤로 밀리면 안 되기 때문이다.</p>
+     *
+     * <p>채널이 없어 단계가 아직 없는 기관(stage=null)도 건드리지 않는다. 채널 생성 시
+     * ①신청으로 들어오는 것이 먼저다.</p>
+     *
+     * <p>사람이 이 단계를 다시 되돌리는 것은 막지 않는다(요구사항 [19]: 되돌림 허용).
+     * 진행단계 변경에서 이전 단계를 고르면 그대로 내려간다.</p>
+     *
+     * @return 실제로 넘어갔으면 true
+     */
+    @Transactional
+    public boolean autoAdvance(Long orgId, int targetStage, String reason) {
+        Organization org = orgMapper.findById(orgId);
+        if (org == null || org.getStage() == null) {
+            return false;
+        }
+        if (org.getStage() >= targetStage) {
+            return false;
+        }
+        int lastStage = codeService.group(Codes.STAGE).size();
+        if (targetStage < 1 || targetStage > lastStage) {
+            return false;
+        }
+
+        orgMapper.updateStage(orgId, targetStage);
+        historyMapper.insert(orgId, targetStage, true, reason);
+        return true;
+    }
+
     public java.util.List<StageHistoryRow> history(Long orgId) {
         if (orgMapper.findById(orgId) == null) {
             throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);

4dee05f

9e8c4ce

src/main/resources/application.yml

--- src/main/resources/application.yml

+++ src/main/resources/application.yml

...	...	@@ -44,3 +44,6 @@
44	44	admin:
45	45	username: ${APP_ADMIN_USERNAME}
46	46	password: ${APP_ADMIN_PASSWORD}
	47	+ # 업무메모·연락이력·보고서에 작성자로 찍히는 이름(요구사항 [22]).
	48	+ # 비워 두면 로그인 아이디가 그대로 찍힌다.
	49	+ display-name: ${APP_ADMIN_DISPLAY_NAME:관리자}

9e8c4ce

src/main/resources/db/migration/V17__auto_stage_and_shared_files.sql (added)

+++ src/main/resources/db/migration/V17__auto_stage_and_shared_files.sql

...	...	@@ -0,0 +1,24 @@
	1	+-- 요구사항 [19] · [26] 반영.
	2	+
	3	+-- [19] 단계 이력에 "자동으로 넘어간 것인지" 표시를 남긴다.
	4	+-- 회신: 되돌림 허용 + 이력에 구분 표시.
	5	+-- 기존 이력은 전부 사람이 눌러서 넘긴 것이므로 false가 맞다.
	6	+alter table stage_history add column auto boolean not null default false;
	7	+
	8	+-- 자동 전환이 무엇 때문에 일어났는지 남긴다. 나중에 "왜 저절로 넘어갔지?"를 설명할 수 있어야 한다.
	9	+alter table stage_history add column reason varchar(100);
	10	+
	11	+-- [26] 자료실 = 공용 양식 보관소.
	12	+-- 기관에 딸리지 않는 공용 서식을 올려두는 자리다. 파일은 org_report와 같은 이유로
	13	+-- DB에 직접 담는다(Mattermost 채널을 초기화해도 사라지면 안 된다).
	14	+create table shared_file (
	15	+ id bigserial primary key,
	16	+ file_name varchar(300) not null,
	17	+ description varchar(500),
	18	+ content_type varchar(200),
	19	+ byte_size bigint not null,
	20	+ content bytea not null,
	21	+ uploaded_by varchar(100) not null,
	22	+ uploaded_at timestamptz not null default now()
	23	+);
	24	+create index ix_shared_file_recent on shared_file (uploaded_at desc, id desc);

9e8c4ce

src/main/resources/mapper/SharedFileMapper.xml (added)

+++ src/main/resources/mapper/SharedFileMapper.xml

...	...	@@ -0,0 +1,31 @@
	1	+<?xml version="1.0" encoding="UTF-8"?>
	2	+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
	3	+ "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
	4	+<mapper namespace="kr.itn.itnhub.shared.SharedFileMapper">
	5	+
	6	+ <!-- 목록에는 파일 내용을 싣지 않는다. 서식이 커지면 목록 조회가 무거워진다. -->
	7	+ <select id="findAll" resultType="kr.itn.itnhub.shared.SharedFile">
	8	+ select id, file_name, description, byte_size, uploaded_by,
	9	+ (extract(epoch from uploaded_at) * 1000)::bigint as uploaded_at
	10	+ from shared_file
	11	+ order by uploaded_at desc, id desc
	12	+ </select>
	13	+
	14	+ <insert id="insert">
	15	+ insert into shared_file (file_name, description, content_type, byte_size, content, uploaded_by)
	16	+ values (#{fileName}, #{description}, #{contentType}, #{byteSize}, #{content}, #{uploadedBy})
	17	+ </insert>
	18	+
	19	+ <update id="updateDescription">
	20	+ update shared_file set description = #{description} where id = #{id}
	21	+ </update>
	22	+
	23	+ <select id="findContent" resultType="kr.itn.itnhub.shared.SharedFileMapper$Content">
	24	+ select file_name, content_type, content from shared_file where id = #{id}
	25	+ </select>
	26	+
	27	+ <delete id="delete">
	28	+ delete from shared_file where id = #{id}
	29	+ </delete>
	30	+
	31	+</mapper>

4dee05f

9e8c4ce

src/main/resources/mapper/StageHistoryMapper.xml

--- src/main/resources/mapper/StageHistoryMapper.xml

+++ src/main/resources/mapper/StageHistoryMapper.xml


     changed_at을 밀리초 epoch로 내려준다 - WorkMemoMapper.created_at과 동일한 관례.
   -->
   <select id="findByOrg" resultType="kr.itn.itnhub.stage.StageHistoryRow">
-    select stage, (extract(epoch from changed_at) * 1000)::bigint as changed_at
+    select stage, (extract(epoch from changed_at) * 1000)::bigint as changed_at,
+           auto, reason
     from stage_history
     where org_id = #{orgId}
     order by changed_at desc, id desc
   </select>
 
+  <!-- auto=true면 프로그램이 저절로 넘긴 것이다(요구사항 [18][19]). reason에 계기를 남긴다. -->
   <insert id="insert">
-    insert into stage_history (org_id, stage)
-    values (#{orgId}, #{stage})
+    insert into stage_history (org_id, stage, auto, reason)
+    values (#{orgId}, #{stage}, #{auto}, #{reason})
   </insert>
 
   <!--

4dee05f

9e8c4ce

src/test/java/kr/itn/itnhub/memo/WorkMemoControllerTest.java

--- src/test/java/kr/itn/itnhub/memo/WorkMemoControllerTest.java

+++ src/test/java/kr/itn/itnhub/memo/WorkMemoControllerTest.java


                                 """))
                 .andExpect(status().isOk())
                 // 작성자는 요청 본문이 아니라 로그인 사용자에서 온다
-                .andExpect(jsonPath("$.contactName").value("admin"))
+                .andExpect(jsonPath("$.contactName").value("관리자"))
                 .andExpect(jsonPath("$.body").value("채널 생성 일정 문의"))
                 .andExpect(jsonPath("$.createdAt").isNumber());
 
         mvc.perform(get("/api/orgs/{id}/memos", orgId))
                 .andExpect(status().isOk())
-                .andExpect(jsonPath("$[0].contactName").value("admin"))
+                .andExpect(jsonPath("$[0].contactName").value("관리자"))
                 .andExpect(jsonPath("$[0].body").value("채널 생성 일정 문의"));
     }
 

                                 """))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.body").value("고친 뒤"))
-                .andExpect(jsonPath("$.contactName").value("admin"))
+                .andExpect(jsonPath("$.contactName").value("관리자"))
                 .andExpect(jsonPath("$.createdAt").value(createdAt));
     }
 

4dee05f

9e8c4ce

src/test/java/kr/itn/itnhub/project/ProjectControllerTest.java

--- src/test/java/kr/itn/itnhub/project/ProjectControllerTest.java

+++ src/test/java/kr/itn/itnhub/project/ProjectControllerTest.java


                                 """))
                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.length()").value(1))
-                .andExpect(jsonPath("$[0].author").value("admin"))
+                .andExpect(jsonPath("$[0].author").value("관리자"))
                 .andExpect(jsonPath("$[0].contactedOn").value("2026-07-20"));
 
         mvc.perform(post("/api/orgs/{id}/contact-logs", orgId).with(csrf())

                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$[0].summary").value("고침"))
                 .andExpect(jsonPath("$[0].method").value("방문"))
-                .andExpect(jsonPath("$[0].author").value("admin"));
+                .andExpect(jsonPath("$[0].author").value("관리자"));
     }
 
     @Test

                 .andExpect(status().isOk())
                 .andExpect(jsonPath("$.length()").value(1))
                 .andExpect(jsonPath("$[0].fileName").value("최종보고서.pdf"))
-                .andExpect(jsonPath("$[0].uploadedBy").value("admin"))
+                .andExpect(jsonPath("$[0].uploadedBy").value("관리자"))
                 .andReturn().getResponse().getContentAsString();
         int reportId = com.jayway.jsonpath.JsonPath.parse(uploaded).read("$[0].id", Integer.class);
 

9e8c4ce

src/test/java/kr/itn/itnhub/stage/AutoStageTest.java (added)

+++ src/test/java/kr/itn/itnhub/stage/AutoStageTest.java

...	...	@@ -0,0 +1,127 @@
	1	+package kr.itn.itnhub.stage;
	2	+
	3	+import kr.itn.itnhub.AbstractDbTest;
	4	+import kr.itn.itnhub.org.Organization;
	5	+import kr.itn.itnhub.org.OrganizationMapper;
	6	+import org.junit.jupiter.api.BeforeEach;
	7	+import org.junit.jupiter.api.Test;
	8	+import org.springframework.beans.factory.annotation.Autowired;
	9	+import org.springframework.jdbc.core.JdbcTemplate;
	10	+
	11	+import java.util.List;
	12	+
	13	+import static org.assertj.core.api.Assertions.assertThat;
	14	+
	15	+/**
	16	+ * 자료가 올라온 것을 계기로 단계가 저절로 넘어가는 규칙(요구사항 [18][19]).
	17	+ *
	18	+ * <p>핵심은 "앞으로만 간다"는 것이다. 자료를 다시 올렸다고 단계가 뒤로 밀리면 안 된다.</p>
	19	+ */
	20	+class AutoStageTest extends AbstractDbTest {
	21	+
	22	+ @Autowired
	23	+ StageService stageService;
	24	+
	25	+ @Autowired
	26	+ OrganizationMapper orgMapper;
	27	+
	28	+ @Autowired
	29	+ StageHistoryMapper historyMapper;
	30	+
	31	+ @Autowired
	32	+ JdbcTemplate jdbc;
	33	+
	34	+ private Long orgId;
	35	+
	36	+ @BeforeEach
	37	+ void setUp() {
	38	+ jdbc.update("delete from stage_history");
	39	+ jdbc.update("delete from organization where org_no = '930'");
	40	+
	41	+ Organization org = new Organization();
	42	+ org.setOrgNo("930");
	43	+ org.setOrgName("자동전환테스트기관");
	44	+ org.setChannelSlug("930");
	45	+ orgMapper.upsertBySeed(org);
	46	+ orgId = orgMapper.findByOrgNoAndOrgName("930", "자동전환테스트기관").getId();
	47	+ }
	48	+
	49	+ private void setStage(int stage) {
	50	+ orgMapper.updateStage(orgId, stage);
	51	+ historyMapper.insert(orgId, stage, false, null);
	52	+ }
	53	+
	54	+ @Test
	55	+ void 뒤에_있으면_앞으로_넘어간다() {
	56	+ setStage(1);
	57	+
	58	+ boolean moved = stageService.autoAdvance(orgId, AutoStage.REVIEW_STARTED,
	59	+ AutoStage.REASON_REVIEW_STARTED);
	60	+
	61	+ assertThat(moved).isTrue();
	62	+ assertThat(orgMapper.findById(orgId).getStage()).isEqualTo(AutoStage.REVIEW_STARTED);
	63	+ }
	64	+
	65	+ @Test
	66	+ void 이미_앞서_있으면_뒤로_밀지_않는다() {
	67	+ setStage(10);
	68	+
	69	+ boolean moved = stageService.autoAdvance(orgId, AutoStage.REVIEW_STARTED,
	70	+ AutoStage.REASON_REVIEW_STARTED);
	71	+
	72	+ assertThat(moved).isFalse();
	73	+ assertThat(orgMapper.findById(orgId).getStage()).isEqualTo(10);
	74	+ }
	75	+
	76	+ @Test
	77	+ void 같은_단계면_이력을_또_쌓지_않는다() {
	78	+ setStage(AutoStage.REVIEW_STARTED);
	79	+ int before = historyMapper.findByOrg(orgId).size();
	80	+
	81	+ boolean moved = stageService.autoAdvance(orgId, AutoStage.REVIEW_STARTED,
	82	+ AutoStage.REASON_REVIEW_STARTED);
	83	+
	84	+ assertThat(moved).isFalse();
	85	+ assertThat(historyMapper.findByOrg(orgId)).hasSize(before);
	86	+ }
	87	+
	88	+ @Test
	89	+ void 채널이_없어_단계가_아직_없으면_건드리지_않는다() {
	90	+ // 채널 생성으로 ①신청이 들어오는 것이 먼저다.
	91	+ boolean moved = stageService.autoAdvance(orgId, AutoStage.LIST_RECEIVED,
	92	+ AutoStage.REASON_LIST_RECEIVED);
	93	+
	94	+ assertThat(moved).isFalse();
	95	+ assertThat(orgMapper.findById(orgId).getStage()).isNull();
	96	+ }
	97	+
	98	+ @Test
	99	+ void 이력에_자동_여부와_계기가_남는다() {
	100	+ setStage(1);
	101	+ stageService.autoAdvance(orgId, AutoStage.PROCESS_STARTED, AutoStage.REASON_PROCESS_STARTED);
	102	+
	103	+ List<StageHistoryRow> history = historyMapper.findByOrg(orgId);
	104	+
	105	+ assertThat(history).hasSize(2);
	106	+ // 최신순이라 자동 전환이 앞에 온다.
	107	+ assertThat(history.get(0).getStage()).isEqualTo(AutoStage.PROCESS_STARTED);
	108	+ assertThat(history.get(0).isAuto()).isTrue();
	109	+ assertThat(history.get(0).getReason()).isEqualTo(AutoStage.REASON_PROCESS_STARTED);
	110	+ // 사람이 넣은 것은 자동이 아니다.
	111	+ assertThat(history.get(1).isAuto()).isFalse();
	112	+ assertThat(history.get(1).getReason()).isNull();
	113	+ }
	114	+
	115	+ @Test
	116	+ void 자동으로_올라간_단계를_사람이_되돌릴_수_있다() {
	117	+ // 요구사항 [19]: 되돌림 허용.
	118	+ setStage(1);
	119	+ stageService.autoAdvance(orgId, AutoStage.REVIEW_STARTED, AutoStage.REASON_REVIEW_STARTED);
	120	+ assertThat(orgMapper.findById(orgId).getStage()).isEqualTo(AutoStage.REVIEW_STARTED);
	121	+
	122	+ stageService.updateStage(orgId, new StageRequest(2));
	123	+
	124	+ assertThat(orgMapper.findById(orgId).getStage()).isEqualTo(2);
	125	+ assertThat(historyMapper.findByOrg(orgId).get(0).isAuto()).isFalse();
	126	+ }
	127	+}

...	...	@@ -8,6 +8,7 @@
8	8	import OrgOverview from './components/OrgOverview'
9	9	import ProjectsPage from './components/ProjectsPage'
10	10	import SeedUpload from './components/SeedUpload'
	11	+import SharedFiles from './components/SharedFiles'
11	12	import Sidebar from './components/Sidebar'
12	13	import SystemPage from './components/SystemPage'
13	14	import { CodeProvider } from './codes/CodeProvider'
...	...	@@ -16,7 +17,7 @@
16	17	// 화면 4개: Dashboard(전체 기관 현황 - 좌측 기관 목록 없이 전폭으로 쓴다),
17	18	// 기관관리(시안 레이아웃의 기관 상세), 채널관리(명부 시드 + 담당자 배정 + 채널 생성),
18	19	// 담당자관리(담당자 3종 CRUD - 담당자 정보가 입력되는 유일한 화면).
19		-type Page = 'dashboard' \| 'orgs' \| 'channels' \| 'contacts' \| 'projects' \| 'system'
	20	+type Page = 'dashboard' \| 'orgs' \| 'channels' \| 'contacts' \| 'projects' \| 'files' \| 'system'
20	21
21	22	const PAGE_TITLE: Record<Page, string> = {
22	23	dashboard: 'Dashboard',
...	...	@@ -24,6 +25,7 @@
24	25	channels: '채널관리',
25	26	contacts: '담당자관리',
26	27	projects: '사업관리',
	28	+ files: '자료실',
27	29	system: '시스템관리',
28	30	}
29	31
...	...	@@ -117,6 +119,7 @@
117	119	key === 'channels' \|\|
118	120	key === 'contacts' \|\|
119	121	key === 'projects' \|\|
	122	+ key === 'files' \|\|
120	123	key === 'system'
121	124	) {
122	125	setPage(key)
...	...	@@ -140,7 +143,8 @@
140	143	</header>
141	144
142	145	<div className="flex min-h-0 flex-1">
143		- {page !== 'contacts' && page !== 'dashboard' && page !== 'system' && page !== 'projects' && (
	146	+ {page !== 'contacts' && page !== 'dashboard' && page !== 'system'
	147	+ && page !== 'projects' && page !== 'files' && (
144	148	<div
145	149	className={`flex shrink-0 flex-col border-r border-gray-200 transition-all duration-200 ${
146	150	listCollapsed ? 'w-14' : 'w-80'
...	...	@@ -176,6 +180,8 @@
176	180	setPage('orgs')
177	181	}}
178	182	/>
	183	+ ) : page === 'files' ? (
	184	+ <SharedFiles />
179	185	) : page === 'system' ? (
180	186	<SystemPage onChanged={() => void reload()} />
181	187	) : page === 'contacts' ? (

...	...	@@ -2,13 +2,23 @@
2	2
3	3	import org.springframework.boot.context.properties.ConfigurationProperties;
4	4
	5	+/**
	6	+ * @param displayName 업무메모·연락이력·보고서의 작성자로 찍히는 이름(요구사항 [22]).
	7	+ * 예전에는 로그인 아이디(admin)가 그대로 찍혔다. 비워 두면 아이디를 쓴다.
	8	+ */
5	9	@ConfigurationProperties(prefix = "app.admin")
6		-public record AdminProperties(String username, String password) {
	10	+public record AdminProperties(String username, String password, String displayName) {
	11	+
	12	+ /** 화면에 보일 이름. 설정이 없으면 로그인 아이디로 떨어진다. */
	13	+ public String displayNameOrUsername() {
	14	+ return (displayName == null \|\| displayName.isBlank()) ? username : displayName;
	15	+ }
7	16
8	17	// record 기본 toString()은 password를 그대로 노출한다. 로그에 실수로 찍혀도
9	18	// 원문이 남지 않도록 마스킹한다.
10	19	@Override
11	20	public String toString() {
12		- return "AdminProperties[username=%s, password=****]".formatted(username);
	21	+ return "AdminProperties[username=%s, password=****, displayName=%s]"
	22	+ .formatted(username, displayName);
13	23	}
14	24	}

...	...	@@ -35,12 +35,15 @@
35	35	private final OrganizationMapper orgMapper;
36	36	private final MattermostClient mattermost;
37	37	private final MattermostProperties mattermostProps;
	38	+ private final kr.itn.itnhub.stage.StageService stageService;
38	39
39	40	public ChannelFeedService(OrganizationMapper orgMapper, MattermostClient mattermost,
40		- MattermostProperties mattermostProps) {
	41	+ MattermostProperties mattermostProps,
	42	+ kr.itn.itnhub.stage.StageService stageService) {
41	43	this.orgMapper = orgMapper;
42	44	this.mattermost = mattermost;
43	45	this.mattermostProps = mattermostProps;
	46	+ this.stageService = stageService;
44	47	}
45	48
46	49	public List<PostView> posts(Long orgId, String channel) {
...	...	@@ -69,6 +72,13 @@
69	72	String postId = mattermost.createPost(channelId, message, fileIds);
70	73	PostView post = fetchPost(channelId, postId, message);
71	74
	75	+ // 요구사항 [18]: 채널에 자료가 올라가면 ②목록접수로 저절로 넘어간다.
	76	+ // 파일이 실린 게시글만 계기로 본다 - 그냥 대화만 오간 것은 자료 접수가 아니다.
	77	+ if (!fileIds.isEmpty()) {
	78	+ stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.LIST_RECEIVED,
	79	+ kr.itn.itnhub.stage.AutoStage.REASON_LIST_RECEIVED);
	80	+ }
	81	+
72	82	if (!notice) {
73	83	return new SendResult(post, null);
74	84	}

...	...	@@ -19,9 +19,12 @@
19	19	public class WorkMemoController {
20	20
21	21	private final WorkMemoService memoService;
	22	+ private final kr.itn.itnhub.config.CurrentUser currentUser;
22	23
23		- public WorkMemoController(WorkMemoService memoService) {
	24	+ public WorkMemoController(WorkMemoService memoService,
	25	+ kr.itn.itnhub.config.CurrentUser currentUser) {
24	26	this.memoService = memoService;
	27	+ this.currentUser = currentUser;
25	28	}
26	29
27	30	@GetMapping("/api/orgs/{id}/memos")
...	...	@@ -29,11 +32,14 @@
29	32	return memoService.list(id);
30	33	}
31	34
32		- /** 작성자는 본문에서 받지 않고 로그인 사용자(principal)를 서버가 직접 기록한다. */
	35	+ /**
	36	+ * 작성자는 본문에서 받지 않고 로그인 사용자를 서버가 직접 기록한다.
	37	+ * 요구사항 [22]로 아이디가 아니라 표시 이름이 찍힌다.
	38	+ */
33	39	@PostMapping("/api/orgs/{id}/memos")
34	40	public WorkMemo create(@PathVariable Long id, @Valid @RequestBody MemoRequest request,
35	41	Principal principal) {
36		- return memoService.create(id, request, principal.getName());
	42	+ return memoService.create(id, request, currentUser.displayName(principal));
37	43	}
38	44
39	45	@PutMapping("/api/orgs/{id}/memos/{memoId}")

...	...	@@ -17,13 +17,16 @@
17	17	private final ProcessParser parser;
18	18	private final ProcessItemMapper mapper;
19	19	private final OrganizationMapper orgMapper;
	20	+ private final kr.itn.itnhub.stage.StageService stageService;
20	21	private final TransactionTemplate transactionTemplate;
21	22
22	23	public ProcessImportService(ProcessParser parser, ProcessItemMapper mapper, OrganizationMapper orgMapper,
	24	+ kr.itn.itnhub.stage.StageService stageService,
23	25	PlatformTransactionManager transactionManager) {
24	26	this.parser = parser;
25	27	this.mapper = mapper;
26	28	this.orgMapper = orgMapper;
	29	+ this.stageService = stageService;
27	30	this.transactionTemplate = new TransactionTemplate(transactionManager);
28	31	}
29	32
...	...	@@ -35,7 +38,15 @@
35	38	throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);
36	39	}
37	40	List<ProcessRow> rows = parser.parse(xlsx);
38		- return transactionTemplate.execute(status -> importRows(orgId, rows));
	41	+ ProcessImportReport report = transactionTemplate.execute(status -> importRows(orgId, rows));
	42	+
	43	+ // 요구사항 [18]: 권리처리 자료가 올라오면 ⑧법률검토(권리처리)로 저절로 넘어간다.
	44	+ // 이미 그보다 앞서 있으면 아무 일도 하지 않는다.
	45	+ if (report != null && report.total() > 0) {
	46	+ stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.PROCESS_STARTED,
	47	+ kr.itn.itnhub.stage.AutoStage.REASON_PROCESS_STARTED);
	48	+ }
	49	+ return report;
39	50	}
40	51
41	52	private ProcessImportReport importRows(Long orgId, List<ProcessRow> rows) {

...	...	@@ -29,9 +29,12 @@
29	29	public class ProjectController {
30	30
31	31	private final ProjectService projectService;
	32	+ private final kr.itn.itnhub.config.CurrentUser currentUser;
32	33
33		- public ProjectController(ProjectService projectService) {
	34	+ public ProjectController(ProjectService projectService,
	35	+ kr.itn.itnhub.config.CurrentUser currentUser) {
34	36	this.projectService = projectService;
	37	+ this.currentUser = currentUser;
35	38	}
36	39
37	40	@GetMapping("/api/projects")
...	...	@@ -49,7 +52,7 @@
49	52	public List<ContactLog> addLog(@PathVariable("id") Long orgId,
50	53	@Valid @RequestBody ContactLogRequest request,
51	54	Principal principal) {
52		- return projectService.addLog(orgId, request, principal.getName());
	55	+ return projectService.addLog(orgId, request, currentUser.displayName(principal));
53	56	}
54	57
55	58	@PutMapping("/api/orgs/{id}/contact-logs/{logId}")
...	...	@@ -75,7 +78,7 @@
75	78	Principal principal) throws IOException {
76	79	String name = file.getOriginalFilename() == null ? "report" : file.getOriginalFilename();
77	80	return projectService.addReport(orgId, name, file.getContentType(), file.getBytes(),
78		- principal.getName());
	81	+ currentUser.displayName(principal));
79	82	}
80	83
81	84	/** 한글 파일명이 깨지지 않게 ChannelFeedController.download와 같은 RFC 5987 인코딩을 쓴다. */
...	...	@@ -103,7 +106,7 @@
103	106	Principal principal) throws IOException {
104	107	String name = file.getOriginalFilename() == null ? "report" : file.getOriginalFilename();
105	108	return projectService.replaceReport(orgId, reportId, name, file.getContentType(),
106		- file.getBytes(), principal.getName());
	109	+ file.getBytes(), currentUser.displayName(principal));
107	110	}
108	111
109	112	@ResponseStatus(HttpStatus.NO_CONTENT)

...	...	@@ -227,7 +227,8 @@
227	227	}
228	228	if (filled(current.getChannelIdMj()) && filled(current.getChannelIdLaw())) {
229	229	mapper.updateStage(orgId, 1);
230		- stageHistoryMapper.insert(orgId, 1);
	230	+ // 이것도 프로그램이 저절로 넣는 단계다(요구사항 [19]: 이력에 자동/수동 구분).
	231	+ stageHistoryMapper.insert(orgId, 1, true, "채널 생성");
231	232	}
232	233	} catch (RuntimeException e) {
233	234	log.warn("진행단계 자동 시작 실패 org={}", orgId, e);

...	...	@@ -17,13 +17,16 @@
17	17	private final ReviewParser parser;
18	18	private final ReviewItemMapper mapper;
19	19	private final OrganizationMapper orgMapper;
	20	+ private final kr.itn.itnhub.stage.StageService stageService;
20	21	private final TransactionTemplate transactionTemplate;
21	22
22	23	public ReviewImportService(ReviewParser parser, ReviewItemMapper mapper, OrganizationMapper orgMapper,
	24	+ kr.itn.itnhub.stage.StageService stageService,
23	25	PlatformTransactionManager transactionManager) {
24	26	this.parser = parser;
25	27	this.mapper = mapper;
26	28	this.orgMapper = orgMapper;
	29	+ this.stageService = stageService;
27	30	this.transactionTemplate = new TransactionTemplate(transactionManager);
28	31	}
29	32
...	...	@@ -35,7 +38,15 @@
35	38	throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);
36	39	}
37	40	List<ReviewRow> rows = parser.parse(xlsx);
38		- return transactionTemplate.execute(status -> importRows(orgId, rows));
	41	+ ReviewImportReport report = transactionTemplate.execute(status -> importRows(orgId, rows));
	42	+
	43	+ // 요구사항 [18]: 권리확인 자료가 올라오면 ⑤법률검토(권리확인)로 저절로 넘어간다.
	44	+ // 이미 그보다 앞서 있으면 아무 일도 하지 않는다.
	45	+ if (report != null && report.total() > 0) {
	46	+ stageService.autoAdvance(orgId, kr.itn.itnhub.stage.AutoStage.REVIEW_STARTED,
	47	+ kr.itn.itnhub.stage.AutoStage.REASON_REVIEW_STARTED);
	48	+ }
	49	+ return report;
39	50	}
40	51
41	52	private ReviewImportReport importRows(Long orgId, List<ReviewRow> rows) {

...	...	@@ -11,7 +11,8 @@
11	11	/** 최신순. */
12	12	List<StageHistoryRow> findByOrg(@Param("orgId") Long orgId);
13	13
14		- int insert(@Param("orgId") Long orgId, @Param("stage") int stage);
	14	+ int insert(@Param("orgId") Long orgId, @Param("stage") int stage,
	15	+ @Param("auto") boolean auto, @Param("reason") String reason);
15	16
16	17	/** 채널 초기화용. 단계가 null로 돌아가므로 이력을 남겨두면 어긋난다. */
17	18	int deleteByOrg(@Param("orgId") Long orgId);

...	...	@@ -5,10 +5,20 @@
5	5
6	6	private int stage;
7	7	private long changedAt;
	8	+ /** 프로그램이 저절로 넘긴 것인지(요구사항 [19]: 이력에 자동/수동 구분 표시). */
	9	+ private boolean auto;
	10	+ /** 자동으로 넘어간 이유. 사람이 눌렀으면 null. */
	11	+ private String reason;
8	12
9	13	public int getStage() { return stage; }
10	14	public void setStage(int stage) { this.stage = stage; }
11	15
12	16	public long getChangedAt() { return changedAt; }
13	17	public void setChangedAt(long changedAt) { this.changedAt = changedAt; }
	18	+
	19	+ public boolean isAuto() { return auto; }
	20	+ public void setAuto(boolean auto) { this.auto = auto; }
	21	+
	22	+ public String getReason() { return reason; }
	23	+ public void setReason(String reason) { this.reason = reason; }
14	24	}

...	...	@@ -45,11 +45,45 @@
45	45	}
46	46
47	47	orgMapper.updateStage(orgId, stage);
48		- historyMapper.insert(orgId, stage);
	48	+ // 사람이 눌러서 넘긴 것이다(요구사항 [19]: 이력에 자동/수동 구분).
	49	+ historyMapper.insert(orgId, stage, false, null);
49	50
50	51	return OrgResponse.of(orgMapper.findById(orgId));
51	52	}
52	53
	54	+ /**
	55	+ * 자료가 올라온 것을 계기로 단계를 저절로 넘긴다(요구사항 [18]).
	56	+ *
	57	+ * <p>앞으로만 간다. 이미 목표 단계에 있거나 그보다 앞서 있으면 아무 일도 하지 않는다 -
	58	+ * 자료를 다시 올렸다고 단계가 뒤로 밀리면 안 되기 때문이다.</p>
	59	+ *
	60	+ * <p>채널이 없어 단계가 아직 없는 기관(stage=null)도 건드리지 않는다. 채널 생성 시
	61	+ * ①신청으로 들어오는 것이 먼저다.</p>
	62	+ *
	63	+ * <p>사람이 이 단계를 다시 되돌리는 것은 막지 않는다(요구사항 [19]: 되돌림 허용).
	64	+ * 진행단계 변경에서 이전 단계를 고르면 그대로 내려간다.</p>
	65	+ *
	66	+ * @return 실제로 넘어갔으면 true
	67	+ */
	68	+ @Transactional
	69	+ public boolean autoAdvance(Long orgId, int targetStage, String reason) {
	70	+ Organization org = orgMapper.findById(orgId);
	71	+ if (org == null \|\| org.getStage() == null) {
	72	+ return false;
	73	+ }
	74	+ if (org.getStage() >= targetStage) {
	75	+ return false;
	76	+ }
	77	+ int lastStage = codeService.group(Codes.STAGE).size();
	78	+ if (targetStage < 1 \|\| targetStage > lastStage) {
	79	+ return false;
	80	+ }
	81	+
	82	+ orgMapper.updateStage(orgId, targetStage);
	83	+ historyMapper.insert(orgId, targetStage, true, reason);
	84	+ return true;
	85	+ }
	86	+
53	87	public java.util.List<StageHistoryRow> history(Long orgId) {
54	88	if (orgMapper.findById(orgId) == null) {
55	89	throw new OrgNotFoundException("기관을 찾을 수 없습니다: " + orgId);

...	...	@@ -7,15 +7,17 @@
7	7	changed_at을 밀리초 epoch로 내려준다 - WorkMemoMapper.created_at과 동일한 관례.
8	8	-->
9	9	<select id="findByOrg" resultType="kr.itn.itnhub.stage.StageHistoryRow">
10		- select stage, (extract(epoch from changed_at) * 1000)::bigint as changed_at
	10	+ select stage, (extract(epoch from changed_at) * 1000)::bigint as changed_at,
	11	+ auto, reason
11	12	from stage_history
12	13	where org_id = #{orgId}
13	14	order by changed_at desc, id desc
14	15	</select>
15	16
	17	+ <!-- auto=true면 프로그램이 저절로 넘긴 것이다(요구사항 [18][19]). reason에 계기를 남긴다. -->
16	18	<insert id="insert">
17		- insert into stage_history (org_id, stage)
18		- values (#{orgId}, #{stage})
	19	+ insert into stage_history (org_id, stage, auto, reason)
	20	+ values (#{orgId}, #{stage}, #{auto}, #{reason})
19	21	</insert>
20	22
21	23	<!--

...	...	@@ -66,13 +66,13 @@
66	66	"""))
67	67	.andExpect(status().isOk())
68	68	// 작성자는 요청 본문이 아니라 로그인 사용자에서 온다
69		- .andExpect(jsonPath("$.contactName").value("admin"))
	69	+ .andExpect(jsonPath("$.contactName").value("관리자"))
70	70	.andExpect(jsonPath("$.body").value("채널 생성 일정 문의"))
71	71	.andExpect(jsonPath("$.createdAt").isNumber());
72	72
73	73	mvc.perform(get("/api/orgs/{id}/memos", orgId))
74	74	.andExpect(status().isOk())
75		- .andExpect(jsonPath("$[0].contactName").value("admin"))
	75	+ .andExpect(jsonPath("$[0].contactName").value("관리자"))
76	76	.andExpect(jsonPath("$[0].body").value("채널 생성 일정 문의"));
77	77	}
78	78
...	...	@@ -192,7 +192,7 @@
192	192	"""))
193	193	.andExpect(status().isOk())
194	194	.andExpect(jsonPath("$.body").value("고친 뒤"))
195		- .andExpect(jsonPath("$.contactName").value("admin"))
	195	+ .andExpect(jsonPath("$.contactName").value("관리자"))
196	196	.andExpect(jsonPath("$.createdAt").value(createdAt));
197	197	}
198	198

...	...	@@ -76,7 +76,7 @@
76	76	"""))
77	77	.andExpect(status().isOk())
78	78	.andExpect(jsonPath("$.length()").value(1))
79		- .andExpect(jsonPath("$[0].author").value("admin"))
	79	+ .andExpect(jsonPath("$[0].author").value("관리자"))
80	80	.andExpect(jsonPath("$[0].contactedOn").value("2026-07-20"));
81	81
82	82	mvc.perform(post("/api/orgs/{id}/contact-logs", orgId).with(csrf())
...	...	@@ -112,7 +112,7 @@
112	112	.andExpect(status().isOk())
113	113	.andExpect(jsonPath("$[0].summary").value("고침"))
114	114	.andExpect(jsonPath("$[0].method").value("방문"))
115		- .andExpect(jsonPath("$[0].author").value("admin"));
	115	+ .andExpect(jsonPath("$[0].author").value("관리자"));
116	116	}
117	117
118	118	@Test
...	...	@@ -151,7 +151,7 @@
151	151	.andExpect(status().isOk())
152	152	.andExpect(jsonPath("$.length()").value(1))
153	153	.andExpect(jsonPath("$[0].fileName").value("최종보고서.pdf"))
154		- .andExpect(jsonPath("$[0].uploadedBy").value("admin"))
	154	+ .andExpect(jsonPath("$[0].uploadedBy").value("관리자"))
155	155	.andReturn().getResponse().getContentAsString();
156	156	int reportId = com.jayway.jsonpath.JsonPath.parse(uploaded).read("$[0].id", Integer.class);
157	157

Delete comment