3.3 KiB

Raw Blame History

Bill Tracker Project Structure

Project Overview

Bill Tracking Website — Full-stack application with Node.js backend and React frontend.

Directory Structure

bill-tracker/
├── client/              # React frontend (ALL UI CODE HERE)
│   ├── components/      # Reusable React components
│   │   ├── layout/      # Layout components (Sidebar, etc.)
│   │   └── ui/          # UI components (buttons, inputs, etc.)
│   ├── pages/           # Page components (one per route)
│   │   ├── TrackerPage.jsx
│   │   ├── BillsPage.jsx
│   │   ├── CategoriesPage.jsx
│   │   ├── CalendarPage.jsx
│   │   ├── SummaryPage.jsx
│   │   ├── AnalyticsPage.jsx
│   │   ├── ProfilePage.jsx
│   │   ├── SettingsPage.jsx
│   │   ├── DataPage.jsx
│   │   ├── AdminPage.jsx
│   │   ├── LoginPage.jsx
│   │   └── AboutPage.jsx
│   ├── hooks/           # Custom React hooks (useAuth, etc.)
│   ├── api.js           # API client functions
│   ├── App.jsx          # React Router configuration
│   ├── main.jsx         # React entry point
│   └── index.html       # HTML template
├── server.js            # Express backend entry
├── routes/              # API route handlers
├── services/            # Business logic layer
├── middleware/           # Express middleware
├── db/                   # Database schemas/migrations
├── workers/              # Background job workers
├── scripts/              # Utility scripts
├── docs/                 # Documentation
├── dist/                 # Build output (generated)
├── public/               # Static assets
├── Dockerfile            # Container config
└── docker-compose.yml

Critical Notes for Agents

Frontend Code Location

ALL React components, pages, and UI code are in client/ folder.

Pages: client/pages/*.jsx
Components: client/components/**/*.jsx
Hooks: client/hooks/*.js
API client: client/api.js
Router: client/App.jsx

Backend Code Location

ALL backend code is at root or in server folders:

Entry: server.js
Routes: routes/*.js
Services: services/*.js
Middleware: middleware/*.js
Database: db/*.js

Agent Review Roles

Agent	Role	Focus Area
Neo	Backend / System Architecture	server.js, routes/, services/, middleware/, workers/, db/, Docker, performance, scalability, security
Scarlett	UI/UX / Frontend	client/, public/, components, styling, accessibility, responsive design
Bishop	Analysis / Code Quality	overall architecture, patterns, maintainability, technical debt
Private_Hudson	Security / Compliance	auth, data protection, input validation, compliance

Cross-Cutting Concerns

All agents must be aware of:

Routing: client/App.jsx defines all frontend routes
Auth: client/hooks/useAuth.jsx and services/authService.js
API: client/api.js mirrors routes/ structure
Database: db/database.js schema affects both frontend and backend

Review Output

All findings appended to REVIEW.md per agent section.

Generated by Prime for multi-agent review

3.3 KiB Raw Blame History