使い方ガイド (依頼の作成者向け)사용 가이드 (요청 작성자용)

Redmine のチケットでウェブサイトの修正を依頼すると、エージェント (自動で作業する担当者) が修正からテストサーバーへの反映、報告まで行います。依頼する人の操作は、これまでどおり Redmine だけで完結します。

1. チケットの担当をエージェントにする (期日など Redmine の必須項目を入れてから)
2. 依頼内容の読み取り
3. 修正
4. 自動の検証
5. リポジトリに反映、テストサーバーにアップロード
6. コメントで報告し、担当をあなたに戻す

ダッシュボードは、進み具合や修正の内容 (変更箇所、修正前後の画面) を確かめたいときに使います。使わなくても依頼と結果の受け取りはできます。

Redmine 티켓으로 웹사이트 수정을 요청하면, 에이전트(자동으로 작업하는 담당자)가 수정부터 테스트 서버 반영, 보고까지 처리합니다. 요청하는 사람은 지금처럼 Redmine에서만 작업하면 됩니다.

1. 티켓 담당자를 에이전트로 지정(기일 등 Redmine 필수 항목을 넣은 뒤)
2. 요청 내용 파악
3. 수정
4. 자동 검증
5. 저장소 반영, 테스트 서버 업로드
6. 코멘트로 보고하고 담당자를 요청자에게 되돌림

대시보드는 진행 상황이나 수정 내용(변경 부분, 수정 전후 화면)을 확인하고 싶을 때 씁니다. 대시보드를 쓰지 않아도 요청과 결과 확인은 할 수 있습니다.

1. Redmine でチケットを作り (または既存のチケットにコメントを書き)、依頼内容を書きます。
2. 担当者をエージェントのアカウントにします。担当が変わったときが依頼の開始です。
3. あとは待つだけです。通常は数分から数十分で結果がコメントされます。

書き方のこつ

• 対象のページ (URL やページ名) と、どこをどう変えるかを具体的に書きます。
• 画像や原稿は、チケットに添付するか、Dropbox・AUN のリンクを書きます。エージェントがリンク先の内容を読み、素材を Dropbox からコピーします。
• 1 回の依頼に複数の修正を書いてもかまいません。

素材の形式

エージェントはデザインツールのファイルを開けません。素材はそのままサイトに使える形式で渡してください。

	形式
使える	画像: JPG、PNG、WebP、GIF、SVG (サイトに載せる大きさで書き出したもの。1 枚 10MB まで) / 文言: チケット本文やコメントに書いたテキスト、Dropbox のテキストファイル (txt、csv) / PDF: サイトにそのまま置くファイルとして (中身は読みません)
使えない	PSD (Photoshop)、AI (Illustrator)、XD、Sketch、Figma のリンクなどのデザインデータ / Word、Excel (文言はテキストで書いてください) / PDF や画像の中にしかない文言 (書き写す必要があるもの)

使えない形式しかない項目は、推測で作らずに残し、「ご確認・ご支給のお願い」(または質問) のコメントで担当をあなたに戻します。使える形式で書き出したものを添付するか Dropbox に置いて、担当をエージェントに戻してください。ほかの項目は先に対応します。

指示によって変わること

依頼に書くこと	エージェントの動き
特に指定しない	通常のブランチに反映し、テストサーバーには変更したファイルだけをアップロード
ブランチ名 (例: 「feature/event ブランチで」)	そのブランチで作業して反映
「pre に上げて」	テストサーバーの pre フォルダーにサイト全体をアップロード
「アーカイブに保存」	テストサーバーのアーカイブ (作業日のフォルダー) にサイト全体を保存
「プロトタイプ」	リポジトリを使わずに作り、テストサーバーの prototype フォルダーにアップロードだけ行う
アップロード先のフォルダー名	そのフォルダーにサイト全体をアップロード

同じチケットで続けて依頼する

