How kuankuan2007/hamlog-manager works
Hamlog Manager is a local ham-radio contact and QSL management application. The main workflow runs from browser pages through the frontend API client to HTTP routes, which validate requests and read or update SQLite; returned records support contact search, address management, and QSL tracking. Separate branches provide callsign/email lookup and email preparation, preview, and SMTP sending. The README documents these capabilities; some route-to-storage details are not shown in sampled source, so those links reflect documented responsibilities rather than inspected call sites.
Main entry points: api/index.ts HTTP API · select/index.ts Select routes · update/index.ts Update routes · callsign2email.ts Automatic lookup
Components 23
Web application
- Vue application
src/main.ts - Management pages
src/views - Page router
src/router/index.ts - API client
src/api
Contact records
- Select routes
server/api/select/index.ts - Update routes
server/api/update/index.ts - Contact records
server/database/select.ts - Record writes
server/database/update.ts - Address and QSL
schema
Email lookup
- Email cache
server/database/callsign-email-cache.ts - Automatic lookup
server/auto/callsign2email.ts - Lookup route
server/api/auto/index.ts
Email workflow
- Email pages
src/views/EmailPrepare.vue - Email composition
src/scripts/mailContent.ts - Email routes
server/api/email/index.ts - Template and SMTP
server/email/send.ts
Server and storage
- Shared schemas
schema - HTTP API
server/api/index.ts - SQLite database
- HTTP server
server/index.ts
Other components
- Ham operator
- QRZ.com
- SMTP service
Connections 26
- Ham operator → Vue application: uses
- Vue application → Page router: mounts
- Page router → Management pages: routes
- Management pages → API client: requests
- API client → HTTP API: calls API
- HTTP server → HTTP API: registers
- HTTP API → Select routes: dispatches
- HTTP API → Update routes: dispatches
- HTTP API → Lookup route: dispatches
- HTTP API → Email routes: dispatches
- Update routes → Shared schemas: validates
- Email routes → Shared schemas: validates
- Select routes → Contact records: reads
- Select routes → SQLite database: reads
- Update routes → Record writes: writes
- Record writes → SQLite database: writes
- Select routes → Address and QSL: serves records
- Lookup route → Automatic lookup: dispatches
- Automatic lookup → Email cache: checks cache
- Email cache → SQLite database: reads and writes
- Automatic lookup → QRZ.com: queries
- Email pages → API client: requests
- Email pages → Email composition: prepares
- Email composition → Email pages: returns draft
- Email routes → Template and SMTP: renders and sends
- Template and SMTP → SMTP service: sends mail