Question 1

Documenso에서 플레이스홀더를 사용하여 동적 서명 필드를 추가하는 방법은 무엇인가요?

Accepted Answer

Documenso가 이제 PDF 플레이스홀더(placeholders)를 지원합니다. 서명이 필요한 PDF에 {{signature_1}}과 같은 플레이스홀더를 추가하면 Documenso가 이를 자동으로 감지하여 필드 배치에 활용합니다. 공식 문서 참조: https://docs.documenso.com/docs/users/documents/advanced/pdf-placeholders

Question 2

Documenso 완료된 문서 이메일 첨부 파일에서 중복된 '.pdf.pdf' 확장자를 수정하는 방법

Accepted Answer

이것은 `packages/lib/jobs/definitions/emails/send-document-completed-emails.handler.ts`에 있는 Documenso의 이메일 파일명 생성 로직에서 알려진 버그입니다. internal version 2 envelope의 경우, 문서 제목이 이미 `.pdf`로 끝나더라도 `.pdf`가 무조건 추가되어 `Contract.pdf.pdf`와 같은 첨부 파일이 생성됩니다. 웹 UI에서의 직접 다운로드는 영향을 받지 않습니다. **공식 수정 방법:** PR #3374 (https://github.com/documenso/documenso/pull/3374)가 포함된 릴리스로 Documenso 설치를 업데이트하세요. **셀프 호스팅 우회 방법:** 코드가 이후에 확장자를 다시 확인하므로, 무조건적인 확장자 추가 부분을 제거하여 핸들러를 패치하세요:
```ts
const fileNameToUse = envelope.internalVersion === 1
  ? envelope.title
  : envelopeItem.title; // remove the unconditional + '.pdf'

return {
  filename: fileNameToUse.endsWith('.pdf') ? fileNameToUse : fileNameToUse + '.pdf',
  content: Buffer.from(file),
  contentType: 'application/pdf',
};
```
그런 다음 애플리케이션을 다시 빌드하고 재시작하세요. 이 버그는 PDF 내용 자체가 아닌 첨부 파일명에만 영향을 미칩니다.

Question 3

문서 언어가 프랑스어로 설정되어 있는데도 'Waiting for others to complete signing' 이메일 제목이 영어로 표시되는 이유는 무엇이며, 어떻게 해결할 수 있나요?

Accepted Answer

`packages/lib/translations/fr/web.po`에 프랑스어 번역 문자열이 누락되어 있어(`msgstr`이 비어 있음), Documenso는 `send-document-pending-email.handler.ts`에서 발송되는 문서 대기 이메일 제목을 영어 원본 텍스트로 폴백합니다. 수정 방법: `fr/web.po`에 번역을 추가하세요:
```
msgid "Waiting for others to complete signing"
msgstr "En attente que les autres terminent de signer"
```
자체 호스팅 인스턴스의 경우 `.po` 파일을 편집한 후 `lingui compile`로 번역을 다시 컴파일하고 앱을 재시작하세요. 업스트림 프로젝트의 경우 향후 릴리스에 포함될 수 있도록 프로젝트의 번역 플랫폼(Crowdin)을 통해 번역을 제출하세요. 이 단일 문자열만 영향을 받으며, "Waiting for others to sign"과 같은 관련 문자열은 이미 번역되어 있습니다.

Question 4

병렬 API 요청이 free-tier의 월 5개 이메일 제한을 우회하게 되는 race condition을 어떻게 수정해야 하나요?

Accepted Answer

동적 rate limiting이 포함된 Documenso 릴리스로 업그레이드하세요. 유지 관리자들에 따르면 이것이 병렬 요청 우회 문제를 간접적으로 해결한다고 합니다. 완전한 수정을 위해서는 데이터베이스 트랜잭션 내에서 원자적인 check-and-increment 방식으로 서버 측에서 쿼터를 강제하세요. 예를 들어 `SELECT ... FOR UPDATE`로 사용자의 월간 사용량 행을 잠그고, `count >= 5`인 경우 요청을 거부하며, 그렇지 않으면 값을 증가시키고 커밋합니다. rate limiting과 idempotency key를 추가하고, 분리된 read-then-write 검사나 클라이언트 측 유효성 검사에 절대 의존하지 마세요.

Question 5

서명자가 문서에 서명한 후에도 문서가 계속 대기 상태로 남아 있는 이유는 무엇인가요?

Accepted Answer

이 문제는 `v1.8.0-rc.0` 버전에서 알려진 이슈였습니다. 최신 안정 릴리스로 업그레이드하세요. Docker의 경우 영구 데이터 볼륨을 유지하면서 이미지를 업데이트하고 컨테이너를 다시 생성하세요. 예를 들어: `docker compose pull && docker compose up -d`. 업그레이드 후 문서 상태를 다시 확인하세요. completed/abgeschlossen으로 변경되어야 합니다.

Documenso

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트