Commit Graph

47 Commits

Author SHA1 Message Date
Achintha Isuru
5cf0c91ebe feat: Add guidelines for prop drilling prevention and BLoC lifecycle management in architecture principles 2026-02-19 15:22:33 -05:00
Achintha Isuru
7b9507b87f feat: Refactor staff profile page and logout button for improved state management and navigation 2026-02-19 13:39:03 -05:00
Achintha Isuru
d404b6604d feat: Update architecture documentation for Data Connect Connectors pattern and remove unused import in staff connector repository implementation 2026-02-19 13:20:43 -05:00
Achintha Isuru
a162824887 feat: Implement profile completion feature with repository and use case 2026-02-19 10:56:04 -05:00
José Salazar
d366bd1443 new file to discuss of backend funcionts 2026-02-18 19:40:15 -05:00
Achintha Isuru
f5a23c3aaa feat: Add comprehensive documentation for Krow Platform architecture, including system bible, web application use cases, and mobile agent development rules
- Introduced the Krow Platform System Bible detailing the executive summary, system vision, ecosystem overview, architecture, application responsibilities, use cases, and security model.
- Created a detailed use case overview for the Krow Web Application, outlining workflows for Admin, Client, and Vendor roles.
- Established non-negotiable agent development rules for mobile applications, emphasizing file structure, naming conventions, logic placement, localization, and error handling.
- Defined architecture principles for the Krow mobile platform, focusing on clean architecture, dependency direction, and session management.
- Documented design system usage guidelines to ensure UI consistency and adherence to design tokens across applications.
2026-02-18 10:23:07 -05:00
Achintha Isuru
61be898609 Add goal and basis for M4 planning document 2026-02-17 16:19:07 -05:00
Achintha Isuru
50c6be46a0 Add goal for order creation transaction in backend
Added goal for order creation flow transaction using cloud functions.
2026-02-17 16:18:57 -05:00
Achintha Isuru
db8a2f6e66 Revise M4 milestone planning with new requirements
Updated M4 milestone planning document to include new goals, acceptance criteria, and key rules for backend and frontend tasks.
2026-02-17 16:18:33 -05:00
José Salazar
5f96d5087b adding isProfileVisible for the staff 2026-02-16 14:52:17 -05:00
Achintha Isuru
1543656b32 Update m4-discrepencies.md 2026-02-12 17:13:44 -05:00
Achintha Isuru
59acd89eea Update m4-discrepencies.md 2026-02-12 17:13:19 -05:00
Achintha Isuru
ca197f12e2 Revise M4 planning document title and content
Updated the title and removed introductory text for clarity.
2026-02-12 17:04:02 -05:00
Achintha Isuru
c906d70812 feat: Add M4 Planning Phase documentation outlining identified discrepancies and proposed enhancements 2026-02-12 17:00:42 -05:00
Achintha Isuru
fd47d84045 feat: Add Milestone 3 documentation including feature testing plan, demo notes, and demo flow details
- Introduced comprehensive testing plan for Milestone 3 in m3-client-note.md
- Documented feedback and suggestions from demo sessions in m3-notes.md
- Created detailed demo flow for Milestone 3 in m3.md, outlining user interactions and expected outcomes
- Added planning tasks for Milestone 4 in m4-planning.md, covering backend and frontend development tasks, research, and business tasks
2026-02-12 16:33:16 -05:00
c1112ac01c feat: Centralized Error Handling & Crash Fixes 2026-02-11 18:52:23 +05:30
4e4b644b32 docs: fix mermaid diagram syntax error 2026-02-11 10:39:35 +05:30
3e212220c7 feat: complete centralized error handling system with documentation 2026-02-11 10:36:08 +05:30
5e7bf0d5c0 refactor: centralize data connect error handling and resolve build issues across applications
This commit addresses several critical issues across the mobile monorepo:

1. Centralized Error Handling: Integrated DataErrorHandler mixin into all repository implementations, ensuring consistent mapping of Data Connect exceptions to domain AppExceptions.
2. Build Stabilization: Fixed numerous type mismatches, parameter signature errors in widgets (e.g., google_places_flutter itemBuilder), and naming conflicts (StaffSession, FirebaseAuth).
3. Code Quality: Applied 'dart fix' across all modified packages and manually cleared debug print statements and UI clutter.
4. Mono-repo alignment: Standardized Data Connect usage and aliasing ('dc.') for better maintainability.

