Saltar al contenido principal

Descripción General del Proyecto

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

Antes de Comenzar

APIs Backend​

Todas las APIs se construyen con Node.js, Express y TypeScript, y se despliegan en AWS Lambda a través de Serverless Framework.

ProyectoPropósitoPuerto de DesarrolloBase de Datos
ApiMonolito modular principal cubriendo membresía, asistencia, contenido, donaciones, mensajería y tareas8084Base de datos MySQL separada por módulo (6 total)
LessonsApiBackend de Lessons.church--Base de datos MySQL única lessons
AskApiHerramienta de consulta de IA impulsada por OpenAI----
info

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

Aplicaciones Web​

ProyectoMarcoPuerto de DesarrolloPropósito
B1AdminReact 19 + Vite + MUI 75173Panel de administración de iglesia
B1AppNext.js 16 + React 19 + MUI 73301Aplicación de miembro de iglesia de cara al público
LessonsAppNext.js 163501Frontend de Lessons.church
B1TransferReact + Vite--Utilidad de importación/exportación de datos
BrochureSitesEstático--Sitios web de folleto de iglesia estáticos

Aplicaciones Móviles​

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

ProyectoPropósitoVersiones Clave
B1MobileAplicación de miembro de iglesia para iOS y AndroidExpo 54, React Native 0.81
B1CheckinAplicación de quiosco de registroExpo
LessonsScreenAplicación Android TV para mostración de leccionesExpo
FreePlayReproducción de contenido (incluido TV OS)Expo
FreeShowRemoteControl remoto móvil para FreeShowExpo

Escritorio​

ProyectoPilaPropósito
FreeShowElectron 37 + Svelte 3 + ViteSoftware de presentación y adoración

Bibliotecas Compartidas​

El código compartido se publica en npm bajo el alcance @churchapps. Estos se consumen como dependencias npm regulares por los proyectos anteriores.

PaqueteNombre en npmPropósitoUtilizado Por
Helpers@churchapps/helpersUtilidades base (DateHelper, ApiHelper, CurrencyHelper, etc.)Todos los proyectos
ApiHelper@churchapps/apihelperUtilidades del servidor Express (middleware de autenticación, ayudantes de BD, integración de AWS)Todas las APIs
AppHelperEspacio de trabajo con 6 paquetesBiblioteca de componentes ReactTodas las aplicaciones web
ContentProviderHelper@churchapps/content-provider-helperProveedores de contenido de YouTube, Vimeo y localFreeShow, FreePlay, Api

Sub-paquetes de AppHelper​

El proyecto AppHelper es un espacio de trabajo monorepo que publica seis paquetes:

PaqueteNombre en npm
Core@churchapps/apphelper
Login@churchapps/apphelper-login
Donations@churchapps/apphelper-donations
Forms@churchapps/apphelper-forms
Markdown@churchapps/apphelper-markdown
Website@churchapps/apphelper-website

Relaciones del Proyecto​

Aplicaciones Frontend              Bibliotecas Compartidas           APIs Backend
--------------             ----------------           -----------
B1Admin      ──────┐
B1App        ──────┤       @churchapps/helpers ◄───── Api
LessonsApp   ──────┼──►    @churchapps/apphelper      LessonsApi
B1Mobile     ──────┤                                   AskApi
FreeShow     ──────┘       @churchapps/apihelper ◄────┘

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

Próximos Pasos​