iarv/meshcore-hub
1
0
Fork 1
mirror of https://github.com/ipnet-mesh/meshcore-hub.git synced 2026-03-28 17:42:56 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
meshcore-hub/TASKS.md
yellowcooln c22274c4e5 Add LetsMesh structured event parity mappings
2026-03-03 16:18:54 -05:00

796 lines
25 KiB
Markdown
Raw Permalink Blame History

# MeshCore Hub - Task Tracker
This document tracks implementation progress for the MeshCore Hub project. Each task can be checked off as completed.
---
## Phase 1: Foundation ✅
### 1.1 Project Setup
- [x] Create `pyproject.toml` with project metadata and dependencies
- [x] Configure Python 3.11+ requirement
- [x] Set up `src/meshcore_hub/` package structure
- [x] Create `__init__.py` files for all packages
- [x] Create `__main__.py` entry point
### 1.2 Development Tools
- [x] Configure `black` formatter settings in pyproject.toml
- [x] Configure `flake8` linting (create `.flake8` or add to pyproject.toml)
- [x] Configure `mypy` type checking settings
- [x] Configure `pytest` settings and test directory
- [x] Create `.pre-commit-config.yaml` with hooks:
- [x] black
- [x] flake8
- [x] mypy
- [x] trailing whitespace
- [x] end-of-file-fixer
- [x] Create `.env.example` with all environment variables
### 1.3 Common Package - Configuration
- [x] Create `common/config.py` with Pydantic Settings:
- [x] `CommonSettings` (logging, MQTT connection)
- [x] `InterfaceSettings` (mode, serial port, mock device)
- [x] `CollectorSettings` (database URL, webhook settings)
- [x] `APISettings` (host, port, API keys)
- [x] `WebSettings` (host, port, network info)
- [x] Implement environment variable loading
- [x] Implement CLI argument override support
- [x] Add configuration validation
### 1.4 Common Package - Database Models
- [x] Create `common/database.py`:
- [x] Database engine factory
- [x] Session management
- [x] Async session support
- [x] Create `common/models/base.py`:
- [x] Base model with UUID primary key
- [x] Timestamp mixins (created_at, updated_at)
- [x] Create `common/models/node.py`:
- [x] Node model (public_key, name, adv_type, flags, first_seen, last_seen)
- [x] Indexes on public_key
- [x] Create `common/models/node_tag.py`:
- [x] NodeTag model (node_id FK, key, value, value_type)
- [x] Unique constraint on (node_id, key)
- [x] Create `common/models/message.py`:
- [x] Message model (receiver_node_id, message_type, pubkey_prefix, channel_idx, text, etc.)
- [x] Indexes for common query patterns
- [x] Create `common/models/advertisement.py`:
- [x] Advertisement model (receiver_node_id, node_id, public_key, name, adv_type, flags)
- [x] Create `common/models/trace_path.py`:
- [x] TracePath model (receiver_node_id, initiator_tag, path_hashes JSON, snr_values JSON)
- [x] Create `common/models/telemetry.py`:
- [x] Telemetry model (receiver_node_id, node_id, node_public_key, lpp_data, parsed_data JSON)
- [x] Create `common/models/event_log.py`:
- [x] EventLog model (receiver_node_id, event_type, payload JSON)
- [x] Create `common/models/__init__.py` exporting all models
### 1.5 Common Package - Pydantic Schemas
- [x] Create `common/schemas/events.py`:
- [x] AdvertisementEvent schema
- [x] ContactMessageEvent schema
- [x] ChannelMessageEvent schema
- [x] TraceDataEvent schema
- [x] TelemetryResponseEvent schema
- [x] ContactsEvent schema
- [x] SendConfirmedEvent schema
- [x] StatusResponseEvent schema
- [x] BatteryEvent schema
- [x] PathUpdatedEvent schema
- [x] Create `common/schemas/nodes.py`:
- [x] NodeCreate, NodeRead, NodeList schemas
- [x] NodeTagCreate, NodeTagUpdate, NodeTagRead schemas
- [x] Create `common/schemas/messages.py`:
- [x] MessageRead, MessageList schemas
- [x] MessageFilters schema
- [x] Create `common/schemas/commands.py`:
- [x] SendMessageCommand schema
- [x] SendChannelMessageCommand schema
- [x] SendAdvertCommand schema
- [x] Create `common/schemas/__init__.py` exporting all schemas
### 1.6 Common Package - Utilities
- [x] Create `common/mqtt.py`:
- [x] MQTT client factory function
- [x] Topic builder utilities
- [x] Message serialization helpers
- [x] Async publish/subscribe wrappers
- [x] Create `common/logging.py`:
- [x] Logging configuration function
- [x] Structured logging format
- [x] Log level configuration from settings
### 1.7 Database Migrations
- [x] Create `alembic.ini` configuration
- [x] Create `alembic/env.py` with async support
- [x] Create `alembic/script.py.mako` template
- [x] Create initial migration with all tables:
- [x] nodes table
- [x] node_tags table
- [x] messages table
- [x] advertisements table
- [x] trace_paths table
- [x] telemetry table
- [x] events_log table
- [x] Test migration upgrade/downgrade
### 1.8 Main CLI Entry Point
- [x] Create root Click group in `__main__.py`
- [x] Add `--version` option
- [x] Add `--config` option for config file path
- [x] Add subcommand placeholders for: interface, collector, api, web, db
---
## Phase 2: Interface Component ✅
### 2.1 Device Abstraction
- [x] Create `interface/device.py`:
- [x] `MeshCoreDevice` class wrapping meshcore_py
- [x] Connection management (connect, disconnect, reconnect)
- [x] Get device public key via `send_appstart()`
- [x] Event subscription registration
- [x] Command sending methods
- [x] Create `interface/mock_device.py`:
- [x] `MockMeshCoreDevice` class
- [x] Configurable event generation
- [x] Simulated message sending
- [x] Simulated network topology (optional)
- [x] Configurable delays and error rates
### 2.2 Receiver Mode
- [x] Create `interface/receiver.py`:
- [x] `Receiver` class
- [x] Initialize MQTT client
- [x] Initialize MeshCore device
- [x] Subscribe to all relevant MeshCore events:
- [x] ADVERTISEMENT
- [x] CONTACT_MSG_RECV
- [x] CHANNEL_MSG_RECV
- [x] TRACE_DATA
- [x] TELEMETRY_RESPONSE
- [x] CONTACTS
- [x] SEND_CONFIRMED
- [x] STATUS_RESPONSE
- [x] BATTERY
- [x] PATH_UPDATED
- [x] Event handler that publishes to MQTT
- [x] Topic construction: `<prefix>/<pubkey>/event/<event_name>`
- [x] JSON serialization of event payloads
- [x] Graceful shutdown handling
### 2.3 Sender Mode
- [x] Create `interface/sender.py`:
- [x] `Sender` class
- [x] Initialize MQTT client
- [x] Initialize MeshCore device
- [x] Subscribe to command topics:
- [x] `<prefix>/+/command/send_msg`
- [x] `<prefix>/+/command/send_channel_msg`
- [x] `<prefix>/+/command/send_advert`
- [x] `<prefix>/+/command/request_status`
- [x] `<prefix>/+/command/request_telemetry`
- [x] Command handlers:
- [x] `handle_send_msg` - send direct message
- [x] `handle_send_channel_msg` - send channel message
- [x] `handle_send_advert` - send advertisement
- [x] `handle_request_status` - request node status
- [x] `handle_request_telemetry` - request telemetry
- [x] Error handling and logging
- [x] Graceful shutdown handling
### 2.4 Interface CLI
- [x] Create `interface/cli.py`:
- [x] `interface` Click command group
- [x] `--mode` option (receiver/sender, required)
- [x] `--port` option for serial port
- [x] `--baud` option for baud rate
- [x] `--mock` flag to use mock device
- [x] `--mqtt-host`, `--mqtt-port` options
- [x] `--prefix` option for MQTT topic prefix
- [x] Signal handlers for graceful shutdown
- [x] Register CLI with main entry point
### 2.5 Interface Tests
- [x] Create `tests/test_interface/conftest.py`:
- [x] Mock MQTT client fixture
- [x] Mock device fixture
- [x] Create `tests/test_interface/test_device.py`:
- [x] Test connection/disconnection
- [x] Test event subscription
- [x] Test command sending
- [x] Create `tests/test_interface/test_mock_device.py`:
- [x] Test mock event generation
- [x] Test mock command handling
- [x] Create `tests/test_interface/test_receiver.py`:
- [x] Test event to MQTT publishing
- [x] Test topic construction
- [x] Test payload serialization
- [x] Create `tests/test_interface/test_sender.py`:
- [x] Test MQTT to command dispatching
- [x] Test command payload parsing
- [x] Test error handling
---
## Phase 3: Collector Component ✅
### 3.1 MQTT Subscriber
- [x] Create `collector/subscriber.py`:
- [x] `Subscriber` class
- [x] Initialize MQTT client
- [x] Subscribe to all event topics: `<prefix>/+/event/#`
- [x] Parse topic to extract public_key and event_type
- [x] Route events to appropriate handlers
- [x] Handle connection/disconnection
- [x] Graceful shutdown
### 3.2 Event Handlers
- [x] Create `collector/handlers/__init__.py`:
- [x] Handler registry pattern
- [x] Create `collector/handlers/advertisement.py`:
- [x] Parse advertisement payload
- [x] Upsert node in nodes table
- [x] Insert advertisement record
- [x] Update node last_seen timestamp
- [x] Create `collector/handlers/message.py`:
- [x] Parse contact/channel message payload
- [x] Insert message record
- [x] Handle both CONTACT_MSG_RECV and CHANNEL_MSG_RECV
- [x] Create `collector/handlers/trace.py`:
- [x] Parse trace data payload
- [x] Insert trace_path record
- [x] Create `collector/handlers/telemetry.py`:
- [x] Parse telemetry payload
- [x] Insert telemetry record
- [x] Optionally upsert node
- [x] Create `collector/handlers/contacts.py`:
- [x] Parse contacts sync payload
- [x] Upsert multiple nodes
- [x] Create `collector/handlers/event_log.py`:
- [x] Generic handler for events_log table
- [x] Handle informational events (SEND_CONFIRMED, STATUS_RESPONSE, BATTERY, PATH_UPDATED)
### 3.3 Webhook Dispatcher (Optional based on Q10)
- [x] Create `collector/webhook.py`:
- [x] `WebhookDispatcher` class
- [x] Webhook configuration loading
- [x] JSONPath filtering support
- [x] Async HTTP POST sending
- [x] Retry logic with backoff
- [x] Error logging
### 3.4 Collector CLI
- [x] Create `collector/cli.py`:
- [x] `collector` Click command
- [x] `--mqtt-host`, `--mqtt-port` options
- [x] `--prefix` option
- [x] `--database-url` option
- [x] Signal handlers for graceful shutdown
- [x] Register CLI with main entry point
### 3.5 Collector Tests
- [x] Create `tests/test_collector/conftest.py`:
- [x] In-memory SQLite database fixture
- [x] Mock MQTT client fixture
- [x] Create `tests/test_collector/test_subscriber.py`:
- [x] Test topic parsing
- [x] Test event routing
- [x] Create `tests/test_collector/test_handlers/`:
- [x] `test_advertisement.py`
- [x] `test_message.py`
- [x] `test_trace.py`
- [x] `test_telemetry.py`
- [x] `test_contacts.py`
- [x] Create `tests/test_collector/test_webhook.py`:
- [x] Test webhook dispatching
- [x] Test JSONPath filtering
- [x] Test retry logic
---
## Phase 4: API Component ✅
### 4.1 FastAPI Application Setup
- [x] Create `api/app.py`:
- [x] FastAPI application instance
- [x] Lifespan handler for startup/shutdown
- [x] Include all routers
- [x] Exception handlers
- [x] CORS middleware configuration
- [x] Create `api/dependencies.py`:
- [x] Database session dependency
- [x] MQTT client dependency
- [x] Settings dependency
### 4.2 Authentication
- [x] Create `api/auth.py`:
- [x] Bearer token extraction
- [x] `require_read` dependency (read or admin key)
- [x] `require_admin` dependency (admin key only)
- [x] 401/403 error responses
### 4.3 Node Routes
- [x] Create `api/routes/nodes.py`:
- [x] `GET /api/v1/nodes` - list nodes with pagination
- [x] Query params: limit, offset, search, adv_type
- [x] `GET /api/v1/nodes/{public_key}` - get single node
- [x] Include related tags in response (optional)
### 4.4 Node Tag Routes
- [x] Create `api/routes/node_tags.py`:
- [x] `GET /api/v1/nodes/{public_key}/tags` - list tags
- [x] `POST /api/v1/nodes/{public_key}/tags` - create tag (admin)
- [x] `PUT /api/v1/nodes/{public_key}/tags/{key}` - update tag (admin)
- [x] `DELETE /api/v1/nodes/{public_key}/tags/{key}` - delete tag (admin)
### 4.5 Message Routes
- [x] Create `api/routes/messages.py`:
- [x] `GET /api/v1/messages` - list messages with filters
- [x] Query params: type, pubkey_prefix, channel_idx, since, until, limit, offset
- [x] `GET /api/v1/messages/{id}` - get single message
### 4.6 Advertisement Routes
- [x] Create `api/routes/advertisements.py`:
- [x] `GET /api/v1/advertisements` - list advertisements
- [x] Query params: public_key, since, until, limit, offset
- [x] `GET /api/v1/advertisements/{id}` - get single advertisement
### 4.7 Trace Path Routes
- [x] Create `api/routes/trace_paths.py`:
- [x] `GET /api/v1/trace-paths` - list trace paths
- [x] Query params: since, until, limit, offset
- [x] `GET /api/v1/trace-paths/{id}` - get single trace path
### 4.8 Telemetry Routes
- [x] Create `api/routes/telemetry.py`:
- [x] `GET /api/v1/telemetry` - list telemetry records
- [x] Query params: node_public_key, since, until, limit, offset
- [x] `GET /api/v1/telemetry/{id}` - get single telemetry record
### 4.9 Command Routes
- [x] Create `api/routes/commands.py`:
- [x] `POST /api/v1/commands/send-message` (admin)
- [x] Request body: destination, text, timestamp (optional)
- [x] Publish to MQTT command topic
- [x] `POST /api/v1/commands/send-channel-message` (admin)
- [x] Request body: channel_idx, text, timestamp (optional)
- [x] Publish to MQTT command topic
- [x] `POST /api/v1/commands/send-advertisement` (admin)
- [x] Request body: flood (boolean)
- [x] Publish to MQTT command topic
### 4.10 Dashboard Routes
- [x] Create `api/routes/dashboard.py`:
- [x] `GET /api/v1/stats` - JSON statistics
- [x] Total nodes count
- [x] Active nodes (last 24h)
- [x] Total messages count
- [x] Messages today
- [x] Total advertisements
- [x] Channel message counts
- [x] `GET /api/v1/dashboard` - HTML dashboard
- [x] Create `api/templates/dashboard.html`:
- [x] Simple HTML template
- [x] Display statistics
- [x] Basic CSS styling
- [x] Auto-refresh meta tag (optional)
### 4.11 API Router Registration
- [x] Create `api/routes/__init__.py`:
- [x] Create main API router
- [x] Include all sub-routers with prefixes
- [x] Add OpenAPI tags
### 4.12 API CLI
- [x] Create `api/cli.py`:
- [x] `api` Click command
- [x] `--host` option
- [x] `--port` option
- [x] `--database-url` option
- [x] `--read-key` option
- [x] `--admin-key` option
- [x] `--mqtt-host`, `--mqtt-port` options
- [x] `--reload` flag for development
- [x] Register CLI with main entry point
### 4.13 API Tests
- [x] Create `tests/test_api/conftest.py`:
- [x] Test client fixture
- [x] In-memory database fixture
- [x] Test API keys
- [x] Create `tests/test_api/test_auth.py`:
- [x] Test missing token
- [x] Test invalid token
- [x] Test read-only access
- [x] Test admin access
- [x] Create `tests/test_api/test_nodes.py`:
- [x] Test list nodes
- [x] Test get node
- [x] Test pagination
- [x] Test filtering
- [x] Create `tests/test_api/test_node_tags.py`:
- [x] Test CRUD operations
- [x] Test permission checks
- [x] Create `tests/test_api/test_messages.py`:
- [x] Test list messages
- [x] Test filtering
- [x] Create `tests/test_api/test_commands.py`:
- [x] Test send message command
- [x] Test permission checks
- [x] Test MQTT publishing
---
## Phase 5: Web Dashboard ✅
### 5.1 FastAPI Application Setup
- [x] Create `web/app.py`:
- [x] FastAPI application instance
- [x] Jinja2 templates configuration
- [x] Static files mounting
- [x] Lifespan handler
- [x] Include all routers
### 5.2 Frontend Assets
- [x] Create `web/static/css/` directory
- [x] Set up Tailwind CSS:
- [x] Using Tailwind CDN with DaisyUI plugin
- [x] Configured in base.html template
- [x] Create `web/static/js/` directory:
- [x] Minimal JS for interactivity (if needed)
### 5.3 Base Template
- [x] Create `web/templates/base.html`:
- [x] HTML5 doctype and structure
- [x] Meta tags (viewport, charset)
- [x] Tailwind CSS inclusion
- [x] Navigation header:
- [x] Network name
- [x] Links to all pages
- [x] Footer with contact info
- [x] Content block for page content
### 5.4 Home Page
- [x] Create `web/routes/home.py`:
- [x] `GET /` - home page route
- [x] Load network configuration
- [x] Create `web/templates/home.html`:
- [x] Welcome message with network name
- [x] Network description/details
- [x] Radio configuration display
- [x] Location information
- [x] Contact information (email, Discord)
- [x] Quick links to other sections
### 5.5 Members Page
- [x] Create `web/routes/members.py`:
- [x] `GET /members` - members list route
- [x] Load members from JSON file
- [x] Create `web/templates/members.html`:
- [x] Members list/grid
- [x] Member cards with:
- [x] Name
- [x] Callsign (if applicable)
- [x] Role/description
- [x] Contact info (optional)
### 5.6 Network Overview Page
- [x] Create `web/routes/network.py`:
- [x] `GET /network` - network stats route
- [x] Fetch stats from API
- [x] Create `web/templates/network.html`:
- [x] Statistics cards:
- [x] Total nodes
- [x] Active nodes
- [x] Total messages
- [x] Messages today
- [x] Channel statistics
- [x] Recent activity summary
### 5.7 Nodes Page
- [x] Create `web/routes/nodes.py`:
- [x] `GET /nodes` - nodes list route
- [x] `GET /nodes/{public_key}` - node detail route
- [x] Fetch from API with pagination
- [x] Create `web/templates/nodes.html`:
- [x] Search/filter form
- [x] Nodes table:
- [x] Name
- [x] Public key (truncated)
- [x] Type
- [x] Last seen
- [x] Tags
- [x] Pagination controls
- [x] Create `web/templates/node_detail.html`:
- [x] Full node information
- [x] All tags
- [x] Recent messages (if any)
- [x] Recent advertisements
### 5.8 Node Map Page
- [x] Create `web/routes/map.py`:
- [x] `GET /map` - map page route
- [x] `GET /map/data` - JSON endpoint for node locations
- [x] Filter nodes with location tags
- [x] Create `web/templates/map.html`:
- [x] Leaflet.js map container
- [x] Leaflet CSS/JS includes
- [x] JavaScript for:
- [x] Initialize map centered on NETWORK_LOCATION
- [x] Fetch node location data
- [x] Add markers for each node
- [x] Popup with node info on click
### 5.9 Messages Page
- [x] Create `web/routes/messages.py`:
- [x] `GET /messages` - messages list route
- [x] Fetch from API with filters
- [x] Create `web/templates/messages.html`:
- [x] Filter form:
- [x] Message type (contact/channel)
- [x] Channel selector
- [x] Date range
- [x] Search text
- [x] Messages table:
- [x] Timestamp
- [x] Type
- [x] Sender/Channel
- [x] Text (truncated)
- [x] SNR
- [x] Hops
- [x] Pagination controls
### 5.10 Web CLI
- [x] Create `web/cli.py`:
- [x] `web` Click command
- [x] `--host` option
- [x] `--port` option
- [x] `--api-url` option
- [x] `--api-key` option
- [x] Network configuration options:
- [x] `--network-name`
- [x] `--network-city`
- [x] `--network-country`
- [x] `--network-location`
- [x] `--network-radio-config`
- [x] `--network-contact-email`
- [x] `--network-contact-discord`
- [x] `--members-file` option
- [x] `--reload` flag for development
- [x] Register CLI with main entry point
### 5.11 Web Tests
- [x] Create `tests/test_web/conftest.py`:
- [x] Test client fixture
- [x] Mock API responses
- [x] Create `tests/test_web/test_home.py`
- [x] Create `tests/test_web/test_members.py`
- [x] Create `tests/test_web/test_network.py`
- [x] Create `tests/test_web/test_nodes.py`
- [x] Create `tests/test_web/test_map.py`
- [x] Create `tests/test_web/test_messages.py`
---
## Phase 6: Docker & Deployment
### 6.1 Dockerfile ✅
- [x] Create `docker/Dockerfile`:
- [x] Multi-stage build:
- [x] Stage 1: Build frontend assets (Tailwind)
- [x] Stage 2: Python dependencies
- [x] Stage 3: Final runtime image
- [x] Base image: python:3.11-slim
- [x] Install system dependencies
- [x] Copy and install Python package
- [x] Copy frontend assets
- [x] Set entrypoint to `meshcore-hub`
- [x] Default CMD (show help)
- [x] Health check instruction
### 6.2 Docker Compose ✅
- [x] Create `docker/docker-compose.yml`:
- [x] MQTT broker service (Eclipse Mosquitto):
- [x] Port mapping (1883, 9001)
- [x] Volume for persistence
- [x] Configuration file
- [x] Interface Receiver service:
- [x] Depends on MQTT
- [x] Device passthrough (/dev/ttyUSB0)
- [x] Environment variables
- [x] Interface Sender service:
- [x] Depends on MQTT
- [x] Device passthrough
- [x] Environment variables
- [x] Collector service:
- [x] Depends on MQTT
- [x] Database volume
- [x] Environment variables
- [x] API service:
- [x] Depends on Collector (for DB)
- [x] Port mapping (8000)
- [x] Database volume (shared)
- [x] Environment variables
- [x] Web service:
- [x] Depends on API
- [x] Port mapping (8080)
- [x] Environment variables
- [x] Create `docker/mosquitto.conf`:
- [x] Listener configuration
- [x] Anonymous access (or auth)
- [x] Persistence settings
### 6.3 Health Checks ✅
- [x] Add health check endpoint to API:
- [x] `GET /health` - basic health
- [x] `GET /health/ready` - includes DB check
- [x] Add health check endpoint to Web:
- [x] `GET /health` - basic health
- [x] `GET /health/ready` - includes API connectivity
- [x] Add health check to Interface:
- [x] Device connection status
- [x] MQTT connection status
- [x] Add health check to Collector:
- [x] MQTT connection status
- [x] Database connection status
### 6.4 Database CLI Commands ✅
- [x] Create `db` Click command group:
- [x] `meshcore-hub db upgrade` - run migrations
- [x] `meshcore-hub db downgrade` - rollback migration
- [x] `meshcore-hub db revision -m "message"` - create migration
- [x] `meshcore-hub db current` - show current revision
- [x] `meshcore-hub db history` - show migration history
### 6.5 Documentation
- [x] Update `README.md`:
- [x] Project description
- [x] Quick start guide
- [x] Docker deployment instructions
- [x] Manual installation instructions
- [x] Configuration reference
- [x] CLI reference
- [ ] Create `docs/` directory (optional):
- [ ] Architecture overview
- [ ] API documentation link
- [ ] Deployment guides
### 6.6 CI/CD ✅
- [x] Create `.github/workflows/ci.yml`:
- [x] Run on push/PR
- [x] Set up Python
- [x] Install dependencies
- [x] Run linting (black, flake8)
- [x] Run type checking (mypy)
- [x] Run tests (pytest)
- [x] Upload coverage report
- [x] Create `.github/workflows/docker.yml`:
- [x] Build Docker image
- [x] Push to registry (on release)
### 6.7 End-to-End Testing ✅
- [x] Create `tests/e2e/` directory
- [x] Create `tests/e2e/docker-compose.test.yml`:
- [x] All services with mock device
- [x] Test database
- [x] Create `tests/e2e/test_full_flow.py`:
- [x] Start all services
- [x] Generate mock events
- [x] Verify events stored in database
- [x] Verify API returns events
- [x] Verify web dashboard displays data
- [x] Test command flow (API -> MQTT -> Sender)
---
## Progress Summary
| Phase | Total Tasks | Completed | Progress |
|-------|-------------|-----------|----------|
| Phase 1: Foundation | 47 | 47 | 100% |
| Phase 2: Interface | 35 | 35 | 100% |
| Phase 3: Collector | 27 | 27 | 100% |
| Phase 4: API | 44 | 44 | 100% |
| Phase 5: Web Dashboard | 40 | 40 | 100% |
| Phase 6: Docker & Deployment | 28 | 25 | 89% |
| **Total** | **221** | **218** | **99%** |
*Note: Remaining 3 tasks are optional (creating a `docs/` directory).*
---
## Notes & Decisions
### Decisions Made
*(Record architectural decisions and answers to clarifying questions here)*
- [x] LetsMesh/native advertisement parity: in `letsmesh_upload` mode, observer `status` feed stays informational (`letsmesh_status`) and does not populate `advertisements`.
- [x] LetsMesh advertisement persistence source: decoded packet payload type `4` maps to `advertisement`; payload type `11` maps to `contact` parity updates.
- [x] LetsMesh native-event parity extensions: payload type `9` maps to `trace_data`, payload type `8` maps to informational `path_updated`, and payload type `1` can map to response-style native events when decryptable structured content exists.
- [ ] Q1 (MQTT Broker):
- [ ] Q2 (Database):
- [ ] Q3 (Web Dashboard Separation):
- [ ] Q4 (Members JSON Location):
- [ ] Q5 (Multiple Serial Devices):
- [ ] Q6 (Reconnection Strategy):
- [ ] Q7 (Mock Device Scope):
- [ ] Q8 (Event Deduplication):
- [ ] Q9 (Data Retention):
- [ ] Q10 (Webhook Configuration):
- [ ] Q11 (API Key Management):
- [ ] Q12 (Rate Limiting):
- [ ] Q13 (CORS):
- [ ] Q14 (Dashboard Authentication):
- [ ] Q15 (Real-time Updates):
- [ ] Q16 (Map Provider):
- [ ] Q17 (Tag Value Types):
- [ ] Q18 (Reserved Tag Names):
- [ ] Q19 (Health Checks):
- [ ] Q20 (Metrics/Observability):
- [ ] Q21 (Log Level Configuration):
### Blockers
*(Track any blockers or dependencies here)*
### Session Log
*(Track what was accomplished in each session)*
| Date | Session | Tasks Completed | Notes |
|------|---------|-----------------|-------|
| 2025-12-03 | 1 | Phase 1: Foundation | Project setup, common package, database models, schemas, migrations, CLI |
| 2025-12-03 | 2 | Phase 2: Interface | Device abstraction, mock device, receiver/sender modes, CLI, tests |
| 2025-12-03 | 3 | Phase 3: Collector | MQTT subscriber, event handlers, CLI, tests (webhook pending) |
| 2025-12-03 | 4 | Phase 4: API | FastAPI app, auth, all routes, CLI, tests (108 passed, 9 pre-existing failures) |
| 2025-12-03 | 5 | Phase 5: Web Dashboard | FastAPI + Jinja2, Tailwind/DaisyUI, Leaflet map, all pages, CLI (tests pending) |
| 2025-12-03 | 6 | Code quality | Aligned mypy settings between `mypy src/` and pre-commit hooks; added meshcore to ignore_missing_imports, added alembic to pre-commit dependencies |
| 2025-12-03 | 7 | Docker packaging | Fixed pyproject.toml package-data to include web/templates and api/templates in wheel builds |
Reference in New Issue View Git Blame Copy Permalink