Swag adjustments and other tweaks

[TheJolman]

This pr

• adjusts the generation of swag docs
• fixes some naming inconsistencies
• a few other minor QOL changes

(this pr is smaller than it seems, most line diffs are from generated files)

[Copilot]

Pull Request Overview

This PR primarily adjusts the generation of Swagger documentation and fixes a few naming inconsistencies while introducing some minor quality-of-life improvements. Key changes include updates to the DB initialization logic (adding a closer function), revisions to API route definitions (using PUT for updates and consistent pluralized endpoints), and regenerated Swagger docs.

Reviewed Changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
internal/db/db.go	Updated function signature to return a closer function alongside DB.
internal/api/routes/routes.go	Revised route definitions with updated HTTP verbs and pluralized endpoints.
internal/api/handlers/*.go	Modified Swagger annotations to reflect new routes and improved documentation.
go.mod	Adjusted dependencies to support updated Swagger generation.
flake.nix	Added go-swag to the list of shell dependencies.
docs/swagger.yaml	Regenerated Swagger documentation with new model definitions and endpoints.
cmd/api/main.go	Updated usage of db.New with the closer function and corrected Swagger info.

Comments suppressed due to low confidence (1)

docs/swagger.yaml:177

• The GET announcement endpoint defines an 'id' path parameter but is declared under '/announcements'. Consider using '/announcements/{id}' to align the path with the parameter.

    get:

[EthanThatOneKid]

Swagalicious 😎