結果を見て追加の修正があれば、同じチケットにコメントで指示を書き、もう一度担当者をエージェントにします。前回の担当変更より後に書かれた内容が、新しい依頼として扱われます。

チケットのステータスはエージェントは変えません。確認が終わったら、これまでどおり依頼した人がステータスを変更してください。

1. Redmine에서 티켓을 만들거나 기존 티켓에 코멘트를 쓰고, 요청 내용을 적습니다.
2. 담당자를 에이전트 계정으로 바꿉니다. 담당자가 바뀌는 시점이 요청의 시작입니다.
3. 그다음은 기다리기만 하면 됩니다. 보통 몇 분에서 수십 분 안에 결과가 코멘트로 올라옵니다.

잘 쓰는 요령

• 대상 페이지(URL이나 페이지 이름)와 어디를 어떻게 바꿀지 구체적으로 씁니다.
• 이미지나 원고는 티켓에 첨부하거나 Dropbox·AUN 링크를 적습니다. 에이전트가 링크 내용을 읽고, 소재는 Dropbox에서 복사합니다.
• 한 번의 요청에 여러 수정을 적어도 됩니다.

소재 형식

에이전트는 디자인 도구 파일을 열 수 없습니다. 소재는 사이트에 바로 쓸 수 있는 형식으로 주세요.

	형식
쓸 수 있음	이미지: JPG, PNG, WebP, GIF, SVG(사이트에 올릴 크기로 내보낸 것. 1장 10MB까지) / 문구: 티켓 본문이나 코멘트에 적은 텍스트, Dropbox의 텍스트 파일(txt, csv) / PDF: 사이트에 그대로 올리는 파일로(내용은 읽지 않습니다)
쓸 수 없음	PSD(Photoshop), AI(Illustrator), XD, Sketch, Figma 링크 같은 디자인 데이터 / Word, Excel(문구는 텍스트로 적어 주세요) / PDF나 이미지 안에만 있는 문구(옮겨 적어야 하는 것)

쓸 수 없는 형식밖에 없는 항목은 추측으로 만들지 않고 남겨 둔 채, 「ご確認・ご支給のお願い」(또는 질문) 코멘트로 담당자를 요청자에게 되돌립니다. 쓸 수 있는 형식으로 내보낸 파일을 첨부하거나 Dropbox에 올린 뒤 담당자를 에이전트로 바꿔 주세요. 나머지 항목은 먼저 처리합니다.

지시에 따라 달라지는 것

요청에 적는 내용	에이전트의 동작
따로 지정하지 않음	기본 브랜치에 반영하고, 테스트 서버에는 바뀐 파일만 업로드
브랜치 이름 (예: 「feature/event ブランチで」)	그 브랜치에서 작업하고 반영
「pre に上げて」	테스트 서버의 pre 폴더에 사이트 전체 업로드
「アーカイブに保存」	테스트 서버의 아카이브(작업일 폴더)에 사이트 전체 저장
「プロトタイプ」	저장소를 쓰지 않고 만들어, 테스트 서버의 prototype 폴더에 업로드만 함
업로드할 폴더 이름	그 폴더에 사이트 전체 업로드

같은 티켓에서 이어서 요청하기

결과를 보고 추가 수정이 있으면, 같은 티켓에 코멘트로 지시를 적고 다시 담당자를 에이전트로 바꿉니다. 직전 담당 변경 이후에 적은 내용이 새 요청으로 처리됩니다.

에이전트는 티켓 상태를 바꾸지 않습니다. 확인이 끝나면 지금처럼 요청한 사람이 상태를 바꿔 주세요.

エージェントは結果を日本語のコメントで書き、担当者をあなたに戻します。コメントの種類は次のとおりです。

