Skip to content

Onboarding — someli-api

The customer-facing backend. Express + MySQL. The platform's largest service (~728 endpoints, ~108 background jobs). Everything related to publishing posts, billing, OAuth into FB/IG/LI/TT/X, AI content generation, and the RAG pipeline lives here.

First: make sure you've worked through the cross-cutting docs — workstation setup, platform tour, git workflow.

Read in order

  1. 01-setup.md — clone, install, env vars, start the server
  2. 02-stack.md — what's in the stack and why each piece is there
  3. 03-architecture.md — folder map, entry point, request lifecycle, jobs
  4. 04-getting-started.md — find your first ticket, change the code, run it, PR it
  5. 05-where-to-look.md — when X is broken, look at Y
  • ../../audit/someli-api/ — full audit subtree (40+ docs: architecture, security, jobs inventory, API inventory, data model, RAG pipeline, dashboard analytics, deployment, …)
  • ../../code-inspect/someli-api.md — code-level bugs and quality findings with file:line citations