Signed-off-by: Suriya <suriya@tenext.in>
2026-02-06 13:28:57 +05:30
3924801f70 feat(mobile): implement centralized error handling and project cleanup
- Implemented centralized error handling system (#377)
- Unified UIErrorSnackbar and BlocErrorHandler mixin
- Migrated ClientAuthBloc and ClientHubsBloc
- Consolidated documentation
- Addresses Mobile Apps: Project Cleanup (#378)
2026-02-05 15:35:35 +05:30
Achintha Isuru
08b96cea6f feat: Introduce CoverageWorker entity and update coverage repository
- Added CoverageWorker entity to represent worker status and check-in information.
- Updated CoverageRepositoryImpl to utilize CoverageWorker and its status.
- Removed legacy coverage_entities.dart file and replaced references with krow_domain imports.
- Enhanced coverage statistics calculations based on new worker status logic.
- Updated UI components to reflect changes in worker status representation.
- Modified acceptance of shifts to align with new status definitions.
- Cleaned up QA testing checklist to remove outdated items and clarify requirements.
2026-02-01 21:05:14 -05:00
Achintha Isuru
5c15db1695 Integrate Google Maps Places Autocomplete for hub address validation and enhance UI button styles 2026-02-01 20:22:14 -05:00
Achintha Isuru
3ea7d4352f Refactor code structure for improved readability and maintainability 2026-02-01 19:53:00 -05:00
Achintha Isuru
ecc7aece6e chore: Refactor mobile build scripts to use Melos
Updated Makefile, mobile.mk, and melos.yaml to centralize mobile app build, start, and code generation commands using Melos scripts. Added info and install-melos commands for easier onboarding and workspace setup. Documentation updated to reflect staff app naming and new command structure.
2026-01-22 10:55:46 -05:00
José Salazar
6960e9e472 deleting unnecesari files 2026-01-19 19:16:31 -05:00
Boris-Wilfried
7c69efc2a6 Merge pull request #199 from Oloodi/prep-sprint-3
Prep sprint 3
2026-01-15 09:25:32 -05:00
José Salazar
33b9af8e8b diagrams for dataconnect 2026-01-13 13:14:23 -05:00
Achintha Isuru
ef31dbe414 docs: update the route of the mobile apps 2026-01-12 21:01:31 -05:00
Achintha Isuru
7d61997373 doc: doc 05 updated with some changes 2026-01-12 17:26:43 -05:00
bwnyasse
8916a4ac49 feat: add feature roadmap and tickets documentation
feat: add detailed feature roadmap and tickets documentation
feat: add roadmap overview diagram
feat: add roadmap p0 mvp diagram
feat: add roadmap p0 complete workflow diagram
feat: update diagrams config to include new roadmap diagrams
feat: add support for syncing source code for ai context
chore: update allowed hashes
feat: add jose.salazar@oloodi.com to iap-users.txt
feat: add fazulilahi@gmail.com to iap-users.txt
feat: add zouantchaw74@gmail.com to iap-users.txt
2026-01-12 11:44:26 -05:00
bwnyasse
5cc4e0fc0a docs: add project onboarding master document
This commit introduces a comprehensive document outlining the
KROW Workforce Platform project, covering vision, architecture,
domain logic, feature gap analysis, and development strategy.

The document serves as a central source of truth for team
onboarding and sprint planning, ensuring alignment and
consistency across the project. It details the migration from
a legacy system to a new GCP-based architecture using Firebase
Data Connect, Cloud Functions, and Cloud SQL.

Key aspects covered include:

- Project vision and business value proposition
- System architecture and technology stack comparison
- Core domain logic and entity definitions
- Feature gap analysis between legacy and prototype apps
- Data Connect schema evolution and development strategy
- Definition of Done (DoD) for features and sprints

The document also includes appendices with entity relationship
summaries, status enum references, and key file locations.
2026-01-11 10:57:33 -05:00
bwnyasse
ea6765af96 feat(docs): update contributing guide with required tools and IDE setup
feat(internal/launchpad): add iframe viewer for prototypes and update links loader

This commit introduces an iframe viewer in the launchpad to display prototypes directly within the application. It also updates the links loader to handle prototype links differently, opening them in the iframe instead of a new tab.

The contributing guide has been updated to include a list of required development tools and recommended IDE setup, ensuring that contributors have the necessary tools to work on the project.
2026-01-10 23:48:45 -05:00
bwnyasse
969bc13939 feat: add documentation for synchronizing prototypes and script to automate the process
This commit introduces a new document explaining how to synchronize visual prototypes and POCs into the monorepo.
It also adds a script to automate the process of building and copying the prototype files into the `internal/launchpad/prototypes/web/` directory.
The documentation explains the benefits of synchronizing prototypes, the prerequisites, and the steps to synchronize them.
The script automates the process of installing dependencies, building the web application, and copying the resulting `dist/` folder into the `internal/launchpad/prototypes/web/` directory.
This allows developers to easily synchronize prototypes and make them available for local preview and deployment.
2026-01-10 23:04:36 -05:00
bwnyasse
3c0488576b refactor: restructure monorepo to align with industry standards
This commit restructures the monorepo to improve organization,
maintainability, and scalability. The changes include:

- Moving mobile apps from `mobile-apps/` to `apps/mobile-*`.
- Moving the web dashboard from `admin-web/` and `frontend-web/`
 to `apps/web-dashboard/`.
- Moving Firebase-related files to the root `firebase/` directory.
- Adding a `.geminiignore` file to exclude unnecessary files from
 Gemini analysis.
- Updating `.gitignore` to reflect the new structure and exclude
 sensitive files.
- Updating `codemagic.yaml` to reflect the new app locations.
- Adding a `make help` command to the root directory.
- Adding a `make install-git-hooks` command to install git hooks.
- Adding a `docs/02-codemagic-env-vars.md` file to document
 Codemagic environment variables.
- Adding a `docs/03-contributing.md` file to document
 contribution guidelines.
- Adding prototype placeholders to the internal launchpad.
- Updating the `README.md` file to reflect the new structure and
 provide updated instructions.

These changes improve the overall structure of the monorepo and
make it easier to develop, maintain, and scale the KROW Workforce
platform.
2026-01-10 22:36:29 -05:00
bwnyasse
a0d820d3ce feat: add backend api specification document
This commit introduces a new document, `docs/01-backend-api-specification.md`, which outlines the backend API specification for the KROW Workforce platform. This document serves as a reference for the development of the backend using Firebase Data Connect and Cloud Functions, replacing the Base44 backend. It includes details on authentication, data API, services API, security, migration notes, and implementation priority.
feat: remove obsolete documentation files

This commit removes several obsolete documentation files that are no longer relevant to the project. The removed files include:

- `docs/01-product-functional-roadmap.md`: This file contained the product roadmap, which is now outdated.
- `docs/02-architecture-overview.md`: This file provided an overview of the architecture, which has been superseded by more recent documentation.
- `docs/03-backend-api-specification.md`: This file contained the backend API specification, which has been replaced by `docs/01-backend-api-specification.md`.
- `docs/04-strategy-technical-roadmap.md`: This file outlined the technical roadmap, which is now outdated.
- `docs/05-project-plan.md`: This file contained the project plan, which is no longer current.
- `docs/06-maintenance-guide.md`: This file provided a maintenance guide, which is no longer applicable.
- `docs/07-reference-base44-api-export-v3.md`: This file contained a reference to the Base44 API export, which is no longer needed.

chore: remove obsolete documentation files

This commit removes several documentation files that are no longer
relevant or have been superseded by other documentation. Removing
these files helps to keep the repository clean and organized.

The following files were removed:

- `docs/07-reference-base44-api-export.md`
- `docs/08-reference-base44-prompts.md`
- `docs/09-sred-tracking.md`
- `docs/10-development-conventions.md`
- `docs/flows/vendor-flow.md`
- `docs/issues/template.md`
- `docs/prompts/create-codemagic-monorepo.md`
- `docs/prompts/create-full-architecture-diagram-flutter.md`
- `docs/prompts/create-mermaid-be-diagrams-flutter.md`
- `docs/prompts/create-mermaid-overview-flutter.md`
- `docs/prompts/create-mermaid-usecase-flutter.md`
2026-01-10 21:36:01 -05:00
José Salazar
56918f4374 new flow for vendor on web 2025-12-12 10:06:51 -05:00
bwnyasse
ef645fd99f feat: add documentation for GCP migration and Base44 API export
This commit adds two new documentation files:

- `docs/03-backend-api-specification-v3.md`: This document defines the backend API to be built on the Firebase/GCP ecosystem, replacing the Base44 backend. It is based on the comprehensive Base44 API documentation (v3.0) and will guide the development of the new backend using Firebase Data Connect and Cloud Functions.
- `docs/07-reference-base44-api-export-v3.md`: This document provides complete API specifications for all entities, SDK methods, and integration endpoints of the KROW Workforce platform built on Base44.
2025-11-21 09:53:25 -05:00
Achintha Isuru
a8f935d61a feat: Configure Codemagic workflows for multi-environment mobile app distribution 2025-11-18 11:17:06 -05:00
Achintha Isuru
26dff819a1 feat(diagrams): add comprehensive architecture and use case diagrams for client mobile application 2025-11-16 16:57:47 -05:00
Achintha Isuru
c329dbe138 feat(diagrams): add new Mermaid diagrams for client mobile application overview, use cases, API map, and backend architecture 2025-11-16 16:57:47 -05:00
Achintha Isuru
662008c870 feat(diagrams): add Mermaid diagrams for backend architecture, API map, and use-case flows 2025-11-16 16:57:46 -05:00
bwnyasse
edf3dc4042 feat: add base44 entity schemas reference
feat: add issue template
feat: add labels.yml with platform:admin label
feat: add setup_admin_console.sh script and update Makefile

This commit introduces several new features and files to the
repository:

- Adds a reference document for Base44 entity schemas to
 ensure data integrity during the migration to the new
 GCP/Firebase backend.
- Adds an issue template to standardize issue reporting and
 ensure all necessary information is included.
- Adds a new label to `labels.yml` for tasks specific to the
 Admin Console web app.
- Adds a shell script to automate the setup of the Admin
 Console web application, including scaffolding,
 dependency installation, and configuration. Also updates
 the Makefile to include new targets for managing the Admin
 Console application.
- Adds issues to create markdown file.
2025-11-14 18:50:24 -05:00
Achintha Isuru
9afd275d9f feat: add prompts for generating Mermaid diagrams for Flutter application architecture and use cases 2025-11-13 18:39:55 -05:00
bwnyasse
6540d01175 feat: add SR&ED tracking and project management tools
This commit introduces several new files and updates to support
SR&ED tracking and project management:

- Adds a template for SR&ED tasks to standardize issue creation.
- Adds a Makefile command to set up GitHub labels from a YAML file.
- Adds a Makefile command to export SR&ED-eligible issues to a
 Markdown file.
- Adds a Makefile command to create issues from a file.
- Adds documentation for SR&ED tracking and development
 conventions.
- Adds a YAML file to define GitHub labels.
- Adds scripts to set up GitHub labels, export issues, and create
 issues from a file.
- Updates the project plan to include SR&ED considerations.

These changes aim to improve project organization, facilitate
SR&ED claims, and streamline development workflows.
2025-11-13 11:33:52 -05:00
bwnyasse
554dc9f9e3 feat: Initialize monorepo structure and comprehensive documentation
This commit establishes the new monorepo architecture for the KROW Workforce platform.

Key changes include:
- Reorganized project into `frontend-web`, `mobile-apps`, `firebase`, `scripts`, and `secrets` directories.
- Updated `Makefile` to support the new monorepo layout and automate Base44 export integration.
- Fixed `scripts/prepare-export.js` for ES module compatibility and global component import resolution.
- Created and updated `CONTRIBUTING.md` for developer onboarding.
- Restructured, renamed, and translated all `docs/` files for clarity and consistency.
- Implemented an interactive internal launchpad with diagram viewing capabilities.
- Configured base Firebase project files (`firebase.json`, security rules).
- Updated `README.md` to reflect the new project structure and documentation overview.
2025-11-12 12:50:55 -05:00
bwnyasse
866d0df45c feat(docs): add MAINTENANCE_GUIDE.md to describe the process of updating the API documentation and specification
feat(docs): update API_documentation.md with comprehensive API specifications for all entities, SDK methods, and integration endpoints
feat(docs): update api_specification.md to align with the updated API documentation and guide the development of the new backend
2025-11-11 06:57:58 -05:00
bwnyasse
e571193362 feat: Initial commit of KROW Workforce Web client (Base44 export) 2025-11-11 06:08:01 -05:00