AMPA Digital Membership Card System

A cryptographically secure digital membership card platform.

Try the Live Apps

• Verifier (production domain): https://verify.ampanovaschoolalmeria.org/
  • Verifier with a valid membership
  • Verifier with an expired membership
  • Verifier with a revoked membership
• Issuer (production domain): https://verify.ampanovaschoolalmeria.org/issuer/

Issuer link is useful for evaluation only. For real use, run issuer locally and never expose production private keys in a public environment.

What This Repo Contains

• Issuer app (issuer/): admin tool to create signed membership cards (PNG + QR)
• Issuer desktop scaffold (issuer/src-tauri/): optional installer packaging path for Windows/macOS/Linux
• Verification app (verification/): public app for merchants to validate cards
• Shared project docs (docs/): technical spec, roadmap, and implementation notes

Cards are signed with EdDSA (Ed25519). Verification is performed client-side using the public key.

Quick Start

Prerequisites

• Node.js >=20

Install and test

npm install
cd verification && npm install && cd ..
cd issuer && npm install && cd ..
npm test

Run locally

# Terminal 1
cd verification && npm run dev

# Terminal 2
cd issuer && npm run dev

• Verification local URL: http://localhost:5173
• Issuer local URL: http://localhost:5174

For full end-to-end setup (key generation, config wiring, card generation, verification flow), see docs/LOCAL_SETUP.md.

Documentation Map

• Manuals index (EN/ES, end-user + technical): docs/MANUALS.md
• Issuer end-user manual (EN): docs/manuals/end-user/issuer/en/README.md
• Manual de usuario del Emisor (ES): docs/manuals/end-user/issuer/es/README.md
• Verifier end-user manual (EN): docs/manuals/end-user/verifier/en/README.md
• Manual de usuario del Verificador (ES): docs/manuals/end-user/verifier/es/README.md
• Technical manual (EN): docs/manuals/technical/en/README.md
• Manual técnico (ES): docs/manuals/technical/es/README.md
• End-to-end local setup: docs/LOCAL_SETUP.md
• Issuer details: issuer/README.md
• Issuer PWA install/offline guide: issuer/README.md#pwa-install-and-offline-behavior
• Verification details: verification/README.md
• Security policy and model: SECURITY.md
• Technical specification: docs/SPEC.md
• Desktop packaging/signing guide: docs/DESKTOP_SIGNING.md
• Roadmap and status: docs/TODO.md
• Implementation plan/history: docs/PLAN.md
• Contributing guide: CONTRIBUTING.md

Security

• Never commit private keys.
• Issuer is intended for local/admin use.
• Verification distributes only a public key.

See full details in SECURITY.md.

License

MIT. See LICENSE.