From 351773cca98ccc61f7844ba9892ee797f1dd3d29 Mon Sep 17 00:00:00 2001 From: Bryan Newbold Date: Wed, 25 Apr 2018 12:53:08 -0700 Subject: start notes on golang branch --- fatcat-go/README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 fatcat-go/README.md diff --git a/fatcat-go/README.md b/fatcat-go/README.md new file mode 100644 index 00000000..ea1166ce --- /dev/null +++ b/fatcat-go/README.md @@ -0,0 +1,23 @@ + +This folder contains source for the fatcat API daemon ("fatcatd"), written in +golang. + + +## Structure + +fatcatd is essentially just glue between two declarative schemas: + +- a postgres-flavor SQL database schema +- an OpenAPI/Swagger REST API definition + + +## Simplifications + +In early development, we'll make at least the following simplifications: + +- authentication (authn and authz) are not enforced and don't have user + interfaces. actual authentication will be eased in via a microservice and/or + oauth to gitlab/github/orcid.org +- "extra" metadata is stored in-entity as JSONB. In the future this might be + broken out to a separate table +- libraries won't be vendored; in the future they will be via a git submodule -- cgit v1.2.3