NFA Stamp Manager

A private record manager for organizing NFA stamp entries, tracking related details, and controlling access to sensitive stamp PDFs.

The system provides a way to store approved NFA paperwork, track regulated items, view records from a mobile-friendly interface, and generate time-limited verification access when documentation needs to be shown to a range officer, compliance contact, investigator, or other authorized party.

Private vault Mobile compliance passes QR-based verification PHP + MySQL + PDF access logging
Private workflow, content being documented
VERIFIED VAULT CORE (AES-256) APPROVED TAX STAMP 09:41 COMPLIANCE PASS ITEM: SBR-15 S/N: AE-9482 APPROVED PASS TIMEOUT: 04:59 SECURE CHANNEL GATED MOBILE COMPLIANCE PASS LOG [09:41:02] PDF ACCESS VERIFIED LOG [09:41:04] QR GRANT EXPIRED LOG [09:41:05] SYSTEM AUDIT OK PDF ACCESS LOGGER

Keeping stamp records organized

NFA Stamp Manager is built around a simple need: keep sensitive stamp records organized, searchable, and easier to audit without turning document storage into a scavenger hunt. The current evidence points to a web workflow with a stamp list, per-record documents, and explicit PDF access logging.

The app gives owners a practical way to store approved NFA paperwork, track regulated items, view their collection from a mobile-friendly interface, and produce time-limited verification access when a range officer, compliance contact, investigator, or federal agent needs to confirm documentation.

The core idea is simple: prove compliance without surrendering control of your phone, account, or private document library.

A private vault for NFA records

NFA Stamp Manager gives each owner a private vault for NFA tax stamp records and approved PDF documents. Users can add stamps manually or upload approved ATF paperwork so the app can assist with filling out common fields such as item type, model, serial number, transferor, approval date, and status.

The dashboard summarizes active, pending, inactive, expired, and suspended records. The stamp manager supports searching, filtering, pagination, PDF viewing, edits, soft deletion, recovery, and eventual cleanup of records that are no longer needed.

The mobile wallet view turns active records into quick-access compliance passes. Each pass can show key item details and, when needed, generate a secure QR verification flow for that individual stamp.

Admins can manage users, roles, active/deactivated accounts, and organization-level stamp records while regular users are limited to their own records. The system is built for both individual owners and organizations that need to administer multiple users with clearer oversight.

Observed components

Local evidence is limited, so the claims below are cautious and based on confirmed traces only. Fields marked (likely) are intended but not yet confirmed from source files.

Confirmed Components

  • Backing Database nfa_app
  • Web Record Interface /nfa/v3dev/stamps.php
  • Access Control & Logging Explicit logging of PDF document views

Data flow and access boundaries

The system is designed around controlled access to sensitive records. Owners and admins authenticate into the vault, documents are stored behind access checks, and outside verifiers only receive short-lived access to the specific stamp being verified. The diagram below shows the primary data flow without implementation internals.

