|
| 1 | += VEDS Roadmap |
| 2 | +:toc: |
| 3 | +:sectnums: |
| 4 | +:icons: font |
| 5 | + |
| 6 | +== Overview |
| 7 | + |
| 8 | +This roadmap outlines the development phases for the Voyage Enterprise Decision System (VEDS). |
| 9 | + |
| 10 | +*Current Status:* Phase 1 - Foundation (35% complete) |
| 11 | + |
| 12 | +--- |
| 13 | + |
| 14 | +== Phase 1: Foundation [CURRENT] |
| 15 | + |
| 16 | +=== 1.1 RSR Compliance & SCM [COMPLETE] |
| 17 | + |
| 18 | +[cols="1,1,2"] |
| 19 | +|=== |
| 20 | +|Task |Status |Notes |
| 21 | + |
| 22 | +|.gitignore & .gitattributes |✓ |RSR-compliant |
| 23 | +|.well-known directory |✓ |security.txt, ai.txt, humans.txt, consent-required.txt |
| 24 | +|Security policy (SECURITY.md) |✓ |RFC 9116 compliant |
| 25 | +|CI/CD workflows |✓ |13 workflows configured |
| 26 | +|Container policy enforcement |✓ |Blocks Dockerfile, enforces Containerfile |
| 27 | +|Package management |✓ |guix.scm + flake.nix fallback |
| 28 | +|Dependabot |✓ |Cargo, Mix, GitHub Actions |
| 29 | +|CodeQL scanning |✓ |Weekly + PR triggers |
| 30 | +|=== |
| 31 | + |
| 32 | +=== 1.2 Service Scaffolds [IN PROGRESS] |
| 33 | + |
| 34 | +[cols="1,1,2"] |
| 35 | +|=== |
| 36 | +|Service |Status |Progress |
| 37 | + |
| 38 | +|rust-routing |Scaffold |Cargo.toml, dependencies, basic structure |
| 39 | +|elixir-api |Scaffold |mix.exs, Phoenix setup |
| 40 | +|clojure-constraints |Scaffold |deps.edn, XTDB integration |
| 41 | +|ada-spark-verify |Scaffold |alire.toml, GPR project |
| 42 | +|julia-viz |Scaffold |Project.toml, Makie dependencies |
| 43 | +|=== |
| 44 | + |
| 45 | +=== 1.3 Database Schemas [IN PROGRESS] |
| 46 | + |
| 47 | +[cols="1,1"] |
| 48 | +|=== |
| 49 | +|Database |Status |
| 50 | + |
| 51 | +|SurrealDB schema |Defined (config/surrealdb-schema.surql) |
| 52 | +|XTDB config |Defined (config/xtdb.yaml) |
| 53 | +|Dragonfly cache |Pending implementation |
| 54 | +|PostgreSQL (Elixir) |Ecto migrations pending |
| 55 | +|=== |
| 56 | + |
| 57 | +--- |
| 58 | + |
| 59 | +== Phase 2: Core Engine Development |
| 60 | + |
| 61 | +=== 2.1 Rust Routing Optimizer |
| 62 | + |
| 63 | +* [ ] Implement graph-based route representation (petgraph) |
| 64 | +* [ ] Multi-modal edge cost functions |
| 65 | +* [ ] Pareto-optimal path finding (cost, carbon, time) |
| 66 | +* [ ] gRPC service endpoints |
| 67 | +* [ ] Integration with SurrealDB for graph storage |
| 68 | +* [ ] Redis/Dragonfly caching layer |
| 69 | + |
| 70 | +=== 2.2 Clojure Constraints Engine |
| 71 | + |
| 72 | +* [ ] XTDB bitemporal data model |
| 73 | +* [ ] Datalog constraint rules |
| 74 | +* [ ] ILO labor compliance rules |
| 75 | +* [ ] Carbon budget constraints |
| 76 | +* [ ] Time window constraints |
| 77 | +* [ ] Integration with Rust optimizer via gRPC |
| 78 | + |
| 79 | +=== 2.3 Elixir API Gateway |
| 80 | + |
| 81 | +* [ ] Phoenix REST API (v1) |
| 82 | +* [ ] GraphQL endpoint (Absinthe) |
| 83 | +* [ ] Phoenix Channels for real-time tracking |
| 84 | +* [ ] Authentication & authorization |
| 85 | +* [ ] Rate limiting |
| 86 | +* [ ] OpenAPI documentation |
| 87 | + |
| 88 | +=== 2.4 Testing Infrastructure |
| 89 | + |
| 90 | +* [ ] Property-based tests (Hypothesis) |
| 91 | +* [ ] Integration test suite |
| 92 | +* [ ] Load testing setup |
| 93 | +* [ ] Mutation testing for critical paths |
| 94 | + |
| 95 | +--- |
| 96 | + |
| 97 | +== Phase 3: Formal Verification |
| 98 | + |
| 99 | +=== 3.1 Ada/SPARK Proofs |
| 100 | + |
| 101 | +* [ ] Constraint satisfaction proofs |
| 102 | +* [ ] Route validity proofs |
| 103 | +* [ ] Labor compliance formal specs |
| 104 | +* [ ] Z3/CVC5 integration |
| 105 | +* [ ] Proof coverage metrics |
| 106 | + |
| 107 | +=== 3.2 Verification Pipeline |
| 108 | + |
| 109 | +* [ ] CI integration for SPARK proofs |
| 110 | +* [ ] Proof failure blocking |
| 111 | +* [ ] Coverage reporting |
| 112 | +* [ ] Documentation generation from specs |
| 113 | + |
| 114 | +--- |
| 115 | + |
| 116 | +== Phase 4: Visualization & Analytics |
| 117 | + |
| 118 | +=== 4.1 Julia Dashboards |
| 119 | + |
| 120 | +* [ ] Route visualization (GeoMakie) |
| 121 | +* [ ] Real-time tracking display |
| 122 | +* [ ] Cost/carbon analytics |
| 123 | +* [ ] Network graph visualization (GraphMakie) |
| 124 | +* [ ] Interactive Pluto notebooks |
| 125 | + |
| 126 | +=== 4.2 Reporting |
| 127 | + |
| 128 | +* [ ] PDF report generation |
| 129 | +* [ ] Carbon audit reports |
| 130 | +* [ ] Labor compliance reports |
| 131 | +* [ ] Cost breakdown analysis |
| 132 | + |
| 133 | +--- |
| 134 | + |
| 135 | +== Phase 5: Integration & APIs |
| 136 | + |
| 137 | +=== 5.1 External Transport APIs |
| 138 | + |
| 139 | +* [ ] Maritime: AIS data integration |
| 140 | +* [ ] Rail: Network timetables |
| 141 | +* [ ] Road: Traffic/routing APIs |
| 142 | +* [ ] Air: Flight schedule integration |
| 143 | + |
| 144 | +=== 5.2 Linked Data / VoID |
| 145 | + |
| 146 | +* [ ] SPARQL endpoint |
| 147 | +* [ ] VoID vocabulary mapping |
| 148 | +* [ ] Federation capabilities |
| 149 | +* [ ] RDF export |
| 150 | + |
| 151 | +=== 5.3 Third-Party Integration |
| 152 | + |
| 153 | +* [ ] ERP connectors |
| 154 | +* [ ] TMS integration adapters |
| 155 | +* [ ] EDI message handling |
| 156 | + |
| 157 | +--- |
| 158 | + |
| 159 | +== Phase 6: Production Deployment |
| 160 | + |
| 161 | +=== 6.1 Kubernetes Infrastructure |
| 162 | + |
| 163 | +* [ ] RKE2 manifests finalization |
| 164 | +* [ ] K3s lightweight option |
| 165 | +* [ ] ArgoCD GitOps deployment |
| 166 | +* [ ] Horizontal Pod Autoscaling |
| 167 | +* [ ] Pod Security Policies |
| 168 | + |
| 169 | +=== 6.2 Observability |
| 170 | + |
| 171 | +* [ ] OpenTelemetry instrumentation |
| 172 | +* [ ] Grafana dashboards |
| 173 | +* [ ] Prometheus metrics |
| 174 | +* [ ] Distributed tracing |
| 175 | +* [ ] Log aggregation |
| 176 | + |
| 177 | +=== 6.3 Security Hardening |
| 178 | + |
| 179 | +* [ ] mTLS between services |
| 180 | +* [ ] Secret management (Vault/Sealed Secrets) |
| 181 | +* [ ] Network policies |
| 182 | +* [ ] Pod security admission |
| 183 | +* [ ] Regular penetration testing |
| 184 | + |
| 185 | +--- |
| 186 | + |
| 187 | +== Phase 7: Advanced Features |
| 188 | + |
| 189 | +=== 7.1 Machine Learning |
| 190 | + |
| 191 | +* [ ] Demand forecasting |
| 192 | +* [ ] Route recommendation |
| 193 | +* [ ] Anomaly detection |
| 194 | +* [ ] Carbon prediction models |
| 195 | + |
| 196 | +=== 7.2 Cooperative Economics Features |
| 197 | + |
| 198 | +* [ ] Worker-owned fleet support |
| 199 | +* [ ] Fair wage enforcement |
| 200 | +* [ ] Cooperative pricing models |
| 201 | +* [ ] Profit sharing calculations |
| 202 | + |
| 203 | +--- |
| 204 | + |
| 205 | +== Milestone Summary |
| 206 | + |
| 207 | +[cols="1,2,1"] |
| 208 | +|=== |
| 209 | +|Milestone |Description |Status |
| 210 | + |
| 211 | +|M1 |Foundation & RSR Compliance |✓ Complete |
| 212 | +|M2 |Service Scaffolds |In Progress (80%) |
| 213 | +|M3 |Database Integration |In Progress (50%) |
| 214 | +|M4 |Core Routing Engine |Pending |
| 215 | +|M5 |Constraint Engine |Pending |
| 216 | +|M6 |API Gateway |Pending |
| 217 | +|M7 |Formal Verification |Pending |
| 218 | +|M8 |Visualization |Pending |
| 219 | +|M9 |Production Deployment |Pending |
| 220 | +|=== |
| 221 | + |
| 222 | +--- |
| 223 | + |
| 224 | +== Dependencies & Risks |
| 225 | + |
| 226 | +=== Technical Dependencies |
| 227 | + |
| 228 | +* XTDB 2.0 beta stability |
| 229 | +* Ada/SPARK toolchain availability in CI |
| 230 | +* Julia package ecosystem compatibility |
| 231 | +* gRPC interop between Rust/Clojure/Elixir |
| 232 | + |
| 233 | +=== Risks |
| 234 | + |
| 235 | +[cols="1,1,2"] |
| 236 | +|=== |
| 237 | +|Risk |Impact |Mitigation |
| 238 | + |
| 239 | +|XTDB 2.0 API changes |High |Pin version, monitor release notes |
| 240 | +|SPARK proof complexity |Medium |Start with critical path proofs only |
| 241 | +|Multi-language gRPC schema drift |Medium |Single source of truth for protobuf |
| 242 | +|Performance at scale |High |Early load testing, profiling |
| 243 | +|=== |
| 244 | + |
| 245 | +--- |
| 246 | + |
| 247 | +== Contributing |
| 248 | + |
| 249 | +See link:CONTRIBUTING.md[CONTRIBUTING.md] for contribution guidelines. |
| 250 | + |
| 251 | +Priority areas for contribution: |
| 252 | + |
| 253 | +1. Rust routing algorithm implementations |
| 254 | +2. Clojure Datalog constraint rules |
| 255 | +3. Ada/SPARK formal specifications |
| 256 | +4. Julia visualization components |
| 257 | +5. Integration tests |
0 commit comments