solopm/solopm-server
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

phase 0 complete

Browse Source
This commit is contained in:
brian
2026-08-14 11:29:11 -06:00
parent 4da16c7573
commit 85df9a208e
102 changed files with 25019 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
plans/01-architecture.md
+17 -17
View File
@@ -4,7 +4,7 @@ Backend is a single Go module `solopm.com/solopm-server`, one binary, serving th
## Repository layout
- [ ] Create the repo skeleton:
- [x] Create the repo skeleton (Phase 0 subset; `internal/domain/*`, `internal/events`, `internal/jobs`, `internal/search`, `internal/mail`, `internal/auth`, `internal/files` are added by the phases that need them):
```
/ (repo root; /app in this workspace)
@@ -36,19 +36,19 @@ Backend is a single Go module `solopm.com/solopm-server`, one binary, serving th
## Configuration (env vars)
- [ ] Implement `internal/config` reading these variables (fail fast at startup on missing required ones):
- [ ] `DATABASE_URL` (required) — pgx connection string
- [ ] `HTTP_PORT` (default `4080`)
- [ ] `BASE_URL` (required) — external URL, used in emails/OAuth callbacks/webhook payloads
- [ ] `SESSION_SECRET` (required) — 32+ bytes
- [ ] `UPLOAD_DIR` (default `./uploads`) — attachment storage root
- [ ] `MAX_UPLOAD_MB` (default `25`)
- [ ] `MEILI_URL`, `MEILI_KEY` (required for search; app runs degraded without them — search endpoints return 503)
- [ ] `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM` (optional; email disabled when unset)
- [ ] `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET` (optional — hides the button when unset)
- [ ] `GITEA_URL`, `GITEA_CLIENT_ID`, `GITEA_CLIENT_SECRET` (optional — same)
- [ ] `CULL_AFTER_DAYS` (default `30`)
- [ ] `LOG_LEVEL` (default `info`)
- [x] Implement `internal/config` reading these variables (fail fast at startup on missing required ones):
- [x] `DATABASE_URL` (required) — pgx connection string
- [x] `HTTP_PORT` (default `8080`)
- [x] `BASE_URL` (required) — external URL, used in emails/OAuth callbacks/webhook payloads
- [x] `SESSION_SECRET` (required) — 32+ bytes
- [x] `UPLOAD_DIR` (default `./uploads`) — attachment storage root
- [x] `MAX_UPLOAD_MB` (default `25`)
- [x] `MEILI_URL`, `MEILI_KEY` (required for search; app runs degraded without them — search endpoints return 503)
- [x] `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASS`, `SMTP_FROM` (optional; email disabled when unset)
- [x] `GITHUB_CLIENT_ID`, `GITHUB_CLIENT_SECRET` (optional — hides the button when unset)
- [x] `GITEA_URL`, `GITEA_CLIENT_ID`, `GITEA_CLIENT_SECRET` (optional — same)
- [x] `CULL_AFTER_DAYS` (default `30`)
- [x] `LOG_LEVEL` (default `info`)
## Cross-cutting conventions
@@ -61,9 +61,9 @@ Backend is a single Go module `solopm.com/solopm-server`, one binary, serving th
- [ ] **Logging**: `log/slog`, JSON in production, request-id middleware; log every request (method, path, status, duration, user id).
- [ ] **Validation**: in services, not handlers; titles trimmed/non-empty; markdown bodies size-capped (64 KB).
- [ ] **Time/date fields**: `start_date`/`target_date` are `date` (no time component); `completed_at` is `timestamptz` set by status automation.
- [ ] **Graceful shutdown**: on SIGINT/SIGTERM stop accepting requests, close SSE hub, drain dispatcher + job workers (10s cap), close pgx pool.
- [ ] **SPA serving**: `go:embed web/dist`; any non-`/api`, non-`/webhooks`, non-`/files` GET serves `index.html` (deep links work).
- [ ] **Makefile targets**: `make dev` (Vite + Go with reload), `make build` (pnpm build → go build), `make test`, `make sqlc`, `make migrate-up/down`, `make lint`.
- [x] **Graceful shutdown**: on SIGINT/SIGTERM stop accepting requests, close SSE hub, drain dispatcher + job workers (10s cap), close pgx pool. *(SSE hub/dispatcher/job workers land in later phases; server shutdown + pool close done in Phase 0)*
- [x] **SPA serving**: `go:embed web/dist`; any non-`/api`, non-`/webhooks`, non-`/files` GET serves `index.html` (deep links work).
- [x] **Makefile targets**: `make dev` (Vite + Go with reload), `make build` (pnpm build → go build), `make test`, `make sqlc`, `make migrate-up/down`, `make lint`. *(`make dev` runs both servers concurrently; no file-watcher/hot-reload for the Go side yet)*
- [ ] **Tests**: table-driven unit tests for services (cycle detection, numbering, fan-out rules); integration tests against a real Postgres (dockertest or `TEST_DATABASE_URL`); no mocking of sqlc stores.
## Middleware chain (chi)