flowchart TB owner["NFA Owner
Private Device"] adminUser["Admin User
Oversight Role"] subgraph gateway["Access Gateway"] login["Authenticated Login
Hashed Credentials, Forgery-Protected Forms"] ratelimit["Server-Side Rate Limiting
Lockouts Persist Across Browser Resets"] sessionGuard["Continuous Session Guard
Inactivity Timeout + Per-Request Account Re-Check"] end subgraph vault["Authenticated Vault"] dashboard["Dashboard
Collection Summaries and Status"] manager["Stamp Manager
Add, Edit, Soft Delete, Restore, Purge"] wallet["Mobile Wallet
Per-Item Compliance Passes"] adminPanel["Admin Console
Users, Roles, Org-Wide Records"] end subgraph data["Protected Data Layer"] records["Stamp Records
Owner-Scoped Access"] docs["Per-Owner Document Storage
Server-Assigned, Non-Guessable Locations"] audit["Audit Trail
Actions Logged, Never Document Contents"] end subgraph share["Temporary Verification"] token["Short-Lived Access Grant
Single Stamp, Auto-Expiring"] qr["QR Code
Scanned From the Owner's Screen"] certificate["Limited Verification Certificate
Minimal Fields, No Caching or Indexing"] pdfview["Controlled PDF View
Grant-Gated, Time-Boxed"] end verifier["Verifier's Device
Range Officer, Dealer, Agent, Compliance Contact"] expired["Expired or Stale Link
Access Rejected"] owner --> login adminUser --> login login --> ratelimit --> sessionGuard sessionGuard --> dashboard sessionGuard --> manager sessionGuard --> wallet sessionGuard -- "Admin role only,
re-verified each request" --> adminPanel dashboard --> records manager --> records manager --> docs manager --> audit adminPanel --> records adminPanel --> audit wallet --> records wallet -- "Owner taps Share" --> token token --> qr qr --> verifier verifier --> certificate certificate --> pdfview token -. "Expires automatically
after 15 minutes" .-> expired classDef private fill:#eef2ff,stroke:#3730a3,color:#111827 classDef gate fill:#fdf4ff,stroke:#86198f,color:#111827 classDef protected fill:#ecfdf5,stroke:#047857,color:#111827 classDef temporary fill:#fff7ed,stroke:#c2410c,color:#111827 classDef external fill:#f8fafc,stroke:#475569,color:#111827 class owner,adminUser private class login,ratelimit,sessionGuard gate class dashboard,manager,wallet,adminPanel,records,docs,audit protected class token,qr,certificate,pdfview,expired temporary class verifier external

Node colors indicate access boundary: purple = private users, pink = gateway controls, green = protected vault resources, orange = temporary verification, gray = external verifier devices.

QR-based verification workflow

When documentation needs to be verified, the owner opens the wallet, selects the relevant item, and generates a temporary QR code. The verifying party scans the code using their own device, which opens a limited verification page for the selected stamp.

Scanned link, not shared device

The owner keeps their phone. The verifier uses their own device to view the limited verification page. The QR code encodes a scoped link — not the device itself.

Single stamp scope

Each generated code is tied to a specific stamp record. The verification page shows only the details relevant to that item, not the full record set.

Automatic expiration

Generated verification links expire after a configurable time window. Expired links are rejected at the access layer. This limits the usefulness of captured or forwarded codes.

Access logging

Verification events — generation, access, expiration — are logged. The owner can see when and how many times a verification link was used.

The QR Verification Advantage

When someone needs to verify a specific NFA stamp, the owner does not need to unlock their phone and hand it over. Instead, the owner can open the wallet, choose the relevant item, and generate a temporary QR code. The verifying party scans that code using their own device.

That scan opens a limited verification certificate for the selected item. It can show the relevant compliance details and, when permitted, the approved PDF for that stamp. The link expires automatically after a short window, limiting exposure if the QR code is photographed, forwarded, or left open.

This is a major difference from handing over an unlocked phone.

The owner remains in physical control of their device. The verifier sees the documentation needed for the encounter. The rest of the owner's private life stays private.

Security and privacy controls

NFA paperwork contains identities, regulated item details, serial numbers, dates, transferor information, and official documents. The system treats access control, data separation, and document handling as core requirements rather than afterthoughts.

Account protection

The app uses authenticated accounts with hashed passwords, role-based access, account activation controls, and enforced password changes for default or temporary credentials. Admin functions are restricted to admin users, while standard users are scoped to their own records.

Failed login attempts are rate-limited on the server side, so lockouts persist even if an attacker clears cookies or switches browsers. Repeated guessing against a single account and broader password-spraying patterns are both slowed.

Sessions expire after inactivity, and session identifiers are refreshed during authentication-sensitive events to reduce the risk of session fixation. The session cookie is marked secure on HTTPS deployments. Beyond login, every request re-verifies the account against the live user record: deactivating a user or changing their role takes effect immediately, rather than lingering until an old session happens to expire.

Scoped user access

Regular users can only manage their own stamp records. Admins can manage broader records and user accounts where appropriate. This separation applies to families, trusts, clubs, or organizations where several people need access but should not all have the same authority. Active and deactivated users are handled separately — deactivation does not immediately destroy historical context, which preserves administrative traceability when access must be removed.

Form and request protection

Sensitive form actions include request validation so that routine account, stamp, and profile changes are protected against forged browser submissions. User input is validated and displayed safely to reduce common web application risks.

Database operations are performed through parameterized queries, reducing exposure to injection attacks and keeping user-supplied values separate from database instructions.

Protected document handling

Approved tax stamp PDFs are not treated as ordinary public files. The app validates uploads, limits accepted document types, checks file content, stores documents using non-guessable names, and serves PDFs through controlled access checks rather than simple public links.

Document locations are assigned entirely by the server and are never accepted from the browser, so a tampered request cannot point a record at a file it should not reference. Storage is segregated per owner, and when an administrator reassigns a record to a different owner, the underlying document moves with it so ownership boundaries stay intact.

Document access is checked against the current user's permission, administrative role, or a valid temporary verification grant. Attempts to access a document without authorization are denied and can be logged for review. The contents of uploaded documents are never written into application logs or echoed back in error messages \u2014 diagnostics record what happened, not what the paperwork says.

Time-limited verification

The QR verification flow is intentionally temporary. A generated code is meant for a specific verification moment, not as a permanent public URL to someone's NFA paperwork.

Temporary verification access expires automatically and is tied to the selected stamp. Expired verification links are rejected. This limits the usefulness of old screenshots, forwarded links, or codes left visible after the interaction has ended.

The certificate itself is built on data minimization: it retrieves and displays only the handful of fields a verifier actually needs, never the owner's contact details or anything beyond the selected item. The verification page also instructs browsers and search engines not to cache, index, or pass along the link, so a one-time verification does not leave a discoverable trail.

Auditability and recovery

The system includes audit logging for important administrative and record-management actions. Audit and security logs record actions and outcomes \u2014 who did what, and when \u2014 never the contents of stored documents. Stamp records support soft deletion and recovery, which helps avoid accidental loss while still allowing cleanup of old deleted records.

That lifecycle is important for compliance software. A mistaken deletion should not instantly destroy a critical record, but stale deleted data should not linger forever without a cleanup path.

Browser-level hardening

The app sends security-focused browser headers to reduce common risks such as clickjacking, unintended content interpretation, overly broad referrer leakage, and unauthorized framing. Session cookies are flagged secure when served over HTTPS. In production deployments, HTTPS and properly configured server-level file protections should be used.

Safer phone handling

The app is designed to reduce one of the most uncomfortable real-world risks for owners: being pressured to hand an unlocked phone to someone else.

With QR verification, the owner can keep the phone in hand and show only a scan target. A range officer, law enforcement officer, federal agent, or other verifier can use their own device to review the limited verification page. The owner's messages, photos, browsing sessions, cloud drives, password manager, financial apps, and other private information remain out of scope.

This is not a substitute for legal advice, and it does not change anyone's obligations during a lawful encounter. It is a privacy-preserving way to present documentation without casually exposing an entire personal device.

Production-safe defaults

Administrative diagnostic utilities are disabled by default and must be explicitly switched on in the deployment configuration. A standard production install exposes only the application itself \u2014 no setup checkers, test pages, or environment detail.

The problem it solves

NFA paperwork matters at exactly the moments when fumbling for it is most stressful.

Owners may need to confirm lawful possession at a range, during travel, at a dealer, during an estate or trust review, or in an encounter where handing over an unlocked personal phone creates unnecessary privacy risk. A phone can contain messages, photos, accounts, location history, financial apps, family information, work data, and other personal material that has nothing to do with an NFA item.

Paper copies can be lost, damaged, forgotten, or mixed into old folders. Screenshots and cloud folders are better than nothing, but they often lack access control, audit discipline, and a clean way to show only the stamp that needs to be shown.

NFA Tax Stamp Manager is built for that gap.

Organization that scales with your collection

NFA ownership requires careful recordkeeping, but responsible recordkeeping should not require oversharing.

For individual owners, the app reduces the stress of proving compliance at the range or during unexpected checks. For trusts, families, clubs, dealers, estate planners, and small organizations, it creates a cleaner way to organize ownership records and access boundaries.

The app is also useful for day-to-day collection management. Owners can quickly answer questions such as:

Which stamps are active?
Which items are still pending?
What serial number belongs to which approved document?
Which transferor handled a given item?
Where is the approved PDF?
Who owns which item in a multi-user environment?

That organization becomes especially valuable when a collection grows beyond a few items.

What the tool provides

Secure NFA tax stamp vault
Mobile-friendly progressive web app experience
Dashboard summaries for active, pending, inactive, expired, and suspended records
Searchable and filterable stamp management
Supported NFA item categories including suppressors, SBRs, SBSs, machine guns, and destructive devices
Approved PDF upload and assisted data extraction
Protected PDF viewing with access checks
Mobile wallet-style compliance passes
QR-based temporary verification for individual stamps
Public verification certificate for scanned QR links, limited to minimal fields and shielded from caching and indexing
Server-side login rate limiting that survives cookie and browser resets
Immediate access revocation for deactivated accounts and role changes
Server-assigned, per-owner document storage that follows ownership changes
Privacy-preserving diagnostics that never log document contents
Admin user management
Standard user self-service profile and password management
Role-based access controls
Deactivated user handling
Soft delete, restore, and permanent cleanup flows
Audit logging for key actions
Production-safe defaults with diagnostic tools disabled unless explicitly enabled
Installable app-style mobile experience

Built for the people who need it

NFA Tax Stamp Manager is designed for:

Individual NFA owners
Gun trusts and families with shared compliance needs
Shooting clubs and private ranges
Dealers and compliance-oriented businesses
Estate planners and trustees managing regulated property records
Collectors who want better organization than loose PDFs and paper folders
Owners who want to prove compliance without exposing their unlocked phone

More than a filing cabinet

NFA Tax Stamp Manager is not just a filing cabinet for PDFs. It is a privacy-first compliance presentation tool.

Most storage systems answer the question, "Where did I put the document?" This app also answers, "How do I show the right document to the right person for the shortest reasonable amount of time without exposing everything else?"

That distinction is the product.

A moment of verification

An owner is at a range with a suppressor. A range officer asks to verify the tax stamp.

Instead of unlocking a phone, opening a personal cloud drive, searching through folders, and handing over the device, the owner opens NFA Tax Stamp Manager, taps the item in the mobile wallet, and shows a QR code.

The range officer scans the code with their own phone. The officer sees a verification certificate and the relevant approved stamp document. The owner's phone never leaves their hand. The link expires shortly afterward.

That is faster, cleaner, and more respectful of everyone involved.

Reserved for future capture

All screenshots require a redaction pass before public display. Captions describe what each frame will contain once cleared.

Screenshot slot 01 Stamp list view — Reserved for the primary stamp table or card list. Redact names, serials, trust names, and control numbers.
Screenshot slot 02 Stamp detail view — Reserved for one stamp record with identifying fields blurred.
Screenshot slot 03 PDF access flow — Reserved for document access UI or a redacted PDF viewer.
Screenshot slot 04 Audit trail — Reserved for PDF access log or record activity history.
Screenshot slot 05 Edit workflow — Reserved for create/edit record fields once safe to capture.

What stuck

Private tools still deserve polished information architecture — the same care in structure and navigation applies, even when there's only one user.

Auditability matters most when documents are sensitive — logging and traceability aren't features, they're the foundation of trust in the system.

Screenshot capture must include a redaction pass — every image needs names, serials, trust names, and control numbers removed before it goes public.

Production notes

The app is built as a web-based system with a mobile app-like experience. It can be deployed for personal, family, organizational, or hosted commercial use depending on the business model.

For production use, deployments should use HTTPS, strong administrator credentials, restricted server file access, regular backups, tested restore procedures, and normal operational monitoring. Buyers should treat the system as sensitive compliance infrastructure, not a casual hobby database.

What's next

The public project page documents the workflow, intent, and privacy design. Final screenshots and exact field descriptions should wait for a safe redaction pass before public display.

Prepared without being exposed

NFA owners already accept a high burden of responsibility. They should not also have to choose between being organized and protecting their personal privacy.

NFA Tax Stamp Manager helps owners keep lawful documentation ready, controlled, and presentable. It respects the sensitivity of the data, the reality of mobile-device privacy, and the practical need to verify compliance quickly when asked.

It is a product for people who want to be prepared without being exposed.

NFA Stamp Manager is a recordkeeping and document presentation tool. It is not legal advice, does not determine whether an item is lawful, and does not replace the user's responsibility to comply with all applicable federal, state, and local laws. Users should consult qualified counsel for legal questions about possession, transport, transfer, trusts, documentation obligations, or interactions with law enforcement.