USSD service
Go to file
lash b615c27cf6
Some checks failed
release / docker (push) Has been cancelled
Merge pull request 'trigger-balance-reload' (#193) from trigger-balance-reload into master
Reviewed-on: #193
Reviewed-by: lash <accounts-grassrootseconomics@holbrook.no>
2024-12-02 16:36:26 +01:00
.github/workflows fix: github ci spec 2024-11-19 17:18:13 +03:00
cmd Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
common updated the UpdateVoucherData description 2024-11-30 15:26:13 +03:00
config Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
dev feat: dockerfile and github based CI build for Africastalking variant (#174) 2024-11-19 15:15:24 +01:00
devtools/admin wrap in devtools/admin 2024-11-01 16:44:54 +03:00
initializers rename file 2024-10-19 13:41:19 +03:00
internal Merge branch 'master' into trigger-balance-reload 2024-12-02 16:36:08 +01:00
menutraversal_test Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
models add voucher details 2024-11-21 13:03:43 +03:00
remote Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
services/registration check vouchers before checking the balance 2024-11-30 15:24:14 +03:00
.dockerignore fix: Dockerfile to include .env 2024-11-19 17:25:20 +03:00
.env.example use a single bearer token 2024-11-15 18:35:49 +03:00
.gitignore ignore .log files 2024-11-07 16:41:38 +03:00
Dockerfile debug: postgres conn string 2024-11-19 17:53:06 +03:00
go.mod feat: upgrade go-vise dep, minor cleanups to go.mod 2024-11-25 09:56:24 +03:00
go.sum feat: upgrade go-vise dep, minor cleanups to go.mod 2024-11-25 09:56:24 +03:00
LICENSE init: project 2024-08-12 14:30:13 +08:00
Makefile init: project 2024-08-12 14:30:13 +08:00
README.md updated README 2024-11-08 20:35:17 +03:00
sample_tokens.json define importable token list 2024-10-08 13:41:09 +03:00

URDT USSD service

This is a USSD service built using the go-vise engine.

Prerequisites

1. go-vise

Set up go-vise by cloning the repository into a separate directory. The main upstream repository is hosted at: https://git.defalsify.org/vise.git

git clone https://git.defalsify.org/vise.git

Setup

  1. Clone the ussd repo in its own directory

    git clone https://git.grassecon.net/urdt/ussd.git
    
  2. Navigate to the project directory.

  3. Enter the services/registration subfolder:

    cd services/registration
    
  4. make the .bin files from the .vis files

    make VISE_PATH=/var/path/to/your/go-vise -B
    
  5. Return to the project root (cd ../..)

  6. Run the USSD menu

    go run cmd/main.go -session-id=0712345678
    

Running the different binaries

  1. CLI:

    go run cmd/main.go -session-id=0712345678
    
  2. Africastalking:

    go run cmd/africastalking/main.go
    
  3. Async:

    go run cmd/async/main.go
    
  4. Http:

    go run cmd/http/main.go
    

Flags

Below are the supported flags:

  1. -session-id:

    Specifies the session ID. (CLI only).

    Default: 075xx2123.

    Example:

    go run cmd/main.go -session-id=0712345678
    
  2. -d:

    Enables engine debug output.

    Default: false.

    Example:

    go run cmd/main.go -session-id=0712345678 -d
    
  3. -db:

    Specifies the database type.

    Default: gdbm.

    Example:

    go run cmd/main.go -session-id=0712345678 -d -db=postgres
    

    Note: If using -db=postgres, ensure PostgreSQL is running with the connection details specified in your .env file.

License

AGPL-3.0.