Lumipat sa pangunahing nilalaman

API

Ang ChurchApps API ay isang modular monolith -- iisang codebase na naglilingkod sa anim na data module, bawat isa ay may sariling database. Ibinibigay ng arkitekturang ito ang mga benepisyo sa organisasyon ng microservices (malinaw na hangganan, independenteng data store) kasama ang pagiging simple sa operasyon ng iisang deployment.

Mga Module​

ModuleLayunin
MembershipMga tao, grupo, household, permiso
AttendanceMga serbisyo, session, record ng check-in
ContentMga pahina, seksyon, elemento, streaming
GivingMga donasyon, fund, pagproseso ng bayad
MessagingMga usapan, notification, email
DoingMga task, plan, takda

Tech Stack​

  • Runtime: Node.js 24.x na may TypeScript (ES modules)
  • Framework: Express
  • Dependency Injection: Inversify (routing na nakabatay sa decorator)
  • Database: MySQL -- isang database bawat module, bawat isa ay may sariling connection pool
  • Auth: JWT-based na authentication sa pamamagitan ng CustomAuthProvider
  • Deployment: AWS Lambda gamit ang Serverless Framework v3

Mga Port​

ProtocolPortPaglalarawan
HTTP8084Pangunahing REST API
WebSocket8087Real-time na socket connection

Mga Lambda Function​

Kapag na-deploy sa AWS, tumatakbo ang API bilang anim na Lambda function:

  • web -- Humahawak sa lahat ng HTTP request
  • socket -- Namamahala sa mga WebSocket connection
  • timer15Min -- Tumatakbo kada 30 minuto para sa mga email notification (historikal ang pangalan)
  • timerMidnight -- Tumatakbo araw-araw para sa digest email at maintenance task
  • timerScheduledTasks -- Tumatakbo araw-araw para sa mga automation na dapat tumakbo at pagproseso ng overdue na workflow
  • timerWebhooks -- Tumatakbo kada minuto para ihatid ang mga naka-queue na outbound webhook

Mga Shared Library​

Umaasa ang API sa dalawang shared ChurchApps package:

Impormasyon

Gumagamit ang API ng ES modules ("type": "module" sa package.json). Siguraduhing ginagamit ng iyong mga import ang ES module syntax.

Nasa Seksyong Ito​

  • Local Setup -- I-clone, i-configure, at patakbuhin ang API nang lokal
  • Database -- Arkitekturang database-per-module, mga schema script, at mga pattern ng pag-access ng datos
  • Module Structure -- Mga controller, repository, model, at authentication
  • API Keys -- Mga personal na access token para sa mga script at connector
  • Connected Apps (OAuth) -- Multi-tenant na OAuth flow para sa mga third-party app
  • Webhooks -- Magpadala ng push notification ng mga event sa mga external na sistema
  • MCP Server -- Model Context Protocol endpoint na naglalantad ng API sa mga AI assistant
  • Endpoint Reference -- Kumpletong REST API documentation para sa lahat ng module