mirror of
https://github.com/GSA/notifications-admin.git
synced 2026-09-07 16:08:24 -04:00
Tidy up README
This commit is contained in:
52
README.md
52
README.md
@@ -3,24 +3,18 @@
|
|||||||
|
|
||||||
|
|
||||||
# notifications-admin
|
# notifications-admin
|
||||||
|
|
||||||
Application to handle the admin functions of the notifications application.
|
Application to handle the admin functions of the notifications application.
|
||||||
|
|
||||||
### Features of this 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
|
- Register users
|
||||||
```shell
|
- Register services
|
||||||
mkvirtualenv -p /usr/local/bin/python3 notifications-admin
|
- Download CSV for an email or SMS batch
|
||||||
```
|
- Show history of notifications
|
||||||
|
- Reports
|
||||||
|
|
||||||
|
## First-time setup
|
||||||
### Building the frontend
|
|
||||||
|
|
||||||
You need [Node](http://nodejs.org/) which will also get you [NPM](npmjs.org),
|
You need [Node](http://nodejs.org/) which will also get you [NPM](npmjs.org),
|
||||||
Node's package management tool.
|
Node's package management tool.
|
||||||
@@ -43,28 +37,36 @@ The frontend dependencies are managed using NPM and Bower. To install or update
|
|||||||
npm run build
|
npm run build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
The app runs within a virtual environment. To [install virtualenv](https://virtualenv.readthedocs.org/en/latest/installation.html), run
|
||||||
|
```shell
|
||||||
|
[sudo] pip install virtualenv
|
||||||
|
```
|
||||||
|
|
||||||
|
To make a virtualenv for this app, run
|
||||||
|
```shell
|
||||||
|
mkvirtualenv -p /usr/local/bin/python3 notifications-admin
|
||||||
|
pip install -r requirements.txt
|
||||||
|
./scripts/bootstrap.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
## Building the frontend
|
||||||
|
|
||||||
If you want the front end assets to re-compile on changes, leave this running
|
If you want the front end assets to re-compile on changes, leave this running
|
||||||
in a separate terminal from the app
|
in a separate terminal from the app
|
||||||
```shell
|
```shell
|
||||||
npm run watch
|
npm run watch
|
||||||
```
|
```
|
||||||
|
|
||||||
### Running the application:
|
## Running the application
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
pip install -r requirements.txt
|
workon notifications-admin
|
||||||
./scripts/bootstrap.sh
|
|
||||||
./scripts/run_app.sh
|
./scripts/run_app.sh
|
||||||
```
|
```
|
||||||
|
|
||||||
Note: the ./scripts/bootstrap.sh script only needs to be run the first time to
|
Then visit [localhost:6012](localhost:6012)
|
||||||
create the database.
|
|
||||||
|
|
||||||
URL to test app:
|
## Domain model
|
||||||
|
|
||||||
localhost:6012/helloworld
|
|
||||||
|
|
||||||
|
|
||||||
### Domain model
|
|
||||||
|
|
||||||
All the domain models are defined in the
|
All the domain models are defined in the
|
||||||
[models.py](https://github.com/alphagov/notifications-admin/blob/master/app/models.py)
|
[models.py](https://github.com/alphagov/notifications-admin/blob/master/app/models.py)
|
||||||
|
|||||||
Reference in New Issue
Block a user