# rifandiysf/fitalenta architecture

> Architecture diagram of the GitHub repository rifandiysf/fitalenta, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rifandiysf/fitalenta
- Repository: https://github.com/rifandiysf/fitalenta

## Overview

Fitalenta is a public-facing talent, training and organizational-information portal backed by an API and content-management backend. The user-facing workflow spans browsing services, programs, articles, events and galleries, plus account and contact forms; administrators manage content through protected routes. The excerpts show the program and authentication paths end to end, and article retrieval through its service. Other content areas are represented from the repository tree, but their runtime links are not asserted because their source was not sampled.

Main entry points: [`server/src/routes/admin/program.routes.ts`](https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/admin/program.routes.ts) (Admin program routes), [`server/src/controllers/auth.controller.ts`](https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/auth.controller.ts) (Auth handlers), [`server/src/services/auth.service.ts`](https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/auth.service.ts) (Auth service), [`server/src/middlewares/authenticate.ts`](https://github.com/rifandiysf/fitalenta/blob/main/server/src/middlewares/authenticate.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Public web"]
  node_webcontent["Content pages"]
  node_webforms["Contact form<br/>[contact-form.tsx]"]
  node_loginform["Login form<br/>[login-form.tsx]"]
  node_registerform["Registration form<br/>[register-form.tsx]"]
end

subgraph group_api["API routing"]
  node_programroutes["Public program routes<br/>[program.routes.ts]"]
  node_programcontroller["Program queries"]
  node_adminprogramroutes["Admin program routes<br/>[program.routes.ts]"]
  node_adminprogramcontroller["Program management"]
  node_authroutes["Auth routes<br/>[auth.routes.ts]"]
  node_authcontroller["Auth handlers<br/>[auth.controller.ts]"]
  node_articlectrl["Article queries"]
end

subgraph group_domain["Domain services"]
  node_programservice["Program service<br/>[program.service.ts]"]
  node_articleservice["Article service<br/>[article.service.ts]"]
  node_jobservice["Job service<br/>[job.service.ts]"]
end

subgraph group_identity["Identity and access"]
  node_authservice["Auth service<br/>[auth.service.ts]"]
  node_authmw["Authentication<br/>[authenticate.ts]"]
  node_authz["Role authorization<br/>[authorize.ts]"]
  node_jwt["Token utilities<br/>[jwt.ts]"]
  node_cookie["Cookie utilities<br/>[cookie.ts]"]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))
node_database[("MariaDB")]

node_visitor -.->|"browses"| node_webcontent
node_visitor -.->|"submits"| node_webforms
node_visitor -.->|"signs in"| node_loginform
node_visitor -.->|"registers"| node_registerform
node_admin -.->|"manages programs"| node_adminprogramroutes
node_programroutes -->|"routes requests"| node_programcontroller
node_programcontroller -->|"queries programs"| node_programservice
node_adminprogramroutes -->|"authenticates"| node_authmw
node_adminprogramroutes -->|"checks roles"| node_authz
node_adminprogramroutes -->|"routes requests"| node_adminprogramcontroller
node_adminprogramcontroller -->|"manages programs"| node_programservice
node_authroutes -->|"routes requests"| node_authcontroller
node_authcontroller -->|"authenticates users"| node_authservice
node_authcontroller -->|"sets cookies"| node_cookie
node_authmw -->|"reads cookie name"| node_cookie
node_authmw -->|"verifies token"| node_jwt
node_authservice -->|"signs token"| node_jwt
node_articlectrl -->|"queries articles"| node_articleservice
node_programservice -->|"reads and writes"| node_database
node_articleservice -->|"reads and writes"| node_database
node_authservice -->|"reads and writes"| node_database
node_jobservice -->|"reads and writes"| node_database

