How drremain/cyber-ecosystem works
Cyber Ecosystem is a contract-first full-stack skeleton: protobuf contracts define service APIs, a Go system service implements identity and administration capabilities, and a TanStack Start admin console exposes them. The primary workflow runs from an administrator through routed console features and generated RPC clients to the Go transport, domain use cases, persistence, and infrastructure. The README documents this layering and the generated contract consumers; sampled source excerpts are limited, so unverified implementation-level links are omitted.
Main entry points: module Domain modules · routes Admin routes · features Admin features · platform Platform facade
Components 18
Contracts and clients
- Protobuf contracts
proto - Connect bindings
gen/connect-ts - OpenAPI client
gen/openapi-ts
Admin console
- Admin routes
app/clients/admin/src/routes - Admin features
app/clients/admin/src/features - Admin modules
app/clients/admin/src/features/modules - Connect client
app/clients/admin/src/services/connect - Console foundations
app/clients/admin/src/domains - Shared TypeScript libraries
shared-ts
System service
- RPC transports
app/services/system/internal/server - Domain modules
app/services/system/internal/module - Authorization engine
app/services/system/internal/module/authz - File services
app/services/system/internal/module/fileproxy
Persistence and capabilities
- Platform facade
app/services/system/internal/platform - Ent persistence
app/services/system/internal/ent - Infrastructure capabilities
shared-go/capability
Other components
- Administrator
- Backing infrastructure
Connections 17
- Protobuf contracts → Connect bindings: defines bindings
- Protobuf contracts → OpenAPI client: defines API
- Administrator → Admin routes: uses console
- Admin routes → Admin features: routes to
- Admin features → Admin modules: presents
- Admin modules → Connect client: requests data
- Connect client → Connect bindings: uses bindings
- Admin routes → Console foundations: uses foundations
- Connect bindings → RPC transports: calls services
- RPC transports → Domain modules: dispatches RPCs
- Domain modules → Authorization engine: delegates checks
- Domain modules → File services: handles files
- Domain modules → Platform facade: uses ports
- Platform facade → Ent persistence: accesses data
- Platform facade → Infrastructure capabilities: uses capabilities
- Infrastructure capabilities → Backing infrastructure: connects backends
- Admin features → Shared TypeScript libraries: uses shared tools