mirror of
https://github.com/GSA/notifications-admin.git
synced 2026-02-05 10:53:28 -05:00
1b7658e09a
Gulp was failing silently on Travis. I tracked this down to the task that builds a custom, slimmed-down version of jQuery from source. To fix this I’ve removed the task and replaced it with just `src`ing the minified version of jQuery from `node_modules`. Cons: - A few more kb of JS Pros: - Less random, afternoon-chewing complexity
72 lines
1.9 KiB
Markdown
72 lines
1.9 KiB
Markdown
[](https://travis-ci.org/alphagov/notifications-admin)
|
|
[](https://requires.io/github/alphagov/notifications-admin/requirements/?branch=master)
|
|
|
|
|
|
# notifications-admin
|
|
Application to handle the admin functions of the notifications application.
|
|
|
|
### Features of this application:
|
|
<ul>
|
|
<li>Register users
|
|
<li>Register services
|
|
<li>Download CSV for an email or sms batch
|
|
<li>Show history of notifications
|
|
<li>Reports
|
|
</ul>
|
|
|
|
### Create a virtual environment for this project
|
|
```shell
|
|
mkvirtualenv -p /usr/local/bin/python3 notifications-admin
|
|
```
|
|
|
|
|
|
### Building the frontend
|
|
|
|
You need [Node](http://nodejs.org/) which will also get you [NPM](npmjs.org),
|
|
Node's package management tool.
|
|
```shell
|
|
brew install node
|
|
```
|
|
|
|
n is a tool for managing different versions of node. The following installs n and uses the latest version of node.
|
|
|
|
npm install -g n
|
|
n latest
|
|
npm rebuild node-sass
|
|
|
|
Most of the frontend dependencies are managed using Git Submodules. Some are
|
|
managed with NPM and Bower. To install or update *all the things*, run
|
|
```shell
|
|
git submodule init
|
|
git submodule update
|
|
npm install
|
|
npm run build
|
|
```
|
|
|
|
If you want the front end assets to re-compile on changes, leave this running
|
|
in a separate terminal from the app
|
|
```shell
|
|
npm run watch
|
|
```
|
|
|
|
### Running the application:
|
|
```shell
|
|
pip install -r requirements.txt
|
|
./scripts/bootstrap.sh
|
|
./scripts/run_app.sh
|
|
```
|
|
|
|
Note: the ./scripts/bootstrap.sh script only needs to be run the first time to
|
|
create the database.
|
|
|
|
URL to test app:
|
|
|
|
localhost:6012/helloworld
|
|
|
|
|
|
### Domain model
|
|
|
|
All the domain models are defined in the
|
|
[models.py](https://github.com/alphagov/notifications-admin/blob/master/app/models.py)
|
|
file.
|