コメント	内容	あなたがすること
修正の報告	対応内容、テスト URL、変更箇所のスクリーンショット (修正前・後)	テスト URL で確認する。追加の修正があればコメントで指示し、担当をエージェントに戻す
質問	依頼の内容があいまいで決められない点	コメントで回答し、担当をエージェントに戻す
ご確認・ご支給のお願い	素材や情報が足りずに対応できなかった項目 (対応できた分は修正の報告に含まれる)	素材を添付するかリンクを書き、担当をエージェントに戻す
完了報告	依頼の内容がすでに反映済みだった場合の確認結果とテスト URL	テスト URL で確認する

運用の設定によっては、反映の前に運用者が内容を確認してから進むため、報告まで時間がかかることがあります。

에이전트는 결과를 일본어 코멘트로 쓰고 담당자를 요청자에게 되돌립니다. 코멘트 종류는 다음과 같습니다.

코멘트	내용	요청자가 할 일
수정 보고	처리 내용, 테스트 URL, 변경 부분 스크린샷(수정 전·후)	테스트 URL에서 확인합니다. 추가 수정이 있으면 코멘트로 지시하고 담당자를 에이전트로 바꿉니다
질문	요청 내용이 모호해서 정할 수 없는 부분	코멘트로 답하고 담당자를 에이전트로 바꿉니다
확인·자료 요청	소재나 정보가 부족해 처리하지 못한 항목 (처리한 부분은 수정 보고에 포함)	소재를 첨부하거나 링크를 적고 담당자를 에이전트로 바꿉니다
완료 보고	요청 내용이 이미 반영돼 있던 경우의 확인 결과와 테스트 URL	테스트 URL에서 확인합니다

운영 설정에 따라 반영 전에 운영자가 내용을 확인한 뒤 진행하므로, 보고까지 시간이 더 걸릴 수 있습니다.

接続とログイン

1. 運用者から案内された URL をブラウザーで開きます (アプリのインストールは不要です。社内でも社外でも同じ URL です)。
2. 運用者が作ったログイン名とパスワードでログインします。パスワードは「表示設定」のアカウント欄で変更できます。

12 時間操作しないとき、ログインから 7 日たったときは、もう一度ログインが必要です。

見られるもの

あなたが作成したチケットのうち、エージェントが扱ったもの (いまエージェントが担当しているもの、作業の記録があるもの) だけが表示されます。

• 一覧: チケットごとの状態がタグで出ます (下の表)。
• 詳細: 今回の依頼として読み取った範囲、依頼の分析結果、修正の内容 (変更したファイル、差分、修正前・後のスクリーンショット)、コメントの履歴。
• 作業履歴: これまでの依頼の結果。

一覧のタグ	意味
自動: 待機 自動: 処理中	順番待ち、または作業中
自動: 保留	同じサイトの別の作業が終わるのを待っている、または一時的な問題で再試行を待っている (自動で続きます)
自動: 検証済み	修正と検証は終わり、反映の前で運用者の確認を待っている
自動: 反映済み 自動: 完了報告済み	反映してコメントで報告した
自動: 質問投稿済み 自動: ご支給依頼済み	質問、素材のお願いをコメントした (あなたの回答待ち)
要対応: Redmine に書き込めない	Redmine の必須項目 (期日など) が空で、コメントも書けないため止まっている (あなたの対応待ち)。Redmine で項目を入力すると、自動で続きます
自動: 要確認 自動: 失敗 自動: 反映失敗	自動では進められなかった (運用者が対応します)

通常は画面での操作は必要ありません。作業の実行などのボタンは、運用者から案内があったときだけ使ってください。

表示設定

画面右上の「表示設定」で、表示言語 (日本語 / 韓国語)、テーマ (システム / ライト / ダーク)、パスワードの変更、ログアウト、Redmine の API キーの登録 (次の章) ができます。

접속과 로그인

1. 운영자가 알려 준 URL을 브라우저로 엽니다(앱 설치는 필요 없습니다. 사내든 사외든 같은 URL입니다).
2. 운영자가 만든 로그인 이름과 비밀번호로 로그인합니다. 비밀번호는 「표시 설정」의 계정 항목에서 바꿀 수 있습니다.

