How cooldad7777/stamp-system works
STAMP is an attendance-verification product built around location check-in/out and cryptographically bound proof. The documented user flow leads from a mobile check-in to validator review and compliance reporting; the available tree does not include mobile source, so its runtime wiring cannot be traced. The backend exposes check-in and TSCB verification routes, and includes cryptographic, geohash, database, and blockchain services. The portal has verification, compliance, audit, and settings areas. An independent CLI audits exported records offline. Differential-privacy analytics and federated fraud detection are README capabilities, but no implementation paths for them appear in this tree.
Main entry points: AppRouter.tsx Portal routing · server.ts API server · BlockchainVerificationService.ts Cross-jurisdiction verification · mobile Mobile app
Components 25
Attendance proof
- Mobile app
mobile - Check-in API
backend/src/routes/checkin.ts - TSCB verify API
backend/src/routes/tscb-verify.ts
Backend trust
- TSCB protocol
backend/src/crypto/TSCBProtocol.ts - Crypto service
backend/src/crypto/CryptoService.ts - Geohash service
backend/src/services/GeohashService.ts - API server
backend/src/server.ts - Database service
backend/src/services/DatabaseService.ts - PostgreSQL
- Cross-jurisdiction verification
backend/src/services/BlockchainVerificationService.ts
Validator portal
- Portal app
validator-portal/src/App.tsx - Portal routing
validator-portal/src/components/AppRouter.tsx - Auth state
validator-portal/src/stores/AuthStore.tsx - Login
validator-portal/src/pages/LoginPage.tsx - Dashboard
validator-portal/src/pages/DashboardPage.tsx - Verification
validator-portal/src/pages/VerificationPage.tsx - Compliance reports
validator-portal/src/pages/CompliancePage.tsx - Audit view
validator-portal/src/pages/AuditPage.tsx - Settings
validator-portal/src/pages/SettingsPage.tsx
Independent audit
- Offline record auditor
stamp_verify/verify.js - Exported record
Other components
- Attendee
- Blockchain network
- Validator
- Facility public key
Connections 21
- Attendee → Mobile app: uses
- Mobile app → Check-in API: submits check-in
- API server → Check-in API: registers route
- API server → TSCB verify API: registers route
- API server → Database service: initializes
- API server → Crypto service: initializes
- API server → Geohash service: initializes
- Database service → PostgreSQL: queries
- Cross-jurisdiction verification → Crypto service: generates proof
- Cross-jurisdiction verification → Blockchain network: submits verification
- Validator → Portal app: uses
- Portal app → Portal routing: renders
- Portal routing → Auth state: checks session
- Portal routing → Login: routes to
- Portal routing → Dashboard: routes to
- Portal routing → Verification: routes to
- Portal routing → Compliance reports: routes to
- Portal routing → Audit view: routes to
- Portal routing → Settings: routes to
- Exported record → Offline record auditor: audits
- Facility public key → Offline record auditor: verifies signature