# DTP Newsroom Web Application

The Web application provides an ExpressJS-based HTTP interface made of application routes that process mostly GET and POST requests.

## Managing The Server

Follow the instructions in [README.md](../README.md) to configure a host for running DTP Newsroom including the configuration of [supervisord](https://supervisord.org/) to start and manage the execution of the `newsroom-web` process.

Refer to the [.env](./env.md) documentation for information about environment variables used to control `newsroom-web` in your environment.

You will need to decide on an IP address and TCP port number for `newsroom-web`. The default is 8000.

### pnpm start-control

The command `pnpm start-web` will run a full build and start the target, but it is not intended for use in production environments where process monitoring, automatic restarts, and more are needed. The command can be used to quickly test the configuration of a host's `.env` file, but servers shouldn't be left running as `pnpm start-web` for long-term production service.

### Controlling The Server With Supervisor
If you are suing the provided Supervisor config files unaltered, the following commands can be used to start, stop, restart, and monitor the `newsroom-web` process.

```sh
sudo supervisorctl start newsroom-web
sudo supervisorctl stop newsroom-web
sudo supervisorctl restart newsroom-web
sudo supervisorctl tail -f newsroom-web
```

## Accessing The Web Application

`newsroom-web` provides an ExpressJS-based Web app for browsing generated news content. Only HTTPS is offered (it does not bind an HTTP server).

### User Account

The system does have its own user account management service, and supports OAuth2 through a variety of providers. The system will use the email address discovered during OAuth2 as the new user's email address.

Whether created through OAuth2 or direct, Users can change their email address. They will have to re-verify their email address if changed, and their User account record loses email-verified status if changed until verified.

Users can self-serve a re-send of the verification email in Settings.

### Permissions

The system administrator can grant and revoke permissions to User accounts in the System Administration menu.

#### Manage Feeds
The User can add/remove RSS feeds using their URL.

#### Un-Publish Media
The User can un-publish content generated by the AI engine, which can sometimes just be too stupid to waste storage space on. Yep.

#### Comment
The User can comment on media and reply to other people's comments.