12시간 동안 조작하지 않았을 때, 로그인한 지 7일이 지났을 때는 다시 로그인해야 합니다.

볼 수 있는 것

내가 작성한 티켓 가운데 에이전트가 다룬 것(지금 에이전트가 담당하고 있거나 작업 기록이 있는 것)만 표시됩니다.

• 목록: 티켓별 상태가 태그로 표시됩니다(아래 표).
• 상세: 이번 요청으로 읽어 들인 범위, 요청 분석 결과, 수정 내용(바뀐 파일, 차이, 수정 전·후 스크린샷), 코멘트 이력.
• 작업 이력: 지금까지의 요청 결과.

목록 태그	의미
자동: 대기 자동: 처리 중	순서를 기다리거나 작업 중
자동: 보류	같은 사이트의 다른 작업이 끝나기를 기다리거나, 일시적인 문제로 재시도를 기다리는 중(자동으로 이어집니다)
자동: 검증 완료	수정과 검증은 끝났고, 반영 전에 운영자의 확인을 기다리는 중
자동: 반영 완료 자동: 완료 보고 완료	반영하고 코멘트로 보고함
자동: 질문 게시 완료 자동: 소재 요청 완료	질문이나 소재 요청을 코멘트로 남김(요청자의 답을 기다리는 중)
조치 필요: Redmine에 쓸 수 없음	Redmine 필수 항목(기일 등)이 비어 있어 코멘트도 쓸 수 없어 멈춘 상태(요청자의 조치를 기다리는 중). Redmine에서 항목을 입력하면 자동으로 이어집니다
자동: 확인 필요 자동: 실패 자동: 반영 실패	자동으로 진행하지 못함(운영자가 처리합니다)

보통은 화면에서 조작할 필요가 없습니다. 작업 실행 같은 버튼은 운영자의 안내가 있을 때만 사용해 주세요.

표시 설정

화면 오른쪽 위의 「표시 설정」에서 표시 언어(일본어 / 한국어), 테마(시스템 / 라이트 / 다크), 비밀번호 변경, 로그아웃, Redmine API 키 등록(다음 장)을 할 수 있습니다.

チケットの詳細画面の下のコメント欄から、Redmine にコメントを書けます。コメントは あなたの Redmine アカウントの名前で書かれ、そのチケットへの追加の指示として扱われます。使う前に一度だけ、Redmine の API キーを登録します。

1. Redmine にログインし、右上の「個人設定」を開きます。
2. 右側の「API アクセスキー」の「表示」を押し、表示されたキー (英数字 40 文字) をコピーします。
3. ダッシュボードの「表示設定」→ アカウント欄の「Redmine の API キー」で「登録」を押し、キーを貼り付けて登録します。

• キーはサーバー内に安全に保存され、画面には登録の有無だけが表示されます。本人のキーかどうかは登録のときに確かめます。
• Redmine でキーを作り直したときは、ダッシュボードでも登録し直してください。
• コメントを書いただけでは作業は始まりません。新しい依頼として処理させたいときは、Redmine で担当者をエージェントにしてください。

티켓 상세 화면 아래의 코멘트 칸에서 Redmine에 코멘트를 쓸 수 있습니다. 코멘트는 내 Redmine 계정 이름으로 기록되고, 그 티켓에 대한 추가 지시로 처리됩니다. 처음 한 번만 Redmine API 키를 등록하면 됩니다.

1. Redmine에 로그인해서 오른쪽 위의 「個人設定」(개인 설정)을 엽니다.
2. 오른쪽의 「API アクセスキー」(API 접근 키)에서 「表示」를 누르고, 표시된 키(영숫자 40자)를 복사합니다.
3. 대시보드의 「표시 설정」 → 계정 항목의 「Redmine API 키」에서 「등록」을 누르고 키를 붙여 넣어 등록합니다.

