Polish: docs, seeds, and the finishing touches

1v1 := http.NewServeMux()
2userH.Routes(v1)
3noteH.Routes(v1)
4
5mux := http.NewServeMux()
6mux.Handle("/v1/", http.StripPrefix("/v1", v1))
7mux.HandleFunc("GET /livez", live)      // health checks stay unversioned

1cmd/
2  api/main.go
3  seed/main.go      go run ./cmd/seed

1# SnapNotes API
2
3Notes with accounts and file attachments. Go 1.25, Postgres, no framework.
4
5## Run it
6    cp .env.example .env
7    docker compose up -d
8    make migrate
9    make run
10
11## Endpoints
12    POST   /v1/auth/register
13    POST   /v1/auth/login
14    POST   /v1/auth/refresh
15    POST   /v1/auth/logout
16    GET    /v1/me
17
18    POST   /v1/notes
19    GET    /v1/notes?limit=20&offset=0
20    GET    /v1/notes/{id}
21    PATCH  /v1/notes/{id}
22    DELETE /v1/notes/{id}
23
24    POST   /v1/notes/{id}/attachments    multipart, field "file", max 10MB
25    GET    /v1/notes/{id}/attachments
26    GET    /v1/attachments/{id}
27    DELETE /v1/attachments/{id}
28
29    GET    /livez
30    GET    /readyz
31
32## Notes
33- Access token 15 min, refresh token 7 days with rotation.
34- All list endpoints paginated, max limit 100.
35- Uploads: jpeg, png, gif, webp, pdf. Type sniffed, not trusted.

1@host = http://localhost:8080/v1
2
3### register
4POST {{host}}/auth/register
5Content-Type: application/json
6
7{"name":"Sahdev","email":"s@example.com","password":"password123"}
8
9### login
10# @name login
11POST {{host}}/auth/login
12Content-Type: application/json
13
14{"email":"s@example.com","password":"password123"}
15
16### create a note
17POST {{host}}/notes
18Authorization: Bearer {{login.response.body.access_token}}
19Content-Type: application/json
20
21{"title":"First note","body":"hello"}

1// Package note stores and retrieves a user's notes.
2//
3// Every repository method takes a userID and scopes its query to it, so a note
4// belonging to another user is indistinguishable from one that does not exist.
5package note
6
7// Service applies the business rules for notes. It is safe for concurrent use.
8type Service struct{ repo Repository }