# benni2013/kp-bps architecture

> Architecture diagram of the GitHub repository benni2013/kp-bps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/benni2013/kp-bps
- Repository: https://github.com/benni2013/kp-bps

## Overview

##### Project Type and Purpose
- E-Voisy is a full-stack web application (Node.js/Express backend + Handlebars/TailwindCSS frontend) that facilitates two‐stage electronic voting and reporting for BPS Kota Padang.

##### File Structure
- app.js & bin/www: Application entry point and server launcher
- config/: Database configuration (Sequelize + MySQL)
- models/ & migrations/ & seeders/: Sequelize ORM layer, schema migrations, and seed data
- routes/: Express route definitions (e.g., auth, admin, voting)
- controllers/: Business logic for each route
- views/: Handlebars templates for Admin, User, Supervisor UIs
- public/: Static assets (CSS, images, generated PDFs)
- package.json: Dependencies (Express, Sequelize, ExcelJS, PDFKit, etc.)

##### Read README for Additional Insights
- Users & roles: Admin, Pegawai (voter), Supervisor
- Workflow:
1) Data input (CKP & attendance)
2) Voting stage 1 (top-3 candidate selection)
3) Voting stage 2 (criteria-based scoring)
4) Real-time monitoring & report generation
- Key libraries: Sequelize (ORM), ExcelJS/PDFKit (file generation), Handlebars (templating)

##### Main Components and Interactions
- Client Browser (Frontend)
- UI templates (Handlebars + TailwindCSS)
- Static files (JS/CSS/images) served from public/
- Web Server (Backend – Express.js)
- Routes → Controllers → Services → Models
- Session or JWT‐based Authentication (SECRET_KEY)
- File‐generation modules (ExcelJS, PDFKit)
- Database (MySQL via Sequelize)
- Tables: anggota (members), indikator (criteria), periode, pemilihan (elections), detail_pemilihan, data_nilai, voting1/voting2
- File Storage (local filesystem)
- Uploaded proofs, generated reports (PDFs, Excel) in public/files
- (Optional) External/Devops
- .env for environment variables, config/config.json for DB credentials
- Deployment container or PaaS

##### Architectural Patterns & Design Principles
- MVC Pattern:
- Models (Sequelize) ↔ Controllers (business logic) ↔ Views (Handlebars)
- Modular Routing: Each feature (auth, admin, voting, reports) has its own route module
- Layered File‐Generation Service: Controllers invoke ExcelJS/PDFKit for report exports
- Real‐Time Monitoring: Controllers fetch live voting data and push to views (can evolve into WebSocket layer)

