feat: add pinned inventory location enrichment

This commit is contained in:
jb
2026-09-20 12:13:51 -04:00
parent fe7d218195
commit 0c9197f841
32 changed files with 3116 additions and 55 deletions
+4 -4
View File
@@ -1,7 +1,7 @@
# Implementation roadmap
**Status:** planning proposal, not implementation or a public-launch declaration.
**Baseline:** prior checkpoints historically recorded live sign-in, asset synchronization and matching Assets/chat reference valuations for one character (see [verification](verification.md)); that history is not new T07 evidence. This T07 checkpoint records a local, disposable prototype only, with no new deployed/live ESI or production-readiness claim. T07 durable synchronization is implemented and verified locally with the current 204-test suite. T08 location/containment enrichment remains a separate feature whose post-assets/pre-publication integration is still pending.
**Baseline:** prior checkpoints historically recorded live sign-in, asset synchronization and matching Assets/chat reference valuations for one character (see [verification](verification.md)); that history is not new T08 evidence. This T08 checkpoint records a local, disposable prototype only, with no deployed/live ESI, live Convex-capacity, or production-readiness claim. T07 durable synchronization and T08 location/containment enrichment are implemented and verified locally. The current 254-test count is a combined suite including parallel-core T09/T13 tests, not a T08-only count. T09 projection/query and T13 wallet completion remain separate roadmap work.
**Evidence:** [architecture](architecture.md), [milestone 1](milestone.md), [verification](verification.md), [ESI research](research/eve.md), [expansion data/permission matrix](research/expansion-data-contracts.md), and [reference operations](reference-operations.md).
## 1. Decisions confirmed for this roadmap
@@ -16,9 +16,9 @@
New service/table/path names below are proposed implementation boundaries, not existing APIs. Later phases need focused design and current contract verification before coding; they are not one large implementation task.
### T07 prototype checkpoint
### T07/T08 prototype checkpoint
T07 is implemented as a local prototype, not a deployment claim. It requires the distinct `CONVEX_SYNC_WORKER_SECRET` in Convex and the worker environment, alongside `TOKEN_ENCRYPTION_KEY`, EVE client credentials and `ESI_USER_AGENT`. Start Compose workers only through the explicit `worker` profile; standalone development uses a worker-only `.env.worker`. T08 core modules and their integration at the post-assets/pre-publication seam remain pending.
T07 durable synchronization and T08 location/containment enrichment are implemented as local prototypes, not deployment claims. T07 requires the distinct `CONVEX_SYNC_WORKER_SECRET` in Convex and the worker environment, alongside `TOKEN_ENCRYPTION_KEY`, EVE client credentials and `ESI_USER_AGENT`. T08 adds the read-only `REFERENCE_DIR` artifact mount and generation-pinned enrichment seam. Start Compose workers only through the explicit `worker` profile; standalone development uses a worker-only `.env.worker`. T09 projection/query and T13 wallet remain separate tasks; passing the combined local suite does not claim either task complete.
## 2. What exists versus what still needs building
@@ -28,7 +28,7 @@ T07 is implemented as a local prototype, not a deployment claim. It requires the
| Assets | Complete staged snapshots, tenant gates, exact reference totals | Real search/filtering, paging, containment, custom names, meaningful locations, history |
| References | 53,001 types; recipes, dogma and system/gate tables; immutable publication | Runtime reader exposes only types/version; station table currently empty; search and domain-specific readers missing |
| Prices | Global ESI average prices, held by the web process | Durable public feed coordination, regional/private books, history, depth allocation, fees |
| Sync | T07 durable queued jobs, dedicated worker, leases, fenced generation publication, cancellation/recovery and shared refresh coordination | T08 enrichment integration and production release evidence remain pending |
| Sync | T07 durable queued jobs, dedicated worker, leases, fenced generation publication, cancellation/recovery and shared refresh coordination; T08 generation-pinned location enrichment | T09 projection/query integration and production release evidence remain pending |
| Finances | Signed integer-cent money helpers | Wallets, journals, transactions, own orders, history/coverage and reconciliation |
| Industry | Recipe data plus placeholder interfaces/economics fields | Owned blueprint instances, skills/jobs, facility assumptions, formulas and optimizer |
| Navigation | Exact light-year distance helper and universe data | Gate-distance service, ship-aware capital graph, dynamic constraints and qualified access evidence |