How vic778/jumia-api works
JUMIA is a Rails e-commerce backend exposing JSON APIs for users and a hierarchical product catalog, with an ActiveAdmin interface for administration. The principal workflow is a client request routed to a resource controller, which reads or changes domain records and returns JSON. The routes and sampled controllers establish several catalog stages; the README documents additional commerce and product capabilities. Some controllers, models, and integrations are unsampled, so their internal calls are not inferred.
Main entry points: routes.rb API routes · drawers_controller.rb Drawers API · posts_controller.rb Posts API · categories_controller.rb Categories API
Components 24
API and catalog
- API routes
config/routes.rb - Categories API
app/controllers/categories_controller.rb - Subcategories API
app/controllers/sub_categories_controller.rb - Drawers API
app/controllers/drawers_controller.rb - Posts API
app/controllers/posts_controller.rb - Specifications API
app/controllers/specifications_controller.rb - Boxes API
app/controllers/box_controller.rb - Key features API
app/controllers/key_features_controller.rb - JSON serializers
app/serializers
Identity and access
- User and sessions API
app/controllers/sessions_controller.rb - Users and roles
app/models/user.rb - Authorization
app/controllers/permissions_controller.rb
Administration
- Admin interface
app/admin/dashboard.rb - Category administration
app/admin/category.rb
Commerce domain
- Categories
app/models/category.rb - Subcategories
app/models/sub_category.rb - Drawers
app/models/drawer.rb - Products and posts
app/models/post.rb - Specifications
app/models/specification.rb - Product boxes
app/models/box.rb - Key features
app/models/key_feature.rb - Cart and line items
app/models/cart.rb
Persistence
- PostgreSQL
Other components
- API client
Connections 24
- API client → API routes: sends request
config/routes.rb - API routes → Categories API: routes to
config/routes.rb - API routes → Subcategories API: routes to
config/routes.rb - API routes → Drawers API: routes to
config/routes.rb - API routes → Posts API: routes to
config/routes.rb - API routes → Specifications API: routes to
config/routes.rb - API routes → Boxes API: routes to
config/routes.rb - API routes → Key features API: routes to
config/routes.rb - API routes → User and sessions API: routes to
config/routes.rb - Categories API → Categories: reads and updates
app/controllers/categories_controller.rb - Drawers API → Drawers: reads and updates
app/controllers/drawers_controller.rb - Drawers API → Subcategories: finds parent
app/controllers/drawers_controller.rb - Posts API → Products and posts: reads and updates
app/controllers/posts_controller.rb - Posts API → Drawers: finds parent
app/controllers/posts_controller.rb - Specifications API → Product boxes: loads records
app/controllers/specifications_controller.rb - Specifications API → Key features: loads records
app/controllers/specifications_controller.rb - User and sessions API → Users and roles: authenticates users
- Admin interface → Category administration: provides management
- Category administration → Categories: manages categories
- Categories API → Authorization: checks access
app/controllers/categories_controller.rb - Drawers API → Authorization: checks access
app/controllers/drawers_controller.rb - Posts API → Authorization: checks access
app/controllers/posts_controller.rb - Categories → PostgreSQL: persists records
- Users and roles → PostgreSQL: persists records