aboutsummaryrefslogtreecommitdiffstats
path: root/fatcat-go/README.md
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-04-25 12:53:08 -0700
committerBryan Newbold <bnewbold@robocracy.org>2018-05-09 11:12:16 -0700
commit351773cca98ccc61f7844ba9892ee797f1dd3d29 (patch)
tree4daf5c07d9966378dd7971ff8e77d6cb9f21e01f /fatcat-go/README.md
parent7f5f12d8d5a090e402716b774f685283149b53fd (diff)
downloadfatcat-351773cca98ccc61f7844ba9892ee797f1dd3d29.tar.gz
fatcat-351773cca98ccc61f7844ba9892ee797f1dd3d29.zip
start notes on golang branch
Diffstat (limited to 'fatcat-go/README.md')
-rw-r--r--fatcat-go/README.md23
1 files changed, 23 insertions, 0 deletions
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