owning-a-home, 面向homebuyers的工具和资源套件

分享于 

11分钟阅读

GitHub

  繁體 雙語
Unbiased mortgage rate comparison tool for homebuyers.
  • 源代码名称:owning-a-home
  • 源代码网址:http://www.github.com/cfpb/owning-a-home
  • owning-a-home源代码文档
  • owning-a-home源代码下载
  • Git URL:
    git://www.github.com/cfpb/owning-a-home.git
    Git Clone代码到本地:
    git clone http://www.github.com/cfpb/owning-a-home
    Subversion代码到本地:
    $ svn co --depth empty http://www.github.com/cfpb/owning-a-home
    Checked out revision 1.
    $ cd repo
    $ svn up trunk
    
    拥有一个家庭

    Build StatusCoverage StatusCode Climate

    "拥有家庭"是一个交互式的在线工具箱,用于帮助消费者在他们购买抵押的时候。 工具套件为消费者提供了获得最佳交易所需的信息和信心。 它使用户从家庭购买过程开始,指导借助贷款选项,术语和成本,通过结束表。

    这个项目进行中

    issues issues issues repo issues final 除非标记为 such www www gov gov/owning-a-home/,否则不会出现任何内容。 一些副本或者公式可以替换为虚拟文本,以确保我们遵循CFPB的任何隐私和安全程序。 决策过程的所有设计。布局和演变都是精确的。

    我们需要你的反馈,但将无法对大家作出回应

    我们使用敏捷框架,并计划使用这里 repo 发布。接收反馈,并尽可能频繁地迭代反馈。 我们的目标是看到用户对我们工作的趋势和React。 我们需要尽可以能多的反馈,以帮助我们做出明确的决定,以便我们能够更好地。 不幸的是,我们将无法响应我们收到的每一个反馈或者评论,但是打算通过工具的演进来响应。

    依赖项

    virtualenv & Virtualenvwrapper python-模块

    如果已经安装这些模块,则跳到cfgov刷新

    • 运行:
    pip install virtualenv virtualenvwrapper

    Autoenv模块

    如果已经安装了 Autoenv插件,请跳到cfgov刷新

    • 运行:
    pip install autoenv

    node,Grunt,Bower,Browserify

    安装 node.js 它或者最新版本将工作。

    安装 GruntBrowserify:

    npm install -g grunt-cli bower browserify
    • 导航到克隆的owning-a-home 目录并安装项目依赖项的node:
    npm install
    • 导航到 config 文件夹。 在该文件夹中,复制 example-config.json 文件并将它的重命名为 config.json。 可以通过以下两个命令从 命令行 完成:
    cd config
    cp example-config.json config.json
    • 运行grunt以生成站点:
    grunt

    npm封装用于锁定依赖项。 如果向 package.json, 中添加任何依赖项,运行 npm shrinkwrap 以生成新的npm-shrinkwrap.json 文件。

    cfgov刷新

    拥有一个主页可以通过cfgov刷新应用程序安装和运行。

    • 将cfgov刷新项目的项目克隆到你保存项目(。inside 拥有主页)的任何地方:
    git clone https://github.com/cfpb/cfgov-refresh.git

    运行 cfgov-refresh中列出的所有安装步骤。

    在窗口的cfgov刷新中,运行sheerlike命令,以便在仍然运行的页面中运行。

    python cfgov/manage.py sheer_index
    • 运行cfgov刷新并导航到浏览器中拥有的主项目。

    配置

    WordPress索引

    从WordPress索引你的内容:

    • 按cfgov刷新 repo refresh,复制 .env_SAMPLE 文件和 NAME .env。 这可以通过以下命令从 命令行 完成:
    cp. evn_SAMPLE. env
    • 将你的WordPress URL添加到以下 env 行代替 http://wordpress.url
    
    export WORDPRESS=http://wordpress.url
    
    
    
    
    • 运行以下命令 inside cfgov刷新:
    python cfgov/manage.py sheer_index

    利率检查和抵押保险

    利率检查和抵押保险是用于检查抵押贷款利率和抵押保险保险费的JavaScript应用程序。 目前owning-a-home检查和贷款比较率由返回抵押率。县数据和抵押保险保费的private api驱动。 如果没有配置这些 api,网站仍将加载,但利率检查器和贷款比较应用程序将不可用。

    因此只有对那些能够访问 private Rate和贷款比较应用的用户才能使用以下部分的

    private API用户

    要配置速率检查器和贷款比较,你需要指向 config/config.json 中所需的API url。

    • config/config.json 中,分别更改要指向 API url的行:
    {
     "rateCheckerAPI": "YOUR RATE CHECKER API URL HERE",
     "countyAPI": "YOUR COUNTY API URL HERE",
     "mortgageInsuranceAPI": "YOUR MORTGAGE INSURANCE API URL HERE",
    }

    工作流

    以下命令需要作为你日常工作流程的一部分来开发这个应用程序。

    获取更改工作流

    • 每次从 upstream 获取时,都要使用npm安装依赖项,并运行 grunt 以生成所有内容:
    npm install
    grunt

    基于的弹性搜索工作流

    要显示wordpress内容,需要运行弹性搜索:

    • 使用拥有的主 virtualenv:
    workon OAH

    保留在基本目录中

    开始弹性搜索:

    elasticsearch

    工作流程

    当你每次保存这些项目文件时,Grunt表都会重新编译。

    • 打开一个新的命令提示符并运行:
    grunt watch

    若要查看站点浏览,请执行下列操作: http://localhost:7000

    :如何测试软件

    Linting JavaScript

    运行 grunt lint 可以检测和更正JavaScript错误和警告。

    浏览器测试设置

    浏览器测试可以在 test/browser_testing/ 目录中找到。 要运行它们,你需要 Chromedriver

    下载Chromedriver后,解压 Chromedriver文件并将它的复制到开发环境可以访问的文件夹,如。

    在运行测试之前,需要设置一个 python 虚拟环境,安装依赖项并创建 enviconment.cfg 文件。

    cd test/browser_testing/
    mkvirtualenv oah-tests
    pip install -r requirements.txt

    重命名 test/browser_testing/features/example-environment.cfgtest/browser_testing/features/environment.cfg 编辑文件以将 chromedriver_path 指向你的本地chromedriver文件。

    运行浏览器测试

    workon oah-tests
    behave -k

    API测试

    在运行测试之前,需要设置一个 python 虚拟环境,安装依赖项并创建 environment.cfg 文件。

    cd test/api_testing/
    mkvirtualenv oah-tests
    pip install requests

    重命名 test/api_testing/features/example-environment.cfgtest/api_testing/features/environment.cfg 并编辑文件以指向 ratechecker_urlmortgageinsurance_url 到你想要测试的环境。

    workon oah-tests
    behave -k

    运行 behave -k -t=~prod_only 以忽略生产环境测试。

    负载测试

    安装 Jmeter

    运行 python jmeter-bootstrap/bin/JMeterInstaller.pytest 文件夹中安装 Jmeter 2.11和需要的插件以在本地运行 Jmeter

    从 命令行 本地运行负载测试的:

    
    apache-jmeter-2.11/bin/jmeter.sh -t owning-a-home/test/load_testing/RateChecker.jmx -Jserver_url oah.fake.demo.domain -Jthreads=8
    
    
    
    

    -t owning-a-home/test/load_testing/RateChecker.jmx :这告诉Jmeter测试生命的位置,relative 到从 -Jserver_url oah.fake.demo.domain 运行到的位置: 这是运行负载测试的URL。 用你想要 -Jthreads=8的URL替换 oah.fake.demo.domain: 这是负载测试的并发用户的最大数量

    OaH.jmx - 这里测试用于使用所有默认设置( 贷款选项,利率检查器等)的目标网页

    Rate_Checker.jmx - 这里测试使用列出的inside" rc.csv"查询运行速率检查器API的负载测试。 其他查询可以在" rc.csv"中作为行添加,并且测试将把它们 pick。

    Mortgage_Insurance.jmx - 这里测试使用列出的inside" mi.csv"查询来运行抵押保险API的负载测试。 其他查询可以在" mi.csv"中作为行添加,并且测试将把它们 pick。

    如果线程数为 6,并且有 3行查询,则测试将按以下顺序执行:

    
    user 1 - row 1
    
    
    user 2 - row 2
    
    
    user 3 - row 3
    
    
    user 4 - row 1
    
    
    user 5 - row 2
    
    
    user 6 - row 3
    
    
    
    

    捐赠

    我们欢迎代码和设计表单中的贡献,以及你对 public 域中的项目的理解也将发布到 public 域。 有关详细信息,请参阅我们的贡献文件


    tool  HOME  resource  资源  Suite  
    相关文章