[Feature]: Proposal Acceptance & Contract Creation Service

[SudiptaPaul-31]

🔍 Problem Statement

Description

When a client accepts a freelancer’s proposal, the system should automatically generate a corresponding contract record. This ensures a seamless transition from proposal stage to contract execution, while maintaining data integrity and preventing conflicts.

---

Flow

1. Proposal Accepted — client confirms acceptance of a freelancer’s proposal.
2. Validate Project — ensure the project is active, not already bound to another accepted proposal.
3. Create Contract — generate a new contract record linked to the accepted proposal.
4. Create Milestones — initialize contract milestones based on the proposal’s breakdown (if provided).
5. Initialize Escrow Status — set escrow state to Pending Funding until client deposits funds.

---

Acceptance Criteria

• ✅ Database transaction for atomicity — all steps (proposal acceptance → contract creation → milestone setup → escrow initialization) must occur within a single transaction to prevent partial state.
• ✅ Prevent multiple accepted proposals per project — enforce uniqueness so only one proposal can be accepted per project.
• ✅ Maintain proposal → contract relationship — contracts must reference the originating proposal ID for traceability.
• ✅ Status updates — proposal status changes to Accepted, contract status set to Draft or Pending Funding.
• ✅ Error handling — rollback transaction if any step fails (e.g., milestone creation error).

---

Additional Notes

• Data model considerations:

  • Proposal → Contract one-to-one relationship.
  • Contract → Milestones one-to-many relationship.
  • Escrow state tied to contract lifecycle.

• Authorization:

  • Only clients can accept proposals.
  • Freelancers cannot trigger contract creation directly.

• Audit trail:

  • Log acceptance event, contract creation, and escrow initialization with timestamps and actor IDs.

---

Future Enhancements

• 🔹 Automatic notification to freelancer upon contract creation.
• 🔹 Smart contract integration (blockchain-based escrow).
• 🔹 Contract versioning for milestone updates.
• 🔹 Analytics on proposal-to-contract conversion rates.

📈 Expected Impact

High — Would significantly improve user experience

[jast78]

@jast78 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

Hi, I have carefully gone over the issue description and understand what is needed. I would welcome the chance to take this on and help resolve it effectively.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jast78 to this issue.

[Jentle042]

@Jentle042 has applied to work on this issue as part of the Stellar Wave Program's 9th wave.

I can handle this issue please assign to me .

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Jentle042 to this issue.

[drips-wave]

Congratulations, @Jentle042! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on September 30, 2026.

🧑‍💻 @Jentle042: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