{"id":34908066,"url":"https://github.com/nikkiaung/angular-spring-boot-shopping","last_synced_at":"2026-04-14T06:02:09.795Z","repository":{"id":328600542,"uuid":"1116090716","full_name":"NikkiAung/angular-spring-boot-shopping","owner":"NikkiAung","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-11T02:15:15.000Z","size":174,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T10:16:05.606Z","etag":null,"topics":["angular","bootsrap5","dependency-injection","hibernate-jpa","html-css","java","jwt-authentication","mysql-database","object-oriented-programming","spring-boot","typescript"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NikkiAung.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-14T07:09:35.000Z","updated_at":"2026-01-11T02:15:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/NikkiAung/angular-spring-boot-shopping","commit_stats":null,"previous_names":["nikkiaung/angular-spring-boot-shopping"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NikkiAung/angular-spring-boot-shopping","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikkiAung%2Fangular-spring-boot-shopping","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikkiAung%2Fangular-spring-boot-shopping/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikkiAung%2Fangular-spring-boot-shopping/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikkiAung%2Fangular-spring-boot-shopping/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NikkiAung","download_url":"https://codeload.github.com/NikkiAung/angular-spring-boot-shopping/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NikkiAung%2Fangular-spring-boot-shopping/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31784255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","bootsrap5","dependency-injection","hibernate-jpa","html-css","java","jwt-authentication","mysql-database","object-oriented-programming","spring-boot","typescript"],"created_at":"2025-12-26T10:34:52.359Z","updated_at":"2026-04-14T06:02:09.789Z","avatar_url":"https://github.com/NikkiAung.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spring Boot + Angular Shopping\n\nA full-stack shopping app split into two projects:\n\n- `shop/`: Spring Boot REST API with JWT auth and MySQL persistence.\n- `shoppy/`: Angular UI for shopping and basic admin management.\n\nThe backend serves data and static images; the frontend consumes the API and manages auth via JWT stored in `localStorage`.\n\n## Tech Stack\n\nBackend\n- Java + Spring Boot\n- Spring Web, Spring Security, Spring Data JPA\n- MySQL\n- JWT authentication\n\nFrontend\n- Angular (standalone components, Angular Router)\n- TypeScript, RxJS\n\n## Project Structure\n\n```\n.\n├── shop/                 # Spring Boot API\n│   ├── src/main/java/... # Controllers, services, models, security\n│   ├── src/main/resources\n│   │   ├── application.properties\n│   │   └── static/images # Uploaded product/category images\n│   └── pom.xml\n├── shoppy/               # Angular app\n│   ├── src/app            # Components, routes, services\n│   ├── src/styles.css\n│   └── package.json\n└── README.md\n```\n\n## Backend Overview (`shop/`)\n\nKey layers:\n- Controllers: REST endpoints for public API (`/api/*`) and admin API (`/admin/*`).\n- Services + Impl: business logic and persistence orchestration.\n- Repositories: Spring Data JPA repositories for CRUD queries.\n- Models: JPA entities (`Category`, `Subcat`, `Childcat`, `Tag`, `Product`, `Order`, `OrderItem`, `AppUser`, `Role`).\n- Security: JWT filter + user details service + security config.\n\nImportant classes:\n- `com.coder.shop.controller.ApiController` handles public endpoints:\n  - `GET /api/cats`, `/api/subcats`, `/api/childcats`, `/api/tags`, `/api/products`\n  - `POST /api/login`, `/api/register`\n  - `POST /api/orders` (requires JWT)\n  - `POST /api/myOrders` (requires JWT)\n- `com.coder.shop.controller.*Controller` under `/admin/*` for CRUD of categories, products, tags, roles, users, etc.\n- `com.coder.shop.security.*` for JWT parsing and auth integration.\n- `com.coder.shop.services.ImageService` saves uploads to `src/main/resources/static/images`.\n\nConfig:\n- `server.port=3000`\n- MySQL DB: `jdbc:mysql://localhost:3306/shoppy`\n- JWT secret + expiration set in `application.properties`\n\nNote: The JWT secret in `application.properties` is committed; for real use, move it to environment variables.\n\n## Frontend Overview (`shoppy/`)\n\nRouting is defined in `src/app/app.routes.ts` with pages for:\n- Home, login, register, cart, order history\n- Admin sections for categories, subcategories, child categories, tags, products, roles, users\n\nAPI integration:\n- `src/app/apiservice.ts` for public endpoints (`/api/*`)\n- Feature services under `src/app/**/` for admin endpoints (`/admin/*`)\n\nAuth:\n- `src/app/auth.interceptor.ts` injects `Authorization: Bearer \u003ctoken\u003e` for API calls\n- `src/app/login/login.ts` stores JWT in `localStorage`\n\nBase URLs are defined in `src/app/utils/Vary.ts`:\n- API base: `http://localhost:3000/api`\n- Admin base: `http://localhost:3000/admin/...`\n\n## Local Development\n\n### 1) Database\n\nCreate a MySQL database named `shoppy`.\n\nIf needed, update credentials in:\n- `shop/src/main/resources/application.properties`\n\n### 2) Backend (Spring Boot)\n\nFrom `shop/`:\n\n```\n./mvnw spring-boot:run\n```\n\nThe API will run on `http://localhost:3000`.\n\n### 3) Frontend (Angular)\n\nFrom `shoppy/`:\n\n```\nnpm install\nnpm start\n```\n\nThe Angular dev server will run on `http://localhost:4200`.\n\n## CORS / Port Notes\n\nBackend controllers use `@CrossOrigin(origins = \"http://localhost:4000\")` while the Angular dev server defaults to `http://localhost:4200`. For local development, either:\n\n- Change Angular to run on port 4000, or\n- Update CORS origins in the backend to allow 4200.\n\n## API Summary\n\nPublic endpoints (`/api/*`):\n- `GET /api/cats`, `/api/subcats`, `/api/childcats`, `/api/tags`, `/api/products`\n- `POST /api/login`\n- `POST /api/register`\n- `POST /api/orders` (JWT required)\n- `POST /api/myOrders` (JWT required)\n\nAdmin endpoints (`/admin/*`):\n- CRUD for categories, subcategories, child categories, tags, products, roles, users\n\nImages:\n- Uploaded images are available at `http://localhost:3000/images/\u003cfilename\u003e`\n\n## Testing\n\nBackend: no explicit test setup found in this repo.\nFrontend: Angular uses `ng test` (Vitest in `package.json`).\n\n## Known Caveats\n\n- `ProductImpl.add` throws `UnsupportedOperationException` and is not implemented; product creation may fail unless updated.\n- JWT secret is committed to source; consider moving to environment variables.\n\n## Suggested Next Steps\n\n- Implement `ProductService.add` to allow product creation.\n- Align CORS origins with your frontend port.\n- Move DB credentials and JWT secret to environment variables.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikkiaung%2Fangular-spring-boot-shopping","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikkiaung%2Fangular-spring-boot-shopping","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikkiaung%2Fangular-spring-boot-shopping/lists"}