djengo-proto-contracts

gRPC documentation map

Browsers cannot issue raw HTTP/2 gRPC calls here. This page lists every backend package so you know what exists — host, port, proto file, and service names. Call them with grpcurl, BloomRPC, or Postman’s gRPC client against Docker DNS (e.g. profile-service:50051).

Example: grpcurl -plaintext profile-service:50051 list

profile.proto · profile-service:50051

Auth, users, staff, OTP, admin profile, security.

ProfileService
AdminProfileService

organization.proto · organization-service:50055

Orgs, companies, branches, roles, departments, SaaS billing.

OrganizationService
BranchService
CompanyRoleService
DepartmentService
AdminOrganizationService
SaasBillingService
OrganizationAnalyticsService
StaffSelfService

admin.proto · admin-service:50057

Platform admin accounts, roles, action audit.

AdminService

files.proto · files-service:50052

File upload and metadata.

FilesService

address.proto · address-service:50053

Address CRUD for any entity.

AddressService

communication.proto · communications-service:50054

Transactional email / OTP mailer (Nest).

CommunicationService

comms.proto · comms-service:50061

Realtime chat / push (.NET) — also OpenAPI at /comms/docs.

CommsService

financials.proto · financial-service:50056

Payroll, budgets, wallets, guest billing, procurement — OpenAPI at /financials/docs.

FinancialsService
FinancialsHealthService
GuestBillingService
HospitalityBillingPolicyService
ProcurementService
FacilityAssetService
StatutoryRemittanceService
EventLogService / ApprovalChainService

events.proto · events-service:50060

HR events stack — OpenAPI at /events/docs.

AttendanceService
LeaveRequestService / LeavePolicyService
ApprovalService / ApprovalChainService
EmploymentContractService
CalendarEventService / ShiftTemplateService
PerformanceReviewService / DisciplinaryService
HrAnalyticsService / EventsOverviewService

facility.proto · facility-service:50062

Layout & occupancy — OpenAPI at /facility/docs.

FacilityService

operations.proto · operations-service:50059

Reservations, F&B, kitchen, incidents.

OperationService / PublicOperationService
ReservationService
OrderService / KitchenService
RestaurantMenuService (+ categories / combos)
IncidentService / GuestFeedbackService
FacilityOpsService

Source of truth

Edit protos in backend/djengo-proto-contracts/proto/, then npm run sync:services. Gateway Swagger documents the HTTP surface that wraps many of these RPCs.