astrojuanlu / meetup-checkin

3 stars 1 forks source link

Documentar app #8

Open astrojuanlu opened 1 year ago

astrojuanlu commented 1 year ago

La app usa las APIs de Meetup y Airtable. Toma los checkins de Meetup y los guarda en Airtable, y también en un PostgreSQL local por si acaso (no debería hacer falta tanto lío pero evolucionó así orgánicamente). La documentación de la API de Meetup es malísima pero está aquí. Va por GraphQL:

https://www.meetup.com/api/general/

La app utiliza un "blueprint" de Flask básicamente porque no entiendo cómo funciona OAuth2. Me encantaría usar FastAPI en su lugar, simplemente tendríamos que adaptar esa lógica.

Lo más difícil de la app es probarla localmente, no tengo ni idea de cómo hacer tal cosa.

Hay que documentar:

miguel-angel-monjas commented 1 year ago

No entiendo (aún) dónde corre esta app. ¿Meetup proporciona el hosting? ¿Es una app estándar que se permite instalar a los adminstradores de un meetup?

Además de todo lo relacionado con OAuth, que parece no ser trivial, ¿sabemos, al menos, qué datos son los que proporciona meetup via GraphQL (que no he usado nunca)?

astrojuanlu commented 1 year ago

Corre en https://Railway.app

astrojuanlu commented 1 year ago

Los datos que proporciona meetup están en el enlace de la documentación que puse en el primer comentario

miguel-angel-monjas commented 1 year ago

Vale, ¿dónde ponemos la documentación? ¿En el README.md del raíz y lo gestiono vía pull request? ¿En español o en inglés?

astrojuanlu commented 1 year ago

Hay cosas específicas de cómo está desplegada nuestra instancia, eso lo pondría en español en https://github.com/astrojuanlu/meetup-checkin/wiki. Lo que sea independiente de PyData Madrid yo creo que debería ir en el README en inglés.

miguel-angel-monjas commented 1 year ago

Vale, crea entonces la página de wiki, que sospecho que solo pueden crealas los desarrolladores del repo. Supongo que el resto ya se puede hacer mediante pull request

astrojuanlu commented 1 year ago

@miguel-angel-monjas ¿me confirmas si tienes permisos de edición en https://github.com/astrojuanlu/meetup-checkin/wiki ? si no, te doy acceso