Files
accounted/lib/documents/filename-voucher-ref.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

179 lines
7.5 KiB
TypeScript

/**
* Read a source-system voucher reference out of an underlag filename.
*
* Systems that export receipts alongside a SIE file name each file after the
* verifikat it belongs to: SpeedLedger writes `A31_<internal-uuid>.pdf`, Fortnox
* `V123.pdf`, others `2024-A-31 kvitto.pdf`. That prefix is a deterministic
* pointer into the ledger, which is why underlag import does not need to read
* the document at all: no AI, no amount matching, no date windows.
*
* Design rule: an unrecognised name returns null. A wrong parse attaches
* räkenskapsinformation to the wrong verifikat, and that cannot be undone
* (BFL 7 kap), so the cost of guessing is far higher than the cost of asking.
*/
export type VoucherRefPattern =
/** `A31`, `A31_uuid`, `A-31 kvitto`, `2024_A31`, `ver A31` */
| 'series_number'
/** `31`, `31_kvitto`: a number with no series at all. */
| 'number_only'
export interface ParsedFileNameRef {
/** Null when the filename carried a number but no series. */
series: string | null
number: number
pattern: VoucherRefPattern
/**
* Whether this parse may be pre-selected in a bulk plan. Three classes are
* never auto-selectable, even on a single-candidate hit:
* - series-less parses (`31.pdf` can point at any series);
* - refs on the collision list (`A4.pdf` is far more often a scanner's
* paper size than verifikat A4, `K10.pdf` a blankett);
* - three-letter series (`IMG_0031.jpg`: real SIE series are 1-2 chars,
* three letters is a camera or scanner prefix).
* They all still parse and resolve; a human confirms with one click.
*/
autoSelectable: boolean
}
/**
* Optional noise ahead of the reference: a year folder prefix and the words
* some exporters prepend. Kept tight on purpose, `(?:19|20)\d{2}` rather than
* any 4 digits, so a voucher number is never eaten as a year.
*
* `ifikation` must precede `ifikat` in the alternation: regex alternation is
* first-match, so the short branch would otherwise consume `Verifikat` out of
* `Verifikation 31` and leave `ion` for the series group to swallow.
*/
const YEAR_NOISE = '(?:(?:19|20)\\d{2}[-_. ]+)?'
/**
* The lookahead is load-bearing, not decoration. Without it the engine
* backtracks into the shorter alternatives and `Verifikation 31` matches `ver`
* + `ifikat`, leaving `ion` for the series group to swallow as series `ION`.
* Requiring the word to end here means the prefix is either the whole word or
* not consumed at all.
*/
const VER_NOISE = '(?:ver(?:ifikation|ifikat)?(?![A-Za-zÅÄÖåäö])[-_. ]*)?'
/** `A31`, `A-31`, `A_31`, `A 31`, optionally followed by `_`/`-`/space + anything. */
const SERIES_NUMBER_RE = new RegExp(
`^${YEAR_NOISE}${VER_NOISE}([A-Za-zÅÄÖåäö]{1,3})[-_. ]?(\\d{1,7})(?:[-_. ].*)?$`,
'i',
)
/**
* `31`, `31_kvitto`, `Verifikat 31`. The `ver` prefix is allowed here but the
* year prefix is NOT: `2024 31` is far more likely a date fragment than
* voucher 31 of 2024, and this branch has no series to corroborate it with.
*/
const NUMBER_ONLY_RE = new RegExp(`^${VER_NOISE}(\\d{1,6})(?:[-_. ].*)?$`, 'i')
/**
* A date-named file, never a voucher number. Deliberately loose where the
* parser is strict: unpadded components (`2024-1-31`), two-digit years
* (`24-01-31`), any of `-_. /` as separator, and the compact `20240131`.
* A false positive here costs one manual assignment; a false negative attaches
* a receipt to a verifikat whose number happens to equal a year fragment.
*/
const DATE_PREFIX_RE = new RegExp(
'^(?:' +
// 20240131
'(?:19|20)\\d{6}' +
// 2024-01-31, 2024-1-31, 24-01-31, 2024 01 31, 2024/01/31
'|(?:19|20)?\\d{2}[-_. /]\\d{1,2}[-_. /]\\d{1,2}' +
// 31.01.2024, 31/1/2024, 12-24-2024: day-first and US order. Without this
// the day becomes a voucher number that always exists in the year.
'|\\d{1,2}[-_. /]\\d{1,2}[-_. /](?:19|20)\\d{2}' +
')(?!\\d)',
)
/**
* `ver` is a prefix word, never a series. Without this `ver 31.pdf` parses as
* series VER and comes back auto-selectable, while the spelled-out
* `Verifikat 31.pdf` correctly yields a series-less reference that requires
* confirmation. Same filename, two trust levels, decided by an abbreviation.
*/
const NOT_A_SERIES = new Set(['VER'])
/**
* Refs that are, in the wild, far more often document names than voucher
* references: A0-A6 are paper sizes (every scanner emits an `A4.pdf`),
* K2-K13 / N1-N9 / T1-T2 are Skatteverket blanketter, Q1-Q4 are quarters.
* Verifikat A4 genuinely exists in every migrated ledger, which is exactly
* why these must not be pre-selected: the review table cannot tell a scanned
* "A4.pdf" from the real receipt for voucher A4, and a wrong link is
* permanent. Demoted, not refused: a genuine A4 costs one click.
*
* The inconsistency this fixes: `31.pdf` already required confirmation while
* `A4 scan.pdf`, which carries LESS voucher evidence in a single-series
* company, was pre-ticked.
*/
const COLLISION_REFS = new Set([
'A0', 'A1', 'A2', 'A3', 'A4', 'A5', 'A6',
'K2', 'K3', 'K4', 'K5', 'K6', 'K7', 'K8', 'K9', 'K10', 'K11', 'K12', 'K13',
'N1', 'N2', 'N3', 'N4', 'N5', 'N6', 'N7', 'N8', 'N9',
'T1', 'T2',
'Q1', 'Q2', 'Q3', 'Q4',
])
/** Real SIE series are 1-2 characters; three letters is IMG/DSC/DOC/SCN. */
const MAX_AUTO_SERIES_LENGTH = 2
/**
* Any four-digit run that reads as a calendar year. Used to refuse a
* SERIES-LESS parse: `2024` alone is overwhelmingly a year, not verifikat 2024.
*/
const YEAR_LIKE_RE = /^(?:19|20)\d{2}$/
/**
* Trim only. Directory components are NOT stripped: `file.name` from an
* `<input type=file>` never carries a path, while the manual-reference box
* feeds arbitrary user text through this same parser, where splitting on `/`
* would quietly turn the typed date `2024/01/31` into voucher 31. The one
* place a path does show up is the multipart `filename` of an upload (Chrome
* writes the folder-relative path for folder selections); the attach route
* reduces that to a basename before it reaches here, see
* `lib/documents/upload-file-name.ts`.
*/
function baseName(fileName: string): string {
return fileName.trim()
}
/** Drop the extension, but only a real-looking one (`.pdf`, `.jpeg`). */
function stripExtension(name: string): string {
return name.replace(/\.[A-Za-z0-9]{1,5}$/, '')
}
export function parseVoucherRefFromFileName(fileName: string): ParsedFileNameRef | null {
const stem = stripExtension(baseName(fileName))
if (!stem) return null
// A file named after its date is the single most common false positive: the
// digits parse cleanly and point at a verifikat number that has nothing to do
// with the receipt. Refuse the whole name rather than try to be clever.
if (DATE_PREFIX_RE.test(stem)) return null
const seriesMatch = SERIES_NUMBER_RE.exec(stem)
if (seriesMatch) {
const series = seriesMatch[1].toUpperCase()
const number = Number(seriesMatch[2])
if (!NOT_A_SERIES.has(series) && Number.isInteger(number) && number > 0) {
// The check runs on the NORMALIZED ref: a scanner's `A0004.pdf` parses
// to number 4 and must be caught by the same A4 entry.
const autoSelectable =
series.length <= MAX_AUTO_SERIES_LENGTH && !COLLISION_REFS.has(`${series}${number}`)
return { series, number, pattern: 'series_number', autoSelectable }
}
}
const numberMatch = NUMBER_ONLY_RE.exec(stem)
if (numberMatch && !YEAR_LIKE_RE.test(numberMatch[1])) {
const number = Number(numberMatch[1])
if (Number.isInteger(number) && number > 0) {
return { series: null, number, pattern: 'number_only', autoSelectable: false }
}
}
return null
}