A project planning and proposal support platform for engineering consultants, utilities, and infrastructure organizations.
Schedule Builder assists project teams with developing schedules, staffing plans, resource allocations, schedule assumptions, risk registers, and proposal support documentation through a structured and repeatable workflow.
Engineering schedules are frequently developed by modifying previous projects rather than leveraging a structured planning process. While experienced project managers possess valuable knowledge regarding project sequencing, staffing requirements, permitting durations, and schedule risks, that knowledge is often difficult to capture and reuse consistently.
Schedule Builder seeks to standardize project planning workflows while preserving engineering judgment.
The platform is initially focused on municipal infrastructure projects including:
- Water distribution systems
- Wastewater collection systems
- Lift stations
- Force mains
- Stormwater systems
- Water treatment facilities
- Wastewater treatment facilities
- Capital improvement programs
Project schedules are among the most important planning tools used by engineering organizations, yet schedule development often remains a manual process.
Common challenges include:
- Recreating similar schedules for every proposal
- Inconsistent planning assumptions
- Limited visibility into staffing requirements
- Resource conflicts across projects
- Lack of standardized schedule templates
- Poor documentation of schedule logic
- Limited ability to compare planned versus actual performance
Schedule Builder aims to improve consistency, efficiency, and transparency throughout the planning process.
Generate schedules from predefined project templates.
Create project-specific task lists and milestone schedules.
Develop staffing allocations by discipline and project phase.
Generate labor-hour summaries and resource loading tables.
Produce standardized planning assumptions suitable for proposal documents.
Generate project-specific risks and mitigation measures.
Generate schedule narratives for proposal submissions.
The initial release focuses on proposal support and project planning.
Included features:
- Project templates
- Task generation
- Milestone generation
- Staffing tables
- Schedule assumptions
- Risk registers
- Proposal narrative generation
- Excel exports
Excluded features:
- Microsoft Project integration
- Resource leveling
- Schedule optimization
- Historical analytics
- Monte Carlo simulation
- Multi-user collaboration
- Project templates
- Task generation
- Staffing plans
- Proposal narratives
- Risk registers
- Multi-project staffing analysis
- Resource loading calculations
- Resource conflict identification
- Enhanced reporting
- Planned vs actual tracking
- Milestone performance analysis
- Schedule variance reporting
- Historical benchmarking
- Historical project repository
- Lessons learned integration
- Schedule benchmarking
- Performance metrics
- Schedule risk scoring
- Delay probability analysis
- Contingency recommendations
- Monte Carlo schedule simulation
Planned technologies include:
- Python
- FastAPI
- PostgreSQL
- SQLAlchemy
- Alembic
- Pandas
- OpenPyXL
- Plotly
Specific implementation details are documented within the project architecture documentation.
- Python 3.12 or higher
uv– Fast Python package installer and resolver
- Clone the repository:
git clone <repository-url>
cd schedule-builder- Install dependencies using
uv:
uv syncThis command will:
- Create a virtual environment (
.venv) - Install all project dependencies
- Install development dependencies from the
devgroup
For detailed uv setup instructions, see the uv documentation.
Start the development server with auto-reload enabled:
uv run uvicorn schedule_builder.main:app --reloadThe API will be available at http://localhost:8000.
Once the server is running:
- Swagger UI (Interactive API docs): http://localhost:8000/docs
- ReDoc (Alternative API docs): http://localhost:8000/redoc
- OpenAPI Schema: http://localhost:8000/openapi.json
Verify the server is running:
curl http://localhost:8000/healthExpected response:
{"status": "ok"}Run the test suite:
uv run pytestRun tests with verbose output:
uv run pytest -vRun a specific test file:
uv run pytest tests/api/test_health.py| Document | Description |
|---|---|
docs/00_overview.md |
Project overview, vision, and roadmap |
docs/01_architecture/00_project_structure.md |
Repository organization and architecture |
docs/01_architecture/01_system_architecture.md |
System architecture and component relationships |
docs/02_requirements/ |
Functional and non-functional requirements |
docs/03_design/ |
Design decisions and implementation planning |
docs/04_development/ |
Development notes and implementation tracking |
Current Phase: Concept Development
Current activities include:
- Requirements gathering
- Architecture planning
- Template design
- Staffing model development
- MVP definition
No production implementation has begun.
The long-term vision of Schedule Builder is to evolve into a project delivery analytics platform that supports schedule development, staffing optimization, resource planning, project performance tracking, and schedule forecasting.
By combining engineering knowledge, historical project data, and analytical tools, the platform aims to improve project planning and delivery outcomes across engineering organizations.
This project is licensed under the MIT License.