Someli-admin-api

This is the documentation subtree for Someli-ai/Someli-admin-api, the Express backend for the internal Admin Console.

Component summary

Component name	Someli-admin-api
Purpose	HTTP API serving the Admin Console (admin_console_R). Account management, personnel, prompts, affiliate marketing, customer-service tooling.
Tech stack	Node.js 20 + Express 4 + MySQL (callback + sync-mysql + mysql2/promise) + Passport (declared, not actively used) + Stripe + AWS Bedrock
Routes	~40 (31 in routes/routes.js, 9 in routes/auth.js)
Background jobs	None (no job_*.js files)
Audit version	0.1
Last verified	2026-05-17

Index

Architecture & code organisation

• Architecture Overview
• API Inventory
• Configuration
• Dependencies Inventory

Behaviour & integration

• Authentication
• Code Overlap With someli-api
• Integration Inventory

Cross-cutting concerns

• Security
• Observability
• Testing
• Error Handling

Operations

• Build & Deploy

Strategy

• Enterprise Readiness

Audit trail

• Verification Report
• Verify Markers

At a glance

• ~2400 LoC of routes (957 in routes/auth.js, 1400 in routes/routes.js) — a fraction of someli-api's 22 000-LoC routes/routes.js
• Uses the same Express-skeleton-from-someli-api pattern: conf.js + server.js + routes/routes.js + actions/actions.js + helper/ + modules/dbDriver/
• helper/ has 10 files; 4 are byte-identical to their counterparts in someli-api/helper/; the other 6 have drifted (some heavily — helper.js differs by 856 lines, aiLogics.js by 396 lines). See code-overlap.md.
• One Python script (Nova-Pro_KnowledgeBased_Content.py) for batch knowledge-base content via AWS Bedrock Nova
• Auth: bespoke JWT (encrypted via tokenGenerator.js, byte-identical to someli-api's version) — see authentication.md
• No Dockerfile, no Jenkinsfile, no .github/workflows/, no nginx.conf in this repo — see build-and-deploy.md
• No tests