Commit Graph

6 Commits

Author SHA1 Message Date
Pascal Bleser d9878b38eb groupware: add mock endpoints for addressbooks and contacts 2026-01-22 09:42:22 +01:00
Pascal Bleser 0cce8f5df3 docs(groupware): OpenAPI improvements
* refactor some pkg/jmap and groupware methods to make more sense from
   an API point-of-view

 * add path parameter documentation, but automate it by injecting their
   definition into the OpenAPI YAML tree that is extracted from the
   source code using go-swagger as it is too cumbersome, repetitive and
   error-prine to document them in the source code; wrote a TypeScript
   file apidoc-process.ts to do so

 * add generating an offline HTML file for the OpenAPI documentation
   using redocly, and injecting a favicon into the resulting HTML; wrote
   a TypeScript file apidoc-postprocess-html.ts to do so
2026-01-22 09:42:22 +01:00
Pascal Bleser 146558eea9 groupware: swagger API documentation improvements
* add more documentation for properties

 * fixes after a bit of trial-and-error with go-swagger

 * fix email filter marshalling when there are no search criteria

 * introduce an apidoc.yml that contains Swagger data and is merged when
   generating the swagger.yml from sources
2026-01-22 09:39:16 +01:00
Pascal Bleser 6f593d1bd8 refactored the Session object, refactored the services/groupware directory, and started Swagger documentation implementation 2026-01-22 09:39:15 +01:00
Pascal Bleser 8ef4d0a9c4 add an auth-api service to make an exemplary implementation of an external authentication API for third party services such as Stalwart 2026-01-22 09:39:15 +01:00
Pascal Bleser abd01d2922 WIP: initial implementation of the groupware service 2026-01-22 09:39:12 +01:00