click node_webcontent "https://github.com/rifandiysf/fitalenta/tree/main/client/src/app/(front)"
click node_webforms "https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/(front)/contact/features/contact-form.tsx"
click node_loginform "https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/auth/features/login-form.tsx"
click node_registerform "https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/auth/features/register-form.tsx"
click node_programroutes "https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/program.routes.ts"
click node_programcontroller "https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/program.controller.ts"
click node_adminprogramroutes "https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/admin/program.routes.ts"
click node_adminprogramcontroller "https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/admin/program.controller.ts"
click node_authroutes "https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/auth.routes.ts"
click node_authcontroller "https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/auth.controller.ts"
click node_articlectrl "https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/article.controller.ts"
click node_programservice "https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/program.service.ts"
click node_articleservice "https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/article.service.ts"
click node_jobservice "https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/job.service.ts"
click node_authservice "https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/auth.service.ts"
click node_authmw "https://github.com/rifandiysf/fitalenta/blob/main/server/src/middlewares/authenticate.ts"
click node_authz "https://github.com/rifandiysf/fitalenta/blob/main/server/src/middlewares/authorize.ts"
click node_jwt "https://github.com/rifandiysf/fitalenta/blob/main/server/src/utils/jwt.ts"
click node_cookie "https://github.com/rifandiysf/fitalenta/blob/main/server/src/utils/cookie.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webcontent,node_webforms,node_loginform,node_registerform toneBlue
class node_programroutes,node_programcontroller,node_adminprogramroutes,node_adminprogramcontroller,node_authroutes,node_authcontroller,node_articlectrl,node_database toneAmber
class node_programservice,node_articleservice,node_jobservice toneMint
class node_authservice,node_authmw,node_authz,node_jwt,node_cookie toneRose
class node_visitor,node_admin toneIndigo
```

## Components

### Public web

- [Content pages](https://github.com/rifandiysf/fitalenta/tree/main/client/src/app/(front)): `client/src/app/(front)`
- [Contact form](https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/(front)/contact/features/contact-form.tsx): `client/src/app/(front)/contact/features/contact-form.tsx`
- [Login form](https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/auth/features/login-form.tsx): `client/src/app/auth/features/login-form.tsx`
- [Registration form](https://github.com/rifandiysf/fitalenta/blob/main/client/src/app/auth/features/register-form.tsx): `client/src/app/auth/features/register-form.tsx`

### API routing

- [Public program routes](https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/program.routes.ts): `server/src/routes/program.routes.ts`
- [Program queries](https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/program.controller.ts): `server/src/controllers/program.controller.ts`
- [Admin program routes](https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/admin/program.routes.ts): `server/src/routes/admin/program.routes.ts`
- [Program management](https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/admin/program.controller.ts): `server/src/controllers/admin/program.controller.ts`
- [Auth routes](https://github.com/rifandiysf/fitalenta/blob/main/server/src/routes/auth.routes.ts): `server/src/routes/auth.routes.ts`
- [Auth handlers](https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/auth.controller.ts): `server/src/controllers/auth.controller.ts`
- [Article queries](https://github.com/rifandiysf/fitalenta/blob/main/server/src/controllers/article.controller.ts): `server/src/controllers/article.controller.ts`

### Domain services

- [Program service](https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/program.service.ts): `server/src/services/program.service.ts`
- [Article service](https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/article.service.ts): `server/src/services/article.service.ts`
- [Job service](https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/job.service.ts): `server/src/services/job.service.ts`

### Identity and access

- [Auth service](https://github.com/rifandiysf/fitalenta/blob/main/server/src/services/auth.service.ts): `server/src/services/auth.service.ts`
- [Authentication](https://github.com/rifandiysf/fitalenta/blob/main/server/src/middlewares/authenticate.ts): `server/src/middlewares/authenticate.ts`
- [Role authorization](https://github.com/rifandiysf/fitalenta/blob/main/server/src/middlewares/authorize.ts): `server/src/middlewares/authorize.ts`
- [Token utilities](https://github.com/rifandiysf/fitalenta/blob/main/server/src/utils/jwt.ts): `server/src/utils/jwt.ts`
- [Cookie utilities](https://github.com/rifandiysf/fitalenta/blob/main/server/src/utils/cookie.ts): `server/src/utils/cookie.ts`

### Other components

- **Visitor**
- **Administrator**
- **MariaDB**

## Connections

- Visitor → Content pages: browses
- Visitor → Contact form: submits
- Visitor → Login form: signs in
- Visitor → Registration form: registers
- Administrator → Admin program routes: manages programs
- Public program routes → Program queries: routes requests (evidence: `server/src/routes/program.routes.ts`)
- Program queries → Program service: queries programs (evidence: `server/src/controllers/program.controller.ts`)
- Admin program routes → Authentication: authenticates (evidence: `server/src/routes/admin/program.routes.ts`)
- Admin program routes → Role authorization: checks roles (evidence: `server/src/routes/admin/program.routes.ts`)
- Admin program routes → Program management: routes requests (evidence: `server/src/routes/admin/program.routes.ts`)
- Program management → Program service: manages programs (evidence: `server/src/controllers/admin/program.controller.ts`)
- Auth routes → Auth handlers: routes requests (evidence: `server/src/routes/auth.routes.ts`)
- Auth handlers → Auth service: authenticates users (evidence: `server/src/controllers/auth.controller.ts`)
- Auth handlers → Cookie utilities: sets cookies (evidence: `server/src/controllers/auth.controller.ts`)
- Authentication → Cookie utilities: reads cookie name (evidence: `server/src/middlewares/authenticate.ts`)
- Authentication → Token utilities: verifies token (evidence: `server/src/middlewares/authenticate.ts`)
- Auth service → Token utilities: signs token (evidence: `server/src/services/auth.service.ts`)
- Article queries → Article service: queries articles (evidence: `server/src/controllers/article.controller.ts`)
- Program service → MariaDB: reads and writes (evidence: `server/src/services/program.service.ts`)
- Article service → MariaDB: reads and writes (evidence: `server/src/services/article.service.ts`)
- Auth service → MariaDB: reads and writes (evidence: `server/src/services/auth.service.ts`)
- Job service → MariaDB: reads and writes (evidence: `server/src/services/job.service.ts`)
