Bangsluke Documentation

website·Indexed 31 days ago

https://bangsluke-documentation.netlify.app/

A comprehensive knowledge base covering the Software Development Life Cycle (SDLC), Agile methodologies, and Product Management. It includes guides on Scrum, SRE principles, product discovery, and release strategies, alongside technical documentation for specific projects like the Dorkinians Website and Acre Software Task, as well as general guides for Git, NPM, and PowerShell.

Tokens
46.7K
Snippets
71
Records
329
Agent score
75%

What's inside Bangsluke Documentation

  1. Overview of the Dorkinians Website PWA

    The Dorkinians Website is a mobile-first Progressive Web App (PWA) designed to provide comprehensive statistics and information about Dorkinians Football Club. Key features include a chatbot interface for querying statistics, detailed player/team/club metrics, Team of the Week (TOTW) displays, and club information.
  2. Overview of the Dorkinians Website Home page

    The Home page serves as the main entry point for the Dorkinians Website app. It features a chatbot interface that allows users to query player statistics, team performance, and club information using natural language. To enable personalized queries (using pronouns like "I", "me", or "my"), users must first select a player. However, users can still query other players by using their full names regardless of the current selection.
  3. Understand the core risks addressed by Product Discovery

    Product discovery is the process of uncovering unmet customer needs and validating solutions before committing engineering resources. Its primary purpose is to collect evidence to mitigate four critical risks:

    • Value Risk: Will the customer buy or use this? (Validates if the problem is worth solving).
    • Usability Risk: Can the user figure out how to use it? (Tests the approach's usability).
    • Feasibility Risk: Can we build it? (Confirms technical feasibility and scope).
    • Business Viability Risk: Does this solution work for our business? (Ensures alignment with strategy and viability).

    Additionally, teams should consider Ethics Risk: "Should we build it?" to avoid harming users or the environment.

  4. Organize React project folder structure

    A recommended folder structure for React projects, based on the Bulletproof React architecture, is as follows:
    src
    |-- /assets      # Static files (images, fonts, etc.)
    |-- /components    # Shared components used across the app
    |-- /config       # Global configuration and env variables
    |   -- .env       # Environment variables
    |-- /data         # Stored data used across the application
    |-- /features     # Feature-based modules
    |-- /hooks        # Shared hooks
    |-- /lib          # Preconfigured library re-exports
    |-- /providers    # Application providers
    |-- /routes       # Routes configuration (omit for Next.js)
    |-- /stores       # Global state stores
    |-- /test         # Test utilities and mock server
    |-- /types        # Base types
    |-- /utils        # Shared utility functions
  5. Implement Lender Dashboard Overview KPIs

    The Lender Dashboard provides lenders with a comparative view of their performance against the market. Key metrics include conversion speed, market share, and commercial outcomes.
    • Conversion Velocity Rank: Position among lenders by average days-to-offer (firstSubmittedDate to completionDate). Minimum volume eligibility: >= 5 cases.
    • Your Cases: Total case count and completion market share (Lender completed cases / Market completed cases).
    • Total Net Revenue: Sum of netCaseRevenue values and Total loan value.
    • Avg Loan Size: Average loan size for submitted business.
    • Completion Rate: Lender completed cases / Lender total cases, compared to market equivalent.
    • Avg Days to Offer: Average difference between firstSubmittedDate and firstOfferDate (requires both dates to be present).
  6. Acre Software Task project overview and technical stack

    The Acre Software Task is a Single Page Application (SPA) designed to visualize mortgage metrics and insights. It features two distinct dashboards: an Internal Dashboard for Acre employees to monitor global lender activity, and a Lender Dashboard for external partners to track their own performance against anonymized market baselines.

    Technical Stack & Implementation:

    • Architecture: React + TypeScript SPA.
    • Data Handling: CSV data is parsed client-side and mapped into typed domain objects.
    • Scope: Designed for desktop viewports; excludes routing, authentication, and global navigation (header/footer/sidebar) as it is intended to be embedded within a larger application.
  7. Select a data fetching library for React

    Depending on the API type and architecture, use the following libraries:

    • TanStack Query (React Query): Versatile for both REST and GraphQL APIs. Install via yarn add @tanstack/react-query.
    • Apollo Client: Specifically for GraphQL APIs. Install via yarn add @apollo/client.
    • RTK Query: Use if the project is already utilizing Redux.
    • tRPC: Ideal when both frontend and backend are TypeScript and controlled by the same team; can be combined with TanStack Query.
  8. Understand the standard phases of the Software Development Life Cycle (SDLC)

    The SDLC is a structured methodology used to design, develop, and test high-quality software. It typically consists of eight sequential phases where each phase relies on the deliverables of the previous one:

    1. Planning and Design: Gathering requirements and architecting the solution.
    2. Code: The active development phase where software is written.
    3. Verify: Testing to ensure the software is bug-free and solves the intended problem.
    4. Integrate: Combining modules and managing dependencies.
    5. Release: Packaging and preparing software for delivery.
    6. Deploy: Moving software into production environments.
    7. Operate: Running the software in a live environment.
    8. Monitor: Observing system health and user behavior.