ClickerHeroesTracker

KO | EN

gitlite — search

#javascript #ai #golang #android #machine-learning #docker #nodejs #java #windows #cli #kubernetes #awesome-list #vue #mcp

ClickerHeroesTracker

(★ 31)

A progress tracker for the game Clicker Heroes

ClickerHeroesTracker Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Getting started
## Prereqs
1. **Clone the Repo** - There should be a "Clone" button to the right on this page.
1. For the API code, you'll want [Visual Studio 2019](https://www.visualstudio.com/vs/). The Community version is free.
1. For the frontend code, use an editor like [Visual Studio Code](https://code.visualstudio.com/).
1. Use **SQL** for the local database:
    1. [SQL LocalDB](https://docs.microsoft.com/en-us/sql/database-engine/configure-windows/sql-server-2016-express-localdb#install-localdb) should work just fine.
    1. Add a new empty database to your local instance, eg. "ClickerHeroesTrackerData"
    1. Update your user secrets with the database connection string. To get to your user secrets, in Visual Studio you can right-click on the Website project and select "Manage User Secrets", or you can manually find them (or create the file if it doesn't exist) at `%APPDATA%\Microsoft\UserSecrets\aspnet-ClickerHeroesTrackerWebsite-20161025101322\secrets.json`
    1. The required schema structure will be set up automatically when starting the application for the first time.
1. (Optional) Install [Azure Storage Emulator](https://go.microsoft.com/fwlink/?linkid=717179&clcid=0x409) to locally mock a storage account.
    - By default, in memory stores are used.
    - To use the Azure Storage Emulator set `Storage:ConnectionString` to `"UseDevelopmentStorage=true;"` by uncommenting it out in `appsettings.json`.

## Building
Today there is a main website and a new Angular app. The main website serves as both the API and the MVC application, but we are transitioning to the Angular app for the UI.

Because of the temporary duplication, you'll need to build both in the short term.

### Web Client
The Angular app is known as the webclient, rooted at the `WebClient` folder. Visual Studio Code is recommended to work with this project.

First run `npm install` initially to download the packages.

Use one of the following commands depending on what you're trying to do:
* `npm run clean` - Cleans the `dist` dir
* `npm run build` - Builds the project for production and puts it in the `dist` dir
* `npm run watch` - Builds the project and watches for file changes for incremental builds as you go. This is recommended during normal development.
* `npm run test` - Runs all unit tests. Note that building first is not required as we compile on the fly.
* `npm run test-watch` - Runs tests in a browser which you can refresh to re-run and debug as needed.

Other useful tools:
* `build` produces a `/logs/stats/report.html` which visualizes the bundles. The raw `stats.json` file can also be used to feed into other visualization tools. The bundles are as follows:
    * `app` is the main app code
    * `data` is a bundle of json files. This is in a separate bundle since the data should not change often.
    * `vendor` is most the 3rd party libraries
    * `polyfill` is the polyfill scripts
* `test` produces a code coverage report under `/logs/coverage/html/index.html`. This can be used to drill into code coverage. A cobertura report is also produced for the VSTS build.

### Website
The Website is the API layer. Visual Studio is recommended to work with this project.

Simply building the solution in Visual Studio should be sufficient.

## Starting the service
For the Client, it's recommended to use the watch command (described above) during development although the build command also also produces relevant output.

Next, start the Website as you normally would in Visual Studio. For the best experience, use the "web" profile, but IIS Express should also work just fine.

## Create an Admin user
To make a user a site admin:
1. Create a user via registration normally, or use an existing one.
1. Get the user id from the database. In this example, suppose it's `71584f37-4165-4cd6-90af-0762ea996b6e`
1. Ensure the Admin role exists in the `AspNetRoles` table. If it does not, add it with:

INSERT INTO AspNetRoles(Id, ConcurrencyStamp, Name, NormalizedName)
       VALUES(NEWID(), NEWID(), 'Admin', 'ADMIN');

1. Add your user to the role. Rememeber to replace the user id below with the one from above.

INSERT INTO AspNetUserRoles(UserId, RoleId)
       VALUES('71584f37-4165-4cd6-90af-0762ea996b6e', (SELECT Id FROM AspNetRoles WHERE Name = 'Admin'));

1. You may need to log out and back in for the change to take effect. You should see an Admin link in the navbar if you were successful.

## Using the API
It sometimes can be easier during development to directly hit the API instead of using the website, especially for automation tasks like database setup or cleanup.

## Authentication
Hitting the API without a browser can be difficult to use. The server is its own OpenID Connect Server so can produce its own authentication token.

1. Download a program that can help you make raw HTTP requests, such as [Fiddler](http://www.telerik.com/fiddler).
1. Retrieve an auth token using the following request:

POST http://localhost:5000/api/auth/token
       Content-Type: application/x-www-form-urlencoded

grant_type=password&username={username}&password={password}&scope=openid offline_access profile email roles

1. The response should be a Json object with the `access_token`, `expires_in`, and `token_type` fields.
1. Make the API request you want, including an Authorization header with the token. Example:

GET http://localhost:5000/api/users/{username}/uploads
       Authorization: {token_type} {access_token}

ClickerHeroesTracker

ClickerHeroesTracker Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

ClickerHeroesTracker

ClickerHeroesTracker Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README