Editing Business Requirement Document (section)

== 4. Functional Requirements ==

<span id="fr-01-prime-generation"></span>
=== FR-01 — Prime Generation ===

* The system shall accept a <code>generate</code> command-line argument to trigger prime-number generation.
* The system shall test every odd integer from 3 upward for primality using trial division.
* The system shall store each confirmed prime in the database in ascending order of discovery.
* Generation shall continue until the candidate number reaches 999,999,999.

<span id="fr-02-trial-division-algorithm-correctness"></span>
=== FR-02 — Trial-Division Algorithm Correctness ===

* For each candidate number N, the system shall divide N by each known prime p where p ≤ √N.
* If any p divides N exactly (remainder = 0), N is composite and shall not be stored.
* If no p ≤ √N divides N, N is prime and shall be persisted.

<span id="fr-03-prime-reporting"></span>
=== FR-03 — Prime Reporting ===

* The system shall accept a <code>report</code> command-line argument to trigger report generation.
* The system shall read all stored primes from the database in sequence order.
* The system shall write a paginated, formatted print file containing all primes.

<span id="fr-04-print-report-format"></span>
=== FR-04 — Print Report Format ===

* The report shall contain a page heading (“primes overview”) and column headers on each page.
* Each data line shall display six prime entries side by side: sequence number and prime value.
* Each page shall carry a page-number footing.
* The print record width shall be 132 characters.
* The report shall be written to a file named <code>primes.prt</code>.

<span id="fr-05-operational-logging"></span>
=== FR-05 — Operational Logging ===

* The system shall write progress and status messages to the system console throughout execution.
* Each message shall identify the issuing program name and paragraph.

<span id="fr-06-error-handling"></span>
=== FR-06 — Error Handling ===

* The system shall log an error message and stop cleanly if an unrecognised command-line argument is provided.
* The system shall log an error message and stop cleanly if the print file cannot be opened.
* The system shall log database connection or cursor failures and set an error indicator before exiting.


-----

<span id="non-functional-requirements"></span>