Sample App: Todolist

[sgammon]

UPDATE: Stuff that depends on this sample is needed downstream, so this is getting merged early as alpha2 and kicked down the road.

This changeset adds a new sample app, which ties together all the features thus far and adds some new ones to facilitate easy app development. I'm using this sample to help define the underlying framework structure, when used with Micronaut/Soy.

The sample is built with unified modelling via Protobuf, and RPC dispatch via gRPC. The UI is built with Soy, with SSR support via Soy/Java, and re-hydrated CSR support via Soy/JS (and idom).

The app's data backend is powered by Firestore, with objects mediated for serialization by the framework. This process is also driven by the protos. Auth is also powered by Firebase, which enables easy data permissions.

Via the central API definition, the app can automatically generate an API console, docs, and Open API/Swagger configs. It is also dispatchable from nearly any platform (via either gRPC or REST). Endpoints served in this manner support either Protobuf on the wire, or JSON (when using REST).

Styles are defined in SASS but processed by both GSS and PostCSS, which enables both (1) tight optimization on a per-browser basis, and (2) style modularity when serving. The server can also rewrite styles using a Soy/GSS rewrite map.

The sample additionally demonstrates testing, with coverage (where supported by the framework, so far).

Related and blocking issues:

• App Framework (#27)
  • BaseController / AppController
  • PageContext / PageContextManager
  • Some way to mount and catalog assets note: kicked
• MVP Functionality Matrix (#43)
• Source-aware Server Targets note: kicked
• Modular JS serving, by entrypoint note: kicked
• Modular CSS serving, by entrypoint note: kicked
• Early page render context/frame template
• Basic asset templates/common templates
• Unable to natively compile complex Soy templates (filed as #35)

The following checklist tracks progress towards the above:

• Data Adapters
  • Initial adapter: in-memory
  • First implementation: Firestore note: kicked
• Basic gRPC Support
  • Ability to build/inject/run a gRPC server
  • Some way to smoothly serve/proxy this
  • Some plan for Envoy support
  • TLS vs. ALTS? note: kicked
  • Ability to generate a gRPC client note: kicked
• Frontend serving logic (more coming soon) note: kicked
• Basic Todolist app
  • Unified Model: services and objects
    • Object definitions
    • Service definition (Tasks)
    • Service configuration
      • Auth (API keys, Firebase auth)
      • Documentation config
      • Quotas and properties
  • Server-side
    • HomeController: serve anonymous app frame
      • Basic implementation
      • Login UI kickoff (via Firebase Auth UI / MDL) note: kicked
      • Anonymous app container note: kicked
    • TodolistController: serve logged-in app frame note: kicked
      • Basic implementation note: kicked
      • Logout UI kickoff and handler note: kicked
    • Auth/session lifecycle note: kicked
    • Rejoiner support note: kicked
    • GraphQL schema/support note: kicked
  • Web app note: kicked
    • gRPC invocation logic note: kicked
    • Initial style structure note: kicked
    • Java-based app implementation note: kicked
• Application-quality tooling
  • Support for hermetic GCB builds
  • Support for deployment directly from GCB
  • Production routing (cluster-internal and ILB)
  • Coverage reporting from CI (Buildkite)
  • Source quality / linting in CI (Buildkite)
  • Test result reporting from CI (Buildkite)
• Issues to file note: kicked
  • Future: Telemetry note: kicked
  • Future: iOS App note: kicked
  • Future: Android App note: kicked
  • Future: Chrome Extension note: kicked

[codecov]

Codecov Report

Merging #46 into feature/testsuite will decrease coverage by 0.1%.
The diff coverage is 99.89%.

@@                  Coverage Diff                  @@
##           feature/testsuite      #46      +/-   ##
=====================================================
- Coverage                100%   99.89%   -0.11%     
=====================================================
  Files                      1       33      +32     
  Lines                      9      957     +948     
=====================================================
+ Hits                       9      956     +947     
- Misses                     0        1       +1

Flag	Coverage Δ
#backend	99.89% <99.89%> (-0.11%)	⬇️
#jvm	99.89% <99.89%> (-0.11%)	⬇️

Impacted Files	Coverage Δ
java/gust/backend/model/CollapsedMessage.java	0% <0%> (ø)
java/gust/backend/ApplicationBoot.java	100% <100%> (ø)
java/gust/backend/model/FetchOptions.java	100% <100%> (ø)
...a/gust/backend/driver/inmemory/InMemoryDriver.java	100% <100%> (ø)
java/gust/backend/runtime/ReactiveFuture.java	100% <100%> (ø)
java/gust/backend/model/ModelDeflateException.java	100% <100%> (ø)
java/gust/backend/model/ProtoModelCodec.java	100% <100%> (ø)
java/gust/backend/model/CacheDriver.java	100% <100%> (ø)
java/gust/backend/model/ModelWriteConflict.java	100% <100%> (ø)
java/gust/backend/model/MissingAnnotatedField.java	100% <100%> (ø)
... and 55 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4ba341b...133d216. Read the comment docs.