bkinnightskytw
/
pdf_signature
mirror of https://github.com/existedinnettw/pdf_signature.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

docs: add multi signature picture in user stories and use cases

This commit is contained in:
insleker 2025-09-02 10:35:44 +08:00
parent eb19022572
commit 51c2a403c4
4 changed files with 50 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/FRs.md
View File

@ -42,3 +42,7 @@
* role: user * role: user
* functionality: the ability to sign multiple locations within a PDF document * functionality: the ability to sign multiple locations within a PDF document
* benefit: documents requiring multiple signatures can be signed simultaneously * benefit: documents requiring multiple signatures can be signed simultaneously
* name: [support multiple signature pictures](../test/features/support_multiple_signature_pictures.feature)
* role: user
* functionality: the ability to use different signature pictures for different signing locations
* benefit: close to real-world signing scenarios where every signature is not the same

6
docs/use_cases.md
View File

@ -1,6 +1,4 @@
# Use cases # Use cases
Use cases are derived from `FRs.md` (user stories) and `meta-arch.md`. Each Feature name matches the corresponding user story; scenarios focus on observable behavior without restating story details. Use cases are derived from `FRs.md` (user stories) and `meta-arch.md`. Each Feature name matches the corresponding user story;
The use cases are written in runnable `Gherkin` BDD feature files at `test/features/*.feature`.
The Gherkin scenarios live in runnable BDD feature files under `test/features/`.

38
test/features/support_multiple_signature_pictures.feature Normal file
View File

@ -0,0 +1,38 @@
Feature: support multiple signature pictures
Scenario: Place signatures on different pages with different images
Given a multi-page PDF is open
When the user places a signature from picture <first_image> on page <first_page>
And the user places a signature from picture <second_image> on page <second_page>
Then both signatures are shown on their respective pages
Examples:
# Same page, same image
# Same page, different images
# Different pages, same image
# Different pages, different images
| first_image | first_page | second_image | second_page |
| 'alice.png' | 1 | 'alice.png' | 1 |
| 'alice.png' | 1 | 'bob.png' | 1 |
| 'alice.png' | 1 | 'bob.png' | 3 |
| 'bob.png' | 2 | 'alice.png' | 5 |
Scenario: Reuse the same image for more than one signature
Given a signature image is loaded or drawn
When the user places it in multiple locations in the document
Then identical signature instances appear in each location
And adjusting one instance does not affect the others
Scenario: Reassign a different image to an existing signature
Given a PDF page is selected for signing
And an image {"alice.png"} is loaded
And the user places a signature on the page
When an image {"bob.png"} is loaded
And the user assigns {"bob.png"} to the selected signature
Then the selected signature is shown with image {"bob.png"}
Scenario: Save/export uses the assigned image for each signature
Given a PDF is open and contains multiple placed signatures across pages
When the user saves/exports the document
Then all placed signatures appear on their corresponding pages in the output
And other page content remains unaltered

12
test/features/support_multiple_signatures.feature
View File

@ -2,8 +2,8 @@ Feature: support multiple signatures
Scenario: Place signatures on different pages Scenario: Place signatures on different pages
Given a multi-page PDF is open Given a multi-page PDF is open
When the user places a signature on page 1 When the user places a signature on page {1}
And the user navigates to page 3 and places another signature And the user navigates to page {3} and places another signature
Then both signatures are shown on their respective pages Then both signatures are shown on their respective pages
Scenario: Place multiple signatures on the same page independently Scenario: Place multiple signatures on the same page independently
@ -25,10 +25,10 @@ Feature: support multiple signatures
And the other signatures remain unchanged And the other signatures remain unchanged
Scenario: Keep earlier signatures while navigating between pages Scenario: Keep earlier signatures while navigating between pages
Given a signature is placed on page 2 Given a signature is placed on page {2}
When the user navigates to page 5 and places another signature When the user navigates to page {5} and places another signature
Then the signature on page 2 remains Then the signature on page {2} remains
And the signature on page 5 is shown on page 5 And the signature on page {5} is shown on page {5}
Scenario: Save a document with multiple signatures across pages Scenario: Save a document with multiple signatures across pages
Given a PDF is open and contains multiple placed signatures across pages Given a PDF is open and contains multiple placed signatures across pages