comercial-template

01Problem

The problem this project takes on is proposals written in documents and spreadsheets: totals calculated by hand, no history per client, and a clean PDF that has to be formatted again every time. It tests whether that flow (client → proposal → line items → total → PDF) can be a small, reliable, reusable application.

02Context

A demonstration application with a Brazilian Portuguese interface and synthetic seed data. It is not deployed and has no users; no production adoption is claimed.

03Solution

• Email and password registration and login, with bcrypt-hashed passwords and JWT sessions.
• A protected dashboard, plus creation, listing and detail views for clients and proposals.
• Line items with quantities, prices and totals rounded to cents.
• A PDF of each proposal generated on the server and downloaded only by its owner.

comercial-template·proposal detail

04Architecture

A single Next.js App Router application in TypeScript. Pages are React Server Components that query the database through Prisma (SQLite); writes go through Server Actions; one route handler renders PDFs with @react-pdf/renderer. Middleware blocks protected routes without a session. A Dockerfile and a standalone build are configured.

05Evidence

• 24/24 unit tests passed (4 files: money, server actions, middleware, PDF route), and the typecheck is clean, in the run for this site on 2026-10-19.
• CI passed on the current commit. The "Web validation" workflow runs install, lint, unit tests, production build, typecheck and a browser smoke test against the production build.
• Data isolation is tested: the PDF route returns 401 without a session and 404 for proposals the user does not own, and creating a proposal refuses another user's client.
• The repository documents a browser run on 2026-10-07 with 13/13 checks, including a second user receiving 404 on the first user's records. That run was not repeated for this site.

Links

• Public repository: https://github.com/lughlammas/comercial-template
• Commit 3ead252: https://github.com/lughlammas/comercial-template/commit/3ead2526b0a2d5e5f7970b539016dba8f56def3c
• CI run "Web validation" on 3ead252 (success, public log): https://github.com/lughlammas/comercial-template/actions/runs/37713989999
• Unit tests (source): https://github.com/lughlammas/comercial-template/tree/3ead2526b0a2d5e5f7970b539016dba8f56def3c/tests
• CI workflow: https://github.com/lughlammas/comercial-template/blob/3ead2526b0a2d5e5f7970b539016dba8f56def3c/.github/workflows/ci.yml
• Product walkthrough with the documented 2026-10-07 browser run: https://github.com/lughlammas/comercial-template/blob/3ead2526b0a2d5e5f7970b539016dba8f56def3c/docs/PRODUCT_WALKTHROUGH.md
• The 24/24 run for this site: internal test log, not public. The public CI run above covers the same tests.

06Human role and AI tools

Built through human-directed AI-assisted development: AI tools contributed to product, implementation, QA and documentation, under human direction. The repository contains application source, not an agent platform.

07Tests executed

09Commercial relevance

This is the reference for S02 · Custom Software & MVP: authentication, data ownership, a money calculation with tests, and a document output, delivered with its limits stated. It is also a base that can be adapted to similar flows (quotes, receipts, simple contracts) after an assessment of what each one needs.

→ S02 · Custom Software & MVP Development · Discuss Your Project