Saltar al contenido principal

Descripción general del proyecto

ChurchApps está formado por aproximadamente 20 repositorios independientes, cada uno publicado bajo la organización de GitHub de ChurchApps. Esta página ofrece un inventario completo de todos los proyectos organizados por categoría, junto con sus frameworks, puertos y relaciones.

Antes de comenzar

APIs de backend​

Todas las APIs están construidas con Node.js, Express y TypeScript, y se implementan en AWS Lambda mediante Serverless Framework.

ProyectoPropósitoPuerto de desarrolloBase de datos
ApiMonolito modular principal que abarca membresía, asistencia, contenido, donaciones, mensajería y tareas8084Base de datos MySQL independiente por módulo (6 en total)
LessonsApiBackend de Lessons.church--Base de datos MySQL lessons única
AskApiHerramienta de consultas con IA impulsada por OpenAI----
info

El proyecto principal Api es un monolito modular. Cada módulo (membresía, asistencia, contenido, donaciones, mensajería y tareas) tiene su propia base de datos y es accesible en una subruta como /membership o /giving. En producción, se exponen como funciones Lambda independientes detrás de API Gateway.

Aplicaciones web​

ProyectoFrameworkPuerto de desarrolloPropósito
B1AdminReact 19 + Vite + MUI 73101Panel de administración de la iglesia
B1AppNext.js 16 + React 19 + MUI 73301Aplicación pública para los miembros de la iglesia
LessonsAppNext.js 163501Interfaz de Lessons.church
B1TransferReact + Vite--Utilidad de importación y exportación de datos
BrochureSitesEstático--Sitios web de folletos estáticos para iglesias

Aplicaciones móviles​

Todas las aplicaciones móviles usan React Native con Expo.

ProyectoPropósitoVersiones clave
B1CheckinAplicación de quiosco para registro de asistenciaExpo
LessonsScreenVisualización de lecciones para Android TVExpo
FreePlayReproducción de contenido (incluido el sistema operativo de TV)Expo
FreeShowRemoteControl remoto móvil para FreeShowExpo

Escritorio​

ProyectoStackPropósito
FreeShowElectron 37 + Svelte 3 + ViteSoftware de presentaciones y adoración

Bibliotecas compartidas​

El código compartido se publica en npm bajo el ámbito @churchapps y lo consumen como dependencias npm habituales los proyectos anteriores. Todos los paquetes compartidos residen en un único repositorio, Packages, que se gestiona como un workspace de Yarn y se publica con changesets.

PaquetePropósitoUtilizado por
@churchapps/helpersUtilidades base e interfaces TypeScript compartidas (DateHelper, ApiHelper, CurrencyHelper, etc.)Todos los proyectos
@churchapps/apihelperUtilidades del servidor Express (autenticación, controladores base, acceso a bases de datos, integraciones con AWS)Todas las APIs
@churchapps/apphelperBiblioteca de componentes React con submódulos para inicio de sesión, donaciones, formularios, markdown y creación de sitios webTodas las aplicaciones web
@churchapps/content-providersAbstracción de proveedores de contenido de terceros (Lessons.church, Planning Center, Dropbox y otros)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkKit de herramientas de integración de B1.church: webhooks, cliente REST, OAuthDesarrolladores de integraciones externas
@churchapps/textingAbstracción de proveedores de SMSApi

Consulte Bibliotecas compartidas para la configuración del workspace y el flujo de publicación.

Relaciones entre proyectos​

Aplicaciones frontend      Bibliotecas compartidas    APIs de backend
-------------- ----------------------- ---------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Todas las aplicaciones frontend dependen de @churchapps/helpers. Las aplicaciones web además dependen de los paquetes de @churchapps/apphelper. Todas las APIs de backend dependen tanto de @churchapps/helpers como de @churchapps/apihelper.

Próximos pasos​