##### Essential Elements
- “Browser (Admin/User/Supervisor)”
- “Express Server” subdivided into:
– Routes
– Controllers (AuthController, GenerateController, HandleVote controllers…)
– Services (ExcelJS/PDFKit modules)
– Models (Sequelize models & migrations)
- “MySQL Database” (tables)
- “File Storage” (public/files)
- Relationships:
- Route → Controller → Model
- Controller → File Service → File Storage
- Controller → View (Handlebars) → Browser
- Annotations for the two‐stage voting flow
- Environment/config layer for .env and config/config.json

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Layers
    subgraph "Presentation Layer"
        Browser["Browser (Admin/User/Supervisor)"]:::ui
    end

    subgraph "Application Layer"
        subgraph "Routes"
            authR["routes/auth.js"]:::logic
            adminR["routes/admin.js"]:::logic
            pemilR["routes/pemilihan.js"]:::logic
            berlangsungR["routes/pemilihanBerlangsung.js"]:::logic
            usersR["routes/users.js"]:::logic
            mAnggotaR["routes/manajerAnggota.js"]:::logic
            mKriteriaR["routes/manajerKriteria.js"]:::logic
            mPemilR["routes/manajerPemilihan.js"]:::logic
            genR["routes/generate.js"]:::logic
            indexR["routes/index.js"]:::logic
        end

        subgraph "Controllers"
            authC["controllers/AuthController.js"]:::logic
            adminC["controllers/AdminMainController.js"]:::logic
            userC["controllers/UserController.js"]:::logic
            voteC["controllers/UserVoting.js"]:::logic
            handleP["controllers/HandlePemilihan.js"]:::logic
            handleV["controllers/HandleVote.js"]:::logic
            genC["controllers/GenerateController.js"]:::logic
            mAnggotaC["controllers/ManajerAnggota.js"]:::logic
            mKriteriaC["controllers/ManajerKriteria.js"]:::logic
            mPemilC["controllers/ManajerPemilihan.js"]:::logic
        end

        subgraph "Services"
            reportS["ExcelJS/PDFKit Service"]:::file
        end

        subgraph "Models (Sequelize)"
            mIndex["models/index.js"]:::data
            mAnggota["models/anggota.js"]:::data
            mIndikator["models/indikator.js"]:::data
            mPeriode["models/periode.js"]:::data
            mPemil["models/pemilihan.js"]:::data
            mDetail["models/detail_pemilihan.js"]:::data
            mDataNilai["models/data_nilai.js"]:::data
            mV1["models/voting1.js"]:::data
            mV2["models/voting2.js"]:::data
        end

        subgraph "Config"
            env[".env"]:::config
            cfgJson["config/config.json"]:::config
        end

        subgraph "Views"
            views["Handlebars Templates"]:::ui
        end
    end

    subgraph "Data Layer"
        DB["MySQL Database"]:::data
    end

    subgraph "File Storage"
        FS["public/files"]:::file
    end

    %% Flows
    Browser -->|HTTP Request| authR
    Browser -->|HTTP Request| adminR
    Browser -->|HTTP Request| pemilR
    Browser -->|HTTP Request| berlangsungR
    Browser -->|HTTP Request| usersR
    Browser -->|HTTP Request| mAnggotaR
    Browser -->|HTTP Request| mKriteriaR
    Browser -->|HTTP Request| mPemilR
    Browser -->|HTTP Request| genR
    Browser -->|HTTP Request| indexR

    authR -->|calls| authC
    adminR -->|calls| adminC
    usersR -->|calls| userC
    pemilR -->|calls| handleP
    berlangsungR -->|calls| handleV
    genR -->|calls| genC
    mAnggotaR -->|calls| mAnggotaC
    mKriteriaR -->|calls| mKriteriaC
    mPemilR -->|calls| mPemilC

    authC -->|queries| mIndex
    authC -->|queries| mAnggota

    adminC -->|queries| mAnggota
    adminC -->|queries| mIndikator
    adminC -->|queries| mPeriode
    adminC -->|queries| mPemil

    handleP -->|queries| mPemil
    handleP -->|queries| mDetail

    handleV -->|queries| mV1
    handleV -->|queries| mV2
    handleV -->|queries| mDataNilai

    genC -->|uses| reportS
    reportS -->|writes| FS

    Controllers -->|renders| views
    views -->|HTML| Browser

    mIndex -->|ORM Sync| DB
    mAnggota -->|ORM Query| DB
    mIndikator -->|ORM Query| DB
    mPeriode -->|ORM Query| DB
    mPemil -->|ORM Query| DB
    mDetail -->|ORM Query| DB
    mDataNilai -->|ORM Query| DB
    mV1 -->|ORM Query| DB
    mV2 -->|ORM Query| DB

    env -->|configures| authC
    cfgJson -->|configures| mIndex

    %% Click events
    click authR "https://github.com/benni2013/kp-bps/blob/main/routes/auth.js"
    click adminR "https://github.com/benni2013/kp-bps/blob/main/routes/admin.js"
    click pemilR "https://github.com/benni2013/kp-bps/blob/main/routes/pemilihan.js"
    click berlangsungR "https://github.com/benni2013/kp-bps/blob/main/routes/pemilihanBerlangsung.js"
    click usersR "https://github.com/benni2013/kp-bps/blob/main/routes/users.js"
    click mAnggotaR "https://github.com/benni2013/kp-bps/blob/main/routes/manajerAnggota.js"
    click mKriteriaR "https://github.com/benni2013/kp-bps/blob/main/routes/manajerKriteria.js"
    click mPemilR "https://github.com/benni2013/kp-bps/blob/main/routes/manajerPemilihan.js"
    click genR "https://github.com/benni2013/kp-bps/blob/main/routes/generate.js"
    click indexR "https://github.com/benni2013/kp-bps/blob/main/routes/index.js"

    click authC "https://github.com/benni2013/kp-bps/blob/main/controllers/AuthController.js"
    click adminC "https://github.com/benni2013/kp-bps/blob/main/controllers/AdminMainController.js"
    click userC "https://github.com/benni2013/kp-bps/blob/main/controllers/UserController.js"
    click voteC "https://github.com/benni2013/kp-bps/blob/main/controllers/UserVoting.js"
    click handleP "https://github.com/benni2013/kp-bps/blob/main/controllers/HandlePemilihan.js"
    click handleV "https://github.com/benni2013/kp-bps/blob/main/controllers/HandleVote.js"
    click genC "https://github.com/benni2013/kp-bps/blob/main/controllers/GenerateController.js"
    click mAnggotaC "https://github.com/benni2013/kp-bps/blob/main/controllers/ManajerAnggota.js"
    click mKriteriaC "https://github.com/benni2013/kp-bps/blob/main/controllers/ManajerKriteria.js"
    click mPemilC "https://github.com/benni2013/kp-bps/blob/main/controllers/ManajerPemilihan.js"

    click mIndex "https://github.com/benni2013/kp-bps/blob/main/models/index.js"
    click mAnggota "https://github.com/benni2013/kp-bps/blob/main/models/anggota.js"
    click mIndikator "https://github.com/benni2013/kp-bps/blob/main/models/indikator.js"
    click mPeriode "https://github.com/benni2013/kp-bps/blob/main/models/periode.js"
    click mPemil "https://github.com/benni2013/kp-bps/blob/main/models/pemilihan.js"
    click mDetail "https://github.com/benni2013/kp-bps/blob/main/models/detail_pemilihan.js"
    click mDataNilai "https://github.com/benni2013/kp-bps/blob/main/models/data_nilai.js"
    click mV1 "https://github.com/benni2013/kp-bps/blob/main/models/voting1.js"
    click mV2 "https://github.com/benni2013/kp-bps/blob/main/models/voting2.js"

    click env "https://github.com/benni2013/kp-bps/blob/main/.env"
    click cfgJson "https://github.com/benni2013/kp-bps/blob/main/config/config.json"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef logic fill:#90EE90,stroke:#000,stroke-width:1px
    classDef data fill:#FFA500,stroke:#000,stroke-width:1px
    classDef file fill:#D3D3D3,stroke:#000,stroke-width:1px
    classDef config fill:#DDA0DD,stroke:#000,stroke-width:1px
```
