USSD service
Go to file
2024-12-18 07:45:48 +01:00
.github/workflows fix: github ci spec 2024-11-19 17:18:13 +03:00
cmd Fix compile errors, test errors 2024-12-14 11:56:31 +00:00
common Segment tx userdata types, add internals docs 2024-12-11 19:13:13 +00:00
config Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
debug Habilitate store dumper 2024-12-08 22:48:39 +00:00
dev feat: dockerfile and github based CI build for Africastalking variant (#174) 2024-11-19 15:15:24 +01:00
devtools Habilitate store dumper 2024-12-08 22:48:39 +00:00
doc Segment tx userdata types, add internals docs 2024-12-11 19:13:13 +00:00
initializers rename file 2024-10-19 13:41:19 +03:00
internal Merge branch 'master' into lash/store-dumper 2024-12-14 13:02:38 +01:00
menutraversal_test add space on expected content 2024-12-17 16:02:35 +03:00
models Merge branch 'master' into profile-edit-traverse 2024-12-03 22:25:47 +03:00
remote Validate aliases, addresses and phone numbers in the send menu (#176) 2024-11-26 07:24:57 +01:00
services/registration add spacing after link 2024-12-17 15:46:28 +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 Upgrade vise 2024-12-14 12:02:13 +00:00
go.sum Upgrade vise 2024-12-14 12:02:13 +00: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.