Define "spec product" for generating the OpenAPI example docs

[gadomski]

There may be some router refactoring required (i.e. there's no product routes on the default app router at the moment) but let's explore. We could just copy the test app's docs as a starting point?

[gadomski]

A note here -- @jkeifer were talking and we were thinking this could belong in its own (unpublished) package in the monorepo, maybe schema-generator? That way we could keep the schema generation code separate from the stapi-fastapi repo itself, since tehcnially it's a use-case of stapi-fastapi, not part of the repo per se.

Not sure if this is right, but thought I'd throw the idea out for discussion.

[toro-berlin]

It makes a lot of sense from my perspective—it's a better choice than adding the "spec product" to stapi-fastapi in the test dir or a separate example dir and maintaining it there.

However, we would leave the current mock product and the FastAPI app in the fastapi tests dir as they might be used for testing more detailed nuances of stapi-fastapi. Does that work for you?

[gadomski]

However, we would leave the current mock product and the FastAPI app in the fastapi tests dir as they might be used for testing more detailed nuances of stapi-fastapi. Does that work for you?

Yup, sounds good!