• 키는 서버 안에 안전하게 보관되고, 화면에는 등록 여부만 표시됩니다. 등록할 때 본인의 키인지 확인합니다.
• Redmine에서 키를 다시 만들었다면 대시보드에서도 다시 등록해 주세요.
• 코멘트만 써서는 작업이 시작되지 않습니다. 새 요청으로 처리하려면 Redmine에서 담당자를 에이전트로 바꿔 주세요.

こんなとき	確かめること
しばらく待っても結果のコメントが来ない	担当者がエージェントになっているか。ダッシュボードの一覧のタグ (保留、検証済み、要確認など) も確認し、要確認・失敗なら運用者に連絡する
ダッシュボードに「要対応: Redmine に書き込めない」が出た	期日などの必須項目が空で、エージェントはコメントも担当の変更もできない。Redmine で項目を入力すれば、担当はそのままで自動で続く (反映の途中で止まっていた場合も、続きから再開する)
「ご確認・ご支給のお願い」のコメントが来た	素材が足りないか、使えない形式 (PSD、AI など) だった項目がある。コメントにある素材を使える形式で渡し、担当をエージェントに戻す (1 章「素材の形式」)
「自動対応の対象外」のコメントが来た	ビルド (ソースから公開用のファイルを作る作業) が必要なプロジェクトで、エージェントは対応できない。担当の方に依頼する
思っていた修正と違う	同じチケットにコメントで具体的に指示し、担当をエージェントに戻す
ダッシュボードにチケットが出ない	自分が作成したチケットで、エージェントが一度でも担当したものだけが出る。他の人が作成したチケットは出ない
ダッシュボードのコメントボタンが押せない	Redmine の API キーが未登録 (4 章)
パスワードを忘れた	運用者にパスワードの再設定を頼む
ダッシュボードが開かない	URL が正しいか。それでも開かなければ運用者に連絡する

이럴 때	확인할 것
한참 기다려도 결과 코멘트가 오지 않음	담당자가 에이전트로 되어 있는지 확인합니다. 대시보드 목록의 태그(보류, 검증 완료, 확인 필요 등)도 보고, 확인 필요·실패면 운영자에게 연락합니다
대시보드에 「조치 필요: Redmine에 쓸 수 없음」이 표시됨	기일 등 필수 항목이 비어 있어 에이전트가 코멘트도 담당자 변경도 할 수 없습니다. Redmine에서 항목을 입력하면 담당자는 그대로 두어도 자동으로 이어집니다(반영 도중에 멈춘 경우에도 이어서 재개합니다)
「ご確認・ご支給のお願い」 코멘트가 옴	소재가 부족하거나 쓸 수 없는 형식(PSD, AI 등)인 항목이 있습니다. 코멘트에 적힌 소재를 쓸 수 있는 형식으로 주고 담당자를 에이전트로 바꿉니다(1장 「소재 형식」)
「自動対応の対象外」 코멘트가 옴	빌드(소스에서 공개용 파일을 만드는 작업)가 필요한 프로젝트라 에이전트가 처리할 수 없습니다. 담당자에게 요청합니다
생각한 수정과 다름	같은 티켓에 코멘트로 구체적으로 지시하고 담당자를 에이전트로 바꿉니다
대시보드에 티켓이 보이지 않음	내가 작성했고 에이전트가 한 번이라도 담당한 티켓만 보입니다. 다른 사람이 작성한 티켓은 보이지 않습니다
대시보드의 코멘트 버튼이 눌리지 않음	Redmine API 키가 등록되지 않았습니다(4장)
비밀번호를 잊음	운영자에게 비밀번호 재설정을 요청합니다
대시보드가 열리지 않음	URL이 맞는지 확인합니다. 그래도 열리지 않으면 운영자에게 연락합니다