feat(tsk_GXDoc3Cs07Rn): apierr + idgen + CONVENTIONS.md

apierr:
- Add New() constructor, StatusFor() HTTP-status mapping
- Add ErrUnauthorized, ErrForbidden, ErrNotFound, ErrConflict predefined errors
- Add chi-compatible Middleware for panic(*Error) → JSON recovery
- Add apierr_test.go (8 tests; covers New, StatusFor, WriteJSON, Middleware)

idgen:
- Implement idgen.go: New()/NewString() (UUID v7 via google/uuid v1.6.0)
- Implement GenerateCode/CanonicalizeCode/HashCode (Crockford Base32 moved from codes)
- Add idgen_test.go (12 tests; UUID v7 ordering/uniqueness + Crockford format/normalization/check)

codes:
- Refactor generator.go to delegate GenerateCode/Canonicalize/Hash to idgen
- All existing codes generator tests continue to pass unchanged

server:
- Add CONVENTIONS.md covering package structure, error handling, ID generation,
  database conventions, handler templates, auth context, testing, and logging rules
- Move google/uuid from indirect to direct dependency in go.mod

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

This commit is contained in:

wangjia

2026-06-13 11:58:38 +08:00

parent 787151245e

commit b64c002a33

9 changed files with 1064 additions and 178 deletions

									
										server/internal/idgen/doc.go
									
		-4
	
												View File
												
				@@ -1,5 +1 @@

				// Package idgen generates application-level identifiers.

				// For most entities it wraps github.com/google/uuid (v7 time-ordered UUIDs).

				// For activation codes it produces 16-character Crockford Base32 strings

				// with a check digit, suitable for display and human entry.

				package idgen